建立數學解答庫

一直想把 20 年前在 BBS 上寫的 數學解答 貼出來,但不論是 Jekyll 或是 HUGO 都對 $\LaTeX$ 不那麼友善。直到最近看到 Docusaurus 才覺得驚為天人。

操作備忘 Link to heading

基本上 官方文件 算蠻清楚了。

name: Deploy to GitHub Pages

on:
  push:
    branches:
      - main
    # Review gh actions docs if you want to further define triggers, paths, etc
    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on

jobs:
  deploy:
    name: Deploy to GitHub Pages
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: 18
          cache: yarn

      - name: Install dependencies
        run: yarn install --frozen-lockfile
      - name: Build website
        run: yarn build

      # Popular action to deploy to GitHub Pages:
      # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          # Build output to publish to the `gh-pages` branch:
          publish_dir: ./build
          # The following lines assign commit authorship to the official
          # GH-Actions bot for deploys to `gh-pages` branch:
          # https://github.com/actions/checkout/issues/13#issuecomment-724415212
          # The GH actions bot is used by default if you didn't specify the two fields.
          # You can swap them out with your own user credentials.
          user_name: github-actions[bot]
          user_email: 41898282+github-actions[bot]@users.noreply.github.com
image: node:latest

# allow caching for faster deployment
cache:
  paths:
    - node_modules/
    - public/
    - .cache/

pages:
  stage: deploy
  script:
    - yarn install
    - yarn build:gitlab
  artifacts:
      paths:
        - public
  only:
    - main
  • 如果要在 GitHub 上放 CNAME 的話,要把它放在 static 資料夾裡面,不然每次重 build 都會被移除,感覺 GitLab 的設計比較簡單。

是否搬家 ? Link to heading

其實有糾結是否要放棄 HUGO 改用 Docusaurus,但發現它的 node_modules 這包資料夾超巨大而且 Build 速度很慢。而且也剛好看到這篇 Moving from Docusaurus to Hugo 有寫類似的內容。所以還是繼續留在 HUGO 吧。 ☕