CSST Part 1 Hugo

• Why you need a Blog?
  • Slide Project
  • 個人宣傳頁曝光
  • 美術作品集
  • 名片上有東西放

• Why Markdown
  • 語法格式統一
  • 純文字卻美觀
  • 多系統支援
  • 撰寫速度快

Markdown 語法介紹

- 「# H1」：最大的標題 
- 「## H2」： 次大的標題
- 「- item」：清單條列用，Tab 可縮排
- 「[連結請點我](https://www.mou.tw)」：超連結
- 「![](https://xxx.png)」：圖片
- 「`#include <stdio.h>`」：放 Code

開始架設一個 Blog 吧！

這代表在 cmd 內執行

請點我

2. 開啟後貼入如下指令，跑完後如 1. 方式重開

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

3. 以系統管理員身份重開後，複製貼上以下指令

choco install git.install -y
choco install golang -y
choco install hugo -y
hugo version

4. 見到版本輸出就代表成功

2. 複製貼上 安裝 brew 套件管理

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. 完成後重新開啟 Terminal（終端機）輸入以下指令

brew update
brew install hugo
hugo version

4. 見到版本輸出就代表成功

2. for Mac/Linux

在config.toml 中新增 theme = "ananke"

echo 'theme = "ananke"' >> config.toml

2. for Windows

1. 輸入以下指令打開 config.toml 檔案
   

2. 第四行新增 theme = "ananke"

3. 建立第一篇 Hugo Blog

hugo new posts/my-first-post.md

你可以在這個檔案內打點字。

4. 渲染並產生網站

• Debug 用：同時渲染並架設伺服器
  hugo server -D
• 手動部署用：僅渲染並產生在 public 資料夾
  hugo -D

5. 上傳 GitHub

git add .
git commit -m "Init"

CI/CD 與軟體工程

屬於

軟體工程（英語：software engineering），是軟體開發領域裡對工程方法的系統應用。

CI/CD 是 Continuous Integration / Continuous Deploy 的縮寫，倡導開發者應建立一套流程能夠在程式碼 push 到版本控制系統後，即時驗證並隨時有穩定可發表/部署的 codebase。

• CI：持續整合，aka 自動測試 Debug
• CD：持續部署，aka 自動編譯上傳上線

更通俗講，每週要交一份 500 字的心得報告：

• CI：幫你檢查
  • 報告有沒有 500 字
  • 名字有沒有寫等等
• CD：自動幫你
  • 上傳到 iLMS
  • 告訴你有沒有成功
  • 連續繳交兩份時：
    • 不成功能恢復上一個作業
    • 減少刪作業、重新傳作業的空窗時間

所以導入 CI/CD 我們要做什麼？

1. 寫好 CI 測試邏輯
2. 找人（機器）幫你跑測試
3. 把他變成你的習慣

GitHub Action 是一種 CI/CD

1. Hugo 提供測試邏輯
2. GitHub 提供機器 （幹話）
3. 就可以輕鬆的用了！

• 免費版的用途與限制：
  • 一定要公開專案

1. 新增 gh-pages.yml 檔案 For Windows

2. 上傳到 GitHub

git add .
git commit -m "Add gh=pages.yml"
git push

3. 到設定頁面將 GitHub Page 設定如下

1. Branch 改成 gh-pages
2. Enforce HTTPS 勾起來

那就買一個專屬的名字吧！（Domain、域名）

• https://Gandi.net
• https://tw.godaddy.com/

Domain 設定

租了名字，如何給你的網站名字ㄋ？

1. 告訴世界上所有人，這個名字就是你的網站

<@所有>.mou.tw 的網頁(A)
全部都給 GitHub(192.230.252.153) 處理

2. 告訴 GitHub 網站說，你有名字了喔