导读
开通了博客园的 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"
-
四个使用心得
A. 创建 GitHub 同步源时,“
文件夹
” 是指跟踪 git 仓库中的哪个文件夹的 md 文件的变化,比如想跟踪整个仓库的 md 文件
,那么就写根目录 “/
”; 如果只跟踪 git 仓库的文件夹下/docs
,那么就填写 “/docs
”这里根据个人文章规划情况,先决定是要同步整个目录,还是只同步具体子目录。比如我这里,README.md 我也要发布,同时想根据不同的类型的文章,在根目录下分不同的子目录来写 md 文件,所以我选择填写 “/”
B. “当新文件创建时”:可选项有 “
无操作
”、“新建草稿
”、“新建随笔并发布
”。个人建议使用 “新建草稿
”“无操作”:不做任何动作,感觉选这个那么同步就失去了意义。可能一些特殊情况才会用到。 “新建草稿”:个人推荐选项,因为这样可以不至于一创建文件,一 commit 就立刻发布了文章。可以分多次提交,当作临时保存而不至于立刻发布。而且,选择该选项后,当在博客源发布了草稿,那么下次修改文件 commit 之后,也会保持文章的“已发布”状态,不会重新变回未发布的草稿状态。 “新建随笔并发布”:这个一创建文件就发布了,只适合一次性就写完文章,这个可能不太适合我。我一般写博客习惯会分多次编辑修订细节之后,再正式发布。
C. “当源文件被删除时”:可选项有 “
无操作
”、“取消发布
”、“删除博文
”。个人建议使用 “取消发布
”“无操作”:不做任何动作,感觉选这个那么同步就失去了意义。可能一些特殊情况才会用到。 “取消发布”:个人推荐选项,因为文章如果有评论的话,直接 “删除博文” 会导致评论永久性丢失。 “删除博文”:如文字所述,删除 md 文件将直接将所有数据包括评论全部删除。
D. "启用 Markdown FrontMatter", 这个可以根据定制的模板,自动让 cnblogs 确认 “
文章标题
”、 “博客预览摘要
”、“使用的标签
” 和 “使用的文章分类
”启用之后,按默认格式,只要在 md 文章开头写下如下内容,即可自定义上面提到的各个项
---
title: 博文标题
description: 博文摘要
#多个标签请使用英文逗号分隔或使用数组语法
tags: 标签1, 标签2
#多个分类请使用英文逗号分隔或使用数组语法,暂不支持多级分类
category: 分类1, 分类2
---
正文内容
具体使用示例参考 [个人文章列表-1],本 cnblogs 博文就是通过 GitHub 编写的 md 文件自动生成
个人文章列表
参考文章
本文源地址:https://www.cnblogs.com/BensonLaur/p/18306067
标签:md,同步,cnblogs,博文,GitHub,文章 From: https://www.cnblogs.com/BensonLaur/p/18306067