快速入门

本文将介绍如何安装、升级本主题,以及书写新的文章。

安装

要求 Hugo 0.75.0 或者更高版本。

从头开始创建站点

1$ hugo new site myblog
2$ cd myblog
3$ git init
4$ git submodule add https://github.com/razonyang/hugo-theme-bootstrap themes/hugo-theme-bootstrap
5$ cp -a themes/hugo-theme-bootstrap/exampleSite/* .
6$ hugo server

如果你使用的是 Windows,请改用 xcopy .\themes\hugo-theme-bootstrap\exampleSite /E

安装到已有站点

 1$ cd myblog
 2$ git submodule add https://github.com/razonyang/hugo-theme-bootstrap themes/hugo-theme-bootstrap
 3$ mkdir config
 4$ cp -a themes/hugo-theme-bootstrap/exampleSite/config/* ./config
 5$ cp -r themes/hugo-theme-bootstrap/exampleSite/content/about/ \
 6  themes/hugo-theme-bootstrap/exampleSite/content/archives/ \
 7  themes/hugo-theme-bootstrap/exampleSite/content/categories/ \
 8  themes/hugo-theme-bootstrap/exampleSite/content/contact/ \
 9  themes/hugo-theme-bootstrap/exampleSite/content/offline/ \
10  themes/hugo-theme-bootstrap/exampleSite/content/search/ \
11  themes/hugo-theme-bootstrap/exampleSite/content/series/ \
12  themes/hugo-theme-bootstrap/exampleSite/content/tags/ \
13  ./content
14$ hugo server

如果你重新克隆仓库,你将需要通过 git submodule update --init --recursive 更新 submodule,或者 git clone --recursive <repo>

升级

1$ cd themes/hugo-theme-bootstrap
2$ git fetch
3$ git checkout [version]
4$ cd ../../
5$ git add themes/hugo-theme-bootstrap
6$ git commit -m 'Upgrade the theme'
  • [version] 替换为最新的版本。所有版本可以通过命令 git tag -l | sort -rV 列出。
  • 你也可以直接使用 master 分支以获取最新的修改。

书写文章

假设默认语言为 en

1$ hugo new posts/new-post/index.md

上述命令创建了一篇英文文章,同样的,我们也可以创建一篇简体中文的文章:

1$ hugo new posts/new-post/index.zh-cn.md

请注意:创建的文章一般处于草稿状态,本地预览时,hugo server 需要指定 -D 参数才能预览草稿文章。文章发布时,需要将 draft 改为 false,或者直接移除 draft 参数。

你可以将文章放在任何地方,比如 blog,只需要将 blog 附加到 mainSections 参数:mainSections = ["posts", "blog"]

下一步

版权

评论