refactor: convert site to hugo + python bibtex parser

Author: hi-liang

.bundle/config

@@ -0,0 +1,35 @@
+name: Build and deploy Hugo site
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build-hugo-deploy-remote:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      # Hugo has no BibTeX engine, so regenerate the publications data + BibTeX
+      # detail pages from _pubs/wise.bib before building (replaces jekyll-scholar).
+      - name: Generate publications from BibTeX
+        run: |
+          python3 -m venv .bibvenv
+          .bibvenv/bin/pip install --quiet -r scripts/requirements.txt
+          .bibvenv/bin/python scripts/gen_bib.py
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@2752ce1d29631191ea3f27c23495fa06139a5b78 # v3.2.1
+        with:
+          hugo-version: '0.163.3'
+          extended: true
+      - name: Build
+        run: hugo --minify
+      - name: rsync to remote server
+        uses: burnett01/rsync-deployments@4d419d1dc46d4a8a2b6ceab2f951f0f93b2da8f5 # v9.0.0
+        with:
+          switches: -vazh
+          path: public/*
+          remote_path: ${{ secrets.DEPLOY_PATH }}
+          remote_host: ${{ secrets.DEPLOY_HOST }}
+          remote_user: ${{ secrets.DEPLOY_USER }}
+          remote_key: ${{ secrets.DEPLOY_SSH_KEY }}

.github/workflows/build-hugo.yml

@@ -1,7 +1,20 @@
-_site
-.sass-cache
-.jekyll-metadata
-Gemfile.lock
-vendor
+# Hugo build output
+/public/
+/resources/
+.hugo_build.lock
+hugo_stats.json
+
+# Publications — generated from _pubs/wise.bib by the deploy workflow (scripts/gen_bib.py)
+/data/publications.json
+/static/bibliography/
+
+# Jekyll reference build (kept locally for comparison; not deployed)
+_site/
+
+# Python virtualenvs for the bibliography generator
+.venv/
+.bibvenv/
+__pycache__/
+
+# OS / editor
 .DS_Store
-.jekyll-cache/

.github/workflows/build-jekyll.yml

@@ -1,60 +1,105 @@
 # website
-Static Bootstrap 4 site generated by Jekyll
 
-## Local Development
-* [Install Jekyll](https://jekyllrb.com/docs/installation/)
-* Install any new ruby packages via `bundle install`
-* Dependencies: `gem install --user-install html-proofer`
-* Preview changes with `jekyll serve` at http://localhost:4000
+Static Bootstrap 4 site for the WiSE Lab, built with [Hugo](https://gohugo.io/)
+(migrated from Jekyll).
 
 ## Making Updates
-Modify content pages and push commit. Changes to `master` branch will automatically
-be deployed to the live server (in about 60s) unless a `skip` keyword is included in
-commit message, e.g. 
-
-```
-Update README
 
-[skip ci] 
-```
+Modify content and push. Commits to `master` are built by GitHub Actions
+(`.github/workflows/build-hugo.yml`) and rsynced to the live server.
 
 ### News
-The news list is a simple [markdown block](_includes/news.md).
+
+The news list is a simple markdown block: [`assets/news.md`](assets/news.md).
 
 ### Projects
-Add projects to the `_projects` directory.
 
-Specify the following metatags in header:
-* `layout: project`
-* `title:` [title]
-* `image:` "/img/projects/[filename]"
-* `priority:` [int]
+Add a markdown file to [`content/projects/`](content/projects/) with front matter:
+
+```yaml
+---
+title:  "[title]"
+image: "/img/projects/[filename]"
+priority: [int]
+---
+```
 
-The body is markdown-enabled description of the project.  
-Images should be 3:2 ratio, ideally 510px * 340px.
+The body is a markdown-enabled description. Projects are listed in ascending
+`priority` order — `priority` is simply the position in the list (1 = first), so
+give each project a unique value. Images should be 3:2, ideally 510px × 340px, in
+`static/img/projects/`.
 
 ### Team Members
-Add team members to the `_team` directory. Move similarly formated entries into the `_alumni` directory as applicable.
 
-Specify the following metatags in header:
-* `firstname:` [firstname]
-* `lastname:` [lastname]
-* `priority:` [int]
-* `title:` [title]
-* `affiliation:` [department/school]
-* `website:` [url]
-* `image:` "/img/team/[filename]"
+Add an entry to [`data/team.yaml`](data/team.yaml) (move to
+[`data/alumni.yaml`](data/alumni.yaml) as applicable):
+
+```yaml
+- firstname: "[firstname]"
+  lastname: "[lastname]"
+  priority: [int]
+  title: "[title]"
+  affiliation: "[department/school]"
+  website: "[url]"        # optional
+  image: "/img/team/[filename]"   # empty string -> anon.png
+```
 
-Images should be square, ideally 450px * 450px.  
-Team member display is sorted first by priority, then by last name.
+Images should be square, ideally 450px × 450px, in `static/img/team/`.
+Members are sorted first by priority, then by last name.
 
 ### Publications
-Add/update BibTeX file as `/_pubs/wise.bib`
 
-Supports following custom fields:
-- `link`: URL to external ref, replaces `url` field. Displayed as hyperlink [(Link)](#)
-- `pdf`: URL to PDF file. Displayed as hyperlink [(PDF)](#)
-- `award`: Award mention, outputs as red text towards end of entry
+Add/update the BibTeX file [`_pubs/wise.bib`](_pubs/wise.bib) and push — that's it.
+The deploy workflow regenerates the publications list and the
+`static/bibliography/<key>.html` detail pages from it automatically
+([`scripts/gen_bib.py`](scripts/gen_bib.py)).
+
+_Optional — only to preview the publications page in a local `hugo server`:_
+
+```bash
+python3 -m venv .bibvenv && .bibvenv/bin/pip install -r scripts/requirements.txt
+.bibvenv/bin/python scripts/gen_bib.py
+```
+
+Supported custom fields (same as the old jekyll-scholar setup):
+
+- `link`: URL to an external reference. Displayed as `(Link)`.
+- `pdf`: URL to a PDF. Displayed as `(PDF)`.
+- `award`: Award mention, shown in red at the end of the entry.
+
+**NOTE:** Tilde characters (`~`) in `pdf`/`link` must be escaped as `\%7E`.
+
+## How the bibliography works
+
+Hugo has no BibTeX/citeproc engine, so [`scripts/gen_bib.py`](scripts/gen_bib.py)
+replaces jekyll-scholar: it parses `wise.bib`, renders each entry in APA style via
+`citeproc-py` + the bundled [`scripts/apa.csl`](scripts/apa.csl), groups entries by
+year (newest first), and emits the data + detail pages consumed by
+[`layouts/partials/bibliography.html`](layouts/partials/bibliography.html). Output
+matches the previous jekyll-scholar rendering.
+
+## Directory layout
+
+```
+hugo.toml                 site config
+content/                  pages (_index, about, publications) + projects/
+data/                     team.yaml, alumni.yaml, publications.json (generated)
+assets/                   css/main.scss (+ bootstrap), news.md  (Hugo Pipes)
+static/                   img/, js/, favicons, bibliography/ (generated)
+layouts/                  templates (baseof, partials, section/page layouts)
+scripts/                  gen_bib.py, apa.csl, requirements.txt
+_pubs/wise.bib            bibliography source
+```
+
+## Local Development
+
+* Install the **extended** edition of Hugo (needed for the SCSS pipeline):
+  <https://gohugo.io/installation/>
+* Preview with `hugo server` at <http://localhost:1313>
+* Build the production site into `public/` with `hugo --minify`
 
-**NOTE:**
-Tilde characters (~) in the `pdf` or `link` field must be escaped by `\%7E`
+> The publications list is generated from `_pubs/wise.bib` by the deploy workflow at
+> build time (see [Publications](#publications)) — nothing to run by hand.
+> `data/publications.json` and `static/bibliography/` are build artifacts and are
+> git-ignored; if you want the publications page to appear in a local `hugo server`
+> preview, generate them once (see below).