歡迎光臨
每天分享高質量文章

用 Hugo 30 分鐘搭建靜態部落格 | Linux 中國

瞭解 Hugo 如何使構建網站變得有趣。
— Marek Czernek


致謝
編譯自 | 
https://opensource.com/article/18/3/start-blog-30-minutes-hugo
 
 作者 | Marek Czernek
 譯者 | jrg (jrglinux) ??共計翻譯:3.0 篇 貢獻時間:308 天

瞭解 Hugo 如何使構建網站變得有趣。

你是不是強烈地想搭建部落格來將自己對軟體框架等的探索學習成果分享呢?你是不是面對缺乏指導檔案而一團糟的專案就有一種想去改變它的衝動呢?或者換個角度,你是不是十分期待能建立一個屬於自己的個人部落格網站呢?

很多人在想搭建部落格之前都有一些嚴重的遲疑顧慮:感覺自己缺乏內容管理系統(CMS)的相關知識,更缺乏時間去學習這些知識。現在,如果我說不用花費大把的時間去學習 CMS 系統、學習如何建立一個靜態網站、更不用操心如何去強化網站以防止它受到駭客攻擊的問題,你就可以在 30 分鐘之內建立一個部落格?你信不信?利用 Hugo 工具,就可以實現這一切。

Hugo 是一個基於 Go 語言開發的靜態站點生成工具。也許你會問,為什麼選擇它?

◈ 無需資料庫、無需需要各種許可權的外掛、無需跑在伺服器上的底層平臺,更沒有額外的安全問題。
◈ 都是靜態站點,因此擁有輕量級、快速響應的服務效能。此外,所有的網頁都是在部署的時候生成,所以伺服器負載很小。
◈ 極易操作的版本控制。一些 CMS 平臺使用它們自己的版本控制軟體(VCS)或者在網頁上整合 Git 工具。而 Hugo,所有的源檔案都可以用你所選的 VCS 軟體來管理。

0-5 分鐘:下載 Hugo,生成一個網站

直白的說,Hugo 使得寫一個網站又一次變得有趣起來。讓我們來個 30 分鐘計時,搭建一個網站。

為了簡化 Hugo 安裝流程,這裡直接使用 Hugo 可執行安裝檔案。

1. 下載和你作業系統匹配的 Hugo 版本[1]
2. 壓縮包解壓到指定路徑,例如 windows 系統的 C:\hugo_dir 或者 Linux 系統的 ~/hugo_dir 目錄;下文中的變數 ${HUGO_HOME} 所指的路徑就是這個安裝目錄;
3. 開啟命令列終端,進入安裝目錄:cd ${HUGO_HOME}
4.

確認 Hugo 已經啟動:

◈ Unix 系統:${HUGO_HOME}/[hugo version]
◈ Windows 系統:${HUGO_HOME}\[hugo.exe version],例如:cmd 命令列中輸入:c:\hugo_dir\hugo version

