docusaurus お試し

20231221ssg react

ちょっと Docusaurus を使うかもしれないので練習する。

minista の方が好みにあっているので後で戻るかもしれない。

戻るときに記事管理に https://contentlayer.dev/ と組み合わせてみたい。 getStaticPaths を調べているとき見つけたのだけど、手作業で markdown 記事を収集しているところにマッチしている感じがする。

docusaurus memo

の手順通りに初期サイトを作成。 package.json を起点に関係ありそうなファイルを手作業でコピーすることでシステムを入れ替えた。

markdown を移植すると細かいエラーが出たりするものだが、エラーメッセージがわかりやすいので簡単に対処できた。これはポイントが高い。

docusaurus はあっという間に体裁が整う。お手軽でよいかもしれない。

左側にサイトのサイドバーが来て、右側に記事の TOC が付くのはよい。 Document には具合がよさそうだ。

TypeError: pathname.match is not a function

npm 掃除がなっていなかった。

rm -rf package-lock.json node_modules

でなおった。

dead link. 治せるエラーメッセージになった。

[cause]: Error: Docusaurus found broken links!

… 内部リンクのdead link はちゃんとなおそう w

過去に Sphinx や mdbook で作ったメモ書きを docusaurus 化して使い勝手を確かめる。