@levino/shipyard-base@0.6.3

Patch Changes

• 50fb3e5: Admonitions and other markdown features now work out-of-the-box without manual configuration. The shipyard integration automatically registers the required remark plugins (remarkDirective, remarkAdmonitions, remarkNpm2Yarn), so you no longer need to add them to your Astro config.

• f8a73a6: You can now create versioned documentation to maintain multiple versions of your docs side-by-side.

  Key features:

  • Configure multiple documentation versions (e.g., v1, v2, latest) with automatic URL routing
  • Version selector UI component displays in both navbar and sidebar for easy version switching
  • Mark versions as stable, deprecated, or unreleased with visual badges
  • Sidebar automatically filters to show only pages in the current version
  • Pagination stays within the same version boundaries
  • Support for a "latest" alias that always points to the current version
  • Automatic redirect from docs root to current version

  Getting started:

  // astro.config.mjs
  shipyardDocs({
    routeBasePath: "docs",
    versions: {
      current: "v2",
      available: [
        { version: "v2", label: "Version 2.0" },
        { version: "v1", label: "Version 1.0" },
      ],
      deprecated: ["v1"],
      stable: "v2",
    },
  });

  See the versioning guide for complete documentation.