https://github.com/mlian031/jekyll-academic
Jekyll Academic is a lightweight theme for any academic usecase. Perfect for portfolio websites, blogs, and academia.
https://github.com/mlian031/jekyll-academic
academic academic-website github-pages jekyll jekyll-site jekyll-theme lightweight-theme portfolio-website themes
Last synced: 11 months ago
JSON representation
Jekyll Academic is a lightweight theme for any academic usecase. Perfect for portfolio websites, blogs, and academia.
- Host: GitHub
- URL: https://github.com/mlian031/jekyll-academic
- Owner: mlian031
- License: mit
- Created: 2021-04-23T15:07:46.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-08-17T21:38:19.000Z (almost 5 years ago)
- Last Synced: 2025-07-01T10:06:13.127Z (11 months ago)
- Topics: academic, academic-website, github-pages, jekyll, jekyll-site, jekyll-theme, lightweight-theme, portfolio-website, themes
- Language: HTML
- Homepage: https://jekyll-academic.netlify.app
- Size: 271 KB
- Stars: 19
- Watchers: 2
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Jekyll Academic
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.