Academic Pages is a GitHub Pages template for building personal and professional portfolio websites using Jekyll, HTML, and Markdown.
The template addresses the need for academics and professionals to quickly establish an online presence without managing complex web infrastructure. It works by providing a pre-configured Jekyll site that deploys directly to GitHub Pages, eliminating hosting concerns. The setup process involves forking the template, renaming the repository to match GitHub's username.github.io convention, and editing configuration files. The template includes optional tooling to generate publication and talk listings from TSV files using Jupyter notebooks or Python scripts, streamlining the process of maintaining a publications section.
Academic Pages suits anyone building a portfolio-oriented website who wants to avoid web hosting setup and prefers writing content in Markdown. It works well for academics, researchers, and professionals who need a straightforward way to showcase their work and publications. The template supports local development through Jekyll with live-reload functionality, and provides Docker support for developers who prefer not to install Ruby dependencies directly. The README includes guidance for multiple operating systems and IDEs, with troubleshooting steps for common permission and dependency issues.
The project maintains a substantial user base, with nearly all open issues originating from adopters rather than the core team. Maintainers typically respond to new issues and pull requests within a day. Work in the issue tracker centers on documentation, bug clarifications, and enhancement requests.
