Blog 心得 on Wenrong Nexus

Blog 心得（3）

Mon, 28 Feb 2022 00:00:00 +0000

前言

此篇在講如何使用 Hugo 在 Github 上自架 Blog。

安裝 Hugo

關於安裝的部分可以參考這些文章

與文章不同的地方主題我是選擇 PaperMod，由於需要設定 config.yml，建議先參考 PaperMod-Installation。

想要完整的設定或理解 PaperMod，最好是完整的看完 PaperMod 的 repo，有不知道的問題可以在 Issues 或者 FAQs 搜尋看看，會比 google 搜尋來得快。

PaperMod

由於 PaperMod 推薦使用 config.yml，因此推薦把原本的 config.toml 刪除。並且去複製官方提供的 config.yml。

config.yml

Search Post

先在 config menu main 新增一個 Search 頁面

menu:
    main:
        - identifier: archives
          name: Archives
          url: /archives/
          weight: 5
        - identifier: tags
          name: Tags
          url: /tags/
          weight: 10
        - identifier: search
          name: Search
          url: /search/
          weight: 20

且在最底下此內容。（參考文件）

outputs:
    home:
        - HTML
        - RSS
        - JSON # is necessary

最後在專案的 content 底下新增 search.md，即可完成功能。（參考文件）

---
title: "Search" # in any language you want
layout: "search" # is necessary
# url: "/archive"
# description: "Description for Search"
summary: "search"
placeholder: "placeholder text in search input box"
---

Comments

此功能是參考 Day 20. Hugo Comments System 文章製作出來的。

Github Action

有使用 Custom domain 的話，且 workflows 沒有設定 domain 的話，會造成每次更新文章時，都會清掉 Custom domain，變回原本的 github.io。

GitHub Pages workflow.yml

name: GitHub Pages

on:
  push:
    branches:
      - main # Set a branch to deploy
  pull_request:

jobs:
  deploy:
    runs-on: ubuntu-20.04
    concurrency:
      group: ${{ github.workflow }}-${{ github.ref }}
    steps:
      - uses: actions/checkout@v2
        with:
          submodules: true # Fetch Hugo themes (true OR recursive)
          fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: "0.91.2"
          # extended: true

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        if: ${{ github.ref == 'refs/heads/main' }}
        with:
          github_token: ${{ secrets.HUGO_DEPLOY_TOKEN  }}
          PUBLISH_BRANCH: gh-pages # 推送到 gh-pages 分支
          commit_message: ${{ github.event.head_commit.message }}
          publish_dir: ./public
          cname: wenrongdev.com

只需要新增或替換掉 cname 後面為 domain 即可。

結論

Hugo 或 PaperMod 我都處於摸索階段。

這次架起來的感覺各方面都不錯，不管是讀取 Blog 速度、支援 Markdown、架設 Github 上且保留原始檔，到目前為止沒有明顯的缺點。

目前最大問題就是 SEO，這是我完全沒有接觸過的。問題在於 Google 搜尋不到我的 Blog，所以這是之後要研究的部分。

Blog 心得（2）

Mon, 21 Feb 2022 00:00:00 +0000

前言

由於 SiteGround 費用問題，因此我需要把文章轉移至別的地方。不過也知道自己需要哪些功能。

免費 Server
網頁速度快
支援程式碼片段
自訂網域

這些是我目前需要的功能，不需要排版、SEO、等功能，最好是直接把 Markdown 語法貼上就能變成文章，剩下就都可以接受了。

Medium

先說結論 Medium 不適合需要貼上 Code 的技術類文章。

貼程式碼片段太麻煩。
使用 Markdown 語法撰寫文章，因為格式不同需要重新排版。

以上這兩點是使用後遇到的難題，導致我不得不再尋找新的平台。也是這時候才知道自己的 Blog 需要什麼樣的功能。最後在寫技術部落格不需要那麼大費周章發現了 CoderBridge，並且申請了 Blog。

CoderBridge

完整提供前言提到所有功能，不過我最後還是選擇使用 Hugo 自架 Blog。

主因是文章沒有備份檔。

