Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions .al-folio-overrides.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
version: 1
overrides:
_includes/courses.liquid:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: _includes/courses.liquid
upstream_sha256: b302f66998945adce1c1bdd396a0123236e4c6b68d198f8bc092e4334b9d10fd
local_sha256: f2ce85b464a8356048760309f6cf35a0aaf34996f7cec776ef6f9ca5f6b05a78
acknowledged_at: '2026-10-21'
_includes/header.liquid:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: _includes/header.liquid
upstream_sha256: c8663513baded68d9fa5fbe4d6363a976535bbe201efe5138243d0ff03101058
local_sha256: c50c16b59f766a457851a638fbfb0c1202c6ae5494940264181e1372e4c5047b
acknowledged_at: '2026-10-21'
_includes/projects.liquid:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: _includes/projects.liquid
upstream_sha256: b824fbc63e1fe9cda6280f482ec51db4e6fcbfbbf4e27f55e728664dab9d4f6e
local_sha256: 067c97bc55c1c2a796e02f53a439da0708f7cf1ece6b72fee87323db1188cf8f
acknowledged_at: '2026-10-21'
_includes/repository/repo.liquid:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: _includes/repository/repo.liquid
upstream_sha256: ce87ac70cb6a8e2b1ed708b0418c638ebc4e59c4198de68bff0fc39cd5a01087
local_sha256: b0379748df59adba6ad5a58758a398d78fb339bfe4573fd50f6765377d563849
acknowledged_at: '2026-10-21'
_includes/video.liquid:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: _includes/video.liquid
upstream_sha256: 787adbfbcbd4b99982a6587ee8c5a36817c5699baf07a06b005a904532de86e4
local_sha256: 5edcffe10d07947037116a50f177703a106d93fee967e76305363e1d01b82669
acknowledged_at: '2026-10-21'
_layouts/bib.liquid:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: _layouts/bib.liquid
upstream_sha256: f3c547969ef76219ca1eb21df09dce5a3daf32a1f491b1586f68e3213fa35f53
local_sha256: 32a4010d5e303655c3af95f3aaff1f35d853297be74fb70fdbe7b218cc87fb61
acknowledged_at: '2026-10-21'
assets/css/main.scss:
owner: al_folio_core
gem_version: 1.0.15
upstream_path: assets/css/main.scss
upstream_sha256: 437c6c911c596391413e435dc0ea7095e682e85c572c1fd3fff69f9597455b3e
local_sha256: a848a0402a82ccec46b751f3184d53602352cb5bf9c6b0e3ff4b21ef4add9c21
acknowledged_at: '2026-10-21'
8 changes: 0 additions & 8 deletions .github/agents/customize.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -344,15 +344,13 @@ Always guide users to test changes locally before pushing to GitHub:
3. **Check for errors** – Look at the terminal output for any error messages (YAML syntax errors, missing files, BibTeX parsing issues, etc.).

4. **Verify visually** – Manually navigate through your site:

- Check that pages load without errors
- Verify text displays correctly
- Ensure images are visible
- Test navigation links
- Check that your changes appear as expected

5. **Test on different pages** – If you modified:

- `_config.yml` – Check the entire site (affects global settings)
- Blog posts – Check the blog page and individual post
- Publications – Check the publications page
Expand Down Expand Up @@ -436,7 +434,6 @@ Help users avoid these frequent errors:
## Boundaries

- ✅ **Always do:**

- Modify configuration files (`_config.yml`, `_data/*.yml`)
- Create/edit content files (posts, pages, projects, news)
- Update BibTeX bibliography
Expand All @@ -446,7 +443,6 @@ Help users avoid these frequent errors:
- Reference official documentation when helpful

- ⚠️ **Ask first:**

- Major structural changes to the template
- Removing core functionality or pages
- Modifying GitHub Actions workflows
Expand Down Expand Up @@ -498,21 +494,17 @@ Help users avoid these frequent errors:
When users reference issues or discussions:

1. **Accept information without requiring links** – Don't demand that users track down and share issue/discussion URLs

- ❌ Avoid: "Please provide the link to the discussion so I can help you."
- ✅ Do this: "Let me help based on what you've described. If you remember any details from the discussion, that would be helpful."

2. **Verify information against current code** – Assume advice from older discussions might be outdated

