请告诉我如何创建一个基本的 Jekyll 站点。我对文件 _config.yml 和 YAML 前端问题特别困惑。
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 }}”字符串之后的两个降价文件。
这应该让你开始学习基础知识。