self

My public obsidian vault.

Setup

I followed advice found here which involves a git subtree of the quartz project, instead of forking and modifying from there.

Subtree Command

git subtree add --prefix=quartz https://github.com/jackyzha0/quartz.git v4 --squash

Setup Quartz

Install and set the build directory to the vault above.

npm i
npx quartz build --directory=../self

Note

Obsidian stuff...

Run the server

npx quartz build --serve --directory=../self

Github Workflow

name: Deploy using Quartz and Github Pages
 
on:
  push:
    branches:
      - main
 
permissions:
  contents: read
  pages: write
  id-token: write
 
concurrency:
  group: "pages"
  cancel-in-progress: false
 
jobs:
  build:
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0 # Fetch all history for git info
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - name: Install Dependencies
        run: npm ci
      - name: Build Quartz
        run: npx quartz build --directory=../self
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: public
 
  deploy:
    needs: build
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

And a while later...

I spent way too long on figuring out the deploy.

Ultimately it was because I had previously deployed iancullinane.github.io as a repository and thus basically everything was being superseded by that.

I changed a line like...

<h2>{opts.title ?? i18n(cfg.locale).components.explorer.title}</h2>