チュートリアル

Docsとは対照的に、チュートリアルではJekyllの様々なトピックやシナリオをカバーしたより詳細な説明を行います。チュートリアルには以下の内容が含まれています。

  • 特定のシナリオや課題のstep-by-stepプロセス。
  • サンプルデータを利用したチュートリアル。サンプルデータの入力と結果。
  • Jekyllの長所と短所の説明。
  • Jekyllサイトの全ての機能を開発するための端から端までの解説。
  • ドキュメンテーションを横断した様々なテクニックの解説。

簡単に言うと、チュートリアルはドキュメンテーションの情報の要約ではありません。ユーザーの最初から最後のプロセスを辿るものです。

注:チュートリアルのセクションは新しく、まだ数は多くありません。作成を助けるために、あなたのチュートリアルを追加することもできます。

いくつかのテクニックは、サポートツールやスクリプトサービス、他のJekyllサイトのハックを通じたガイドの場合もあります。Jekyllを使った外部サービスに関することも、気軽に追加してください。ただし、チュートリアルに紹介されているサードパーティーツールを、Jekyllが推薦することはありません。

チュートリアルへの貢献の仕方

チュートリアルへの貢献を歓迎します。あなたのチュートリアルを追加するには、

  1. jekyll/jekyll project Github repoの右上のForkボタンをクリックして、JekyllプロジェクトをForkします。
  2. _tutorialsコレクションにあなたのチュートリアルを追加します。
  3. 他のチュートリアルと同様のfront matterを用意してください。
  4. _data/tutorials.ymlにあなたのチュートリアルのファイル名を追加してください。これであなたのチュートリアルをチュートリアルのサイドバーに表示します。
  5. 通常のgitのワークフローに従い、pullリクエストを送信してください。

pullリクエストが送信されると、Jekyllドキュメンテーションチームがレビューを行い、mergeするか編集の提案を行います。

Back