文檔系統 - Hugo

Share on:

曾幾何時, 寫過前端又懂後端的我們, 都有種架設自己網站的美夢, 雖說這東西是不是會有人關心並不是重點, 但有自己純手工打造的東西就是"爽". 只是要全部自幹起來, 難免花些時間, 好在有類似 Hugo 這種 SSG, 讓廣大的 IT 宅們得以實現這可悲的美夢!!... 本文使用 BeautifulHugo Theme 來作基底

Prerequests

  • 安裝 hugo
  • 安裝 git

Scripts

 1### 建立 hugo 專案
 2hugo new site blog
 3
 4### 建立 theme
 5cd blog
 6git init
 7git submodule add https://github.com/halogenica/beautifulhugo.git themes/beautifulhugo
 8
 9### 製作組態 (詳 config.toml 段落)
10cp themes/beautifulhugo/exampleSite/config.toml .
11
12### 產生靜態檔案
13hugo
14
15### 本地開發測試
16hugo server -D      # -D 可以把 草稿文章也列出來 (draft: true)

Structure

 1/archetypes/        #
 2/content/           # 文章放裡面
 3    /post/              # 文章們放裡面
 4        /*.md               # 文章們
 5    _index.md               # 首頁置頂的公告
 6/data/              #
 7/layouts/           #
 8/resources/         #
 9/static/            # 靜態文件放置區
10    /img                # 放自己要 po 文連結的圖片
11    /favicon.ico        # favicon
12/themes/            # hugo theme 放裏頭
13    /beautifulhugo/     # 此文選擇的風格
14        /archetypes/        #
15        /data/              #
16        /exampleSite/       #
17            /post/              #
18            _index.md           #
19            /layouts/           #
20            /static/            #
21            config.toml         # 把這個設定主檔範本複製出去改
22        /i18n/              # 多語系翻譯檔
23            /en.yaml            # i18n-英文
24            /zh-TW.yaml         # i18n-繁體中文, 要使用的話「DefaultContentLanguage = "zh-tw"」
25        /images/            #
26        /layouts/           #
27        /static/            #
28        .gitattributes      #
29        .gitignore          #
30        LICENSE             #
31        README.md           #
32        theme.toml          #
33.gitignore          #
34.gitmodules         #
35config.toml         # 從 themes 複製出來要修改的主要設定檔

config.toml

 1
 2### Navigator
 3[[menu.main]]
 4    name = "Archives"
 5    weight = 1
 6    url = "/"
 7
 8[[menu.main]]
 9    name = "Tags"
10    weight = 2
11    url = "/tags"
12
13
14### 最底下的連結
15[Author]
16    name = "Tony Chou"
17    email = "mailto:cool21540125@gmail.com"
18    facebook = "profile.php?id=100000009066426&ref=bookmarks"
19    stackoverflow = "users/7751061/tony-chou"
20    github = "cool21540125"
21    gitlab = "cool21540125"
22
23[Params]
24    useHLJS = false     # Highlight.js 程式碼區塊高量

Additional

花時間聊解一番之後, 才發現世界上有種叫做 WordPress 的東西, 比 Hugo 還要接近一般人...

原來, Hugo 也是邊緣人的玩具罷了

Reference

comments powered by Disqus