2.2 KiB
2.2 KiB
ドキュメントテーマの作業方法
[!NOTE] ドキュメントサイトのコンテンツを変更する作業に必要な設定は何もありません。
貢献ガイドラインを編集するには、
docs
ディレクトリ のファイルを編集または追加します。 変更がマージされると、ドキュメントサイトで自動的に利用可能になります。
ドキュメント Web サイトの構造
サイトは docsify
を使用して生成され、GitHub ページを使用して提供されます。
通常、サイトの設定を変更したり、サイトをローカルにビルドしたりする必要はありません。 以下のように動作します。
- このサイト向けのホームページのソースは、
docs/index.html
にあります。 docsify
と GitHub Pages を使用して、このファイルを SPA として提供します。docsify
スクリプトは、docs
ディレクトリ内のmarkdown
ファイルの内容を必要に応じて生成します。- ホームページは
_coverpage.md
から生成されます。 - サイドバーナビゲーションは
_sidebar.md
から生成されます。
ローカルでドキュメントサイトを提供する
freeCodeCamp をクローンする
git clone https://github.com/freeCodeCamp/freeCodeCamp.git
docsify serve docs
docsify
をインストールする
npm install -g docsify
/docs
ディレクトリを開く
docsify serve docs
Alternatively, if you have installed freeCodeCamp locally (see the local setup guide), we bundled the CLI with the development tools so you can run any of the below commands as needed from the root of the repo:
ドキュメントサイトのみを提供して起動する
npm run docs:serve
freeCodeCamp と一緒にドキュメントサイトをローカルで提供する
npm run develop
ドキュメンテーションサイトは http://localhost:3200 で利用できます。