aditya/hugo-theme-even
1
0
Fork 0
mirror of https://git.adityakumar.xyz/hugo-theme-even.git synced 2024-11-08 22:49:44 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
A super concise theme for Hugo
92 commits 1 branch 0 tags 1.8 MiB
SCSS 50.3%
HTML 37.9%
JavaScript 8.1%
XSLT 3.6%
Makefile 0.1%
Find a file
olOwOlo 77101032aa
feat(highlight): add support for chroma 
BREAKING CHANGE: You need add params to enable `chroma` or `highlight.js` since they are disabled by default.
2018-07-10 00:49:20 +08:00
archetypes feat(post): add out-of-date content warning (#68) 2018-06-01 00:06:14 +08:00
data/even chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
exampleSite feat(highlight): add support for chroma 2018-07-10 00:49:20 +08:00
i18n feat(post): add out-of-date content warning (#68) 2018-06-01 00:06:14 +08:00
images docs: add showcase image, change default qrcode image 2017-09-13 00:25:59 +08:00
layouts feat(highlight): add support for chroma 2018-07-10 00:49:20 +08:00
src feat(highlight): add support for chroma 2018-07-10 00:49:20 +08:00
static chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
.babelrc chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
.gitignore chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
CHANGELOG.md refactor(param): camelcase for parameter names 2018-07-06 22:50:37 +08:00
LICENSE.md 🎉 first commit 2017-08-27 22:38:42 +08:00
package.json chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
postcss.config.js chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
README-zh.md docs(README): use post instead of posts 2018-06-14 21:41:26 +08:00
README.md docs(README): use post instead of posts 2018-06-14 21:41:26 +08:00
theme.toml chore(release): 3.0.0 2018-02-01 21:47:36 +08:00
webpack.config.js chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00
yarn.lock chore(build): yarn & webpack 4 & path & assets.json 2018-07-09 15:12:02 +08:00

README.md

hugo-theme-even

A super concise theme for Hugo

It's a port of the hexo-theme-even

Demo | 中文说明

Screenshots

even-showcase

Installation

$ git clone https://github.com/olOwOlo/hugo-theme-even themes/even

Important: Take a look inside the exampleSite folder of this theme. You'll find a file called config.toml. To use it, copy the config.toml in the root folder of your Hugo site. Feel free to change it.

NOTE: For this theme, you should use post instead of posts, namely hugo new post/some-content.md.

Language Support

Translations are collected from the themes/even/i18n/ folder (built into the theme), as well as translations present in i18n/ at the root of your project. The translations will be merged and take precedence over what is in the theme folder.

To use the translations, just set a correct value for defaultContentLanguage.

defaultContentLanguage = "en"  # en / zh-cn / other...

Can also support any other languages as well. For example, to support german, create a file /i18n/de.yaml in the root folder of your Hugo site. For reference template you can see the en.yaml file.

P.S. In multilingual mode, the language which currently being used to render the website will be used.

Favicon

In order to customize the favicon you need to place all the following files in the static folder at the root of your site, which will overwrite those files in the themes/even/static/ folder.

  • android-chrome-192x192.png
  • android-chrome-512x512.png
  • apple-touch-icon.png
  • browserconfig.xml
  • favicon.ico
  • favicon-16x16.png
  • favicon-32x32.png
  • manifest.json
  • mstile-150x150.png
  • safari-pinned-tab.svg

A favicon generator can help you generate these files.

Front Matter

You can customize something for a single content in the content's front-matter. The themes/even/archetypes/default.md shows all available params. Copy this file in the archetypes folder at the root of your project will be useful.

Shortcodes

This theme provides center, right, left, music four shortcodes, and support center, right, left class for the built-in figure. See more information from there.

Theme Color

There are five built-in theme colors ( Default | Mint Green | Cobalt Blue | Hot Pink | Dark Violet ), you can config it by changing the $theme-color-config value in /src/css/_variable.scss.

Build

If you changed any file under /src/, you need to rebuild.

cd ./themes/even/src/
npm install
npm run build

Update Theme

cd ./themes/even/
git pull

License

Released under the MIT License.

Acknowledgements