使用 GitHub 跟踪博文数据，并自动同步到 cnblogs

导读

开通了博客园的 VIP，发现了会员服务中的 GitHub 跟踪和同步博文数据的功能，测试发现习惯使用 GitHub 的话，这个还是一个挺不错的功能。

本文主要分两部分，一是介绍说明如何使用该功能，并做相关个人的经验分享，二是作为个人 GitHub 同步 cnblogs 的文章的索引

教程：如何使用

适合人群

想要使用博客园 cnblogs 来发布技术博客或其他随笔文章
想要对博文数据进行版本控制（记录和查看文章历史）
熟练使用 GitHub 基本功能，或不排斥学习和使用 GithHub （需要学习：版本控制软件 git，md 文件格式等）
有意愿开通博客园 VIP 会员（以使用其会员服务提供的 GitHub App 同步博文功能）

教程步骤

确保开通博客园会员：「会员购买链接」相关拓展背景「求救信：救下园子，保住这块开发者的天地」
确保能够登录GitHub 「GitHub是一个面向开源及私有软件项目的托管平台」
查看博客园官方博客提供的「 GitHub 同步功能使用帮助」，逐步完成：

A. 在 cnblogs 的账户中心绑定 GitHub 账号

B. 在博客后台，根据指引安装 GitHub App（博客园提供的 cnblogs-sync），完成 Github 和博客园的关联

在博客后台-同步选项卡下，点击「添加 GitHub 源」按钮，弹出创建 GitHub 同步源对话框，点击「GitHub 账户」右侧的数据框，点击「安装 GitHub App」按钮

览器将自动跳转到 GitHub（如果您的浏览器提示「是否允许新建窗口」，请选择允许），请在跳转后的页面选择您希望同步的 repo 所属账号，然后点击「Install」

安装成功后，页面上会出现安装成功的提示：

C. 回到博客后台，账号列表应该会出现您刚刚绑定的账号（如果没有，请刷新页面重试，多次尝试仍然没有的话，请参见使用帮助文章后面的「重新绑定 GitHub 来源」一节）

D. 选择同步行为 “偏好” 和 "启用 Markdown FrontMatter"

几个使用心得

创建 GitHub 同步源 时，“文件夹” 是指跟踪 git 仓库中的哪个文件夹的 md 文件的变化，比如想跟踪整个仓库的 md 文件，那么就写根目录 “/”; 如果只跟踪 git 仓库的文件夹下 /docs，那么就填写 “/docs”

这里根据个人文章规划情况，先决定是要同步整个目录，还是只同步具体子目录。比如我这里，README.md 我也要发布，同时想根据不同的类型的文章，在根目录下分不同的子目录来写 md 文件，所以我选择填写 “/”

“当新文件创建时”：可选项有 “无操作”、“新建草稿”、“新建随笔并发布”。个人建议使用 “新建草稿”

“无操作” ：不做任何动作，感觉选这个那么同步就失去了意义。可能一些特殊情况才会用到。

“新建草稿” ：个人推荐选项，因为这样可以不至于一创建文件，一在 git 提交 commit 就立刻发布了文章。可以分多次提交，当作临时保存而不至于立刻发布。而且，选择该选项后，当在博客园发布了草稿，那么下次修改文件 commit 之后，也会保持文章的 “已发布” 状态，不会重新变回 “未发布” 的草稿状态。

“新建随笔并发布” ：这个一创建文件就发布了，只适合一次性就写完文章，这个可能不太适合我。我一般写博客习惯会分多次编辑修订细节之后，再正式发布。

“当源文件被删除时”：可选项有 “无操作”、“取消发布”、“删除博文”。个人建议使用 “取消发布”

“无操作” ：不做任何动作，感觉选这个那么同步就失去了意义。可能一些特殊情况才会用到。

“取消发布” ：个人推荐选项，因为文章如果有评论的话，直接 “删除博文” 会导致评论永久性丢失。

“删除博文” ：如文字所述，删除 md 文件将直接将所有数据包括评论全部删除。

"启用 Markdown FrontMatter", 这个可以根据定制的模板，自动让 cnblogs 确认 “文章标题”、 “博客预览摘要”、“使用的标签” 和 “使用的文章分类”

启用之后，按默认格式，只要在 md 文章开头写下如下内容，即可自定义上面提到的各个项
```
---
title: 博文标题
description: 博文摘要
#多个标签请使用英文逗号分隔或使用数组语法
tags: 标签1, 标签2
#多个分类请使用英文逗号分隔或使用数组语法，暂不支持多级分类
category: 分类1, 分类2
---

正文内容
```
具体使用示例参考 [个人文章列表-1]，本 cnblogs 博文就是通过 GitHub 编写的 md 文件自动生成
本地 Markdown 工具

在 GitHub 网页上也可以直接写文章，不过 “切换文件时的响应速度” 以及 “Markdown 效果实时预览” 可能不是很理想。

下面这篇文章列出了一些可用的本地 PC 端 Markdown 编辑工具的推荐

Markdown 教程-Markdown编辑工具推荐 - 阿鬼学长的文章 - 知乎

由于我本人电脑已经安装了 “VS Code”，它提供了对 Markdown 的原生支持，所以直接使用它，目前使用起来感觉十分方便。

理由主要有二：

一、完善的 git 功能的原生支持，可以十分方便地进行 git 所有相关操作（提交，同步等）

二、不错的实时预览效果。按快捷键 Ctrl+K + V 即可在右侧显示实时预览效果