最も単純なジキル
GHページの最小限のジキルベースのサイト、テーマのあるコンテンツの1ページに縮小されました
プレビュー
について
これはテンプレートとライブデモプロジェクトです。 GHページでJekyllサイトを取得するためにセットアップする必要がほとんどないことを示しています。
- index.md
- ホームページの場合 - この場合の唯一のページ。
- このページを除外すると、
README.mdホームページとして使用されます。
- _config.yml
- レイアウトとスタイリングを処理するテーマを設定します。
- Jekyll SiteMapプラグインを有効にする - Gemfileで有効にするだけでは十分ではありません。オプションのFrontMatterのように、他のプラグインがあなたのために有効になることに注意してください。
-
baseurl 、 title 、 descriptionなどの他の標準値は、構成から除外されています。 GHページに構築するとき、これらはGHページジェムによって推測されます。
- gemfile
- これは実際にはGHページでは使用されていませんが、Bundlerを使用してJekyllテーマをローカルにインストールすることができます。
- GHページのすべての宝石を一致させる場合は、単一のgem
github-pagesを使用します(インストールするのは重い場合があります)。 - サイトをローカルに実行する必要がない場合は、このファイルを削除します。
投稿、宝石、レイアウトなどを備えたマルチページサイトのより本格的な例が必要な場合は、Jekyll-Blog-Demoリポジトリをチェックアウトします。これは、テンプレートおよびデモサイトとしても使用できます。
このプロジェクトの使用方法
設定
- [このテンプレートを使用]をクリックして、独自のアカウントに新しいリポジトリを作成します。名前を
simplest-jekyllとして残すことができます。 - リポジトリの設定でgithubページを有効にします。
masterブランチと/パスオプションから提供することを選択します。 - 展開がいつ完了したかを確認するには、リポジトリの環境タブを確認してください。
- [展開の表示]をクリックして、ライブサイトを表示します。例:https://michaelcurrin.github.io/simplest-jekyll/
/simplest-jekyll/index.htmlはすぐに利用できることに注意してくださいが、Githubページが/simplest-jekyll/作成するまで数分かかります。
カスタマイズ
- 独自の詳細を使用して、
README.md更新してください。これは実際には展開されたサイトでは使用されていませんが、ローカルではGitHubで表示されます。 - テーマ
- 別のテーマが必要な場合は、_config.ymlでテーマを編集します。
- また、リポジトリ設定のgithubページセクションを使用して、視覚的にプレビューすることもできます。
- 注Githubページでサポートされているテーマのみがカバーされています(約10)ですが、構成でremote_themeフィールドを使用すると、より多くのテーマを参照できます。
- ローカルでインストールして実行するには、Gemfileが構成で使用されているテーマをカバーすることを確認する必要があります。
- ほとんどのJekyllサイトと同様に、index.mdはホームページとして使用されます。
- 上部に前部の問題があるため、液体が適用されます。
- HTMLまたはMarkDownとして、独自のコンテンツを使用して
index.mdファイルを編集します。 - プレーンHTMLのみが必要な場合は、
index.htmlに名前を変更できます。 - 上部のフロントマタンを削除して、液体のフォーマットとテーマを削除できます。
- 必要に応じて、ルートにページを追加し、ヘッダーまたはヘッドやnavbarなどの一般的なHTMLを
_includesフォルダーまたは_layoutsフォルダーに分割します(どちらもこのプロジェクトの範囲でカバーされていませんが、Jekyllプロジェクトには一般的です)。 - 詳細については、Jekyllサイトのドキュメントとチュートリアルを参照してください。
- オプションでジキルをローカルに実行します:
- RubyとBundlerをインストールします。
- Project Gems -Jekyll and the Theme Gemをインストールします。
- Jekyll Devサーバーを実行します。
- より詳細な手順については、Jekyll Blog Demoのドキュメントを参照してください。これらのコマンドに一致するために、
Makefileも追加する必要があります。
関連プロジェクト
- -JekyllCliで生成されたデフォルトのブログ。テーマ、コンテンツ、スタイルのセットアップ、宝石、およびメイクファイルを使用します。
- -Jekyll 4を使用して、テーマ、GitHubアクション、およびGitHubページを使用します。
- - テーマを備えた最小限のJekyllサイトですが、Gemfileはありません。
ライセンス
@michaelcurrinによってMITの下でリリースされました。