- Example: "You mentioned a solution from an older discussion. Let me check if that still applies with the current version..."
- Be prepared to offer updated guidance if the codebase has changed

3. **Acknowledge patterns while providing current guidance** – Show you understand the context but prioritize current best practices

- Example: "I see why that approach was suggested before. With our current code, here's the recommended way to do this..."

4. **Mention when discussions are particularly relevant** – If a recent discussion is very relevant, you can mention it

- Example: "This is similar to what was discussed in #67 (from December 2024), which is still the best approach."

5. **Suggest sharing solutions** – If a user's question or your solution would help the community, encourage them to update or create discussions
Expand Down
2 changes: 0 additions & 2 deletions .github/agents/docs.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,6 @@ to process your files located in `_layouts/` and `_includes/`.
## Boundaries

- ✅ **Always do:**

- Update documentation files (`*.md` in root directory)
- Keep documentation in sync with actual code and configuration
- Use existing documentation style and structure (or improve it with patterns from this agent)
Expand All @@ -143,7 +142,6 @@ to process your files located in `_layouts/` and `_includes/`.
- Preserve existing table of contents markers (`<!--ts-->` and `<!--te-->`

- ⚠️ **Ask first:**

- Major restructuring of documentation organization
- Adding entirely new documentation files
- Changing the documentation format or style guide
Expand Down
5 changes: 4 additions & 1 deletion .github/workflows/broken-links.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,4 +51,7 @@ jobs:
with:
fail: true
# removed md files that include liquid tags
args: --user-agent 'curl/7.54' --exclude-path README.md --exclude-path _pages/404.md --exclude-path _pages/blog.md --exclude-path _posts/2018-12-22-distill.md --exclude-path _posts/2023-04-24-videos.md --exclude-path _books/the_godfather.md --verbose --no-progress './**/*.md' './**/*.html'
# docs/releases is excluded because release notes link to the compare
# range for the tag they are about to create, which cannot resolve until
# the release is published
args: --user-agent 'curl/7.54' --max-retries 3 --retry-wait-time 2 --exclude-path docs/releases --exclude-path README.md --exclude-path _pages/404.md --exclude-path _pages/blog.md --exclude-path _posts/2018-12-22-distill.md --exclude-path _posts/2023-04-24-videos.md --exclude-path _books/the_godfather.md --exclude-path .github/instructions/bibtex-bibliography.instructions.md --exclude-path .github/instructions/yaml-configuration.instructions.md --exclude-path .github/instructions/markdown-content.instructions.md --exclude-path .github/instructions/liquid-templates.instructions.md --exclude-path AGENTS.md --exclude-path docs/SEO.md --exclude-path docs/SHOWCASE.md --verbose --no-progress './**/*.md' './**/*.html'
27 changes: 15 additions & 12 deletions .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,6 @@ on:
- main
paths:
- "assets/**"
- "_sass/**"
- "_scripts/**"
- "**.bib"
- "**.html"
- "**.js"
Expand All @@ -26,19 +24,17 @@ on:
- "!.github/workflows/lighthouse-badger.yml"
- "!.github/workflows/prettier.yml"
- "!lighthouse_results/**"
- "!CONTRIBUTING.md"
- "!CUSTOMIZE.md"
- "!FAQ.md"
- "!INSTALL.md"
- "!docs/CONTRIBUTING.md"
- "!docs/CUSTOMIZE.md"
- "!docs/FAQ.md"
- "!docs/INSTALL.md"
- "!README.md"
pull_request:
branches:
- master
- main
paths:
- "assets/**"
- "_sass/**"
- "_scripts/**"
- "**.bib"
- "**.html"
- "**.js"
Expand All @@ -56,10 +52,10 @@ on:
- "!.github/workflows/lighthouse-badger.yml"
- "!.github/workflows/prettier.yml"
- "!lighthouse_results/**"
- "!CONTRIBUTING.md"
- "!CUSTOMIZE.md"
- "!FAQ.md"
- "!INSTALL.md"
- "!docs/CONTRIBUTING.md"
- "!docs/CUSTOMIZE.md"
- "!docs/FAQ.md"
- "!docs/INSTALL.md"
- "!README.md"
workflow_dispatch:

Expand All @@ -83,6 +79,13 @@ jobs:
with:
python-version: "3.13"
cache: "pip" # caching pip dependencies
- name: Setup Node 🧰
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
- name: Install JS deps 📦
run: npm ci
- name: Update _config.yml ⚙️
uses: fjogeleit/yaml-update-action@main
with:
Expand Down
28 changes: 27 additions & 1 deletion .github/workflows/update-tocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ on:
- master
paths:
- "*.md"
- "docs/*.md"
workflow_dispatch:

permissions:
Expand All @@ -22,11 +23,15 @@ jobs:
with:
fetch-depth: 0 # OR "2" -> To retrieve the preceding commit.

- uses: actions/setup-node@v4

- name: Get changed files
id: changed-files
uses: tj-actions/changed-files@ed68ef82c095e0d48ec87eccea555d944a631a4c # v46
with:
files: ./*.md
files: |
./*.md
docs/*.md

- name: Updated toc on all markdown changed files
env:
Expand All @@ -43,6 +48,27 @@ jobs:
done
rm gh-md-toc

# gh-md-toc and Prettier disagree about escaping in link text: the TOC
# generator emits `_config.yml` where Prettier requires `\_config.yml`.
# Without this step the auto-commit lands unformatted and prettier.yml
# immediately goes red on main. Prettier gets the last word.
- name: Normalize TOC formatting 🎨
env:
ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
run: |
# `npm ci` installs from the lockfile and does not touch package.json or
# package-lock.json. `npm install --save-dev` would rewrite the caret
# ranges to exact pins and upgrade them, and because the auto-commit step
# below sets no file_pattern (default `.`), those dependency changes would
# be committed to main under the message "Auto update markdown TOC".
npm ci
for file in ${ALL_CHANGED_FILES}; do
if [[ "$file" != *.md ]]; then
continue
fi
npx prettier --write "$file"
done

- name: Commit changes
if: steps.changed-files.outputs.any_changed == 'true'
uses: stefanzweifel/git-auto-commit-action@v5.0.1
Expand Down
59 changes: 59 additions & 0 deletions .github/workflows/upgrade-check.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
name: Upgrade contract checks

on:
push:
branches:
- master
- main
- v1.0-dev
paths:
- "_config.yml"
- "_data/**"
- "_pages/**"
- "_posts/**"
- "_projects/**"
- "assets/**"
- "Gemfile"
- "Gemfile.lock"
- "test/integration_upgrade_cli.sh"
- ".github/workflows/upgrade-check.yml"
pull_request:
branches:
- master
- main
- v1.0-dev
paths:
- "_config.yml"
- "_data/**"
- "_pages/**"
- "_posts/**"
- "_projects/**"
- "assets/**"
- "Gemfile"
- "Gemfile.lock"
- "test/integration_upgrade_cli.sh"
- ".github/workflows/upgrade-check.yml"

jobs:
upgrade-check:
runs-on: ubuntu-latest
steps:
- name: Checkout 🛎️
uses: actions/checkout@v4

- name: Setup Ruby 💎
uses: ruby/setup-ruby@v1
with:
ruby-version: "3.3.5"
bundler-cache: true

- name: Run upgrade audit 🧪
run: bundle exec al-folio upgrade audit

- name: Upload upgrade report 📄
if: always()
uses: actions/upload-artifact@v4
with:
name: al-folio-upgrade-report
path: al-folio-upgrade-report.md
if-no-files-found: ignore
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,6 @@ vendor
context/
CLAUDE.md
.claude/
al-folio-upgrade-report.md
__pycache__/
*.pyc
9 changes: 3 additions & 6 deletions .prettierignore
Original file line number Diff line number Diff line change
@@ -1,14 +1,11 @@
**/*.map
**/*.min.css
**/*.min.js
assets/css/main.scss
assets/js/distillpub/template.v2.js
assets/js/search/*.js
assets/plotly/demo.html
lighthouse_results/**
_posts/2015-10-20-math.md
_sass/font-awesome/*.scss
_sass/tabler-icons/*.scss
_scripts/*
# Ignore citation YAML file generated by script
_data/citations.yml
assets/css/main.scss
# Generated by `al-folio upgrade overrides accept`
.al-folio-overrides.yml
Loading
Loading