Hugo&Blowfish博客搭建入坑

mkdir my-blog
cd my-blog
# 修改git默认分支为main
git config --global init.defaultBranch main
git init
git config user.email "your@mail.domain"
git config user.name "yourname"
# 添加远程仓库
git remote add origin https://yourgitdomain/<yourname>/<repo-name>
# 新增.gitignore文件
touch .gitignore

# 添加文件
git add .
git commit -m "commit message"
# push
git push --set-upstream origin main

hugo new site --force .

my-blog
├── .git
│   ├── ......
├── .gitignore
├── archetypes
│   └── default.md
├── assets
├── content
├── data
├── hugo.toml
├── i18n
├── layouts
├── static
└── themes

git submodule add https://github.com/nunocoracao/blowfish.git themes/blowfish

rm hugo.toml
mkdir -p ./config/_default
cp ./themes/blowfish/config/_default/*.toml ./config/_default

config
└── _default
    ├── hugo.toml
    ├── languages.en.toml
    ├── markup.toml
    ├── menus.en.toml
    ├── module.toml
    └── params.toml

hugo server
# 执行成功会有类似如下提示
# Built in 53 ms
# Environment: "development"
# Serving pages from disk
# Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
# Web Server is available at //localhost:1313/ (bind address 127.0.0.1)
# Press Ctrl+C to stop

# 主题为 blowfish
theme = "blowfish"
# 你的博客域名
baseURL = "https://yourdomain.com/"
# 用来指定创作内容的主要语言，中文为"zh"
defaultContentLanguage = "zh"

disabled = false
languageCode = "zh"
languageName = "简体中文"
weight = 1
title = "陌白的个人博客"

[params]
  displayName = "简体中文"
  isoCode = "zh"
  rtl = false
  dateFormat = "2006-01-02 15:04:05"
#  logo = "img/avatar.jpg"
  # secondaryLogo = "img/secondary-logo.png"
  description = "与君初相识，犹如故人归"
  # copyright = "Copy, _right?_ :thinking_face:"

[params.author]
  name = "陌白"
  email = "mobai@10042021.xyz"
  image = "img/avatar.jpg"
  imageQuality = 96
  headline = "与君初相识，犹如故人归"
  bio = "一只热爱技术的码农"
  links = [
    { envelope = "mailto:mobai@10042021.xyz" },
    { github = "https://github.com/greeeds" },
  ]

mkdir -p ./i18n
cp ./themes/blowfish/i18n/zh-CN.yaml ./i18n/zh.yaml

[[main]]
  name = "文章"
  pageRef = "posts"
  weight = 10

[[main]]
  name = "分类"
  pageRef = "categories"
  weight = 20

[[main]]
  name = "标签"
  pageRef = "tags"
  weight = 30

[[main]]
  name = "关于"
  url = "/about/"
  weight = 100

# 主题颜色
colorScheme = "blowfish"
defaultAppearance = "light" # valid options: light or dark
autoSwitchAppearance = true

enableA11y = false
enableSearch = true
enableCodeCopy = false

giteaDefaultServer = "https://git.fsfe.org"
forgejoDefaultServer = "https://v11.next.forgejo.org"

[header]
  layout = "basic" # valid options: basic, fixed, fixed-fill, fixed-gradient, fixed-fill-blur

[footer]
  showMenu = true
  showCopyright = true
  showThemeAttribution = false
  showAppearanceSwitcher = true
  showScrollToTop = true

[homepage]
  layout = "background" # valid options: page, profile, hero, card, background, custom
  homepageImage = "img/homepage.png" # used in: hero, and card
  showRecent = true
  showRecentItems = 5
  showMoreLink = false
  showMoreLinkDest = "/posts/"
  cardView = true
  cardViewScreenWidth = false
  layoutBackgroundBlur = false # only used when layout equals background
  disableHeroImageFilter = false # only used when layout equals hero

[article]
  showDate = true
  showViews = false
  showLikes = false
  showDateOnlyInArticle = false
  showDateUpdated = false
  showAuthor = true
  # showAuthorBottom = false
  showHero = true
  heroStyle = "basic" # valid options: basic, big, background, thumbAndBackground
  layoutBackgroundBlur = true # only used when heroStyle equals background or thumbAndBackground
  layoutBackgroundHeaderSpace = true # only used when heroStyle equals background
  showBreadcrumbs = false
  showDraftLabel = true
  showEdit = false
  # editURL = "https://github.com/username/repo/"
  editAppendPath = true
  seriesOpened = false
  showHeadingAnchors = true
  showPagination = true
  invertPagination = false
  showReadingTime = true
  showTableOfContents = true
  showRelatedContent = true
  relatedContentLimit = 3
  showTaxonomies = true # use showTaxonomies OR showCategoryOnly, not both
  showCategoryOnly = false # use showTaxonomies OR showCategoryOnly, not both
  showAuthorsBadges = false
  showWordCount = true
  showComments = true
  # sharingLinks = [ "linkedin", "twitter", "bluesky", "mastodon", "reddit", "pinterest", "facebook", "email", "whatsapp", "telegram", "line"]
  showZenMode = false

[list]
  showHero = true
  heroStyle = "basic" # valid options: basic, big, background, thumbAndBackground
  layoutBackgroundBlur = true # only used when heroStyle equals background or thumbAndBackground
  layoutBackgroundHeaderSpace = true # only used when heroStyle equals background
  showBreadcrumbs = true
  showSummary = true
  showViews = false
  showLikes = false
  showTableOfContents = true
  showCards = true
  orderByWeight = false
  groupByYear = true
  cardView = false
  cardViewScreenWidth = false
  constrainItemsWidth = false

[sitemap]
  excludedKinds = ["taxonomy", "term"]

[taxonomy]
  showTermCount = true
  showHero = false
  # heroStyle = "background" # valid options: basic, big, background, thumbAndBackground
  showBreadcrumbs = false
  showViews = false
  showLikes = false
  showTableOfContents = true
  cardView = false

[term]
  showHero = false
  # heroStyle = "background" # valid options: basic, big, background, thumbAndBackground
  showBreadcrumbs = false
  showViews = false
  showLikes = false
  showTableOfContents = true
  groupByYear = false
  cardView = false
  cardViewScreenWidth = false

[fathomAnalytics]
  # site = "ABC12345"
  # domain = "llama.yoursite.com"

[umamiAnalytics]
  # websiteid = "ABC12345"
  # domain = "llama.yoursite.com"
  # dataDomains = "yoursite.com,yoursite2.com"
  # scriptName = ""
  # enableTrackEvent = true

[selineAnalytics]
  # token = "XXXXXX"
  # enableTrackEvent = true

[buymeacoffee]
  # identifier = ""
  # globalWidget = true
  # globalWidgetMessage = "Hello"
  # globalWidgetColor = "#FFDD00"
  # globalWidgetPosition = "right"

[verification]
  # google = ""
  # bing = ""
  # pinterest = ""
  # yandex = ""
  # fediverse = ""

[rssnext]
  # feedId = ""
  # userId = ""

[advertisement]
  # adsense = ""

hugo new posts/my-first-post.md

---
title: "我的第一篇文章"
date: 2025-08-28T17:40:00+0800
draft: true # 注意：draft 为 true 的文章在默认情况下不会被发布
categories:
  - 随笔
tags:
  - 入门
---

这是我的第一篇 Hugo 博客文章！

欢迎来到我的新博客。

hugo server

hugo