Hugo 是一個静態網站生成器,搭配 git 很適合來建立個人部落格。在一系列的筆記中將介紹如何安裝/使用相關工具與技術,目的是搭建一個完全免費的個人部落格。

使用的相關工具/技術:

  • Hugo
  • git
  • vs code
  • gist
  • github page
  • Markdown

Chocolatey

Chocolatey 是一個 Windows 上的套件管理工具,它結合了 Nuget 基礎服務與 powershell 指令,提供快速安裝應用程式與工具的服務,將安裝軟體的內容封裝到一個安裝包中,在 Chocolatey 中只需要一條簡單的指令就能完成搜尋、安裝、更新、解安裝等操作。

在 Windows 10 上安裝 Chocolatey

以‘系統管理員’身份開啟 ‘Windows PowerShell’, 執行以下指令來進行 Chocolatey 安裝

PS C:\>Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

移除 Chocolatey

刪除 C:\ProgramData\chocolatey 目錄及移除環境變數即可,搜尋 “編輯系統環境變數” \ “進階” \ “環境變數”

安裝 hugo

Step 1: 在 Windows 10 上使用 choco 安裝 hugo

C:\> choco install hugo -confirm
C:\> choco install hugo-extended - config
C:\> hugo version

image

Step 2: Create a New Site (建立部落格網站)

C:\> hugo new site quickstart
C:\> hugo new site quickstart -f yml # 若要使用 config.yaml 為 config 設定檔,則加入額外參數

Step 3: Add a Theme (新增部落格主題)

請先確認在您的作業系統中已經安裝了 git

C:\> cd quickstart
C:\> git init
C:\> git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
C:\> git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically)

在 config.toml 中加入 theme = “ananke”

C:\> echo 'theme = "ananke"' >> config.toml

Step 4: Add Some Content (建立新文章)

C:\> hugo new posts/my-first-post.md

在 md file 中加入以下內容

# Test Page
This is my first test page.

Step 5: Start the Hugo server (本機測試)

C:\> hugo server -D

開啟瀏覽器,輸入網址 https://localhost:1313