2011-07-28 88 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

你是明星。 –