Question

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

Answer 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”文件。）< / p>

名为_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

将创建两个输出文件：

./_站点/ index.html中
./_站点/ 2011/07 /第29 /我的先化身-post.html

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

这应该让你从基础开始。

你如何创建一个Jekyll网站？

1 个答案: