部署Hugo Doit主题（一）原始框架搭建

简要介绍一下Hugo DoIt主题的部署流程，这里主要是为了记录一下部署的流程，以便日后查阅。在正式开始部署之前，首先需要感谢Hugo DoIt主题的作者们，这是官方的Github地址DoIt。另外也要感谢Hugo项目，Hugo是由Go语言实现的静态网站生成器，可以通过快速入门文档 进一步了解Hugo。

部署hugo DoIt博客原始框架

这部分需要参照DoIt官方详细搭建流程进行操作，需要安装相关的软件，配置相关的环境，具体的操作步骤如下：

1.安装hugo

原部署流程中说明了Hugo extended版本的重要性，因此最好肯定安装这个版本。本人使用的Linux系统，因此直接在snap中安装是最便捷的，直接使用以下命令即可：

1

sudo snap install hugo

安装完成后可以查看hugo版本，确实也是extended版本，版本维护也非常新，非常方便。

1
2

hugo version             
hugo v0.131.0-bfbee17932ff24009008aa94cdd75c0c41f59279+extended linux/amd64 BuildDate=2024-08-02T09:03:48Z VendorInfo=snap:0.131.0

2.在本地创建个人博客项目并使用DoIt主题

这部分需要在本地创建一个hugo项目，然后使用DoIt主题，也就是说以后的博客内容都是在这个项目中进行编写的。具体的操作步骤如下：

2.1 创建项目

Hugo 提供了一个 new 命令来创建一个新的网站，hugo new site后跟的是项目名称这，名称不会对项目配置造成任何影响，根据自己喜好命名即可，这里以blog_test为例：

1
2

hugo new site blog_test
cd blog_test

接下来可以观察一下此时的项目结构，可以看到项目中已经有了一些文件，这些文件是Hugo默认生成的，后续会根据DoIt主题的要求进行修改。而接下来，我们就应该导入DoIt主题。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

(base)  zbl@zbl  ~/MyBlog/blog_test  tree
.
├── archetypes
│   └── default.md
├── assets
├── content
├── data
├── hugo.toml
├── i18n
├── layouts
├── static
└── themes

2.2 导入DoIt主题

DoIt 主题的仓库是: https://github.com/HEIGE-PCloud/DoIt.

你可以下载主题的 最新版本  .zip 文件 并且解压放到 themes 目录.

另外, 也可以直接把这个主题克隆到 themes 目录:

1

git clone https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt

或者, 初始化你的项目目录为 git 仓库, 并且把主题仓库作为你的网站目录的子模块:

1
2

git init
git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt

2.3 配置主题

自然最方便的就是将整个文件夹复制过去，首先保证自己在根目录下，然后复制，操作如下：

1

cp -r themes/DoIt/exampleSite/* .

之后就是进行具体的配置了，此处的配置涉及到很多方面，包括主题的配置，网站的配置，SEO的配置等等，这些都是在config.toml文件中进行配置的，具体的配置可以参考DoIt官方配置文档，之后关于部分细节再专门进行补充。但是目前我们已经搭建好了基本的使用框架。

2.4 编写第一篇文章并启动！

在配置完成后，我们就可以编写第一篇文章了，这里以hugo new posts/first.md为例，创建一个posts目录，然后在里面创建一个first.md文件。需要注意的是，创建的md文件模板在项目根目录的archetypes/default.md中，这是笔者使用的模板：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

---
title: "{{ replace .TranslationBaseName "-" " " | title }}"
subtitle: ""
date: {{ .Date }}
lastmod: {{ .Date }}
draft: false
authors: []
description: ""

tags: []
categories: []
series: []

hiddenFromHomePage: false
hiddenFromSearch: false

featuredImage: ""
featuredImagePreview: ""

toc:
  enable: true
math:
  enable: false
lightgallery: false
license: ""
---

<!--more-->

TODO

创建完成后，执行指令hugo server -e production，将在本地启动一个服务，然后在浏览器中输入http://localhost:1313/即可看到你的博客页面，这是一个本地的页面，可以用来预览你的博客内容。

总结

这篇文章主要是记录了Hugo DoIt主题的部署流程，包括了Hugo的安装，项目的创建，主题的导入，主题的配置，第一篇文章的编写等，这是一个最基本的框架搭建，后续会继续进行更多的配置。