你如何创建一个 Jekyll 网站？答案

【问题标题】：How do you create a Jekyll site?你如何创建一个 Jekyll 网站？
【发布时间】：2011-07-28 09:13:26
【问题描述】：

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

【问题讨论】：

我不明白你在问什么。 YAML 只是一种在文本文件中编码简单数据结构的方法。 Jekyll 使用它进行配置；你想做什么？

标签： yaml jekyll

【解决方案1】：

我不太明白你问题的措辞，但我会试一试。我猜你指的是两件事之一。配置文件或 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 }}”字符串之后的两个降价文件。

这应该让您开始了解基础知识。

【讨论】：

config.yml 必须使用以下划线开头：_config.yml。测试服务器，可以使用jekyll --server
谢谢，@FèlixGalindoAllué - 我已经更正了我错过下划线的错字。
你是明星。