1

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

4

1 回答 1

15

我不太明白你的问题的措辞,但我会试一试。我猜你指的是两件事之一。配置文件或 YAML 前端问题。无论哪种方式,请参阅下面的基本入门知识,以启动和运行 jekyll 站点。它显示了两者在上下文中的用法。

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

  1. 一个名为 的新目录_layouts

  2. 一个名为 的新目录_posts

  3. 一个名为 的新目录_site

  4. index.md具有以下内容的文件:

    ---
    layout: default
    ---
    
    # My Jekyll site
    
    Welcome to my Jekyll site
    

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

  5. _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
    

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

  1. 在“_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>
    
  2. 在“_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 }}”字符串之后的两个降价文件。

这应该让你开始学习基础知识。

于 2011-07-30T00:03:48.297 回答