配置站点

站点根目录下有一个”config.toml“就是站点配置文件

到这里,怎么跟官方的不一样了?当然咯,这里是中文嘛,这里都是充分理解的基础上的文档,不是翻译,翻译请找度娘谷歌冰姐!配置文件的修改需要重新开启”hugo server -w“命令。

信息放那

没错,hugo没有数据库,那么,比如我们建立的sina,他的信息放哪里?

hugo有三个地方可以放信息,一个是站点的配置文件“config.toml”,一个是我们文章文件md文件的头部(默认的用三个“+++”号开始和结束,开始看上去像是“艹”,最后一个是“data”数据目录。

修改站点信息

以此作为例子,您就会了全部的配置方法。

打开“config.toml”文件,修改编码。您会看到这样的代码:

baseurl = "http://replace-this-with-your-hugo-site.com/"
languageCode = "en-us"
title = "My New Hugo Site"

第一个是基本目录,您大可以改成“www.sina.com”,呵呵,还是换个吧,老这样不好。

第二个是语言,可以改成中文的“zh-hans”。

第三个是站点的标题,我更乐意把它叫做站点名称,比如“百度”,呵呵,我们换了个。

在打开了”-w“监控参数之后的配置文件修改需要停止后重新打开,也就是说实时监控并不更新配置文件的修改。

这里有该文件默认支持的全部参数:

archetypedir:               "archetype"
# 基础路径
baseURL:                    ""
# 标记内容为草稿
buildDrafts:                false
# 包括内容的将来发布日期
buildFuture:                false
# 启用基于root的相对路径,不影响绝对路径
relativeURLs:               false
canonifyURLs:               false
# 配置文件 (默认是 path/config.yaml|json|toml)
config:                     "config.toml"
contentdir:                 "content"
dataDir:                    "data"
defaultExtension:           "html"
defaultLayout:              "post"
# 写入文件系统
destination:                ""
disableLiveReload:          false
# 不生成RSS文件
disableRSS:                 false
# 不建立站点地图文件
disableSitemap:             false
# 选择使用新编辑器编辑内容
editor:                     ""
footnoteAnchorPrefix:       ""
footnoteReturnLinkContents: ""
languageCode:               ""
layoutdir:                  "layouts"
# 启用日志
log:                        false
# 日志文件目录 (如果设置了目录,将自动启动日志)
logFile:                    ""
# 头部文本格式
metaDataFormat:             "toml"
newContentEditor:           ""
# 不同步文件写该日期
noTimes:                    false
paginate:                   10
paginatePath:               "page"
permalinks:
# Pluralize titles in lists using inflect
pluralizeListTitles:         true
publishdir:                 "public"
# 代码高亮风格
pygmentsStyle:              "monokai"
# true: 使用 pygments-css 或者 false: color-codes
pygmentsUseClasses:         false
# 默认的站点地图配置
sitemap:
# 文件系统相对路径
source:                     ""
staticdir:                  "static"
# 显示程序不同步骤的内存和运行时间
stepAnalysis:               false
# 使用的主题 (位于: /themes/THEMENAME/)
theme:                      ""
title:                      ""
# true: /filename.html 而不是 /filename/
uglyURLs:                   true
# 详细输出
verbose:                    false
# 详细日志
verboseLog:                 false
# 根据需要监视变化重建
watch:                      false

当然,上面的并不是我们默认的“toml”配置文件格式,这个也是官方复制来的。toml配置的格式是:

baseurl = "http://www.zimustudio.com/"
languageCode = "zh-hans"
title = "字母-原创设计技术"

自定义信息

站点配置文件并不是只能存放默认的配置项目的,它一样可以存放自定义的数据,并且在模版中被调用。

下面是本站的目录的自定义信息:

[[menu.mainmenu]]
    name = "原创"
    weight = -110
    identifier = "yuanchuang"
    url = "/yuanchuang/"
[[menu.mainmenu]]
    name = "设计"
    weight = -109
    url = "/sheji/"
[[menu.mainmenu]]
    name = "技术"
    weight = -108
    url = "/jishu/"
[[menu.mainmenu]]
    name = "hugo"
    weight = -107
    url = "/hugo/"

目录和导航将会对于中文站点来说,是一件麻烦事。默认以目录来定义章节、类型,他们是不支持中文的。要是想生成章节目录,类型目录,便出现了英文?拼音?

从上面的代码可以看出,我们的“原创”章节(有的叫栏目,频道,随便了,hugo叫章节),它的文章肯定是存放在一个叫做“yuanchuang”的文件夹下的,使用章节名变会出现“yuanchuang”这样的链接名,这个问题我们后面再讨论。