Jane 是一个专注于阅读体验的 Hugo 主题。最早的版本基于 hugo-theme-even ,在它的基础上进行了重新改造。
主要特色:
注意: 这个教程假设你 第一次 使用 Hugo 。 Hugo 是一个非常流行的静态网站生成工具。 你可查看官方文档 Hugo Official Docs 获取更多帮助。
从 Hugo Releases 上直接下载安装适合你的版本。
hugo new site myBlog
上面的命令将会在一个名为 myBlog
的文件夹中创建一个新的 hugo 站点。
把这个主题克隆到 themes
文件夹
cd myBlog
git clone https://github.com/xianmin/hugo-theme-jane.git --depth=1 themes/jane
复制一些示例文本:
cp -r themes/jane/exampleSite/content ./
复制默认的站点设置:
cp themes/jane/exampleSite/config.toml ./
启动 hugo server :
hugo server
打开 http://localhost:1313/ ,你将会看到一个示例网站。
默认配置文件 config.toml
位于你的网站的根目录,请按自身需要进行定制。
默认的文章文件位于 ./content/post
目录。
直接运行 hugo
,将会自动生成你的网站到 public/
目录。
如果你有额外的时间,并且想更多的了解 Hugo ,请查阅官方文档 Hugo Official Docs 。
不妨看一看 exampleSite 文件夹中的文件。
这个目录包含一个示例 config.toml
文件和一些示例文章。
将 config.toml
复制到你的网站根目录。按自身需要进行修改。
Front Matter : Hugo 允许你使用 yaml, toml 或者 json 语法在你每一篇文章的开头进行设置。
YAML 示例:
---
# 常用定义
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" # 作者
# 用户自定义
# 你可以选择 关闭(false) 或者 打开(true) 以下选项
comment: false # 关闭评论
toc: false # 关闭文章目录
# 你同样可以自定义文章的版权规则
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 # 打开 mathjax
---
Hugo-Theme-Jane 支持创建多语言网站。
你需要为你的网站对 languages
进行配置。
翻译位于 i18n/
文件夹下。
使用特定的翻译:
# 使用中文
defaultContentLanguage = "zh-cn" # 默认使用的语言
[Languages.zh-cn]
languageCode = "zh-cn"
有关多语言设置,请查看 Multilingual Mode | Hugo 。
使用 npm
安装依赖:
npm install
然后:
npm run dev
这条命令会同时运行 webpack --watch
和 hugo server
。 如果你修改了任何文件,浏览器将会自动更新。
Hugo-theme-jane is licensed under the MIT license. Check the LICENSE file for details.
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.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。