Jack77793's Blog

Quo Fata Vocant

09 Jul 2023

建站小记

关于标题

About 所说,本博客基于 Hugo 框架搭建,并托管在 Cloudflare Pages 上,大概不太能称得上是传统的“建站”,然而毕竟是一个静态博客网站,叫它“建站”似乎也并无不妥,遂以之为题。

关于 Hugo 与其安装

正如 Hugo 官网所言,Hugo 是世界上最快的内容生成框架,是最受欢迎的开源静态网站生成器之一,有着令人惊讶的速度与灵活性。Hugo 使搭建网站重新变得有趣,也使得使用 Hugo 来搭建博客成为了一个很好的选择。

Hugo 的安装也十分简单,一般的发行版的软件源里都包含了 Hugo,使用各自发行版的包管理程序安装即可。BSD,macOS 和视窗用户可以前往官网参考文档,进行安装。

博客搭建

建立网站

安装 Hugo 之后,就可以使用它来建立新的网站,只需:

1
hugo new site <your-directory> # Notice that the argument <your-directory> must be a directory to be created or empty

你可以在新建立的网站中找到 archtypesassetscontentdatalayoutsstaticthemes 等目录和文件 hugo.toml,其中 archtypes 用来存放模板文件,assets 用来存放资源文件,content 用来存放网站内容,data 用来存放数据文件,layouts 用来存放前端的自定义内容,static 中的内容会在生成时复制到网站根目录,themes 用来存放主题,而 hugo.toml 是网站的配置文件,不过 Hugo 不仅支持 TOML,还支持 YAML 和 JSON 作为配置文件的格式,使用时更改文件后缀名即可。

创建文章

网站建立之后,你便可以在网站所在的目录下创建文章:

1
hugo new content <your-content> # <your-content> can be either relative path from the "content" directory or absolute path in the "content" directory, and must be a known content format like markdown or html

此时你所指定的位置会生成一个以模板文件夹下模板文件为模板的新文件,即是你所创建的文章。

站点预览与生成

预览

只需:

1
hugo server # if you need preview drafts, add option "-D"

即可在 localhost:1313 上预览站点。

生成

只需:

1
hugo

即可(默认)在 public 目录下生成内容。

不过此时你会发现预览和生成无法成功进行,这是因为站点还没有安装主题。

主题安装

你可以在此处寻找主题,并根据文档安装。

由于主题的差异,主题定制的配置项十分不同,所以建议参照主题的示例配置文件进行配置。Hugo 所定义的所有配置项可以在这里找到。

网站发布

一般来讲,在生成站点之后,把 public 目录下的内容复制到对应的地方即可。

本站托管于 Cloudflare Pages 上,源码托管于 GitLab 上,对此,你需要注册 Cloudflare 帐号并连接版本库,在仪表板上作好相应的设置后,每次提交都会自动生成网站,十分方便而且快捷。

评论支持

目前本站没有评论系统,Disqus 之流无法在墙内正常访问,我也不想为各种基于 GitHub 的评论系统单独建立一个版本库,如有相关需求还请邮件联系,也欢迎向我提出建议。

Next time, we'll talk about "nothing"