一直想把 20 年前在 BBS 上寫的 數學解答 貼出來,但不論是 Jekyll 或是 HUGO 都對 $\LaTeX$ 不那麼友善。直到最近看到 Docusaurus 才覺得驚為天人。
操作備忘 Link to heading
基本上 官方文件 算蠻清楚了。
- 建議使用 yarn 執行一切指令。因為不管 發佈到 Github 或是 發佈到 GitLab 的設定都以
yarn
為主。
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
是否搬家 ? Link to heading
其實有糾結是否要放棄 HUGO 改用 Docusaurus,但發現它的 node_modules 這包資料夾超巨大而且 Build 速度很慢。而且也剛好看到這篇 Moving from Docusaurus to Hugo 有寫類似的內容。所以還是繼續留在 HUGO 吧。 ☕