如何创建 Jekyll 网站？

Question

请告诉我如何创建一个基本的 Jekyll 网站。我对文件 _config.yml 和 YAML 前面的内容特别困惑。

Answer 1

我不太明白你问题的措辞，但我会尝试一下。我猜你指的是两件事之一。配置文件或 YAML 前面的内容。无论是哪一个，请参阅下面的基本入门指南，以获取并运行 jekyll 站点。它显示了两者在上下文中的用法。

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

1. 名为 _layouts 的新目录。

2. 名为 _posts 的新目录。

3. 名为 _site 的新目录。

4. 名为 index.md 的文件，其中包含以下内容：

   <前><代码>---
   布局：默认
   ---

   # 我的 Jekyll 网站

   欢迎来到我的 Jekyll 网站

   （注意：两行破折号包围的“layout:default”是 YAML Front Matter。指定“default”意味着 jekyll 将使用下面列出的 _layouts 目录中的“default.html”文件。）< /p>

5. 名为 _config.yml 的文件，其中包含以下默认内容：

   安全：假
   自动：假
   服务器：假
   服务器端口：4000
   基本网址：/
   
   来源： 。
   目的地：./_site
   插件：./_plugins
   
   未来：真实
   大规模集成电路：假
   图像：假
   降价：maruku
   永久链接： 日期
   
   丸久：
     use_tex：假
     use_div：假
     png_engine: blahtex
     png_dir: 图像/乳胶
     png_url：/图像/乳胶
   
   折扣：
     扩展名：[]
   
   克拉姆当：
     自动ID：真，
     脚注编号：1
     实体输出：as_char
     目录级别：1..6
     use_coderay：假
   
     码锐：
       coderay_wrap：div
       coderay_line_numbers：内联
       coderay_line_numbers_start: 1
       coderay_tab_width: 4
       coderay_bold_every：10
       coderay_css：样式
   

---

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

1. 在“_layouts”内目录中，一个名为 default.html 的文件，其中包含以下内容：

   
   
   <头>
       <元字符集=“utf-8”>
       <标题>我的杰基尔网站
   
   <正文>
   
       
       {{ 内容 }}
   
   
   
   
   

2. 在“_posts”目录中，有一个名为 2011- 的文件07-29-my-first-jekyll-post.md 包含以下内容：

   <前><代码>---
   布局：默认
   ---

   # 我的第一篇杰基尔帖子

   敏捷的棕色狐狸跳过了那只懒狗。

   （注意：再一次，两行破折号包围的“layout:default”是 YAML Front Matter，并指定“default.html”将用于模板。）

---

此时目录结构应如下所示：

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

完成所有设置后，从命令行转到具有索引的目录。 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

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

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