Hugo + Github Action + Cloudflare 建站指北

brew install Hugo

hugo create site myblog

cd myblog
git init
git submodule add https://github.com/cryptowww/Mainroad themes/mainroad

baseurl = "/"
title = "巴贝奇的织机"
languageCode = "en-us"
theme = "mainroad"

[services.disqus]
  shortname = "" # Enable Disqus by entering your Disqus shortname
[services.googleAnalytics]
ID = "" # Enable Google Analytics by entering your tracking ID

[Params.author]
  name = "James"
  bio = "Stay Hungry, Stay Foolish."
  avatar = "img/avatar.png" # 要放到mainroad/static/img/下

[Params]
  description = "科技领域的新鲜事"           # Description of your site
  opengraph = true
  twitter_cards = false
  readmore = false                   # Show "Read more" button in list if true
  authorbox = false
  pager = true
  post_meta = ["date", "categories"] # Order of post meta information
  mainSections = ["posts", "docs"]   # 指定哪些文件目录里的文章显示到主页

[Params.logo]
  subtitle = "科技分享"      # Logo subtitle
  image = "img/logo.JPG" # Logo image

[Params.links] # 定义 links 表
  [[Params.links.items]] # 定义链接数组
    name = "Github"
    url = "https://github.com/cryptowww"

[Params.sidebar] # 定义侧边栏显示的位置和内容
  home = "right"   # Configure layout for home page
  list = "right"   # Configure layout for list pages
  single = "right" # Configure layout for single pages
# Enable widgets in given order
  widgets = ["search", "recent", "categories", "taglist", "links"]

[Params.widgets]
  recent_num = 6            # Set the number of articles in the "Recent articles" widget
  tags_counter = true       # Enable counter for each tag in "Tags" widget (disabled by default)
  categories_counter = true # Enable counter for each category in "Categories" widget (disabled by default)

[menus] # 设置两个菜单
  [[menus.main]]
    name = "主页"
    title = "home"
    pageRef = "/"
    weight = 1
  [[menus.main]]
    name = "编程"
    pageRef = "/program"
    weight = 2

hugo new posts/myblog-first-post.md

hugo server

hugo server -D

<h3>Links</h3>
<ul>
  {{ range .Site.Params.links.items }}
    <li><a href="{{ .url }}"{{if hasPrefix .url "http"}} target="_blank" rel="noopener noreferrer" {{end}}>{{ .name }}</a></li>
  {{ end }}
</ul>

[params]
  [params.links] # 定义 links 表
    [[params.links.items]] # 定义链接数组
      name = "示例网站 1"
      url = "https://example.com"
    [[params.links.items]]
      name = "Google"
      url = "https://google.com"
    [[params.links.items]]
      name = "关于我们" # 站内链接
      url = "/about/"
    [[params.links.items]]
      name = "我的项目"
      url = "https://github.com/yourname/yourproject"

[services.disqus]
  shortname = "your-short-name" # Enable Disqus by entering your Disqus shortname

name: deploy

on:
  push:
    branches: [main]
  #workflow_dispatch:
  #schedule:
  # Runs everyday at 8:00 AM
  #  - cron: "0 0 * * *"

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          submodules: true
          fetch-depth: 0

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: 0.139.4
          extended: true

      - name: Build Web
        run: hugo --gc --minify

      - name: Deploy Web
        uses: peaceiris/actions-gh-pages@v3
        with:
          PERSONAL_TOKEN: ${{ secrets.PERSONAL_TOKEN }}
          PUBLISH_BRANCH: website
          PUBLISH_DIR: ./public
          commit_message: ${{ github.event.head_commit.message }}