誰でも簡単にドキュメントサイトを無料で公開する方法

Docusaurus は一般的に使用されている静的サイトジェネレータです。react の上に構築されており、あらゆる種類のサイト（個人サイト、製品、ブログ、マーケティングのランディングページなど）を作成するために使用できます。

Cloudflare Pages は、フロントエンド開発者がウェブサイトを共同開発・デプロイするための JAMstack プラットフォームです。

ドキュメントを作成

• Docusaurus を用いたドキュメントの作成は数行のコマンドで完了します。 https://docusaurus.io/docs/installation#scaffold-project-website

npx create-docusaurus@latest my-website classic --typescript

※my-website の部分はお好きな名前に変更してください。 （例: npx create-docusaurus@latest okane-vip classic —typescript

作成が終わったら、cd my-website で、先ほど作成したアプリのディレクトリに移します。

そして、start コマンドを実行します。

npm start

ブラウザで開発サイト (http://localhost:3000/) が表示されます。

さて、あなたのドキュソーサイトの準備ができましたので、cloudflare ページで展開しましょう。

docusaurus.config.js の url フィールドを https://.pages.dev またはカスタムドメインに変更します。

Vercel や netlify と異なり、Cloudflare pages はまだ cli デプロイメントをサポートしていません（いずれはサポートされるかもしれません）。

そのため、すべてのコードを github にプッシュする必要があります。

git init
git add -A
git commit -m "initial commit"
git branch -M main
git remote add origin https://github.com/myrepo/myDocs.git
git push -u origin main

これらのコマンドを実行した後、github を確認すると、そこにコードがあります。

cloudflare pages のダッシュボードに行き、まだの場合は Signup for pages に登録してください。

アプリを作成し、github リポジトリを選択します。

フレームワークのプリセットとして、Create React App を選択します。

環境変数 NODE_VERSION を 16.14.2 という値で作成します。

Docusaurus は node v14 以上のバージョンを必要とし、16.13.2 は LTS(Long time support) Version of Node.js です。

デプロイをクリックすると、5 分以内にアプリが完成します :)

https://docusaurus-cf-pages.pages.dev/

Add a Custom Domain To Your App
Redirecting www to apex domain

お問い合わせ

• もしうまくいかなかったら こちら までご連絡下さい。

参考リンク

• Docusaurus Documentation
• Docusaurus Discord Server
• Cloudflare Pages Documentation
• Cloudflare Developers Discord Server