本教程在windows10平台上制作完成，适合windows平台，其他平台大差不差。

为了确保你能一遍成功，请先完全按照本教程来，各种名称、内容，也请无脑按照本教程来，熟悉了以后再改为你自己的。

准备工作

要白嫖，先做好准备工作，准备工作在闲暇时或上班摸鱼时就可以做了。

本地搭建

先在本地搭建好，随时可以看到效果。

安装配置hugo

解压安装

实际上这里不用安装，前面下载好的hugo解压即可使用，解压后把文件夹名改为"hugo"，放到D盘。

文件夹其他名称或放到其他位置也可以，先按照这个来，熟了以后再改吧。

如图：

配置环境变量

如果你对配置环境变量很熟，下面的详细小步骤对你就没有什么价值，这个环节把D:\hugo\加到环境变量path里，就可以进行下一环节了。如果你不太熟悉怎么配置环境变量，按照下面操作即可。

我这截图的系统是英文的，如果你是中文系统，按照对应的中文来就行。

1、在“我的电脑”上右键，打开“属性”

2、在最右侧找到“高级系统设置”，打开

3、在弹出的窗口右下角打开“环境变量”

4、在弹出的窗口上半部分“用户变量”里找到“path”，选中，点“编辑”

5、在弹出的窗口点“新建”，把D:\hugo加进去

然后一路点“确定”就可以了。

至此，hugo安装配置完毕。

创建blog

打开Windows PowerShell，如果不常用，在windows系统的搜索框里搜一下就行：

如果系统里没有Windows PowerShell，用命令行窗口也可以：

在命令行里进入到D:\hugo：

注意如果使用命令行窗口，需要按照下面操作：

输入创建blog的命令

1

hugo new site blog

执行后结果如下：

这时D:\hugo下会出现一个新的文件夹blog:

至此，blog创建完成

下面开始为你的blog设置主题。

为blog设置主题

配置主题

把前面下载好的主题解压缩，解压后得到一个文件夹hugo-theme-stack-3.22.0，把这个文件夹名字改为hugo-theme-stack。

把hugo-theme-stack整个目录复制到D:\hugo\blog\themes目录下，如图：

进入hugo-theme-stack目录在进入到子目录exampleSite，找到config.yaml，如图：

把config.yaml复制到D:\hugo\blog目录下，如图：

这时你会看到D:\hugo\blog目录下还有一个config.toml，把它删掉。

设置主题参数

先不用在意这些参数的意义，按照下面的步骤进行修改，等运行起来以后再对照页面看这些参数会更好，后面我对这些参数进行说明。

设置基本参数

打开D:\hugo\blog目录下的config.yaml，前14行是酱式的：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


baseurl: https://example.com
languageCode: en-us
theme: hugo-theme-stack
paginate: 3
title: Example Site
copyright: Example Person

# Theme i18n support

# Available values: ar, bn, ca, de, el, en, es, fr, hu, id, it, ja, ko, nl, pt-br, th, uk, zh-cn, zh-hk, zh-tw

DefaultContentLanguage: en

# Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]

# This will make .Summary and .WordCount behave correctly for CJK languages.

hasCJKLanguage: false

把它改成酱式的：

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


baseurl: "/"
languageCode: zh-cn
theme: hugo-theme-stack
paginate: 3		 
title: 我的blog
copyright: 宇宙探索

# Theme i18n support
# Available values: ar, bn, ca, de, el, en, es, fr, hu, id, it, ja, ko, nl, pt-br, th, uk, zh-cn, zh-hk, zh-tw
DefaultContentLanguage: zh-cn

# Set hasCJKLanguage to true if DefaultContentLanguage is in [zh-cn ja ko]
# This will make .Summary and .WordCount behave correctly for CJK languages.
hasCJKLanguage: true

直接把上面这些拷过去覆盖原来的就行。

设置语言

第16行到35行原来是酱式的：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


languages:
    en:
        languageName: English
        title: Example Site
        weight: 1
        params:
            description: Example description
    zh-cn:
        languageName: 中文
        title: 演示站点
        weight: 2
        params:
            description: 演示说明
    ar:
        languageName: عربي
        languagedirection: rtl
        title: موقع تجريبي
        weight: 3
        params:
            description: وصف تجريبي

