メインコンテンツまでスキップ

ドキュメントのバージョン管理

Docusaurus は、ドキュメントの複数のバージョンを管理できます。

ドキュメントのバージョンを作成する​

プロジェクトのバージョン 1.0 をリリースします：

npm run docusaurus docs:version 1.0

docs フォルダが versioned_docs/version-1.0 にコピーされ、versions.json が作成されます。

これでドキュメントには 2 つのバージョンが存在します：

  • バージョン 1.0 のドキュメントは http://localhost:3000/docs/ にあります
  • 今後リリース予定の未公開ドキュメント は http://localhost:3000/docs/next/ の current にあります

バージョンドロップダウンの追加​

バージョン間をシームレスに移動するために、バージョンドロップダウンを追加します。

docusaurus.config.js ファイルを以下のように変更します：

docusaurus.config.js
export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'docsVersionDropdown',
        },
      ],
    },
  },
};

ドキュメントのバージョンドロップダウンがナビゲーションバーに表示されます：

Docs Version Dropdown

既存のバージョンを更新する​

バージョン管理されたドキュメントは、それぞれのフォルダで編集することができます：

  • versioned_docs/version-1.0/hello.md は http://localhost:3000/docs/hello を更新します
  • docs/hello.md は http://localhost:3000/docs/next/hello を更新します