Hugo 游樂(lè)場(chǎng)內(nèi)容初始化示例詳解
正文
使用Hugo構(gòu)建站點(diǎn)的體驗(yàn)很棒。 首先是構(gòu)建速度快,其次是使用起來(lái)簡(jiǎn)單,一個(gè)hugo
命令,我們的站點(diǎn)就已經(jīng)就緒。
在構(gòu)建過(guò)程中,Hugo提供了豐富的內(nèi)置功能函數(shù),可以在構(gòu)建過(guò)程中向你提供所需要的幾乎任何站點(diǎn)相關(guān)的信息。 通過(guò)可重用模板,讓主題來(lái)幫助處理所有展示和布局相關(guān)的問(wèn)題。 讓作者更專注在內(nèi)容的創(chuàng)作上。
Hugo 游樂(lè)場(chǎng)
站點(diǎn)構(gòu)建的就將寫好的內(nèi)容,轉(zhuǎn)化成Web服務(wù)器能理解的網(wǎng)站資源。 比如我們寫作的時(shí)候用的是Markdown格式,生成的網(wǎng)站資源通常是HTML格式。
下面是一個(gè)簡(jiǎn)單的初始化博客內(nèi)容:
-- config.toml -- theme = "mytheme" contentDir = "mycontent" -- myproject.txt -- Hello project! -- themes/mytheme/mytheme.txt -- Hello theme! -- mycontent/blog/post.md -- --- title: "Post Title" --- ### first blog Hello Blog -- layouts/index.html -- {{ $entries := (readDir ".") }} START:|{{ range $entry := $entries }}{{ if not $entry.IsDir }}{{ $entry.Name }}|{{ end }}{{ end }}:END: -- layouts/_default/single.html -- {{ .Content }} === Static Content ===
可以看到我們自定義了一個(gè)主題mytheme,只有一個(gè)mytheme.txt文件,并沒(méi)有實(shí)際的模板文件。 這將會(huì)在下面的構(gòu)建流程講解中,幫助我們理解到主題是如何嵌套和加載的。
我們的內(nèi)容文件夾是mycontent,在blog目錄下有一篇簡(jiǎn)單博文/blog/post.md。 如果想要獨(dú)立訪問(wèn)這篇博文,就需要為她生成一個(gè)HTML文件,這樣我們就可以在瀏覽器中訪問(wèn)了。
在樣例中,為了生成首頁(yè)和博客,我們還在layouts下創(chuàng)建了兩個(gè)模板。 一個(gè)是首頁(yè)模板index.html,另一個(gè)則是單篇文章會(huì)用到的模板_default/single.html。
通過(guò)golang tools txtar解析上述文本,方便我們轉(zhuǎn)換成如下結(jié)構(gòu)的磁盤文件:
. ├── config.toml ├── layouts │ ├── _default │ │ └── single.html │ └── index.html ├── mycontent │ └── blog │ └── post.md ├── myproject.txt └── themes └── mytheme └── mytheme.txt
通過(guò)Hugo命令進(jìn)行構(gòu)建,就能生成如下站點(diǎn)資源:
? public tree . ├── blog │ └── index.html ├── index.html └── robots.txt
并包含了我們想要的信息:
站點(diǎn)首頁(yè)
? public cat index.html START:|config.toml|myproject.txt|:END:%
博客頁(yè)面
? public cat blog/index.html <h3 id="first-blog">first blog</h3> <p>Hello Blog</p> === Static Content === %
那Hugo的這個(gè)魔術(shù)到底是怎么變出來(lái)的呢?
為了了解Hugo構(gòu)建的核心原理,通過(guò)對(duì)Hugo最新源碼進(jìn)行裁剪,移除當(dāng)前階段不必要的"噪音"。 結(jié)合我們上面的實(shí)例,手動(dòng)生成了一個(gè)最小可工作源碼庫(kù) - hugo游樂(lè)場(chǎng)。 以保證我們?cè)谶@個(gè)游樂(lè)場(chǎng)可以盡情地玩耍,專注于核心原理,享受整個(gè)源碼的學(xué)習(xí)過(guò)程。
通過(guò)命令:
git ls-files | grep '.go' | xargs wc -l
分別統(tǒng)計(jì)gohugoio/hugo和hugo playground的代碼行數(shù)。 我們得到的數(shù)據(jù)分別是 163075 和 33990 行。
整整縮減了近四倍!
相信各位看官也會(huì)虎軀一震,信心倍增!看源碼原來(lái)也可以這么開心。 請(qǐng)準(zhǔn)備好瓜子飲料小板凳,各位看官你細(xì)聽分說(shuō)。
Show Me The Code
package main import ( "bytes" "fmt" "path/filepath" "golang.org/x/tools/txtar" ) // 文件結(jié)構(gòu) // 文件名: config.toml // 文件內(nèi)容:theme = 'mytheme' var files = "-- config.toml --\n" + "theme = 'mytheme'" func main() { // 解析上面的文件結(jié)構(gòu) data := txtar.Parse([]byte(files)) fmt.Println("File start:") // 遍歷解析生成的所有文件,通過(guò)File結(jié)構(gòu)體獲取文件名和文件數(shù)據(jù) // f.Name 獲取文件名 // f.Data 獲取文件數(shù)據(jù) for _, f := range data.Files { filename := filepath.Join("workingDir", f.Name) data := bytes.TrimSuffix(f.Data, []byte("\n")) fmt.Println(filename) fmt.Println(string(data)) } fmt.Println("File end.") }
Output:
# 解析后得到文件config.toml,以及下面的文件內(nèi)容 # workingDir就是我們的工作目錄,通常是要寫入的文件目錄 File start: workingDir/config.toml theme = 'mytheme' File end.
以上就是Hugo 游樂(lè)場(chǎng)內(nèi)容初始化示例詳解的詳細(xì)內(nèi)容,更多關(guān)于Hugo 內(nèi)容初始化的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
Go語(yǔ)言基礎(chǔ)學(xué)習(xí)之指針詳解
Go 語(yǔ)言中指針是很容易學(xué)習(xí)的,Go 語(yǔ)言中使用指針可以更簡(jiǎn)單的執(zhí)行一些任務(wù)。所以本文就來(lái)和大家聊聊Go語(yǔ)言中指針的定義與使用,需要的可以參考一下2022-12-12golang中兩個(gè)協(xié)程交替打印數(shù)字和字母的實(shí)現(xiàn)
這篇文章給大家介紹了golang中兩個(gè)協(xié)程交替打印數(shù)字和字母的實(shí)現(xiàn),文中通過(guò)代碼示例講解的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作有一定的幫助,需要的朋友可以參考下2024-01-01Go簡(jiǎn)單實(shí)現(xiàn)協(xié)程方法
本文主要介紹了Go簡(jiǎn)單實(shí)現(xiàn)協(xié)程的實(shí)現(xiàn)示例,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2022-12-12golang簡(jiǎn)易令牌桶算法實(shí)現(xiàn)代碼
這篇文章主要介紹了golang簡(jiǎn)易令牌桶算法實(shí)現(xiàn)代碼,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2021-04-04