2011-07-28 87 views
1

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

+0

我不明白你在问什么。 YAML只是在文本文件中编码简单数据结构的一种手段。 Jekyll将其用于配置;你想做什么? –

回答

14

我不太了解你的问题的措辞,但我会拍摄。我猜你是指两件事中的一件。无论是配置文件还是YAML前端。无论哪一个,请参阅下面的基本入门知识,让jekyll站点正常运行。它显示了在上下文中的用法。

在一个空目录,创建以下文件:

  1. 一个新的目录中名为_layouts

  2. 一个名为_posts的新目录。

  3. 一个名为_site的新目录。

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

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

    (注:“布局:默认”用虚线的两个线包围是YAML前页指定的“默认”意味着化身将使用在_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. 
    

    (注:再次,“布局:默认”用虚线的两个线包围是YAML前页,并且指定“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负一哲基尔post.html

这些文件对应于两个降价文件转化为HTML后投进default.html和包装更换“{{内容}}”字符串。

这应该让你的基础开始。

+1

必须使用初始下划线来命名config.yml:'_config.yml'。要测试服务器,您可以使用'jekyll --server' –

+0

谢谢,@FlielixGalindoAllué - 我已更正了错过了下划线的错字。 –

+0

你是明星。 –