VuePress がやっと動いた

VuePress は利用者も多いので安定して使えるのかと思いきやなかなかたいへんだった。

もっともシンプルに始める場合

mkdir /tmp/test-of-vuepress
cd /tmp/test-of-vuepress
npm i -g vuepress
echo "# Hello" > README.md
vuepress dev -p 3901 --open

• わりと玄人向け
• 一から作りたいとき用
• 対象アプリのドキュメント用であれば vuepress はそのアプリの packages.json に追加する形にした方がよいかもしれない
• 自分は create-vuepress-site で最初に生成されたコンテンツをまるごとこっちにコピってはじめることにした

create-vuepress-site を使う場合

mkdir /tmp/test-of-create-vuepress-site
cd /tmp/test-of-create-vuepress-site
npx create-vuepress-site
cd docs
vuepress dev -p 3902 --open src

• 小さな構成のサンプルが生成される
• コンポーネントの組み込み方やカスタマイズ方法がわかりやすい
• packages.json が別になる

Error: Cannot find module 'vue-template-compiler' 対策

https://github.com/vuejs/vue-cli/issues/2109#issuecomment-1398625950

OK

npm i vue-template-compiler

NG

npm i -g vue-template-compiler

なぜかこのエラーが必ず出る。そしてなぜかグローバルに入れると解決しない。

Uncaught TypeError: AllHtmlEntities is not a constructor 対策

https://github.com/vuejs/vuepress/issues/2996

npm i -D html-entities@~1.4.0

他のパッケージの影響なのか html-entities が新しくなりすぎて動かなくなる場合があった。