freeCodeCamp/docs/i18n/Japanese/how-to-work-on-the-docs-the...

2.0 KiB

ドキュメントテーマの使い方

[!NOTE] ドキュメントサイトのコンテンツを操作するために何も設定する必要はありません。

貢献するガイドラインに取り組むには、ここ ドキュメント ディレクトリ にあるファイルを編集または追加することができます。 変更がマージされると、ドキュメントサイトで自動的に利用可能になります。

ドキュメントウェブサイトの構造

サイトは docsifyを使用して生成され、GitHub ページを使用して提供されます。

通常、サイトの設定を変更したり、サイトをローカルにビルドしたりする必要はありません。 興味がある場合は、以下のように動作します。

  • The homepage source for this site is available in docs/index.html.
  • docsify と GitHub Pages を使用して、このファイルをSPAとして提供します。
  • docsify スクリプトは、 docs ディレクトリ内の markdown ファイルの内容を必要に応じて生成します。
  • ホームページは _coverpage.md から生成される。
  • サイドバーナビゲーションは _sidebar.md から生成されます。

ローカルでドキュメントサイトを提供しています

freeCodeCampをクローン:

git clone https://github.com/freeCodeCamp/freeCodeCamp.git
serve docs

docsify をインストールする

npm install -g docsify

/docs ディレクトリを開く

docsify serve docs

あるいは、freeCodeCampをローカルにインストールした場合(ローカルのセットアップガイドを参照してください)。 CLI を開発ツールとバンドルして、リポジトリのルートから npm run docs:serve を実行できます。