记一次hugo的搭建

使用环境

• 系统：Debian GNU/Linux 11 x86_64
• 宝塔：7.9.0
• GIt

安装hugo

apt-get install hugo 

检查是否安装成功

hugo version 

输出下图内容，即安装成功

创建站点

hugo new site Hugo_blog 

Hugo_blog可以自定义，就是生成的hugo文件夹名字，自此Hugo站点生成完毕。

主题安装

可以参阅官网的 themes.gohugo.io 查看可用的主题列表。

先进入Hugo_blog文件夹，我是放在了/www/wwwroot/Hugo_blog这个路径下

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

宝塔会自动用cd指令进入该目录下,先执行初始化指令。

git init 

然后执行获取主题的命令，没有用过Git的可以先去简单安装一下，很简单。

git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke 

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

将主题添加到站点的配置文件中

theme = "ananke" 

当然也可以用一条指令完成添加

echo 'theme = "ananke"' >> config.toml 

添加内容

这个时候其实博客已经搭建好了，但为了更好看看效果还是要添加下文章看看效果如何。

在Hugo_blog目录下，终端里，输入一下命令（当然你也可以不用宝塔，直接在终端通过cd指令也行，直接手动创建也是可以的）

hugo new post/some-content.md 

站点目录下此时会出现一个content文件夹，文章是存放在了post目录下，新创建的文件默认包含如下内容，根据需要修改即可：

--- 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的，很容易出错。

原文在这里.