Jane is a readable theme for Hugo. It's a fork of the hugo-theme-even and made a lot of changes.
This theme focuses on improving reading experience.
Other Key features:
- Responsive and mobile friendly
- Multilingual Mode support
- Shortcodes : image, blockquote, music, etc.
- Separate design for Tags & Categories Page
- Social network linking
- Better Pagination, TOC, footnote behavior
- Use the awesome Chroma syntax highlighting
- Custom css, Custom js, Custom head support
- Sub menu support
- Search Optimization
Who use Hugo-theme-Jane
- ATFeng - A beautiful blog fork from Jane.
- Jack Baty's Blog - Thousands of posts on the site powered by Hugo & Theme Jane.
- Notes on Blue Skies - Personal blog in Russian by @paskal
- 贤民的比特记忆 - A Chinese blog.
- 虞双齐爱折腾 - @ysqi 个人技术博客.
- Waiting to add more...
1. Quick Install Hugo
Download the appropriate version for your platform from Hugo Releases. Once downloaded, the binary can be run from anywhere. Ideally, you should install it somewhere in your
PATH for easy use.
/usr/local/bin is the most probable location.
2. Quick Create a New Site
hugo new site myBlog
The above will create a new Hugo site in a folder named
3. Quick Use Hugo-Theme-Jane
Clone this repository into
cd myBlog git clone https://github.com/xianmin/hugo-theme-jane.git --depth=1 themes/jane
Copy the example site content:
cp -r themes/jane/exampleSite/content ./
Copy the default site config:
cp themes/jane/exampleSite/config.toml ./
Take a look at the example site:
Open http://localhost:1313/ , you will see the example site.
4. Start Blog
The default config file
config.toml in your site root directory. Customize it.
The default content files in the
5. Generate Your Website
hugo , this generates your website to the
public/ directory by default.
Take a look in the exampleSite folder.
This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation.
config.toml in the root directory of your website. Overwrite the existing config file if necessary.
Single Post Configuration
Front Matter : Hugo allows you to add front matter in yaml, toml, or json to your content files.
--- # Common-Defined title: "An Example Post" date: 2018-01-01T16:01:23+08:00 lastmod: 2018-01-02T16:01:23+08:00 draft: false tags: ["tag-1", "tag-2", "tag-3"] categories: ["index"] author: "xianmin" # User-Defined # You can close(false) or open(true) something for this content. # P.S. comment can only be closed comment: false toc: false # You can also define another contentCopyright contentCopyright: '<a rel="license noopener" href="https://creativecommons.org/licenses/by-nc-nd/4.0/" target="_blank">CC BY-NC-ND 4.0</a>' reward: false mathjax: true ---
Multilingual (Language) Support
Hugo-Theme-Jane supports the creation of websites with multiple languages side by side.
You should define the available languages in a
languages section in your site configuration.
Translations are collected from the
To use the translations:
# use Chinese translation defaultContentLanguage = "zh-cn" # Default language to use (if you setup multilingual support) [Languages.zh-cn] languageCode = "zh-cn"
To use the Multilingual Mode, see Multilingual Mode | Hugo .
If you are interested in fixing issues and contributing directly to this theme, please see the document How to Contribute .
There are many ways to contribute to the Jane theme:
- submitting pull requests
- reporting issues
- providing new translations
- creating suggestions
- Correct inappropriate English expression (ok, my English is not good)
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
Hugo-theme-jane is licensed under the MIT license. Check the LICENSE file for details.