个人网站搭建教程

前言 动态网站(PHP+数据库):WordPress 静态网站: Hugo:GO语言,非常快,体积小,上手难度大 Hexo:js友好,中文社区活跃,慢 Hugo 借鉴的中文博客 一、安装Hugo 官网下载 安装extended版本,功能更多 官方文档:Quick start 放到e:\hugo\bin下 在此文件夹中打开git bash hugo version:出现版本号安装成功 hugo new site 'document':我的项目在e:\hugo\document下 ![[picture/hugo_document.png]] cd document git init https://themes.gohugo.io/:安装主题 git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod:我用的PaperMod主题。国内用https下载很慢,记得开加速。或者使用浏览器的gitzip插件,下载zip文件,解压缩到themes\PaperMod 网站配置文件:建议删除hugo.toml,config.toml。新建hugo.yml 官方配置文件 echo 'theme: "PaperMod"' >> hugo.yml:将主题配置写入Hugo的网站配置文件 hugo new posts/my-first-post.md:在content\posts文件下新建一个 hugo server -D:启动Hugo的本地开发服务器,实时预览你的网站,-D表示显示draft 二、部署到GitHub作为代码托管 官方文档:Host on GitHub Pages 1.新建仓库 在Gihub中新建一个repositories,以用户名.github.io命名,这是静态网站托管仓库。注意仓库大小写,全部改成小写! 😭 修改hugo.yml中的,baseURL: 'https://用户名.github.io/' 在项目根目录下e:\hugo\document mkdir -p .github/workflows touch .github/workflows/hugo.yaml # GitHub Actions 工作流定义文件,脚本自动部署网站 2.工作流配置 复制官方文档中的标准工作流配置 注意修改 修改时区: 将第25行的 TZ: Europe/Oslo 改为 TZ: Asia/Shanghai,这样生成的文章时间戳会更符合本地时间。 确认主题子模块: 这个工作流在第29行设置了 submodules: recursive,这能确保你的PaperMod主题被正确拉取。必须是使用 git submodule add 方式安装的。如果是zip下载,直接注释掉这一行(避免弹出报错)。 托管仓库基本不手动操作。所有更改通过Actions自动推送。 坑:单仓管理就行,笨蛋AI推荐双仓管理,结果配置出错了 ...

October 5, 2026 · 3 min · Zhiyu Ni