Repolode
Submit
alshedivat

alshedivat/al-folio

A Jekyll starter template for building academic websites with publications, CV, blog, and project pages.

View on GitHubWebsite
Stars
16,314
Forks
13,035
Open issues
13
Last commit
4 days ago

What is it?

al-folio is a Jekyll starter for academic homepages. It generates a publications page from a BibTeX bibliography, a CV page from a cv.yml or resume.json file, and a people page from data files, so most content is edited as data rather than templates.

Since v1.x the project is a thin starter: runtime features such as layouts, search, analytics, comments, math and charts are provided by separately versioned Ruby gem plugins that are pinned in the Gemfile. The site also ships with light and dark mode, a blog with distill-style layouts, MathJax and TikZ support, and a repositories page that renders GitHub stats.

Some features, such as comments, analytics, cookie consent and newsletter signup, render nothing until the user supplies the relevant key or ID. The project includes agent-oriented instructions and migration skills for upgrading customized forks.

Key features

  • 01Publications generated from a BibTeX bibliography
  • 02CV page built from cv.yml or resume.json
  • 03Blog with distill-style layouts, MathJax, TikZ and syntax-highlighted code
  • 04Light and dark mode with system preference detection
  • 05Full-text search and an Atom feed
  • 06Optional comments, analytics, cookie consent and newsletter signup

Use cases

  • Building a personal homepage for a researcher with a publication list
  • Maintaining a CV that is generated from a structured data file
  • Running a lab or course website with projects and teaching collections
  • Writing technical blog posts with math and diagrams on GitHub Pages

Quick start

  1. 1

    Click "Use this template" on GitHub to create your own copy of the repository

  2. 2

    Follow the setup guide in docs/QUICKSTART.md to install and run the site

Things to know

  • Some features, such as comments, analytics and newsletter signup, render only after you add a key, ID or credential.
  • It is a Jekyll site, so running it locally requires a Ruby and Jekyll environment.

In collections

Static site generators & documentation tools

Topics

#jekyll#academic-website#personal-website#github-pages#portfolio#blog#bibtex#theme#academic#hacktoberfest

FAQ

What is al-folio?
A Jekyll starter template for building academic websites with publications, CV, blog, and project pages. al-folio is a Jekyll starter for academic homepages. It generates a publications page from a BibTeX bibliography, a CV page from a cv.yml or resume.json file, and a people page from data files, so most content is edited as data rather than templates.
Is al-folio free to use? What license does it have?
al-folio is open source under the MIT license. Check the license terms before using it in commercial products.
Is al-folio still maintained?
Actively maintained. The last commit to al-folio was on Nov 4, 2026.
What can I use al-folio for?
Building a personal homepage for a researcher with a publication list Maintaining a CV that is generated from a structured data file Running a lab or course website with projects and teaching collections Writing technical blog posts with math and diagrams on GitHub Pages
How do I install al-folio?
Click "Use this template" on GitHub to create your own copy of the repository Follow the setup guide in docs/QUICKSTART.md to install and run the site
Where can I get al-folio?
The source code and installation instructions are on GitHub: https://github.com/alshedivat/al-folio

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects