基于 Hugo 和 github pages搭建bolg

1
 name: Deploy 🚀
2
              uses: JamesIves/github-pages-deploy-action@v4 # 一个自动发布github pages的action
3
              with:
4
                  repository-name: codetang-2417/codetang-2417.github.io
5
                  token: ${{ secrets.HUGO_BUILD }}
6
                  branch: main
7
                  folder: public
8
                  clean: true
9
                  single-commit: true

1
# Change baseurl before deploy
2
baseurl = "https://codetang-2417.github.io/"

1
name: Deploy to Github Pages
2

3
on:
4
    push:
5
        branches: [master] # 这里的意思是当 master 分支发生push的时候，运行下面的jobs
6
    pull_request:
7
        branches: [master]
8

9
jobs:
10
    build:
11
        runs-on: ubuntu-latest
12

13
        permissions:
14
            # Give the default GITHUB_TOKEN write permission to commit and push the
15
            # added or changed files to the repository.
39 collapsed lines
16
            contents: write
17

18
        steps:
19
            - uses: actions/checkout@v4
20
              with:
21
                  submodules: recursive
22
                  fetch-depth: 0
23

24
            - name: Cache Hugo resources
25
              uses: actions/cache@v4
26
              env:
27
                  cache-name: cache-hugo-resources
28
              with:
29
                  path: resources
30
                  key: ${{ env.cache-name }}
31

32
            - uses: actions/setup-go@v5
33
              with:
34
                  go-version: "^1.17.0"
35
            - run: go version
36

37
            - name: Setup Hugo
38
              uses: peaceiris/actions-hugo@v2
39
              with:
40
                  hugo-version: "latest"
41
                  extended: true
42

43
            - name: Build
44
              run: hugo --minify --gc --cleanDestinationDir
45

46
            - name: Deploy 🚀
47
              uses: JamesIves/github-pages-deploy-action@v4 # 一个自动发布github pages的action
48
              with:
49
                  repository-name: codetang-2417/codetang-2417.github.io
50
                  token: ${{ secrets.HUGO_BUILD }}
51
                  branch: main
52
                  folder: public
53
                  clean: true
54
                  single-commit: true

1
git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack

1
# Change baseurl before deploy
2
baseurl = "https://codetang-2417.github.io/HugoStack/"

1
$ tree -d
2
.
3
├── assets
4
│   ├── img
5
│   └── scss
6
├── config
7
│   └── _default
8
├── content
9
│   ├── categories
10
│   │   └── example-category
11
│   ├── page
12
│   │   ├── archives
13
│   │   ├── links
14
│   │   └── search
15
│   └── post
5 collapsed lines
16
│       ├── hello-world
17
│       ├── image-gallery
18
│       ├── markdown-syntax
19
│       ├── math-typesetting
20
│       └── shortcodes

1
---
2
title: "Archives"
3
date: 2022-03-06
4
layout: "archives"
5
slug: "archives"
6
menu:
7
    main:
8
        weight: 2
9
        params:
10
            icon: archives
11
---

1
---
2
title: Hello World
3
description: Welcome to Hugo Theme Stack
4
slug: hello-world
5
date: 2022-03-06 00:00:00+0000
6
image: cover.jpg
7
categories: # 分类，可以在归档界面看到
8
    - Example Category
9
tags:
10
    - Example Tag
11
weight: 1       # You can add weight to some posts to override the default sorting (date descending)
12
---

1
---
2
title: Example Category
3
description: A description of this category
4
image:
5

6
# Badge style
7
style:
8
    background: "#2a9d8f"
9
    color: "#fff"
10
---

1
# Change baseurl before deploy
2
baseurl = "https://codetang-2417.github.io/"
3
copyright = "LingLong's Blog" # 网站的版权声明，通常显示在页脚
4
languageCode = "zh-cn"
5
title = "LingLong" # 站点标题
6

7
# Theme i18n support
8
# Available values: en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el, uk, ar
9
defaultContentLanguage = "zh-cn"
10

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

15
# Change it to your Disqus shortname before using
11 collapsed lines
16
disqusShortname = "Ling" # 标签页简称
17

18
enableRobotsTXT = true # 允许生成 robots.txt
19
buildDrafts = false # 构建时是否包括草稿
20
buildFuture = false # 构建未来发布的内容
21
buildExpired = false # 构建过期的内容
22

23
enableEmoji = true
24

25
[pagination]
26
pagerSize = 8 # 首页最多容纳的文章数量

1
[comments.giscus]
2
repo = "codetang-2417/codetang-2417.github.io"
3
repoID = "xxxxxxxxx"
4
category = "Announcements"
5
categoryID = "xxxxxxxxx"
6
mapping = "pathname"
7
lightTheme = "light"
8
darkTheme = "dark"
9
reactionsEnabled = 1
10
emitMetadata = 0

1
---
2
title: "Archives"
3
date: 2022-03-06
4
layout: "archives"
5
slug: "archives"
6
menu:
7
    main:        # 菜单层级
8
        weight: 2 # 用于排序
9
        params:
10
            icon: archives # 图标
11
---

1
archives.svg    back.svg          brand-twitter.svg  clock.svg      date.svg  home.svg      language.svg  messages.svg  search.svg  toggle-left.svg   user.svg
2
arrow-back.svg  brand-github.svg  categories.svg     copyright.svg  hash.svg  infinity.svg  link.svg      rss.svg       tag.svg     toggle-right.svg

1
---
2
title: Markdown Syntax Guide
3
date: 2023-09-07
4
description: Sample article showcasing basic Markdown syntax and formatting for HTML elements.
5
tags: # 自定义tag
6
    - markdown
7
    - css
8
    - html
9
    - themes
10
categories: # 自定义分类，可以在 content/categories/ 创建更详细描述
11
    - themes
12
    - syntax
13
---

1
$ ls content/categories/example-category                                                                    ✔
2
_index.md

1
---
2
title: Example Category
3
description: A description of this category
4
image:
5

6
# Badge style
7
style:
8
    background: "#2a9d8f"
9
    color: "#fff"
10
---