个人技术博客搭建及技巧

本文介绍如何利用 Docusaurus + CF Pages 构建并发布个人技术博客, 以及技术博客编写相关技巧.

① 目的

相信大家都有类似经历: 工作几年技术停留在日常业务层面, 想提高无从入手, 想探索不知所措. 原因在忽略了一个问题: 代码倒是写了成千上万行, 却都在重复解决类似问题, 除了更换了几次问题解决体位, 自己有何成长? 如何形成个人核心竞争力?

千人千面, 不同情况解法不同, 需根据上下文分析.

一个简单办法: 写下经验, 经过一天/一周/一月/一年有何收获, 定期回顾总结. (包括但不限: 做过的事, 解过的题, 读过的书, 撕过的逼.)

技术博客编写目的:

1. 建立技术提升的认知-实践-反馈循环, 不断自我提升.
2. 建立 "属于自己的业内知名度".
3. 提高文档编写和表达能力.
4. 协助在公司层面建立技术博客, 提供高质量原创文章(原创的核心技术解决方案).
5. 当然, 也可以通过 SEO 带来流量, 赚xx etc. .

如下是一些典型的例子(来源):

• 猫神(留日大神同行): https://onevcat.com/ (https://onevcat.com/2013/04/half-year-in-japan/)
• 唐巧(猿辅导): https://blog.devtang.com/ (https://blog.devtang.com/2024/01/01/2023-summary/)
• 不知名人士: https://blog.rayy.top/ https://my-mdbooks.pages.dev/

② 博客工具

工具唯一作用是辅助目的达成, 在过程中应平衡工具使用/目的达成开销, 切勿陷入工具无法自拔.

工具选择

个人博客搭建, 建议选择静态站点生成器或文档站点生成器.

1. Hexo: 简单, 主题丰富.
2. mdbook: 开箱即用
3. 其他静态生成工具
4. 其他文档工具
   • Docusaurus
   • Github 文档生成器搜索结果

博客创建和部署

1. 选 Docusaurus 是不想再折腾(book + blog), 之前选 hexo + mdbook 是不想太折腾. 尽量选使用成本低的.
2. 注册 CF, 注册域名, 将域名 Name Server 配置到 CF(因在阿里云注册的便宜货), 并配置 CDN(访问速度非常重要):
3. 构建和发布: Build 静态文件并部署.

③ 关于个人技术博客编写细节

推荐一本书: Technical Blogging, 共同探索.

1. 了解你的用户群: Swift 和 iOS 开发? 操作系统底层研发? 硬件爱好者, 软件操作爱好者等等
2. 定义博客的主题: 更多体现专业性, 以及基于 SEO 的考虑.
3. 确认所选定主题的市场容量, 搜索量以及历史和未来趋势: 工具可以选择 google trends, semrush, google ads 等.
4. 为博客确定一个名字, 申请域名

编写博客时, 应注意:

1. 中文/英语/日语中至少一个能熟练运用.
2. 重视信息安全和知识产权保护: 该打码的打到手抽筋都要打, 不该写的打死都不能写
3. 中华文化博大精深: 技术类博文应言简意赅, 准确通顺(掌握大白话/书面语的度, 专业名词准确使用), 切勿堆字数.
4. 学一些 Web 前后端开发技能.
5. 明确博客主题, 且内容受众群自己应做到心中有数.
6. 分享一下你的博客站点, 多多引流.
7. 应重视 SEO 和数据分析, 这样能更懂读者和市场需要什么.

关于内容编写的技巧, 详见 TB.