请告诉我如何创建一个基本的Jekyll网站。我对文件_config.yml和YAML前端问题特别感到困惑。
答案 0 :(得分:15)
我不太明白你的问题的措辞,但我会采取行动。我猜你指的是两件事之一。配置文件或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
将创建两个输出文件:
这些文件对应于转换为HTML后的两个markdown文件,并放入default.html包装器中,替换“{{content}}”字符串。
这应该让你从基础开始。