目录

Hugo

更新于 2021-01-23

Hugo

建站

hugo new site quickstart

添加一个主题

cd quickstart;
git init;
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke;

# 编辑你的 config.toml 配置文件使用该主题
echo 'theme = "ananke"' >> config.toml

开始写作

hugo new post/my-first-post.md

编辑你新建的markdown文件。现在,在启用drafts参数的条件下开启Hugo内置的服务器。

hugo server -D

你的网站已经在http://localhost:1313/开启了。

目录结构

.
├── archetypes
├── config.toml
├── content
├── data
├── layouts
├── static
└── themes
  • archetypes: 储存.md的模板文件,类似于hexoscaffolds,该文件夹的优先级高于主题下的/archetypes文件夹
  • config.toml: 配置文件
  • content: 储存网站的所有内容,类似于hexosource
  • data: 储存数据文件供模板调用,类似于hexosource/_data
  • layouts: 储存.html模板,该文件夹的优先级高于主题下的/layouts文件夹
  • static: 储存图片,css,js等静态文件,该目录下的文件会直接拷贝到/public,该文件夹的优先级高于主题下的/static文件夹
  • themes: 储存主题
  • public: 执行hugo命令后,储存生成的静态文件

配置 Hugo

编辑你的config.toml文件以配置你的站点。以下节选了部分有趣的参数,完整的配置文件可以参考官方文档

+++
# 主机名 例如: http://spf13.com/
baseURL =                     ""
# 语言编码(中文: zh-CN)
languageCode =                ""
# 默认的内容语言
defaultContentLanguage =      "zh-CN"

# 自动检测是否包含中文/日文/韩文,该参数会影响摘要和字数统计功能,建议设置为true
hasCJKLanguage =              false

# 若为 false,`Getting Started` 这样的英文标签将会被转换为 `getting-started`
preserveTaxonomyNames =       true

# 设置使用的主题名称 (默认储存在 /themes/THEMENAME/)
theme =        

# 分页
paginate =                    10
paginatePath =                "page"

# 启用 Emoji; see emoji-cheat-sheet.com
enableEmoji =                 false

# 创建robots.txt,建议设置为true
enableRobotsTXT =             false

# 定义文章访问路径,详细见下文"URL管理" See "content-management/urls/"
permalinks =                  ""
+++

除了预设的参数外,你也可以通过下面的方式自定义自己的参数。你可以在模板中获取到自定义的参数,通常情况下你使用的主题都会要求你这么做,具体信息可以阅读相关主题的文档。

[params]
  author = "olOwOlo"
  github = "olOwOlo"

至此,你已经掌握了足够的知识,你只需要从主题列表中挑选一个你喜欢的主题,阅读主题的文档并提供主题所需的信息,便可以开始使用hugo来写作了。

阅读下面的内容可以帮你更好的了解到hugo如何管理你的内容,而你又该如何更好的与hugo协作。