{"full_name":"alshedivat/al-folio","owner":"alshedivat","name":"al-folio","shard":"1","url":"https://github.com/alshedivat/al-folio","description":"A beautiful, simple, clean, and responsive Jekyll theme for academics","homepage":"https://alshedivat.github.io/al-folio/","topics":["jekyll","jekyll-theme","academic","academic-website","personal-website","portfolio-website","theme","github-pages","jekyll-blog","hacktoberfest"],"tag_pages":["academic","academic-website","github-pages","hacktoberfest","jekyll","jekyll-theme","personal-website","portfolio-website","theme"],"language":"HTML","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/2126561?u=b434cef91a8c7021cfdcb1e8d918597b78b28036&v=4","created_at":"2016-05-30T16:32:46Z","pushed_at":"2026-11-13T16:50:33Z","metrics":{"stars":16350,"forks":13034,"watchers":37,"issues":733,"prs":2072,"releases":46,"issues_open":13,"issues_closed":720,"prs_open":4,"prs_closed":1275,"prs_merged":793,"discussions":604},"growth":{"day":{"stars":4,"forks":0,"base_day":"2026-11-15"},"week":{"stars":51,"forks":1,"base_day":"2026-11-04"},"month":{"stars":97,"forks":-36,"base_day":"2026-10-17"}},"history":{"dates":["2026-09-06","2026-09-07","2026-09-08","2026-09-09","2026-09-10","2026-09-11","2026-09-12","2026-09-13","2026-09-14","2026-09-15","2026-09-16","2026-09-17","2026-09-18","2026-09-19","2026-09-20","2026-09-21","2026-09-22","2026-09-23","2026-09-24","2026-09-25","2026-09-26","2026-09-27","2026-09-28","2026-09-29","2026-09-30","2026-10-01","2026-10-02","2026-10-03","2026-10-04","2026-10-05","2026-10-06","2026-10-07","2026-10-08","2026-10-09","2026-10-10","2026-10-11","2026-10-12","2026-10-13","2026-10-14","2026-10-15","2026-10-16","2026-10-17","2026-10-18","2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[16088,16097,16099,16104,16112,16118,16123,16127,16130,16132,16144,16149,16151,16156,16160,16167,16171,16178,16178,16187,16196,16202,16208,16211,16215,16218,16215,16220,16224,16226,16227,16230,16231,16232,16235,16233,16235,16235,16241,16245,16251,16253,16257,16260,16260,16261,16267,16268,16271,16270,16271,16274,16275,16278,16283,16287,16288,16289,16292,16299,16325,16334,16337,16340,16344,16346,16350],"forks":[13083,13083,13082,13083,13084,13085,13084,13084,13084,13082,13080,13079,13079,13077,13079,13077,13083,13082,13083,13078,13079,13080,13084,13081,13077,13080,13082,13083,13081,13079,13073,13072,13073,13073,13073,13069,13069,13073,13072,13069,13070,13070,13065,13060,13059,13060,13058,13053,13051,13051,13052,13045,13043,13039,13040,13040,13040,13035,13032,13033,13033,13039,13035,13035,13034,13034,13034],"watchers":[41,42,42,42,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,40,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,41,36,36,36,36,36,36,36,36,36,36,37,null,37,37,37,37,37,37],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,12,12,12,12,12,13],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,2,2,3,4,4,4]},"boards":{},"same_owner":[],"issues":[{"number":3706,"title":"[Bug] GitHub Actions deployment fails on Ubuntu 26.04 due to unavailable Ruby 3.3.5","comments":8,"created_at":"2026-10-24T23:20:13Z"},{"number":2167,"title":"[Feature Request] automatically generate pulications in the CV from .bib file","comments":6,"created_at":"2024-02-07T10:11:50Z"},{"number":3629,"title":"using github-readme-stats-action and github-stats-extended","comments":5,"created_at":"2026-05-28T12:25:46Z"},{"number":2273,"title":"Adding secondary chapter navigation on left side like just-the-docs jekyll theme ","comments":5,"created_at":"2024-03-13T13:35:34Z"},{"number":2531,"title":"Allow the Table of Contents to be expanded to show subsections and collapsed to hide subsections.","comments":3,"created_at":"2024-06-29T04:27:24Z"},{"number":1264,"title":"Sort publication by abbr property, e.g., journal paper, conf paper, book, and so on","comments":3,"created_at":"2023-03-16T07:02:52Z"},{"number":2087,"title":"Implement `axe` accessibility suggestions","comments":2,"created_at":"2024-01-16T18:32:19Z"},{"number":3700,"title":"Fresh sites get a high-severity Dependabot alert: css_parser < 3.0.0 pinned by jekyll-3rd-party-libraries","comments":1,"created_at":"2026-09-03T03:12:02Z"}],"discussions":[{"number":3710,"title":"How to upgrade from pre-v1.0 version when I don't recall if fork or template install was used","comments":1,"category":"Q&A","created_at":"2026-11-10T19:53:42Z"},{"number":3701,"title":"How to tell which version of al-folio am I using?","comments":2,"category":"Q&A","created_at":"2026-09-07T19:18:50Z"},{"number":3699,"title":"Massively Speeding up LLM inference with Speculative Diffusion Decoding | Ferdinando (Nando) Fioretto","comments":1,"category":"Comments","created_at":"2026-08-15T19:40:20Z"},{"number":3691,"title":"CV Layout: Stray bullet point and layout misalignment in date/location column","comments":1,"category":"Q&A","created_at":"2026-07-30T22:35:18Z"},{"number":3650,"title":"How to change color","comments":3,"category":"Q&A","created_at":"2026-06-20T23:51:25Z"},{"number":3643,"title":"Adding new sections to CV when using rendercv","comments":0,"category":"Q&A","created_at":"2026-06-10T06:14:07Z"},{"number":3639,"title":"Constrained Discrete Diffusion for Language, Chemistry, and Code | Ferdinando (Nando) Fioretto","comments":0,"category":"Comments","created_at":"2026-06-05T18:46:01Z"},{"number":3637,"title":"Unexpected popup \"https://polyfill.io/\" when using an older al-folio template;","comments":1,"category":"General","created_at":"2026-06-02T08:21:09Z"}],"latest_release":{"name":"al-folio v1.2","tag":"v1.2","published_at":"2026-08-09T11:52:29Z","body":"v1.2 is a feature release: **three new plugins**, two dead third-party services retired, and a batch of fixes for things that were failing silently — a script 404, a favicon 404, a flickering theme switch.\n\nAs in v1.1, most of the change is in the gems rather than in this repo.\n\n> **`bundle update` on its own will not upgrade you.** The `Gemfile` pins every plugin to an exact version, and Bundler honours the pin already in _your_ `Gemfile` — so a v1.1 site runs `bundle update` and stays exactly where it is, with no error. **You must edit the pins first** — see **Upgrading** at the bottom.\n\n| gem                | v1.1   | v1.2       |\n| ------------------ | ------ | ---------- |\n| `al_folio_core`    | 1.0.12 | **1.0.15** |\n| `al_cookie`        | 1.0.0  | **1.0.1**  |\n| `al_email_protect` | —      | **1.0.1**  |\n| `al_marimo`        | —      | **1.0.0**  |\n| `al_rtl`           | —      | **1.0.0**  |\n\n---\n\n## ✨ Three new plugins\n\nAll three are **off by default** and cost nothing until a page or a flag opts in.\n\n**[`al_rtl`](https://github.com/al-org-dev/al-rtl) — right-to-left languages** (closes #3544, from [#946](https://github.com/alshedivat/al-folio/pull/946))\nSet `lang: fa` (or `ar`, `he`, `ur`, `ps`, `sd`, `ug`, `yi`, …) in a page's front matter and it renders right-to-left. Direction is set with `dir` on `<html>` rather than on a wrapper `div` as the original proposal did — that is what makes the navbar, footer, scrollbar placement and the browser's own bidi algorithm mirror, not just the article text. Code, shell transcripts, BibTeX and rendered maths are deliberately held left-to-right inside RTL prose, since letting them inherit `rtl` reorders operators and punctuation into nonsense. See the demo post, `يک نوشتهٔ راست‌چين`.\n\n**[`al_marimo`](https://github.com/al-org-dev/al-marimo) — runnable Python notebooks** (closes #3541, from [#3517](https://github.com/alshedivat/al-folio/pull/3517))\nAdd `marimo: true` to a post and fenced Python blocks wrapped in `.al-marimo-inline` become an interactive [marimo](https://marimo.io) notebook; `{% al_marimo_embed %}` embeds a hosted one. The `marimo-snippets` runtime is **vendored at a pinned version** with its digest recorded, rather than pulled from a CDN at an unpinned major as the source PR did — that shape is how the polyfill.io supply-chain attack worked, and SRI cannot fix it here because the CDN serves a dynamically minified build. Embedded notebooks are sandboxed **without** `allow-same-origin`.\n\n**[`al_email_protect`](https://github.com/al-org-dev/al-email-protect) — email obfuscation** (closes #3540, from [#3532](https://github.com/alshedivat/al-folio/pull/3532))\nSet `protect_email: true` and addresses rendered through `{% al_email_protect_link %}` or `{{ … | al_email_obfuscate }}` are split at build time — no `user@host` and no `mailto:` in the HTML at all — and clicking copies to the clipboard instead of opening a mail client. The build-time part is the point: harvesters parse markup and do not run your JavaScript, so a client-side rewrite protects nobody.\n\n> **Scope, stated plainly:** this applies where a layout calls the tag or filter. It does **not** yet cover the social links in the navbar and footer — those are rendered by the third-party `jekyll-socials` gem, which owns the whole block and offers no hook for the email entry. 1.0.1 ships `al_email_protect_html`, a filter that rewrites `mailto:` anchors in already-rendered HTML, which is the interception point that fixes this; wiring `al_folio_core`'s layouts through it is landing in v1.2.1. If you enable the flag today, expect the CV and any addresses you render yourself to be protected, and the socials icons not to be.\n\n## 🐛 Fixes\n\n**The theme switch flickered** (`al_folio_core` 1.0.15) — headings changed colour visibly later than the text around them. `color`, `fill` and `stroke` are inherited properties, but were transitioned on `html.transition *`, so every inheriting element ran its own 240ms ease toward a par","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}