改成酱式的：

1
2
3
4
5
6
7


languages:
    zh-cn:
        languageName: 中文
        title: 我的blog
        weight: 2
        params:
            description: 这是一个属于我自己的平台

直接把上面这些拷过去覆盖就行，这样就只保留了中文。

设置头像和简介

完成上面的操作后，再到51行，原来是酱式的：

1
2
3
4
5
6
7


    sidebar:
        emoji: 🍥
        subtitle: Lorem ipsum dolor sit amet, consectetur adipiscing elit.
        avatar:
            enabled: true
            local: true
            src: img/avatar.png

改成酱式的：

1
2
3
4
5
6
7


    sidebar:
        emoji: ♾️
        subtitle: 人生很广阔，内容不垂直。
        avatar:
            enabled: true
            local: false
            src: /img/avatar.png

直接把上面这些拷过去覆盖就行。

同时，你需要到 D:\hugo\blog\static目录下，新建一个文件夹img，然后找一个头像命名为avatar.png，放到这个文件夹里，如图：

如果你手头一时没有头像图，可以先把我这个下载下来临时一用。

关闭评论

我们先把评论关掉，完成上面操作后，到68行，原来是酱式的：

1
2
3


    comments:
        enabled: true
        provider: disqus

改成酱式的：

1
2
3


    comments:
        enabled: false
        provider: disqus

就是把enabled后面的true改为false。

设置菜单

完成上面的操作后，再到190行，原来是酱式的：

1

    main: []

改成酱式的：

 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
31
32
33
34
35
36
37
38
39
40


    main: 
        - identifier: home
          name: 博客
          url: /
          weight: -100
          params:
              icon: home
              newTab: true

        - identifier: categories
          name: 分类
          url: /categories/
          weight: -90
          params:
              icon: categories
              newTab: true

        - identifier: tags
          name: 标签
          url: /tags/
          weight: -80
          params:
              icon: tag
              newTab: true

        - identifier: rss
          name: 订阅
          url: /index.xml
          weight: -70
          params:
              icon: rss
              newTab: true

        - identifier: tf
          name: True Face App
          url: https://tftfapp.com/
          weight: -60
          params:
              icon: link
              newTab: true

直接把上面这些拷过去覆盖就行。

拷过去覆盖以后，再到231行，原来是酱式的：

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


    social:
        - identifier: github
          name: GitHub
          url: https://github.com/CaiJimmy/hugo-theme-stack
          params:
              icon: brand-github

        - identifier: twitter
          name: Twitter
          url: https://twitter.com
          params:
              icon: brand-twitter

把里面的url改成你自己的github和twitter地址就行。

到此为止，主题基本的配置就完成了。

发布文章

写文章

使用markdown写作。

到D:\hugo\blog\content目录下，新建一个文件夹post，在post下新建一个markdown文件 my-first-blog.md。

为了不用你再动脑子写点啥，还能看到一些有内容的效果，把下面的markdown代码内容拷过去直接用就可以了：

 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
31
32
33
34
35
36
37
38
39
40
41


---
title: "我的blog一"
slug: "my-first-blog"
date: 2024-03-29T19:30:00+08:00
lastmod: 2024-03-29T19:30:00+08:00 
draft: false
description : "这是本blog的第一篇"
tags : [
    "hugo",
    "blog",
    "学习",
    "web",
    "静态网站",
]
categories : [
    "天天向上",
    "芝麻开花"
]
---

## 开始

多年来混迹各种论坛，平台，当我意识到平台随时可以让一个人所有的踪迹都消失时，我决定开一个字节的blog。

简单介绍一下我对这个blog的内容规划吧：

## blog内容规划

### 规划一

哪有什么规划，想到哪写到哪。

### 规划二

不被平台规训，不为利益驱使。

## 联系我

如果需要联系我，到我推特吧，这样比较快一点，邮箱只用来在确认要传递什么东西的时候才看一下。

我的推特： [(1) Leige (@LeigeSee) / X (twitter.com)](https://twitter.com/LeigeSee)