如何用 Github Issues 写技术博客?


本文由 简悦 SimpRead 转码, 原文地址 www.jianshu.com

写在前头的话

记得还在大学的那会儿,第一次听见可以用 Github 搭建个人的博客(Jekyll + Github Page),花了好几天搭建起来一个博客。再后来,改用 Hexo + Github Page 搭建博客,发现自己很喜欢玩这些东西,但是却止于玩弄搭建好看功能齐全的博客,却很难用于技术沉淀的记录(这个应该和个人心态有关)。

我觉得,写技术博客,出发点无非是:

  • 梳理自己的知识体系
  • 通过博客与外界交流

发现在搭建自己博客的时候,经常会想着怎样提高阅读量,博客怎样才能有更强大的功能、好看的 UI … 却无法集中精力进行技术总结.

有一天注意到,直接用 Github ,可以让我更加专心, :)

Github 上写博客

Github 提供了下面的功能:

  • Issues
  • Projects

我是这样做的:先在 Github 上创建一个博客专用的项目

QQ20170708-093151@2x.png

步骤 1: 创建 Projects

可以使用 Projects,建立个人的知识点类别

project.png

进入创建好的分类,创建栏目

project-column.png

步骤 2: 编写 Issues

Issues 里面可以自己定义 Lables 标签,对编写的文章进行分类。支持 Markdown 语法。

labels.png

new lables.png

新建 Issues,并且选择对应的标签 Lables,分类 Projects

Issues.png

步骤 3:添加到 Projects 卡片

打开对应的 projects,往专栏中添加新建的 Issues(点击 Add cards,直接拖拽)

add cards.png

步骤 4: 项目的 README.md

可以在 README.md 里面写一些简介,链接到具体的 Project 目录。

homepage

我是这样整理知识体系

Evernote: 知识收集的仓库(使用浏览器剪辑的插件)
Github Issues: 对遇到问题的整体解决思路进行梳理

发现,如果没有把 Evernote 的知识碎片整理成文,以后遇到同一个问题,就可能需要再次耗费精力在知识碎片中找。

现在 Github Issues 上会记录比较具体的解决问题过程,然后在 Github 上写的文章,我平时一般也会同步到简书上。

最后,附上我的 Github 博客地址,有兴趣的可以进去看下~
https://github.com/johnnian/Blog


yg9538 2022年8月30日 11:09 1479 收藏文档