使用环境
- 系统:Debian GNU/Linux 11 x86\_64
- 宝塔:7.9.0
- GIt
安装hugo
bash 代码:apt-get install hugo
检查是否安装成功
bash 代码:hugo version
输出下图内容,即安装成功

创建站点
bash 代码:hugo new site Hugo_blog
Hugo_blog
可以自定义,就是生成的hugo文件夹名字,自此Hugo站点生成完毕。

主题安装
可以参阅官网的 themes.gohugo.io 查看可用的主题列表。
先进入Hugo_blog
文件夹,我是放在了/www/wwwroot/Hugo_blog
这个路径下

在生成的Hugo_blog
目录下点击终端,

宝塔会自动用cd指令进入该目录下,先执行初始化指令。
bash 代码:git init

然后执行获取主题的命令,没有用过Git的可以先去简单安装一下,很简单。
bash 代码:git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

显示done,便是安装好了,最后,先打开config.toml

将主题添加到站点的配置文件中
bash 代码:theme = "ananke"


当然也可以用一条指令完成添加
bash 代码:echo 'theme = "ananke"' >> config.toml
添加内容
这个时候其实博客已经搭建好了,但为了更好看看效果还是要添加下文章看看效果如何。

在Hugo_blog
目录下,终端里,输入一下命令(当然你也可以不用宝塔,直接在终端通过cd指令也行,直接手动创建也是可以的)
hugo new post/some-content.md
站点目录下此时会出现一个content文件夹,文章是存放在了post目录下,新创建的文件默认包含如下内容,根据需要修改即可:
bash 代码:---
title: "Some Content"
date: 2022-05-20T08:40:33+08:00
draft: true
---
预览博客
因为我是直接在服务器进行的搭建的,所以我就不用hugo server -D
指令进行预览了,我是直接把生成的静态文件放入新增的站点下来直接访问域名查看。
首先,构建静态文件。默认情况下,输出的内容位于 站点目录/public/ 目录中(可以通过-d/--destination
参数修改输出位置,或者在配置文件中设置publishdir
参数)
hugo -D

然后,我是有个测试站点的

我把hugo生成的静态挪到测试站点,复制过去后访问域名马上就能看到情况,显示下图情况,便完成了hugo博客搭建

坑
1、主题的文件路径是这样的Hugo\_blog\themes\ananke,路径不要弄错了。
2、在Hugo\_Blog目录下创建一个content文件夹,content文件夹下再创建一个post文件夹。post文件夹里才是真正放md文档的地方。如果路径放错了,文章显示不出来。
3、语言设置
这两行配置改一下就行了。注意就是小写,不是大写
languageCode = "zh-cn"
defaultContentLanguage = "zh-cn"
4、关于作者【菜单】
在这个目录下Hugo\_blog\content直接创建md文档编写即可,文档里的title就是菜单名
5、报错error: failed to transform resource: SCSS
Building sites … ERROR 2019/08/27 16:56:32 error: failed to transform resource: SCSS processing failed: file "stdin", line 3, col 1: File to import not found or unreadable: bulma/bulma.
Total in 13 ms
Error: Error building site: logged 1 error(s)
这个错误耗费的时间比较长,最后找到了hugo一个英文社区。大神说把hugo换成扩展版就可以了,然后就成功了。
地址:hugo
6、页面加载不出来
- hexo是在站点目录,比如Hexo\_blog下进行git commit等类似操作的。
- hugo是首先在Hugo\_blog进行hugo编译,然后生成一个public文件夹。然后在Hugo\_blog\public 目录下进行 git commit的,很容易出错。