yaml - Jekyllサイトをどのように作成しますか？

Question

基本的なJekyllサイトの作成方法を教えてください。私は特にファイル_config.ymlとYAMLフロントマターについて混乱しています。

score 15 · Accepted Answer

質問の言い回しがよくわかりませんが、やってみます。あなたは2つのことのうちの1つを指していると思います。構成ファイルまたは YAML フロントマターのいずれかです。いずれにしても、jekyll サイトを立ち上げて実行するための基本的な入門書については、以下を参照してください。コンテキストでの両方の使用法を示しています。

空のディレクトリに、次を作成します。

という名前の新しいディレクトリ_layouts。
という名前の新しいディレクトリ_posts。
という名前の新しいディレクトリ_site。
index.md次の内容で名前が付けられたファイル:
```
---
layout: default
---

# My Jekyll site

Welcome to my Jekyll site
```
(注: 2 行のダッシュで囲まれた「layout: default」は、YAML の Front Matter です。「default」を指定すると、jekyll は、以下にリストされている _layouts ディレクトリ内の「default.html」ファイルを使用することを意味します。)

_config.yml次のデフォルトの内容で名前が付けられたファイル:

safe:        false
auto:        false
server:      false
server_port: 4000
base-url:    /

source:      .
destination: ./_site
plugins:     ./_plugins

future:      true
lsi:         false
pygments:    false
markdown:    maruku
permalink:   date

maruku:
  use_tex:    false
  use_divs:   false
  png_engine: blahtex
  png_dir:    images/latex
  png_url:    /images/latex

rdiscount:
  extensions: []

kramdown:
  auto_ids: true,
  footnote_nr: 1
  entity_output: as_char
  toc_levels: 1..6
  use_coderay: false

  coderay:
    coderay_wrap: div
    coderay_line_numbers: inline
    coderay_line_numbers_start: 1
    coderay_tab_width: 4
    coderay_bold_every: 10
    coderay_css: style

この例では、さらに 2 つのファイルを作成する必要があります。

「_layouts」ディレクトリ内にdefault.html、次の名前のファイル:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>My Jekyll Site</title>
</head>
<body>

    <!-- This will be replaced with your content -->
    {{ content }}


</body>
</html>

「_posts」ディレクトリ内に2011-07-29-my-first-jekyll-post.md、次の名前のファイル:
```
---
layout: default
---

# My First Jekyll Post

The quick brown fox jumps over the lazy dog. 
```
(注: 繰り返しますが、2 行のダッシュで囲まれた「layout: default」は YAML フロントマターであり、「default.html」がテンプレートに使用されることを指定します。)

この時点で、ディレクトリ構造は次のようになります。

./_config.yml
./_layouts
./_posts
./_posts/2011-07-29-my-first-jekyll-post.md
./_site
./index.md

すべての設定が完了したら、コマンドラインから index.md ファイルがあるディレクトリに移動し、jekyll. 次のような簡単なレポートが表示されます。

Configuration from /some-path/_config.yml
Building site: . -> ./_site
Successfully generated site: . -> ./_site

2 つの出力ファイルが作成されます。

./_site/index.html
./_site/2011/07/29/my-first-jekyll-post.html

これらのファイルは、HTML に変換されて default.html ラッパーにドロップされた後の 2 つのマークダウンファイルに対応し、"{{ content }}" 文字列を置き換えます。

これで、基本から始めることができます。

yaml - Jekyllサイトをどのように作成しますか？

1 に答える 1

Related

Reference