Skip to content
a stylish Jekyll theme
Branch: gh-pages
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_data
_includes
_layouts
_posts
images
styles
.gitignore
README.md
_config.yml
archive.html
category.html
feed.xml
index.html
page.md
tags.html

README.md

tranquil-theme

Tranquil theme (demo) is a stylish Jekyll template originally designed for my blog.

Features

  • Responsive design
  • Mathematics with Latex notation
  • Comment threads
  • Pagination
  • Browsing by categories/tags
  • Archive: posts timeline
  • Homepage slider of feature posts
  • Blog widgets
  • Back to top button
  • Vintage fashion

Quick-start guide

  1. Assume you already installed Jekyll following instructions.
  2. Fork and clone tranquil-theme.
  3. Edit site options in _config.yml, create your own posts in _post/.
  4. Run jekyll serve under site directory and your site is on now!

Some notes

  • edit your social accounts in _data/social.yaml
  • assign ONE category for each post
  • add feature into tags if you want to show post at homepage slider
  • go to images/ and place sidebar portrait pic and ads pic
  • if MathJax is enabled, use \[...\] for displayed mathematics and \(...\) for in-line mathematics
  • ADVANCED: if you want to further customize your site, look over Jekyll to understand how it works, also check html/css/javascript tutorials and liquid language to learn code.

site configurations

Variable Description
baseurl the subpath of the site
paginate posts per pagination
disqus_forumname create a site on disqus and put the forum name here
aboutme a description about self
ads ads banner image path

post configurations

Variable Description
background post's feature picture
category put ONE category for each post
tags a list of tags
math set true or false to enable MathJax mathematics
You can’t perform that action at this time.