Overview
Jasper2 is a port of Ghost’s default theme Casper v2.1.9 for Jekyll and GitHub Pages. It is a full-featured theme that includes support for multiple authors, tag descriptions and personalized covers, related posts view, pagination, code syntax highlighting, Google Analytics tracking, and Disqus comments. It provides various options for deployment, including GitHub Actions, Travis CI, and Jekyll-compatible hosters like Netlify.
Features
- Multiple Authors: Supports multiple authors via a YAML file for author information.
- Tag Descriptions and Personalized Covers: Allows for tag descriptions and personalized covers through a YAML file.
- Related Posts View: Displays a section for related posts at the bottom of each post.
- Ghost Default Pages: Includes all Ghost default pages such as author pages, tag pages, about page, and 404 page.
- Pagination: Supports infinite scrolling or standard pagination for multiple pages.
- Atom Feeds: Generates Atom Feeds using Jekyll-feed.
- Toggleable Subscribe Button: Allows for a toggleable subscribe button, which requires an external service.
- Code Syntax Highlighting: Supports code syntax highlighting using highlight.js.
- Google Analytics Tracking: Provides support for Google Analytics tracking.
- Disqus Comments: Supports Disqus comments (not Ghost standard).
Installation
To install the theme and deploy the site, there are three options:
Option 1: GitHub Actions
- Build the site with GitHub Actions, which pushes the resulting files to the gh-pages branch.
- See the
jekyll_build.ymlfile for more details.
Option 2: Local Generation
- Clone the repository (master branch) and navigate to the directory.
- Run
bundle exec jekyll serveinside the directory. - Upload the resulting
_site/contents to your repository (master branch for personal page or gh-pages branch for project page).
Option 3: Travis CI
- Set up Travis CI for your personal fork.
- Change your details in
_config.ymlto push to your GitHub repo. - Generate a secure key to add to your
.travis.ymlfile. - Refer to the documentation from
jekyll-travisfor more information.
Summary
Jasper2 is a fully-featured Jekyll theme that provides a port of Ghost’s default theme Casper. It offers support for multiple authors, tag descriptions and covers, related posts view, pagination, code syntax highlighting, Google Analytics tracking, and Disqus comments. The theme can be installed and deployed using various methods, including GitHub Actions, local generation, and Travis CI. With its wide range of features and flexibility in deployment, Jasper2 is a great choice for creating a blog or website with Jekyll and GitHub Pages.