首页 / 建站向导 / 个人技术博客 / 内容站

个人技术博客 / 内容站

纯静态写作站:Markdown 写、自动生成页面、RSS 订阅、第三方评论,专注写本身。

✍️ 场景 ⏱ 2.5小时 5 个步骤 难度 已完成 0 / 5 步
■ 全文速览 · 静态内容

个人技术博客 / 内容站:5 步完整做法

下面这份是静态全文(含脚本与自查清单),由 scripts/seo-prerender.js 从 data/steps.json 生成,供搜索引擎与关闭 JS 的访客阅读。上面那套是带进度保存的交互向导,内容和它完全一致。

  1. Step 1 · 选写作方案(手写 vs 生成器)

    先定工具:纯手写 HTML / 静态生成器(Hugo·VitePress)/ 平台托管

    博客站的核心是“写”,不是“折腾工具”。先想清楚你要哪种:

    1. 纯手写 HTML:每篇博文一个 .html,自己维护索引页。零依赖、最透明,但文章一多就累。
    2. 静态生成器(推荐新手):写 Markdown,工具帮你生成 HTML、索引、归档、RSS。主流有 Hugo(Go,构建最快)、VitePress(Vue 系,文档站首选)、11ty(灵活)。
    3. 平台托管:掘金 / 知乎 / CSDN。省事但流量和读者都不在你手上。

    我的建议:想长期沉淀就选 Hugo 或 VitePress,本地写 .md,一条命令出站。别在“选工具”上耗三天——工具不重要,内容才重要。

    自查清单
    • 确定一种写作方案
    • 装好工具能跑出空站
    • 明白 Markdown 是写作格式
  2. Step 2 · 搭好本地写作工作流

    目录约定 + Front Matter + 图片管理 + 分类标签

    方案定下后把骨架搭好:

    • 目录约定:content/ 放 .md 文章,public/ 或 dist/ 是构建结果(别手动改),config 里配站名、作者、导航。
    • Front Matter:每篇 .md 头部写元数据——标题、日期、分类、标签、封面图。生成器靠它自动归类。
    • 图片管理:文章配图放 static/img/,用相对路径引用,别用图床外链(图床挂了文章就裂图)。
    • 分类与标签:分类要大而少(技术 / 生活 / 随笔),标签要细而多(nginx、docker、面试)。

    先写第一篇 Hello World 跑通全流程,比规划十篇大纲有用。

    自查清单
    • content/ 下有一篇带 front matter 的 .md
    • 构建后 public/ 生成了对应 html
    • 图片能正常显示
  3. Step 3 · 自动生成 + 索引 / 归档 / 标签页

    一条命令出站,自动产出列表、分类、标签、RSS

    生成器最爽的是“一次配置,自动产出”。

    构建命令(以 Hugo 为例):
    hugo (开发预览用 hugo server -D,改完秒刷新)

    它会自动帮你生成:

    • 首页文章列表(按时间倒序)
    • 分类页 / 标签页(按 front matter 自动聚合)
    • 归档页(按年月分组)
    • RSS:默认就有,地址一般是 /index.xml,后面订阅用

    如果你纯手写不用生成器,也得自己写索引页和 RSS 文件——RSS 可用现成脚本生成本地 XML,别手敲。构建产物是纯静态文件,丢任何静态托管都能跑。

    自查清单
    • 构建后首页有文章列表
    • 能访问 /categories/ 和 /tags/
    • RSS 文件存在且合法
  4. Step 4 · 加 RSS 订阅 + 第三方评论

    留住读者:RSS 源 + 免后端评论(Giscus 等)

    博客不止“写”,还得“留人”。

    RSS 订阅:前面生成的 /index.xml 就是订阅源。页面放个 RSS 图标链到它,读者用 Feedly / Inoreader 就能订阅。想聚合多个源或换格式,用开源 RSSHub 自己搭一个。

    评论系统(无需自建后端):

    • Giscus:基于 GitHub Discussions,免费、无广告、最好看,需要仓库是 public。
    • Disqus / 来必力:接入快,但有广告、加载慢,国内偶尔抽风。
    • Waline:可以自己搭,带管理后台。

    建议用 Giscus,配置就是填几个仓库参数,几分钟搞定。这样读者能互动,你也不用维护数据库。

    自查清单
    • 页面能看到 RSS 订阅入口
    • 点击能打开 /index.xml
    • 评论框能正常加载并提交
  5. Step 5 · 部署 + SEO + 引流

    推上线、上 HTTPS、做收录,把读者沉淀成资产

    本地写完,部署到线上。

    部署:把 public/ 整个传服务器(宝塔或纯 Nginx),或用 GitHub Pages / Vercel 一键推。Vercel 连 GitHub 仓库,push 自动构建上线,新手最省心。

    SEO:每篇加 meta description 和标题;sitemap 提交百度;图片加 alt 文本。

    引流:博客是长期资产。文末放你的其他产品 / 返利链接(克制),RSS 和邮件订阅把读者沉淀下来。

    备份:文章源文件(.md)就是你的资产,用 Git 管理推到 GitHub 等于自动备份,比宝塔打包还稳。

    自查清单
    • 线上能访问博客
    • https 无证书警告
    • sitemap 已提交
    • 源文件已用 Git 管理

关于个人技术博客 / 内容站,你大概还想问

个人技术博客 / 内容站一共几步?大概要多久?

共 5 步,约 2.5小时:1) 选写作方案(手写 vs 生成器);2) 搭好本地写作工作流;3) 自动生成 + 索引 / 归档 / 标签页;4) 加 RSS 订阅 + 第三方评论;5) 部署 + SEO + 引流。每步都带操作说明、可复制的一键脚本和自查清单。

个人技术博客 / 内容站第一步要做什么?

选写作方案(手写 vs 生成器)——先定工具:纯手写 HTML / 静态生成器(Hugo·VitePress)/ 平台托管。这一步做完,后面的步骤才有依据。

个人技术博客 / 内容站做完后怎么判断做对了没有?

部署 + SEO + 引流——推上线、上 HTTPS、做收录,把读者沉淀成资产。这一步的自查清单就是验收标准,全部勾上才算真正上线。