為了書寫上的簡化,下文中的 hugo 就是指 hugo 可執行檔案所在的路徑(包括可執行檔案),例如命令 hugo version 就是指命令 c:\hugo_dir\hugo version 。(LCTT 譯註:可以把 hugo 可執行檔案所在的路徑新增到系統環境變數下,這樣就可以直接在終端中輸入 hugo version

如果命令 hugo version 報錯,你可能下載了錯誤的版本。當然,有很多種方法安裝 Hugo,更多詳細資訊請查閱 官方檔案[2]。最穩妥的方法就是把 Hugo 可執行檔案放在某個路徑下,然後執行的時候帶上路徑名

5.

建立一個新的站點來作為你的部落格,輸入命令:hugo new site awesome-blog

6.

進入新建立的路徑下: cd awesome-blog

恭喜你!你已經建立了自己的新部落格。

5-10 分鐘:為部落格設定主題

Hugo 中你可以自己構建部落格的主題或者使用網上已經有的一些主題。這裡選擇 Kiera[3] 主題,因為它簡潔漂亮。按以下步驟來安裝該主題:

1. 進入主題所在目錄:cd themes
2. 克隆主題:git clone https://github.com/avianto/hugo-kiera kiera。如果你沒有安裝 Git 工具:

◈ 從 Github[4] 上下載 hugo 的 .zip 格式的檔案;
◈ 解壓該 .zip 檔案到你的部落格主題 theme 路徑;
◈ 重新命名 hugo-kiera-master 為 kiera
3. 傳回部落格主路徑:cd awesome-blog
4.

啟用主題;通常來說,主題(包括 Kiera)都自帶檔案夾 exampleSite,裡面存放了內容配置的示例檔案。啟用 Kiera 主題需要複製它提供的 config.toml 到你的部落格下:

◈ Unix 系統:cp themes/kiera/exampleSite/config.toml .
◈ Windows 系統:copy themes\kiera\exampleSite\config.toml .
◈ 選擇 Yes 來改寫原有的 config.toml
5.

( 可選操作 )你可以選擇視覺化的方式啟動伺服器來驗證主題是否生效:hugo server -D 然後在瀏覽器中輸入 http://localhost:1313。可用透過在終端中輸入 Crtl+C 來停止伺服器執行。現在你的部落格還是空的,但這也給你留了寫作的空間。它看起來如下所示:

你已經成功的給部落格設定了主題!你可以在官方 Hugo 主題[3] 網站上找到上百種漂亮的主題供你使用。

10-20 分鐘:給部落格新增內容

對於碗來說,它是空的時候用處最大,可以用來盛放東西;但對於部落格來說不是這樣,空部落格幾乎毫無用處。在這一步,你將會給部落格新增內容。Hugo 和 Kiera 主題都為這個工作提供了方便性。按以下步驟來進行你的第一次提交:

1. archetypes 將會是你的內容模板。
2.

新增主題中的 archtypes 至你的部落格:

◈ Unix 系統: cp themes/kiera/archetypes/* archetypes/
◈ Windows 系統:copy themes\kiera\archetypes\* archetypes\
◈ 選擇 Yes 來改寫原來的 default.md 內容架構型別
3.

建立部落格 posts 目錄:

◈ Unix 系統: mkdir content/posts
◈ Windows 系統: mkdir content\posts
4.

利用 Hugo 生成你的 post:

◈ Unix 系統:hugo nes posts/first-post.md;
◈ Windows 系統:hugo new posts\first-post.md;
5.

在文字編輯器中開啟這個新建的 post 檔案:

◈ Unix 系統:gedit content/posts/first-post.md
◈ Windows 系統:notepadd content\posts\first-post.md

此刻,你可以瘋狂起來了。註意到你的提交檔案中包括兩個部分。第一部分是以 +++ 符號分隔開的。它包括了提交檔案的主要資料,例如名稱、時間等。在 Hugo 中,這叫做字首。在字首之後,才是正文。下麵編輯第一個提交檔案內容:

  1. +++

  2. title = "First Post"

  3. date = 2018-03-03T13:23:10+01:00

  4. draft = false

  5. tags = ["Getting started"]

  6. categories = []

  7. +++

  8. Hello Hugo world! No more excuses for having no blog or documentation now!

現在你要做的就是啟動你的伺服器:hugo server -D;然後開啟瀏覽器,輸入 http://localhost:1313/

20-30 分鐘:調整網站

前面的工作很完美,但還有一些問題需要解決。例如,簡單地命名你的站點:

1. 終端中按下 Ctrl+C 以停止伺服器。
2. 開啟 config.toml,編輯部落格的名稱,版權,你的姓名,社交網站等等。

當你再次啟動伺服器後,你會發現部落格私人訂製味道更濃了。不過,還少一個重要的基礎內容:主選單。快速的解決這個問題。傳回 config.toml 檔案,在末尾插入如下一段:

  1. [[menu.main]]

  2.    name = "Home" #Name in the navigation bar

  3.    weight = 10 #The larger the weight, the more on the right this item will be

  4.    url = "/" #URL address

  5. [[menu.main]]

  6.    name = "Posts"

  7.    weight = 20

  8.    url = "/posts/"

上面這段程式碼添加了 Home 和 Posts 到主選單中。你還需要一個 About 頁面。這次是建立一個 .md 檔案,而不是編輯 config.toml 檔案:

1. 建立 about.md 檔案:hugo new about.md 。註意它是 about.md,不是 posts/about.md。該頁面不是部落格提交內容,所以你不想它顯示到部落格內容提交當中吧。
2. 用文字編輯器開啟該檔案,輸入如下一段:
  1. +++

  2. title = "About"

  3. date = 2018-03-03T13:50:49+01:00

  4. menu = "main" #Display this page on the nav menu

  5. weight = "30" #Right-most nav item

  6. meta = "false" #Do not display tags or categories

  7. +++

  8. > Waves are the practice of the water. Shunryu Suzuki

當你啟動你的伺服器並輸入:http://localhost:1313/,你將會看到你的部落格。(訪問我 Gihub 主頁上的 例子[5] )如果你想讓文章的選單欄和 Github 相似,給 themes/kiera/static/css/styles.css 打上這個 補丁[6]


via: https://opensource.com/article/18/3/start-blog-30-minutes-hugo

作者:Marek Czernek[8] 
譯者:jrg 
校對:wxy

本文由 LCTT 原創編譯,Linux中國 榮譽推出

贊(0)

分享創造快樂

© 2022 知識星球   網站地圖