Skip to content
A readable & concise theme for Hugo
HTML CSS JavaScript XSLT
Branch: master
Clone or download
Latest commit 18433f2 Nov 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
archetypes first commit Dec 18, 2017
assets #259 Add Mastodon social media icon Oct 27, 2019
exampleSite #259 Add Mastodon social media icon Oct 27, 2019
i18n Fixed typos in the spanish translation (#253) Oct 5, 2019
images optimize png images Nov 18, 2019
layouts Fix RSS Nov 19, 2019
resources/_gen/assets Regenerate css resources after last changes (#228) Aug 19, 2019
static optimize png images Nov 18, 2019
.all-contributorsrc docs: add more contributors Jul 20, 2018
.editorconfig feat: add editorconfig support Apr 19, 2018
.gitattributes feat: support Git diff Minified JS and CSS Apr 19, 2018
.gitignore 🙈 Ignore node environment Apr 28, 2018
CHANGELOG.md docs: update CHANGELOG to 2.0.0 Oct 2, 2018
LICENSE.md readme update Mar 7, 2018
README-zh.md add stackbit button in README.md Aug 30, 2019
README.md add stackbit button in README.md Aug 30, 2019
SITES.md docs: Update SITES.md (#251) Oct 1, 2019
dev-config.toml #259 Add Mastodon social media icon Oct 27, 2019
netlify.toml added stackbit.yaml Aug 30, 2019
stackbit.yaml
theme.toml docs: update theme min_version Aug 3, 2018

README.md

jane-preview All Contributors

hugo-theme-jane

Jane is a readable theme for Hugo. It's a fork of hugo-theme-even with a lot of additional changes.

Demo | 中文说明

This theme focuses on improving the 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 uses Hugo-theme-Jane

Are you using hugo-theme-jane? Add your site to the list!

Quick Start

Note: This tutorial assumes that you are using Hugo for the first time . Hugo is one of the most popular open-source static site generators. You can check the Hugo Official Docs for more help.

1. 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. Create a New Site

hugo new site myBlog

The above will create a new Hugo site in a folder named myBlog.

3. Use Hugo-Theme-Jane

Clone this repository into themes folder:

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:

hugo server

Open http://localhost:1313/ , you will see your site running with the example content.

4. Start a Blog

The default config file config.toml is located in your site root directory. You can customize it to match the details of your site. Documentation about configuring Hugo can be found in the Official Documentation

The default content files are located in the ./content/post directory.

5. Generate Your Website

Run hugo , this generates your website to the public/ directory by default.

Nice work!

If you have extra time or want to know more about Hugo , check out the awosome Hugo Official Docs .

Site Configuration

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 you to configure to your liking.

Copy the config.toml to 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.

YAML Example:

---
# 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 i18n/ folder.

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 .

Contributing

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)

Contributors

Thanks goes to these wonderful people (emoji key):


Chen Xianmin

💻 🎨 📖 💬

Jack Baty

🐛 🤔 ⚠️ 👀

Athurg Feng

👀 ⚠️ 🐛

Dmitry Verkhoturov

👀 🌍 🤔

Deckon

🌍

YuShuangqi

👀 🤔 💻

Josta Yee

🤔 💻

German Lashevich

💻 🤔 🐛 ⚠️

Jean-Loup Adde

🌍

AxdLog

💻

Andrea Borruso

📖

Yong-Siang Shih (Shaform)

💻 🌍

This project follows the all-contributors specification. Contributions of any kind welcome!

License

Hugo-theme-jane is licensed under the MIT license. Check the LICENSE file for details.

Stackbit

This theme is ready to import into Stackbit. This theme can be deployed to Netlify and you can connect any headless CMS including Forestry, NetlifyCMS, DatoCMS or Contentful.

Create with Stackbit

You can’t perform that action at this time.