# alshedivat/al-folio **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/alshedivat-al-folio).** 15,759 stars · 13,073 forks · HTML · MIT ## Links - GitHub: https://github.com/alshedivat/al-folio - Homepage: https://alshedivat.github.io/al-folio/ - awesome-repositories: https://awesome-repositories.com/repository/alshedivat-al-folio.md ## Topics `academic` `academic-website` `github-pages` `hacktoberfest` `jekyll` `jekyll-blog` `jekyll-theme` `personal-website` `portfolio-website` `theme` ## Description al-folio is a Jekyll academic theme and portfolio generator designed for researchers and professors to build professional homepages, lab sites, and research profiles. It functions as a system for creating a digital academic identity, combining a website template with tools for scientific and academic publishing. The project distinguishes itself through specialized scholarly workflows, such as automated publication lists and bibliography management driven by BibTeX files. It provides specific layouts for digital academic CVs, research portfolios, and the rendering of mathematical expressions and technical diagrams. The platform covers a broad range of academic content capabilities, including course showcases, project grids, and research blog management. It supports technical media integration such as syntax-highlighted code, interactive data visualizations, and vector drawings. General site utility is provided through theme customization with light and dark mode toggling and social preview configuration for search and social media discovery. ## Tags ### Part of an Awesome List - [Project Website Templates](https://awesome-repositories.com/f/awesome-lists/devtools/readme-generators-and-templates/academic-document-templates/project-website-templates.md) — Generates coordinated academic homepages, blog and lab sites using research-oriented website templates. ([source](https://cdn.jsdelivr.net/gh/alshedivat/al-folio@main/README.md)) - [Project Showcase Grids](https://awesome-repositories.com/f/awesome-lists/devtools/grid-systems/project-showcase-grids.md) — Builds flexible project showcase grids for displaying research work with images and captions. ([source](https://alshedivat.github.io/al-folio/projects/1_project/)) ### Content Management & Publishing - [Static Site Generators](https://awesome-repositories.com/f/content-management-publishing/static-site-generators.md) — Transforms Markdown source files and YAML metadata into a standalone set of static HTML files via Jekyll. - [Academic Website Themes](https://awesome-repositories.com/f/content-management-publishing/academic-website-themes.md) — Provides a complete Jekyll-based website template for researchers and professors to render publications and CVs. - [Bibliographic Citation Management](https://awesome-repositories.com/f/content-management-publishing/bibliographic-citation-management.md) — Automates the generation of numerical inline citations and complete bibliography appendices in research documents. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) - [Bibliographic Publication Lists](https://awesome-repositories.com/f/content-management-publishing/bibliographic-publication-lists.md) — Automatically generates formatted lists of academic works and bibliography sections from citation files with PDF and DOI support. - [Interactive Technical Blogs](https://awesome-repositories.com/f/content-management-publishing/blog-newsletter-publishing/interactive-technical-blogs.md) — Hosts a research blog designed for technical content with integrated interactive data visualizations. ([source](https://alshedivat.github.io/al-folio/)) - [Technical Content Renderers](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/markdown-markup-tools/markdown-tools/technical-content-renderers.md) — Renders a combination of markdown, LaTeX, and syntax-highlighted code for technical academic publishing. - [Bibliography Generators](https://awesome-repositories.com/f/content-management-publishing/documentation-knowledge-management/bibliography-generators.md) — Automatically compiles and formats scholarly publication lists and citation appendices from BibTeX files. - [Research Portfolio Templates](https://awesome-repositories.com/f/content-management-publishing/static-site-generators/research-portfolio-templates.md) — Provides static site templates designed for showcasing academic research papers and institutional affiliations in a responsive grid. - [Category Organizations](https://awesome-repositories.com/f/content-management-publishing/category-organizations.md) — Groups related pages into named collections, such as news or projects, for automated listing and filtering. - [Chronological Content Organization](https://awesome-repositories.com/f/content-management-publishing/chronological-content-organization.md) — Organizes dated announcements in chronological order to provide visitors with a feed of recent activities. ([source](https://alshedivat.github.io/al-folio/)) - [Syntax Highlighting](https://awesome-repositories.com/f/content-management-publishing/documentation-knowledge-management/syntax-highlighting.md) — Renders syntax-highlighted code blocks across multiple languages with support for custom line numbering. ([source](https://alshedivat.github.io/al-folio/blog/2015/code/)) - [Diagram Renderers](https://awesome-repositories.com/f/content-management-publishing/markdown-renderers/diagram-renderers.md) — Generates sequence diagrams and flowcharts directly from human-readable text definitions within the site content. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) - [Page Layout Adjustments](https://awesome-repositories.com/f/content-management-publishing/page-layout-adjustments.md) — Provides predefined styles to adjust content width for body text, full-screen elements, and marginal gutters. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) ### Education & Learning Resources - [Academic Portfolio Sites](https://awesome-repositories.com/f/education-learning-resources/academic-research-access/academic-portfolio-sites.md) — Provides a professional platform for scholars to document their research output and instructional materials. - [Course Showcases](https://awesome-repositories.com/f/education-learning-resources/educational-resources/algorithms-theory-academics/academic-curricula-resources/academic-course-materials/course-showcases.md) — Provides structured displays for collections of courses organized by term, including schedules and materials. ([source](https://alshedivat.github.io/al-folio/teaching/)) ### Business & Productivity Software - [Academic CV Structures](https://awesome-repositories.com/f/business-productivity-software/academic-cv-structures.md) — Provides professional layouts specifically tailored for organizing scholarly achievements and research-focused curriculum vitae. ([source](https://alshedivat.github.io/al-folio/cv/)) - [Research Homepage Layouts](https://awesome-repositories.com/f/business-productivity-software/academic-cv-structures/research-homepage-layouts.md) — Provides structured website layouts designed specifically to showcase scholarly publications and academic achievements. ### Development Tools & Productivity - [Professional Profiles](https://awesome-repositories.com/f/development-tools-productivity/professional-profiles.md) — Displays professional biography and contact pages tailored for academics and researchers. ([source](https://alshedivat.github.io/al-folio/people/)) ### Software Engineering & Architecture - [Document Front-Matter Configurations](https://awesome-repositories.com/f/software-engineering-architecture/environment-driven-feature-configurations/metadata-configurations/document-front-matter-configurations.md) — Uses YAML front-matter in Markdown files to define page-specific layouts, settings, and social preview metadata. ### User Interface & Experience - [Mathematical Expression Serializers](https://awesome-repositories.com/f/user-interface-experience/content-serializers/mathematical-expression-serializers.md) — Renders professional mathematical expressions in inline and display modes by transforming LaTeX markup into HTML. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) - [Publication List Generators](https://awesome-repositories.com/f/user-interface-experience/list-views/automated-list-generators/publication-list-generators.md) — Automatically renders formatted scholarly publication lists from bibliography files with integrated PDF and DOI support. ([source](https://alshedivat.github.io/al-folio/)) - [Page Layout Templates](https://awesome-repositories.com/f/user-interface-experience/page-layout-templates.md) — Employs a templating language to inject dynamic content into predefined HTML shells for consistent page structures. - [Adaptive Color Schemes](https://awesome-repositories.com/f/user-interface-experience/adaptive-color-schemes.md) — Manages distinct light and dark mode color schemes for automatic interface updates based on user preference. ([source](https://cdn.jsdelivr.net/gh/alshedivat/al-folio@main/README.md)) - [Chart Embeddings](https://awesome-repositories.com/f/user-interface-experience/chart-embeddings.md) — Integrates dynamic scatter plots and line charts within research posts using a specialized visualization library. ([source](https://alshedivat.github.io/al-folio/blog/2025/plotly/)) - [Light and Dark Theme Implementations](https://awesome-repositories.com/f/user-interface-experience/css-variable-theming/light-and-dark-theme-implementations.md) — Implements light and dark mode transitions using global CSS custom properties based on user preference. - [Social Media Link Icons](https://awesome-repositories.com/f/user-interface-experience/links/internal-page-link-resolvers/header-anchors/social-media-link-icons.md) — Integrates a comprehensive library of social and academic icons for linking to professional profiles. ([source](https://alshedivat.github.io/al-folio/people/)) - [Page Marginalia](https://awesome-repositories.com/f/user-interface-experience/page-marginalia.md) — Implements a marginalia system for placing context-providing references and images in the page margins. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) - [Professional Link Iconography](https://awesome-repositories.com/f/user-interface-experience/professional-link-iconography.md) — Displays professional biographies and social media links using a standardized library of academic and professional icons. ([source](https://alshedivat.github.io/al-folio/)) - [Responsive Grid Systems](https://awesome-repositories.com/f/user-interface-experience/responsive-grid-systems.md) — Implements responsive grid systems to consistently format collections of photos, audio, and video across devices. ([source](https://cdn.jsdelivr.net/gh/alshedivat/al-folio@main/README.md)) - [Rich Text Renderers](https://awesome-repositories.com/f/user-interface-experience/rich-text-renderers.md) — Transforms structured data into rich blog posts featuring interactive charts, tabs, and technical diagrams. ([source](https://alshedivat.github.io/al-folio/blog/)) - [Vector Graphics Rendering](https://awesome-repositories.com/f/user-interface-experience/vector-graphics-rendering.md) — Renders high-quality vector graphics by porting complex drawings from LaTeX sources. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) - [Theme Customization](https://awesome-repositories.com/f/user-interface-experience/visual-theme-configurations/visual-themes/theme-customization.md) — Allows users to personalize the site appearance through accent colors and custom CSS assignments. ([source](https://cdn.jsdelivr.net/gh/alshedivat/al-folio@main/README.md)) ### Data & Databases - [Interactive Data Charting](https://awesome-repositories.com/f/data-databases/interactive-data-charting.md) — Generates responsive, interactive charts and graphs using JSON configurations and iframe embeddings. ([source](https://alshedivat.github.io/al-folio/blog/2021/distill/)) ### Scientific & Mathematical Computing - [LaTeX Math Rendering](https://awesome-repositories.com/f/scientific-mathematical-computing/numerical-mathematical-foundations/mathematical-typesetting-engines/mathematical-typesetting/latex-math-rendering.md) — Supports the rendering of mathematical formulas using LaTeX syntax within the web interface. ### Web Development - [Content Collection Managers](https://awesome-repositories.com/f/web-development/api-management-tools/content-static-site-generation/content-collection-managers.md) — Organizes site content into distinct collections like news or projects for automated grid displays. ([source](https://cdn.jsdelivr.net/gh/alshedivat/al-folio@main/README.md))