你如何创建一个Jekyll网站？

Question

你如何创建一个Jekyll网站？

Dee*_*ane 1 yaml jekyll

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

Answer 1

Ala*_*ith 15

我不太明白你的问题的措辞,但我会采取行动.我猜你指的是两件事之一.配置文件或YAML前端都很重要.无论哪一个,请参阅下面的基本入门,以获得jekyll网站的启动和运行.它显示了两者在上下文中的用法.

在空目录中,创建以下内容:

一个名为的新目录_layouts.
一个名为的新目录_posts.
一个名为的新目录_site.
以index.md下列内容命名的文件:
```
---
layout: default
---

# My Jekyll site

Welcome to my Jekyll site
```
Run Code Online (Sandbox Code Playgroud)
(注意:由两行破折号包围的"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

Run Code Online (Sandbox Code Playgroud)

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

在"_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>

Run Code Online (Sandbox Code Playgroud)

在"_posts"目录中,2011-07-29-my-first-jekyll-post.md使用以下命名的文件:
```
---
layout: default
---

# My First Jekyll Post

The quick brown fox jumps over the lazy dog. 
```
Run Code Online (Sandbox Code Playgroud)
(注意:再次,由两行破折号包围的"layout:default"是YAML Front Matter,并指定将"default.html"用于模板.)

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

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

Run Code Online (Sandbox Code Playgroud)

完成所有设置后,从命令行转到其中包含index.md文件的目录并运行jekyll.您应该看到一个快速报告,如:

Configuration from /some-path/_config.yml
Building site: . -> ./_site
Successfully generated site: . -> ./_site

Run Code Online (Sandbox Code Playgroud)

将创建两个输出文件:

./_site/index.html
./_site/2011/07/29/my-first-jekyll-post.html

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

这应该让你从基础开始.

归档时间：	15 年，1 月前
查看次数：	3245 次
最近记录：	10 年前