JekyllPortfolioBlog

jekyll-academic — Jekyll Portfolio Template

By mlian031

Jekyll Academic is a lightweight Jekyll theme for academic use, suitable for portfolio websites, blogs, and academic pages.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

Lightweight Jekyll theme for academic scenarios, usable for portfolios, blogs, and academic pages

02

Provides RSS and JSON feeds

03

Supports a blog search bar based on tag categories

04

Optional Disqus comments and a custom 404 page

05

Markdown enhancements support Highlightjs, MathJax, ChartJs, and FontAwesome/Bootstrap Icons

06

SEO configuration includes robots.txt, sitemap.xml, and jekyll-seo-tag

Template Details

Jekyll Academic is a Jekyll-based theme positioned by its author as a lightweight option for academic scenarios, suitable for portfolio websites, blogs, and academic use. The theme provides RSS and JSON feeds, optional Disqus comments, a blog search bar based on tag categories, and a custom 404 page. For Markdown, it supports enhancements such as Highlightjs, MathJax, ChartJs, and FontAwesome/Bootstrap Icons. SEO-related configuration includes robots.txt, sitemap.xml, and jekyll-seo-tag. There are two installation methods: quick installation via a script, or adding jekyll-academic to the Gemfile of a Jekyll site, setting the theme in _config.yml, and running bundle install; alternatively, clone the repository directly, run bundle install, and preview locally with bundle exec jekyll serve. Before use, edit _config.yml; more configuration details are available in the project documentation. The repository uses the MIT license, and the free scope covers the code of this version; third-party assets such as demo images, fonts, and icons must be checked against their respective licenses, and external services such as domains and hosting may incur separate charges.

JekyllPortfolioBlog

Is it right for your project?

Use Cases

  • Building a personal academic homepage or portfolio website
  • Publishing a technical or academic blog with tag categories and search
  • Static sites that need RSS/JSON subscriptions and basic SEO configuration
  • Content pages where you want to use mathematical formulas, charts, and icons directly in Markdown

Suitable For

  • Developers or researchers building static sites with Jekyll
  • Academic users who need a combined portfolio and blog site
  • Users who prefer a lightweight theme and configure it by editing _config.yml themselves

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    For quick installation, run the bundle-install.sh script provided by the repository

  2. 2

    Manual installation: add gem "jekyll-academic" to the Gemfile, set theme: jekyll-academic in _config.yml, then run bundle install

  3. 3

    You can also clone the repository directly and run bundle install

  4. 4

    For local preview, use bundle exec jekyll serve; the default address is localhost:4000

  5. 5

    Site customization requires editing _config.yml; see the project documentation page for more configuration

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope covers the code of this version and does not mean that external services or third-party assets are free.

Must comply with when using

  • You may use, modify, commercialize, and distribute the code of this version for free.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Disqus comments are optional; enabling them requires registering a Disqus account and depends on its third-party service, which may be subject to its terms of service and fee policies.
  • Markdown enhancements depend on third-party libraries such as Highlightjs, MathJax, ChartJs, and FontAwesome/Bootstrap Icons; you must check their respective licenses when using and distributing them.
  • The quick installation script pulls from GitHub remotely and executes directly; it requires internet access to external services, and you should review the script content before running it.
  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Optional Disqus comments

Original README

Enhanced Markdown (Highlightjs, MathJax, ChartJs, FontAwesome/Bootstrap Icons)

Original README

$ curl -s -L https://raw.githubusercontent.com/yak-fumblepack/jekyll-academic/master/scripts/bundle-install.sh | bash

Original README
https://github.com/mlian031/jekyll-academic/blob/master/LICENSE.txthttps://github.com/mlian031/jekyll-academic/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 77 / 100
Technologies
Jekyll
Website type
Portfolio · Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2021-08-17
Screenshot last checked
2026-10-02

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 4e32394f2ac13ff897072a5ef2ee677be7e6980e5ea1970dae9531a4ab417947

2026-10-02T10:51:58.646Z

Source file / repository
# Jekyll Academic

![Gem](https://img.shields.io/gem/v/jekyll-academic?color=orange&style=plastic)
![Gem](https://img.shields.io/gem/dt/jekyll-academic?color=blue&style=plastic)

Jekyll Academic is a lightweight theme for any academic usecase. Perfect for portfolio websites, blogs, and academia. It is a simple no nonsense theme that offers many features.

[Live preview](https://jekyll-academic.netlify.app)

- Ultra-fast serving times, only ~2.6kb of CSS
- 99/100 Performance on Lighthouse
- 100/100 SEO on Lighthouse
- RSS and JSON feed
- Enhanced Markdown (Highlightjs, MathJax, ChartJs, FontAwesome/Bootstrap Icons)
- Optional Disqus comments
- Search bar with blog categorisation based on tags
- Custom 404 page
- SEO optimised (robots.txt, sitemap.xml, jekyll-seo-tag)

## Contents
- [Jekyll Academic](#jekyll-academic)
  - [Contents](#contents)
  - [Installation](#installation)
    - [Quick install](#quick-install)
    - [Longer installation process](#longer-installation-process)
  - [Usage](#usage)
  - [Contributing](#contributing)
  - [License](#license)

## Installation

### Quick install

```shell
$ curl -s -L https://raw.githubusercontent.com/yak-fumblepack/jekyll-academic/master/scripts/bundle-install.sh | bash
```

### Longer installation process

Add this to your Jekyll site's Gemfile:

```ruby
gem "jekyll-academic"
```

And add this line to your Jekyll site's `_config.yml`:

```yaml
theme: jekyll-academic
```

Then execute:

```shell
$ bundle install
```

or install it yourself as a Gem:

```shell
$ gem install jekyll-academic
```

OR 

```shell
$ git clone https://github.com/yak-fumblepack/jekyll-academic.git
```

```shell
$ bundle install
```

Then finally to view your site (default is [localhost:4000]()):

```shell
$ bundle exec jekyll serve
```

## Usage

To make it yours, edit the `_config.yml` file or refer to our [docs](https://jekyll-academic.netlify.app/docs) for further configuration.

Have fun building your amazing site!

## Contributing

Bugfixes and features are most welcome and appreciated. For features and bugfixes, please make the pull request onto the `dev` branch. If you're looking to improve the documentation, make the pull request onto `docs-pages`.

Is there a bug? Feel free to open an issue.

## Development 

Fork this repo

```shell
$ git clone https://github.com/yak-fumblepack/jekyll-academic.git/
$ cd jekyll-academic/
$ bundle install
$ bundle exec jekyll serve
```

And view it on [localhost:4000]()

Then make your amazing contributions and changes!

## License

This project is licensed under [MIT](https://opensource.org/licenses/MIT). See [LICENSE](https://github.com/yak-fumblepack/jekyll-academic/blob/master/LICENSE.txt) file for more details.
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.