Skip to content

Latest commit

 

History

History
90 lines (57 loc) · 3.78 KB

README-zh.md

File metadata and controls

90 lines (57 loc) · 3.78 KB
Raw

hugo-theme-even

A super concise theme for Hugo

该主题移植自 hexo-theme-even

在线预览 Demo

Screenshots

even-showcase

Installation

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

重要: 在主题的 exampleSite 目录下有一个 config.toml 文件，将这个 config.toml 文件复制到你的站点目录下，根据自己的需求更改即可。

注意: 对于这个主题，你应该使用 post 而不是 posts，即 hugo new post/some-content.md。

Language Support

翻译资源在 themes/even/i18n/ 文件夹（内置在主题中），以及站点根目录下的 i18n/ 文件夹中。两个文件夹下的翻译资源将会被合并，且根目录下的优先级大于内置于主题中的。

只需要正确的设置 defaultContentLanguage 的值即可使用翻译资源。

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

同样也支持其他语言。举例来说，为支持德语，在站点根目录下创建 /i18n/de.yaml 文件。参考 en.yaml 文件查看如何编写翻译资源。

附：在多语言模式下，当前正被用于渲染网站的语言会被用于匹配翻译资源。

Favicon

为了定制 favicon，你需要在站点根目录的 static 文件夹下放置下述所有文件，这将覆盖 themes/even/static/ 文件夹下的那些文件。

  • 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

favicon generator (Google) 能够帮助你生成这些文件。

Front Matter

你可以通过 front-matter 针对每一篇文章单独进行设置。themes/even/archetypes/default.md 文件陈列了所有可用的参数。将该文件复制到站点根目录的 archetypes 文件夹下将会有所帮助。

Shortcodes

主题提供了 center, right, left, music 四种 shortcodes，并支持为内置的 figure 设置 center, right, left 这三种 class 值。点击这里查看详细内容。

Theme Color

主题内置了五种颜色 ( Default | Mint Green | Cobalt Blue | Hot Pink | Dark Violet )，你可以通过改变 /src/css/_variable.scss 文件中 $theme-color-config 的值来改变主题的颜色。

Build

如果你更改了 /src/ 目录下的任意文件，你需要重新编译它们。

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

Update Theme

cd ./themes/even/
git pull

License

Released under the MIT License.

Acknowledgements