Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/varkai/hugo-theme-zozo
:star2: A simple and beautiful theme for Hugo
https://github.com/varkai/hugo-theme-zozo
hugo hugo-blog hugo-blog-theme hugo-theme
Last synced: 29 days ago
JSON representation
:star2: A simple and beautiful theme for Hugo
- Host: GitHub
- URL: https://github.com/varkai/hugo-theme-zozo
- Owner: varkai
- License: mit
- Created: 2019-04-12T13:19:57.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-09-18T00:29:46.000Z (about 1 year ago)
- Last Synced: 2024-09-29T05:40:54.591Z (2 months ago)
- Topics: hugo, hugo-blog, hugo-blog-theme, hugo-theme
- Language: CSS
- Homepage: https://zozo.varkai.com
- Size: 3.56 MB
- Stars: 382
- Watchers: 6
- Forks: 100
- Open Issues: 2
-
Metadata Files:
- Readme: README-zh.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - varkai/hugo-theme-zozo - :star2: A simple and beautiful theme for Hugo (CSS)
README
# Hugo Theme Zozo
[](https://github.com/varkai/hugo-theme-zozo/blob/master/LICENSE)
> 该主题移植自 [Aragaki](https://github.com/PCDotFan/Aragaki)，结构样式参考自 [菩提树下](https://blog.caicai.me/)，部分功能参考自 [Even](https://github.com/olOwOlo/hugo-theme-even)
**在线预览**：[Demo](https://zozo.varkai.com)
## 截图
## 安装
首先进入 hugo 的站点目录运行下面的命令：
```bash
$ git clone https://github.com/varkai/hugo-theme-zozo themes/zozo
```
本主题提供了一个示例配置文件是 [`exampleSite`](./exampleSite) 目录里的 [`config.toml`](./exampleSite/config.toml) 文件。
配置文件中对大部分配置都有详细的注释说明，复制该文件到站点目录下，根据自己的情况修改即可。
更多安装信息查看 Hugo 官方文档 [setup guide](https://gohugo.io/overview/installing/)。
## 示例站点
`exampleSite` 是本主题的一个示例站点，里面有配置文件、关于页面的一些示例。
## 关于页面
使用关于页面，首先要在你的站点目录的 [`content`](./exampleSite/content/) 目录下创建一个 [`about`](./exampleSite/content/about/) 目录，然后再创建一个 [`index.md`](./exampleSite/content/about/index.md) 文件，最后编写该文件即可。
## Shortcodes
主题提供了 `img` shortcode.
```markdown
{{< img src="path/to/xxx.png" >}}
```
## Math 公式
本主题支持 MathJax 数学公式，默认为关闭状态，如需使用，需要在 [`config.toml`](./exampleSite/config.toml) 中进行设置。
设置 `[params]` 下的 `mathjax = true` 来支持数学公式。
## Valine 评论
本主题提供了 Valine 评论系统，默认为关闭状态，如需使用，需要在 [`config.toml`](./exampleSite/config.toml) 中进行设置。
设置 `[params.valine]` 下的 `enable = true` 来开启评论系统，并将 `appId` 和 `appKey` 设置为你自己的。
## 社交链接
本主题的社交链接是字体图标的样式，并放置在了页面头部。你可以通过在 [`config.toml`](./exampleSite/config.toml) 的 `[social]` 模块中修改添加你的社交链接。
## 部署主题
配置完成之后，就可以使用下面的命令来启动 hugo 服务编译 markdown 文件生成静态站点：
```bash
$ hugo server
```
然后在浏览器地址栏输入 [localhost:1313](http://localhost:1313) 来访问站点。
## License
Released under the [MIT](https://github.com/varkai/hugo-theme-zozo/blob/master/LICENSE) License.
## 致谢
- [Aragaki](https://github.com/PCDotFan/Aragaki)
- [菩提树下](https://blog.caicai.me/)
- [olOwOlo](https://olowolo.com/)