多语言
hugo.toml配置中增加以下内容, 注意defaultContentLanguage = "zh"内容最好放在前面,否则可能不生效
defaultContentLanguage = "zh"
defaultContentLanguageInSubdir = true # 默认语言也走子路径就设为 true;想让中文在根 / 则设为 false
enableRobotsTXT = true
[languages.zh]
languageName = "中文"
weight = 1
title = "我的技术博客"
[languages.en]
languageName = "English"
weight = 2
title = "My Tech Blog"
新建layouts\partials\lang-switch.html文件,参考本Repo
每篇文章的md文件格式改成xxx.zh.md、xxx.en.md
图片引用
对应文章文件夹下新建figs文件,md中使用类似的格式引用即可
注意,所有的文件名必须是index.xx.md(xx表示语言),否则功能失效
若需要使用<img src="figs/fig1.png" alt="示例图" width="700">这样的HTML格式,则需要在hugo.toml中增加以下内容
[markup.goldmark.renderer]
unsafe = true
切换主题
以ananke切换到PaperMod为例,首先拉取submodule:
git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod
然后更改hugo.toml中相关配置:
theme = "PaperMod"
删除ananke:
git submodule deinit -f themes/ananke
git rm -f themes/ananke
rm -rf .git/modules/themes/ananke
git commit -m "chore: remove ananke theme submodule"
搜索导航栏
content目录下增加search.xx.md,参考本Repo
hugo.toml配置中增加以下内容
[outputs]
home = ["HTML","RSS","JSON"]
[languages.zh.menu]
[[languages.zh.menu.main]]
identifier = "search"
name = "搜索"
url = "/search/"
weight = 10
pre = "🔍"
[languages.en.menu]
[[languages.en.menu.main]]
identifier = "search"
name = "Search"
url = "/search/" # 大多数主题会做语言相对链接
weight = 10
pre = "🔎"