Below you will find pages that utilize the taxonomy term “Hugo”
Posts
Hugo - Build and Deploy With GitHub Actions
要使用 GitHub Actions 建置並部署 Hugo 到 GitHub Pages,先要切到 GitHub Pages Repository 下的 Settings/Pages 頁面,在 Build and deployment 的 Source 這邊選用 GitHub Actions。
搜尋使用 Hugo GitHub Actions。
這邊會帶出 Hugo GitHub Actions 的 Workflows 設定檔,該設定檔給的是用 master branch 去做設定的內容,預設也是存放到 master branch。如果是 master branch 合用可直接存檔,不合用也只能自行修改上傳到 git。
設定完後在 Actions 左半邊就會看到剛加的 Workflows
切到剛加的 Workflows,右側可選取 Branch 運行 Workflow。
運行後會看到列表產生了對應的建置與部屬的動作。
點進去可以看到建置與部屬動作的細節。
這邊要特別注意,若是 Hugo GitHub Actions 當初設定的不為 master branch,需在 Settings/Environments 這邊設定 github-pages。
將指定的 branch 加入允許部署 GitHub Pages。
不然在 Workflows 建置與部屬時會看到下面這樣的失敗畫面。
read morePosts
Hugo - Add Content
Hugo 站台建立完後可以開始為站台加入文章,透過 Hugo 的 new content 命令,帶入文章檔名建立 Hugo 文章。
hugo new content posts/[postfilename].md 開啟建立的 Hugo 文章檔案進行文章的撰寫。
vim content/posts/[postfilename].md 文章撰寫完成可透過 Hugo 的 server 命令,帶入 –buildDrafts 或 -D 參數啟動 Hugo 站台,表示文章在草稿階段也要呈現。
hugo server --buildDrafts hugo server -D 透過瀏覽器瀏覽 http://localhost:1313/ 即可看到 Hugo 站台運行後的樣子,Hugo 站台內會有剛撰寫的 Hugo 文章。
Link Quick start | Hugo
read morePosts
Hugo - Create a Site
Hugo 裝完後,首先需要先建立站台,透過 Hugo 的 new site 命令,帶入站台的名稱。
hugo new site [sitename] 建立完後進入站台目錄。
cd [sitename] 初始化 git。
git init 透過 git submodule 將 Hugo 的 ananke theme 加入站台。
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke 修改 hugo.toml 將 Hugo 站台套用 ananke theme。
echo "theme = 'ananke'" >> hugo.toml 本地將 Hugo 站台運行起來。
hugo server 透過瀏覽器瀏覽 http://localhost:1313/ 即可看到 Hugo 站台運行後的樣子。
Link Quick start | Hugo
read morePosts
Hugo - Install Hugo on MacOS
Hugo 在 MacOS 下可直接透過 Homebrew 安裝。
brew install hugo 安裝後可調用 Hugo 命令帶入 version 參數查閱 Hugo 版本,確認 Hugo 的安裝是否正確。
hugo version 後續 Hugo 命令使用有問題可調用 Hugo 命令帶入 –help 參數查詢 Hugo 命令的使用方式。
hugo --help Link macOS | Hugo
read more