一步一步教你用hugo搭建博客

Hugo 是一個輕量級的靜態網站生成工具，是基于GO語言的模版技術開發而成，因為最近在學習go，就花了時間研究了下，一研究就喜歡上了。 再加上最新wordpress版本有嚴重的問題，在文章發表后或者再次編輯時，編輯框會丟失所有的格式，這個讓使用Markdown的人無法接受。

安裝hugo

Hugo官方主頁：HUGO hugo托管在github上，我們可以直接二進制安裝也可以源碼安裝。 這里我們演示源碼安裝。

1. 源碼安裝 在go里面我們可以直接通過get安裝：
   go get -u -v github.com/spf13/hugo
   或者直接git下載
   git clone https://github.com/spf13/hugo.git

   </li>

2. 編譯 go build -o hugo main.go
   mv hugo $GOPATH/bin
   終端查看是否成功，mac下可能出現路徑沒找到的問題，要重新開終端
   $ hugo version
   Hugo Static Site Generator v0.16-DEV BuildDate: 2015-12-14T16:07:24+08:00

   </li> </ol>

   生成靜態站點

   1. 創建網站 我們先創建一個空網站.

      $ hugo new site localhost
      $ tree
      .
      ├── archetypes
      ├── config.toml
      ├── content
      ├── data
      ├── layouts
      ├── public
      ├── static
      └── themes  

      默認情況下這些目錄都是空的，直接運行的話會有ERROR提示
      

      ERROR: 2015/12/14   =============================================================
      ERROR: 2015/12/14 Your rendered home page is blank: /index.html is zero-length
      ERROR: 2015/12/14  * Did you specify a theme on the command-line or in your
      ERROR: 2015/12/14    ?config.toml? file?  (Current theme: ??)
      ERROR: 2015/12/14  * For more debugging information, run ?hugo -v?
      ERROR: 2015/12/14 =============================================================

      看提示說是沒有指定theme導致，我們需要下載一個theme。 </li>

   2. 安裝theme 我們可以從hugo的網站下載自己喜歡的theme
      $ cd themes $ git clone https://github.com/spf13/hyde.git

      </li>

   3. 測試框架 安裝完theme后，我們體驗下效果，使用 hugo server就可以起一個http server，默認監聽在1313端口，如果沒有在config中配置theme，就要指定theme。

      $ hugo server -t hyde
      0 draft content
      0 future content
      0 pages created
      0 paginator pages created
      0 tags created
      0 topics created
      in 24 ms
      Watching for changes in /Users/alex/run/localhost/{data,content,layouts,static,themes}
      Serving pages from memory
      Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
      Press Ctrl+C to stop

      </li>

   4. 發表文章 hugo里面寫文章其實就是寫markdown文檔了。寫好文檔，hugo會給你自動轉成html靜態文件。我們通過Hugo創建一個md文檔。
      $ hugo new first.md
      /Users/alex/run/localhost/content/first.md created
      運行時在網站根目錄下運行，創建的文件默認創建在content目錄下。

      +++
      date = ?2015-12-15T22:35:22+08:00?
      draft = true
      title = ?first?
                  
      
                      +++
                  
      

      我們從內容看默認創建的是草稿類型，需要將draft改為true才能看到頁面。正常情況下我們會通過Mou或者github編輯文檔，只要文件頭符合hugo的規范就可以。
      </li> </ol>

      調試部署

      1. 調試 在開發的過程中，我們需要不斷的修改驗證，所以hugo支持LiveReload功能，用戶修改后，可以實時看到效果。執行hugo server命令時加上-w選項，hugo就可以自動檢測本地站點文件的變更。
         $ hugo server －w -t hyde
         注意：在使用server命令時，hugo并沒有在public目錄下產生相應的靜態頁面。

         </li>

      2. 部署 部署時，我們需要生成靜態頁面文件，然后就可以隨便部署在自己的空間上了。轉化時，一個hugo命令就搞定:

         $ hugo -t hyde
         0 draft content
         0 future content
         1 pages created
         0 paginator pages created
         0 topics created
         0 tags created
         in 38 ms

         我們看到有一個頁面生成了，默認在public目錄，實際一起生成的還有其他文件:

         $ ls
         404.html                first
         apple-touch-icon-144-precomposed.png    index.html
         css                 index.xml
         favicon.png             sitemap.xml

         把這些文件放到你的空間，你就可以看見你的頁面和theme了。 </li> </ol>

         到這里，我們已經有了一個基本的能創建文章并且顯示的網站了。

         have fun！

         </div>
         來自：http://www.goodmemory.cc/一步一步教你用hugo搭建博客/