主题
- 1: Hugo主题介绍
- 2: 推荐列表
- 3: academic主题
- 4: docsy主题
- 5: material-docs主题
1 - Hugo主题介绍
Hugo有非常丰富的主题。
后面会列出一些个人觉得不错的Hugo主题,然后重点推荐两个我自己在重度用的主题:
- academic 主题:用于我的个人博客网站
- Docsy 主题:用于我的学习笔记
2 - 推荐列表
在这里列出一些个人觉得不错的Hugo主题,一方面推荐给有兴趣的同学,另一方面也给自己留个备份。
文档类
官网的分类列表:
https://themes.gohugo.io/tags/documentation/
以下主题觉得还不错的:
-
Docsy
超级完善的一个文档类主题, google出品,特别适合做开源项目,强烈推荐。
https://github.com/google/docsy
观察了两年,一直在开发维护,最近选择docsy替代了Material Docs。
-
DocuAPI
类slate风格,带code example列,特别适合API文档和配置文档。
https://themes.gohugo.io/docuapi/
看demo效果相当的不错!!
-
~Material Docs~
非常漂亮的文档主题,但可惜原作者放弃维护,已经无法在hugo新版本中使用。
https://themes.gohugo.io/material-docs/
不得意,已放弃,改用 docsy
-
learn
类似gitbook。
-
Kube
带blog/faq,适合用于小型项目。
3 - academic主题
academic特别适合搭建内容相对比较丰富的网站
主题介绍
academic是一个特别适合搭建内容相对比较丰富的网站的主题,如果我们hugo网站的内容不仅仅是博客,还有其他好几种样式的内容,那么academic会是一个很不错的选择。此外,academic主题简洁大方,也适合作为一个稍有规模的正式网站。
- 官网介绍:https://academic-demo.netlify.app/
- 我用academic主题搭建的个人技术博客网站: https://skyao.io
4 - docsy主题
docsy主题非常适合用于开源项目,支持文档和博客。我主要用它来做学习笔记,替代年旧失修的meterial-docs主题。
主题介绍
docsy 主题官网:
https://github.com/google/docsy
这个主题非常适合用于开源项目,支持文档和博客。
我主要用它来做学习笔记,自行修改和定制。
5 - material-docs主题
material-docs主题非常适合用于文档,但常年不更新,已不能支持新版本的Hugo,不得已放弃改为使用 Google Docsy 主题。
主题介绍
material-docs官网:
这个主题非常适合用于文档,左边的导航栏支持多级菜单,样式也简单美观,而且对移动设备支持很好。
我从2018年出开始使用 material-docs 主题,主要用它来做学习笔记,替代之前长期使用的gitbook(gitbook的问题主要是本地生成内容速度太慢,而gitbook官方网站访问速度又不好)。但很遗憾,material-docs主题的作者已经消失,2017年后再没有更新,包括PR也没有人处理。
随着hugo的版本越来越新,这个主题的问题也越来越多,甚至为了能兼容我的hugo长期停留在0.54版本。
因此,在2021年,正式弃用 material-docs 主题,改为 Google Docsy 主题。当前您看到的这个Hugo学习笔记就是基于 Google Docsy 主题。