使用Hugo和GitHub Pages创建静态网站个人博客

不需要服务器,不需要域名,不需要数据库,可以选择模版,内容为Markdown格式。

Hugo:https://gohugo.io

文档:https://gohugo.io/getting-started/quick-start/

中文文档:https://www.gohugo.org/

下载:https://github.com/gohugoio/hugo/releases/download/v0.139.2/hugo_0.139.2_windows-amd64.zip

皮肤列表:https://www.gohugo.org/theme/

bash 复制代码
hugo new site hugo-site

cd hugo-site

git init

git submodule add https://github.com/spf13/hyde.git themes/hyde

echo "theme = 'hyde'" >> hugo.toml

hugo new about.md
hugo new post/first.md

生成内容中draft=true,即为草稿的意思,通常情况下,Hugo并不会发布和编译草稿文章。因此需要将其改为false,现在就改。

如果你想对主题做一些自定义修改,你可以Fork对应的主题到自己的仓库,然后修改。

bash 复制代码
hugo server --buildDrafts
或者
hugo server -D

访问 http://localhost:1313

假设你需要部署在 GitHub Pages 上,首先在GitHub上创建一个Repository,命名为:raoxiaoya.github.io (raoxiaoya替换为你的github用户名)。

修改hugo.toml文件中的baseURL的值为'https://raoxiaoya.github.io'

hogo.toml

bash 复制代码
baseURL = 'https://raoxiaoya.github.io'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'hyde'

编译

bash 复制代码
hugo

其默认指令就是build

你的静态网站就在public命令下。

public设置为submodule,修改.gitmodules

bash 复制代码
[submodule "themes/hyde"]
	path = themes/hyde
	url = https://github.com/spf13/hyde.git
[submodule "public"]
	path = public
	url = https://github.com/raoxiaoya/raoxiaoya.github.io.git

提交public

bash 复制代码
cd public
git init
git remote add origin https://github.com/raoxiaoya/raoxiaoya.github.io.git
git pull origin master
git add . && git commit -m "public first commit" && git push -u origin master

访问 https://raoxiaoya.github.io/

创建hugo-site仓库,并提交提仓库

bash 复制代码
cd ../
git remote add origin https://github.com/raoxiaoya/hugo-site.git
git pull origin master
git add . && git commit -m "hugo-site first commit" && git push -u origin master

如果你想在博客中加入评论功能,可以使用 utteranc,不需要账号系统,直接基于github平台。

相关推荐
宁雨桥3 小时前
Gitee迁移GitHub开源全攻略:一键配置自动同步,仅需维护单一仓库
gitee·开源·github
掘金安东尼4 小时前
⏰前端周刊第 452 期(2026年2月2日-2月8日)
前端·javascript·github
CoderJia程序员甲4 小时前
GitHub 热榜项目 - 日榜(2026-02-08)
git·ai·开源·llm·github
猫头虎4 小时前
手动部署开源OpenClaw汉化中文版过程中常见问题排查手册
人工智能·langchain·开源·github·aigc·agi·openclaw
叶庭云5 小时前
GitCode 与 GitHub 平台能力深度对比:聚焦于 AI 辅助开发与 Agent 自动化能力
人工智能·github·gitcode·源代码托管平台·ai 辅助开发·agent 自动化能力·易用性
passerby606114 小时前
完成前端时间处理的另一块版图
前端·github·web components
草梅友仁15 小时前
墨梅博客 1.4.0 发布与开源动态 | 2026 年第 6 周草梅周报
开源·github·ai编程
学电子她就能回来吗17 小时前
深度学习速成:损失函数与反向传播
人工智能·深度学习·学习·计算机视觉·github
xuhe220 小时前
[全流程详细教程]Docker部署ClawBot, 使用GLM4.7, 接入TG Bot实现私人助理. 解决Docker Openclaw Permission Denied问题
linux·docker·ai·github·tldr
宇宙帅猴21 小时前
GitHub 私有仓库认证完整指南:告别密码错误,使用 PAT 令牌
github