Hugo
在 Ubuntu 下載 Hugo
不建議在
windows
下面使用Hugo
簸搞,因?yàn)闀?huì)出問題须床。(為什么用 Hugo 上傳到 Github Page 沒辦法正常顯示)我折騰了好久滑绒,還是不知道怎么解決贩挣,只能轉(zhuǎn)到 Linux 了鲤妥。
至于如何使用 Ubuntu
庶橱,要么用 WSL
,要么用 VM
童擎,反正需要用 Linux
滴劲。這里就不放教程啦,網(wǎng)上一大堆啦顾复。在 Ubuntu
下面直接安裝即可班挖,其他 Linux
就自己搜索一下吧。
sudo apt-get install hugo
使用 Hugo 創(chuàng)建新的博客 Blog 并安裝主題
先創(chuàng)建一個(gè)site
hugo new site my-first-blog
然后進(jìn)入文件夾初始化(需要先下載 git:sudo apt-get install git
芯砸。不過一般來說最新版本的 Ubuntu 都會(huì)預(yù)裝 git 了)
git init
然后去 Hugo 的官方主題站尋找你喜歡的主題萧芙,像我是用了 anatole,然后把主題添加到 theme
文件夾里面假丧。
git submodule add https://github.com/lxndrblz/anatole.git themes/anatole
然后要在config.toml
里面加一句theme = 'anatole'
末购。或者可以像我一樣虎谢,去 anatole
的 github下載作者給出來的example config.toml
,直接復(fù)制粘貼曹质,然后自己可以改改標(biāo)題什么的婴噩。而且還有不少東西可以修改擎场,例如改頭像什么的,但是暫時(shí)還沒弄几莽。
新建你的第一篇博客
hugo new posts/my-first-post.md
文章必須在 posts
下面迅办,又因?yàn)槭怯?code>markdown寫的,所以是.md
結(jié)尾章蚣。至于能不能用普通格式站欺,還沒研究。寫完后要把 draft
改成false
纤垂,避免被當(dāng)做草稿而沒有發(fā)表矾策。
在本地預(yù)覽你的博客頁面
hugo server -D
帶-D
就是把草稿也一起預(yù)覽了,如果不帶就不會(huì)預(yù)覽草稿峭沦,也就是 draft: true
的文章贾虽。接著就可以打開瀏覽器,輸入http://localhost:1313/
開始瀏覽你的博客吼鱼。你的網(wǎng)站不一定是我這個(gè)蓬豁,看終端的輸出。
生成靜態(tài)頁面
hugo #同樣菇肃,帶`-D`就是把草稿也生成了地粪。
會(huì)生成一個(gè)public
文件夾,這個(gè)文件夾就是最終產(chǎn)物琐谤,只需要把它移到我們的 Github Page 就搞定了蟆技。
Github Page
Hugo 部分算是搞定了,接下來搞搞 Github Page笑跛。
注冊啊付魔、入門啊、生成 ssh key 啊飞蹂,這些我全部略過了几苍,直接搜索一下就好了。
至于如何簡歷 Github Page陈哑,也是搜索一下就好了妻坝,可以看看這個(gè)三分鐘在GitHub上搭建個(gè)人博客。反正很簡單惊窖。
至于 theme 選不選刽宪,README 要不要建立,無所謂界酒,反正用不上圣拄,或者要用的時(shí)候自己再建一個(gè)就可以了。
Hugo 與 Github Page 連接
進(jìn)入到你的 Hugo blog 文件夾下面的 public 文件夾毁欣,然后將它用 git 初始化庇谆。并且添加你剛剛創(chuàng)建的 repository(倉庫)的網(wǎng)址岳掐,然后上傳 public 里面的文件即可。
cd public
git init
git remote add origin git@github.com:<name>/<name>.github.io.git # 最好用ssh饭耳,不要用https串述,似乎會(huì)比較順利。
git pull origin main #這一步不是必要的
git add .
git commit -m 'add my first blog'
git branch -M main #修改 branch
git push origin main
git branch -M main
是用來把 master 改成 main的寞肖。因?yàn)橹昂谌诉\(yùn)動(dòng)纲酗,github 把默認(rèn)是 master 的主分支,改名成了 main新蟆,但是 git 這個(gè)工具還沒修改好觅赊,默認(rèn)創(chuàng)建是還是 master。這時(shí)候去合并就會(huì)出現(xiàn)兩個(gè)支栅葡,比較麻煩茉兰。或者你也可以手動(dòng)修改 git 的默認(rèn)創(chuàng)建——git config --global init.defaultBranch main
欣簇。也可以去 github 修改主分支的默認(rèn)名字规脸。
理論上,現(xiàn)在你的 public 的文件熊咽,就被上傳到 github 去了莫鸭,然后直接輸入網(wǎng)址,例如我的是 happyjoo.github.io横殴,即可訪問自己的博客了被因。(不行的話得等等,github 的服務(wù)器有時(shí)候會(huì)慢一點(diǎn)衫仑,畢竟是免費(fèi)的梨与。)
后續(xù)博客的更新
至于之后的更新,就是在你寫好文章后文狱,先用 Hugo 刷新 public 里面的文件粥鞋,然后在 public 文件夾下面先 pull,再 push瞄崇,應(yīng)該就可以了呻粹。
你也可以把整個(gè) blog 文件夾上傳到 github 的倉庫中。這樣可以進(jìn)行版本控制苏研,也可以以防你需要在其他電腦進(jìn)行更新等浊。