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

# 使用brew安装hugo
brew install hugo

# 创建新项目（网站）
hugo new site my_website

# 生成用于发布的静态文件（不包含草稿）
hugo

# 生成用于发布的静态文件（包括草稿）
hugo -D

# 本地运行网站
hugo server

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

# 创建新项目（网站）
docker run --rm -it \
  -v $(pwd):/src \
  klakegg/hugo \
  new site my_website

# 生成用于发布的静态文件（不包含草稿）
docker run --rm -it \
  -v $(pwd):/src \
  klakegg/hugo

# 生成用于发布的静态文件（包括草稿）
docker run --rm -it \
  -v $(pwd):/src \
  klakegg/hugo -D

# 本地运行网站
docker run --rm -it \
  -v $(pwd):/src \
  -p 1313:1313 \
  klakegg/hugo \
  server

1
2

# 位于你的博客项目根目录
git clone https://github.com/dillonzq/LoveIt.git themes/LoveIt

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

.
├── archetypes # markdown文章的模版
├── config.toml # 配置文件
├── content # 网站内容，主要保存文章
├── data # 生成网站可用的数据文件，可用在模版中
├── layouts # 生成网站时可用的模版
├── public # 通过hugo命令生成的静态文件，主要发布这个
├── resources # 通过hugo命令一起生成的资源文件，暂时不知道什么用
├── static # 静态文件，比如文章中的图片/视频文件、缩略图等
└── themes # 保存可用的hugo主题

1

hugo new posts/文章标题.md

1

hugo server --disableFastRender

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

## 位于博客源代码根目录

## 初始化本地Git仓库
git init

## 设置名为Origin的远端Git仓库
git remote add origin {{这里替换成你的仓库在Github Clone用的地址}}

## 选择所有文件
git add -A

## Push到github
git push -u origin master

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

.
├── .git
├── .github
├── .gitignore  <---- 在根目录下
├── README.md
├── archetypes
├── config.toml
├── content
├── data
├── layouts
├── public
├── resources
├── static
└── themes

1
2
3
4

cat .gitignore

## 输出
/public

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

.
├── .git
├── .github
│   └── workflows
│       └── main.yml  <---在这里创建
├── .gitignore
├── README.md
├── archetypes
├── config.toml
├── content
├── data
├── layouts
├── public
├── resources
├── static
└── themes

 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
42
43
44
45
46
47
48
49
50
51
52

# This is a basic workflow to help you get started with Actions

name: CI

# Controls when the action will run.
on:
  # Triggers the workflow on push or pull request events but only for the master branch
  push:
    branches: [master]
  pull_request:
    branches: [master]

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
  # This workflow contains a single job called "build"
  build:
    # The type of runner that the job will run on
    runs-on: ubuntu-latest

    # Steps represent a sequence of tasks that will be executed as part of the job
    steps:
      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
      - uses: actions/checkout@v2
        with:
          submodules: true # Fetch Hugo themes (true OR recursive)
          fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod

      - name: Hugo setup
        # You may pin to the exact commit or the version.
        # uses: peaceiris/actions-hugo@2e89aa66d0093e4cd14751b3028fc1a179452c2e
        uses: peaceiris/actions-hugo@v2.4.13
        with:
          # The Hugo version to download (if necessary) and use. Example: 0.58.2
          hugo-version: latest # optional, default is latest
          # Download (if necessary) and use Hugo extended version. Example: true
          extended: true # optional, default is false

      - name: Build
        run: hugo

      - name: Pushes to another repository
        uses: cpina/github-action-push-to-another-repository@master
        env:
          API_TOKEN_GITHUB: ${{ secrets.API_TOKEN_GITHUB }}
        with:
          source-directory: "public"
          destination-github-username: "这里输入你的Github用户名"
          destination-repository-name: "这里输入你的Github用户名.github.io"
          user-email: 这里输入你的Github邮箱

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

    [params.page.comment]
      enable = true  <-- 启用评论系统

      ...


      [params.page.comment.gitalk]
        enable = true
        owner = "JellyZhang"  <-- Github用户名
        repo = "blog-comment" <-- 用来存放评论的repo名称
        clientId = ""  <-- 申请好的OAuth的ClientId
        clientSecret = "" <-- 申请好的OAuth的ClientSecret

1
2
3
4
5

config.toml:

[outputs]
  home = ["HTML", "RSS", "JSON"]

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

config.toml:

      [languages.zh-cn.params.search]
        enable = true
        # 搜索引擎的类型 ("lunr", "algolia")
        type = "algolia"
        # 文章内容最长索引长度
        contentLength = 4000
        # 搜索框的占位提示语
        placeholder = ""
        # 最大结果数目
        maxResultLength = 10
        # 结果内容片段长度
        snippetLength = 50
        # 搜索结果中高亮部分的 HTML 标签
        highlightTag = "em"
        # 是否在搜索索引中使用基于 baseURL 的绝对路径
        absoluteURL = false
        [languages.zh-cn.params.search.algolia]
          index = ""  <---  你创建的index的名字
          appID = ""    <--- Application ID
          searchKey = ""  <--- Search-Only API Key

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

在`main.yml`末尾加上：

      - name: Algolia Index Uploader
        # You may pin to the exact commit or the version.
        # uses: rxrw/algolia-index-uploader@294d1d600c4a2197a64903b6161cc80acea1becb
        uses: rxrw/algolia-index-uploader@v1
        with:
          # Your Algolia IndexPath
          index_path: public/index.json   <-- 生成的index.json位置，默认即可
          # Algolia Index Id
          algolia_index_id: XXXXXXXXX  <-- 你的indexId, 即之前获得的`application ID`
          # Algolia Index Name
          algolia_index_name: XXXX  <--- 你创建的index名字
          # Algolia Admin Key
          algolia_index_admin_key: XXXXXXXXXXXX  <--- 上图中获取的admin Key