docusaurusエラー「Error: Plugin “docusaurus-plugin-content-blog” is used 2 times with ID “default”.」

背景

docusaurus で blog ページを2つ作ろうと、preset + plugin で作ろうとしたら以下のエラーが発生しました。

[ERROR] Error: Plugin "docusaurus-plugin-content-blog" is used 2 times with ID "default".
To use the same plugin multiple times on a Docusaurus site, you need to assign a unique ID to each plugin instance.

The plugin ID is "default" by default. It's possible that the preset you are using already includes a plugin instance, in which case you either want to disable the plugin in the preset (to use a single instance), or assign another ID to your extra plugin instance (to use multiple instances).

原因

エラー内容は読んでそのままの「IDが重複してるから作成できないよ」という内容なのですが、公式ドキュメントを呼んでも「IDなんてパラメーターが存在しない」という状況で、ググってもエラーが発生している人が居ないなど、少々時間を取られました。

公式ドキュメント:

📦 plugin-content-blog | Docusaurus
Provides the Blog feature and is the default blog plugin for Docusaurus.

対策

シンプルにidを追加すれば良いです。
ドキュメントはありませんがコードの方には定義されており、これで対処できます。

ドキュメントの更新漏れでしょうね。

コメント

タイトルとURLをコピーしました