前段時間使用docker搭建了一個wiki的網(wǎng)站，用于記錄日常學習中的筆記，用了一段時間，功能很強大，但是編輯器不太熟悉，網(wǎng)站使用java開發(fā)的，功能很全面，插件多的時候就感覺越來越臃腫。曾經(jīng)有段時間就不想使用它了，最近偶然發(fā)現(xiàn)一個靜態(tài)網(wǎng)站的生成工具hugo，可以將markdown直接生成網(wǎng)站，部署到站點上作為自己的知識庫或者博客，hugo是使用go語言開發(fā)的，使用起來非常方便，生成的網(wǎng)站可直接部署在Nginx、IIS等中間件上面供其他人訪問,hugo還有很多漂亮的主題，大家可以選擇自己喜歡的進行使用，下面介紹下 我安裝使用hugo的經(jīng)歷和方法。
成都創(chuàng)新互聯(lián)專注于松桃網(wǎng)站建設服務及定制，我們擁有豐富的企業(yè)做網(wǎng)站經(jīng)驗。 熱誠為您提供松桃營銷型網(wǎng)站建設，松桃網(wǎng)站制作、松桃網(wǎng)頁設計、松桃網(wǎng)站官網(wǎng)定制、成都小程序開發(fā)服務，打造松桃網(wǎng)絡公司原創(chuàng)品牌,更為您提供松桃網(wǎng)站排名全網(wǎng)營銷落地服務。
1）使用brew install命令安裝
我的電腦是mac的，所以最方便的是直接用brew install hugo命令安裝最為方便：
執(zhí)行安裝完成后執(zhí)行hugo version 命令查看版本，確保安裝成功
2）官網(wǎng)下載二進制包：解壓后將二進制文件加入環(huán)境變量的方式安裝。大家可以根據(jù)自己的操作系統(tǒng)，下載適合的安裝包。
3）也可以下載源碼 編譯 運行，由于我本地的go版本是1.17的，而hugo的最新代碼的最低要求是1.18，暫時還不想升級，所以源碼編譯的方式這里就不過多介紹，感興趣的可以下載源碼編譯試試。
進入要創(chuàng)建網(wǎng)站的目錄，執(zhí)行一下命令
這樣名稱為test-blog的網(wǎng)站就建好了 ，
下載一個主題 可以在 官網(wǎng)上找到各種各樣的主題
將主體添加至配置文件
打開content/posts目錄下的index.md 文件進行編輯，頁面的配置項說明參見官網(wǎng)
執(zhí)行下面命令
成功以后就可以訪問就可以訪問網(wǎng)站了。
執(zhí)行命令hugo -D 即可生成一個public的文件夾，其下面的內(nèi)容即為靜態(tài)網(wǎng)站的所有文件
這里使用nginx的docker鏡像 進行部署，執(zhí)行以下命令：
執(zhí)行成功后就能通過http:localhost訪問到靜態(tài)網(wǎng)站了。
這個工具還有很多需要研究的地方，這里只是將簡單的使用方法記錄了一下，以后怎樣使用才能使網(wǎng)站更加的方便，快捷、美觀，還要花時間研究。有興趣的小伙伴可以私信我一塊研究。
現(xiàn)在個人博客通常有比較多的選擇，如果不想要自己購買服務器實現(xiàn)靜態(tài)博客的發(fā)布，可以在、CSDN等平臺建立自己的賬號并發(fā)布，但是原始數(shù)據(jù)無法在本地管理；如果想要數(shù)據(jù)完全自己管理，可以使用GitHub或者Gitee Pages功能發(fā)布自己的博客，利用Hugo或Hexo等成熟的靜態(tài)博客將md文件轉(zhuǎn)換成靜態(tài)網(wǎng)站文件進行快速發(fā)布。本文就用來記錄如何快速將博客發(fā)布到、GitHub以及Gitee Pages三個平臺。
我希望的流程當然是主要精力用在寫文章，發(fā)布的流程最好完全不需要手動處理，但實際情況下手動發(fā)布博客的流程大體是：
之前有使用過Travis CI+GitHub+Hexo自動發(fā)布到GitHub Pages，但是GitHub的訪問經(jīng)常不那么靠譜，因此想著也能同步到Gitee，并且自動構建Hexo的速度受Nodejs環(huán)境部署影響，速度很慢，因此本次計劃采用Hugo來構建網(wǎng)站文件，整體流程設計如下：
為了滿足博客自動發(fā)布流程，首先需要在本地準備好生產(chǎn)環(huán)境，以滿足快速發(fā)布，以此的復雜是為了長期的簡單，因此在環(huán)境準備階段我會把所有涉及的工具都記錄下來，以方便大家使用以及后邊自己回顧，環(huán)境準備包含：
Obsidian完成知識積累后，按照ZK-Project-Archive-Blog的流程發(fā)布Blog，但是Obsidian的文件相互關聯(lián)，且附件如何快速復用，需要對Typora和Obsidian都進行簡單的配置，確保后續(xù)Blog能夠快速完成并發(fā)布，并且文件仍在Obsidian工程中正常顯示；
Typora非常的簡潔，而且可以實時預覽，在寫博客的時候經(jīng)常會插入一些圖片，截圖后可以直接粘貼進去，圖片也會自動保存在本地，這里需要注意圖片的保存路徑，在偏好設置里，設置插入圖片時復制到指定路徑（./resource/），這樣復制的圖片就會自動保存在當前文件夾下的resource文件夾里，方便后續(xù)管理與轉(zhuǎn)移。
在.ssh文件生成id_rsa和id_rsa.pub兩個文件；
Hugo 是一個基于Go語言開發(fā)的靜態(tài)博客框架，號稱世界上最快的構建網(wǎng)站工具；
命令為： hugo new site myblog
myblog為博客的目錄名，可以修改為你自己想取的名字，生成的目錄如下：
由于默認主題生成的文章頁面有些功能是不需要的，因此需要對themes下文件進行修改：
將config、content和themes三個目錄拷貝到新創(chuàng)建的站點目錄，將content下替換為文章文件即可。
utterances 是一款基于Github Issue的Github工具，優(yōu)點主要是無廣告、加載快、配置簡單，輕量開源。
由于 utterances 是一款Github App，因此 安裝utterances 非常簡單，只需要授權特定repo權限給 utterances 就可以了,注意一個點：授權的這個repo必須是public的，可以選擇多個repo，但是建議選擇一個就可以了，也比較安全。
這是當前最簡單的配置方法， 也可以在 utterances官方 查看其他配置方法，以及詳細的配置參數(shù)說明。
Obsidian的安裝和使用可參考我的另一篇文章： Obsidian作為第二大腦工具的基本使用和配置
所有環(huán)境準備好后，終于要開始啟動我們的自動化流程的實現(xiàn)了；
同之前步驟相同，將Gitee密碼配置到GitHub Secrets，命名為：GITEE_PASSWORD，所有配置結(jié)果如下：
synctogitee.yml
需要綁定Gitee賬號到微信公眾號，否則最后一步reload pages自動部署Gitee Pages會登錄失敗，原因是需要短信驗證；綁定公眾號后則不需要短信驗證；其他問題解決可以參考 gitee-pages-action
在Typora完成文章編寫后，一鍵上傳所有圖片到Gitee圖床，拷貝發(fā)布到，然后提交到GitHub repo master分支，即可自動部署到GitHub和Gitee Pages；
以上就是我利用GitHub-Actions將Hugo博客自動發(fā)布到GitHub和Gitee Pages，希望可以幫助大家快速構建自己的個人網(wǎng)站；后邊我會繼續(xù)完善我的第二大腦系統(tǒng)的構建思路和方法。
以前使用wordpress搭建網(wǎng)站，插件太多，完善起來比較費時費力。現(xiàn)在，靜態(tài)博客也很受歡迎，hugo就是GO語言開發(fā)的一個靜態(tài)博客生成器。
mackbook上直接使用 brew install hugo 安裝hugo，安裝完成后使用 hugo version 來查看hugo的版本。
在Github目錄下打開終端，或者cd到Github目錄下：
hugo new site site_name
其中，si te_name為github賬號名稱加上 .github.io ，例如：
hugo new site gary-hertel.github.io
創(chuàng)建成功后會顯示一些信息，諸如：
這就表示站點已經(jīng)創(chuàng)建成功了。
然后進入到站點目錄：
cd gary-hertel.github.io
使用 tree 查看目錄結(jié)構如下：
接下來需要為我們的網(wǎng)站指定一個主題，這里我們選擇 even 這個主題:
git clone themes/even
將該主題增加到網(wǎng)站的配置文件中，這樣才能生效：
echo 'theme = "even"' config.toml
測試下是否成功，運行：
hugo serve
這里是按照別的教程操作的，但是發(fā)生了報錯，查看even這個主題的文檔后發(fā)現(xiàn)有如下內(nèi)容：
這里提示我們查看 themes/even/exampleSite 目錄下有一個示例的 config 配置文件，我們需要將這個文件復制到站點根目錄，覆蓋原文件，這樣才能夠使站點生效。配置文件中的信息可以查看一下，然后進行相應的修改。
在站點根目錄：
hugo new post/first_article.md
查看 gary-hertel.github.io/content/post 目錄下新增了一個 first_article.md 的markdown文檔，打開之后對其進行編輯即可，注意將 draft:true 修改為 false .
撰寫文章的方法就是通常開發(fā)者常用的markdown格式。
在站點根目錄下：
Hugo serve
然后就可以在瀏覽器中輸入 進行查看了，在撰寫文章或者進行配置修改等等操作時，內(nèi)容會自動更新。
hugo -d docs
靜態(tài)頁面會保存至站點根目錄下的docs文件夾。
每次更新后我們都需要執(zhí)行一下這條命令。
在github上新建一個公開倉庫，名為github用戶名加上 .github.io ，例如 gary-hertel.github.io
在倉庫的settings的pages設置中，Source那里設置為：
說明如下：
使用hugo搭建個個人博客還是不錯的，一開始要花些時間折騰和摸索，后續(xù)就使用起來比較方便了，也不需要購買服務器去部署，部署在github上可能國內(nèi)訪問較慢，可以考慮部署到gitee.
重慶分公司
重慶分公司