因為我自己的壞習慣，所以才都沒有留住這些檔案。也因為從 Wordpress、Medium、CoderBridge 換了三個 Blog，覺得搬遷好麻煩，都沒有完整的文章檔案，每次都需要重新排版，才會想架一個免費而且可以保留文章檔案的 Blog。

最後自己是選擇了使用 Hugo 框架架在 Github page 上。

結論

Wordpress、Medium、CoderBridge 我覺得各有優缺點，假如自己從一開始就決定要找免費的，我會選擇使用 CoderBridge，不過也因為搬來搬去才知道自己需要哪些功能，最後使用 Hugo 也只是因為我自己覺得很潮而已。

Blog 心得（1）

Mon, 14 Feb 2022 00:00:00 +0000

其實我的 Blog 是寫給自己看的。因為我時常忘記怎麼解決問題、怎麼製作功能、忘記是做了什麼蠢事。因此產生這個 Blog 用來記錄我的跌跌撞撞的過程。

前言

在大學寫程式時遇到問題去 Google 查，很多時候很難下關鍵字，主要是自己犯蠢導致很難知道原因。自然而然也很難對症下藥，很多時候只是重打或參考(?)同學就能解決學生時期遇到的問題。

當開始工作時的第一年內，遇到的問題基本上還是類似的，因為我實在是太菜了，會遇到一些其實很基本又很無言的低級錯誤，一直重複的犯錯麻煩其他同事幫忙 debug，所以我一直有一個念頭想架設自己的 Blog。記錄解決過程和解決方式，提醒未來自己有錯誤可以來這邊看，假如又可以幫助別人其實也不錯。

Blogger

第一個 Blog 是使用大學某堂課程用到的 Blogger，其實也沒太認真研究這個 Blog，因為覺得不夠好看用了一下沒有認真的使用。

多年之後看到搞笑談軟工的 Blog，才知道 Blog 的重要的部分其實不是選用什麼架構，持續寫作 才是最重要的核心。

Wordpress

2018 時覺得自己的學習成長曲線變慢了，可能是因為都接觸類似的東西，工作上也大部分內容都能應付，也不會像以前一樣回家繼續寫程式，簡單來講就是發現自己進入了舒適圈(?)。就很坎坷不安，於是就開始買書學習、跟人學習。

2019 的某天 Unity 程式社群，有人發問推薦的程式書籍，而阿祥的開發日常的 Ted 回答了軟技能代碼之外的生存指南。整本書內容都沒在講程式的部分，大部分內容都是在講工程師除了工作以外的事情，例如運動、投資、面試、等等，推薦沒看過的工程師可以買，對於我個人是獲益良多，也是因為看了才有想認真的自己架設 Blog。

書的內容其實就有推薦架設屬於自己的 Blog，當時看到就想到我當年的想法，是沒有想要跟作者一樣利用 Blog 賺錢，畢竟技術不到家。倒是覺得可以當一個不錯的作品集，於是就開始在架設自己的 Wordpress。

當時是看著教學文章邊看邊選擇，過程除了刷卡付錢沒有什麼難度，我在 NameCheap 買網址，虛擬主機則是使用 SiteGround。

使用三年心得 (2019~2020)

年分	SiteGround	NameCheap	花費(NTD)
第一年	1493	285	1778
第二年	5375	315	5690
第三年	0	368	368
總花費			7836

第一年 1778 元。而且很多功能可以玩、可以使用，整體使用是很滿意的。而到了第二年，沒有認真確認第一年花費多少就直接續約了，收到扣款通知才知道收費真的很貴。

第一年跟第二年價格差了 3912 元，當時也沒有想到要退款，想說明年扣款時再來處理。

到了第三年，就打算不續約 SiteGround，所以開始把文章轉移去 Medium，不過 NameCheap 是有持續付費的，畢竟費用還是較少，而且網址現在還在使用。

後來用 Hugo 架設這個 Blog，才知道 Wordpress 的好，很多事情都很簡單就完成（SEO、theme、等等）。

結論

整體而言 Wordpress 對於新手的我架設 Blog，確實是不錯的體驗，只要有錢基本都能處理。不過續約的花費太貴，所以才放棄使用 SiteGround，尋找一些免費的方式。

當時使用 NameCheap 時也有被盜刷過，記得要綁定 2FA、密碼不要重複。