天天看點

hugo-最好用的靜态網站生成器快速開始

hugo是由go語言實作的靜态網站生成器。簡單、易用、高效、易擴充、快速部署。

到 hugo releases 下載下傳對應的作業系統版本的hugo二進制檔案(hugo或者hugo.exe)

mac下直接使用 <code>homebrew</code> 安裝:

源碼編譯安裝,首先安裝好依賴的工具:

git

mercurial

go 1.3+ (go 1.4+ on windows)

設定好 <code>gopath</code> 環境變量,擷取源碼并編譯:

源碼會下載下傳到 <code>$gopath/src</code> 目錄,二進制在 <code>$gopath/bin/</code>

如果需要更新所有hugo的依賴庫,增加 <code>-u</code> 參數:

使用hugo快速生成站點,比如希望生成到 <code>/path/to/site</code> 路徑:

這樣就在 <code>/path/to/site</code> 目錄裡生成了初始站點,進去目錄:

站點目錄結構:

建立一個 <code>about</code> 頁面:

<code>about.md</code> 自動生成到了 <code>content/about.md</code> ,打開 <code>about.md</code> 看下:

内容是 <code>markdown</code> 格式的,<code>+++</code> 之間的内容是 toml 格式的,根據你的喜好,你可以換成 yaml 格式(使用 <code>---</code> 标記)或者 json 格式。

建立第一篇文章,放到 <code>post</code> 目錄,友善之後生成聚合頁面。

打開編輯 <code>post/first.md</code> :

到 皮膚清單 挑選一個心儀的皮膚,比如你覺得 <code>hyde</code> 皮膚不錯,找到相關的 <code>github</code> 位址,建立目錄 <code>themes</code>,在 <code>themes</code> 目錄裡把皮膚 <code>git clone</code> 下來:

在你的站點根目錄執行 <code>hugo</code> 指令進行調試:

使用 <code>--watch</code> 參數可以在修改文章内容時讓浏覽器自動重新整理。

浏覽器裡打開: <code>http://localhost:1313</code>

假設你需要部署在 <code>github pages</code> 上,首先在github上建立一個repository,命名為:<code>coderzh.github.io</code> (coderzh替換為你的github使用者名)。

在站點根目錄執行 <code>hugo</code> 指令生成最終頁面:

如果一切順利,所有靜态頁面都會生成到 <code>public</code> 目錄,将pubilc目錄裡所有檔案 <code>push</code> 到剛建立的repository的 <code>master</code> 分支。

浏覽器裡通路:<code>http://coderzh.github.io/</code>

這個網站 免費教程網 就是我使用hugo生成的。 這個網站模闆是我自己寫的(樣式部分除外),大家如果有關于hugo的以及go 模闆相關的問題可以問我。

繼續閱讀