yaml - 你如何创建一个 Jekyll 网站？

Question

请告诉我如何创建一个基本的 Jekyll 站点。我对文件 _config.yml 和 YAML 前端问题特别困惑。

score 15 · Accepted Answer

我不太明白你的问题的措辞，但我会试一试。我猜你指的是两件事之一。配置文件或 YAML 前端问题。无论哪种方式，请参阅下面的基本入门知识，以启动和运行 jekyll 站点。它显示了两者在上下文中的用法。

在一个空目录中，创建以下内容：

一个名为的新目录_layouts。
一个名为的新目录_posts。
一个名为的新目录_site。
index.md具有以下内容的文件：
```
---
layout: default
---

# My Jekyll site

Welcome to my Jekyll site
```
（注意：两行破折号包围的“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

您还需要为示例创建两个文件，

在“_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. 
```
（注意：再一次，由两行破折号包围的“layout：default”是 YAML Front Matter，并指定“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

将创建两个输出文件：

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

这些文件对应于转换为 HTML 并放入 default.html 包装器替换“{{ content }}”字符串之后的两个降价文件。

这应该让你开始学习基础知识。

yaml - 你如何创建一个 Jekyll 网站？

1 回答 1

Related