[toc]

从零开始搭博客

有个博客的需求是很正常的，大家都想或多或少地与人沟通，获得认同。
以前我也用过qq空间和新浪博客，但现在还是觉得独立博客才是我的归宿，
究其原因主要是因为网络暴力+隐私。
因为网络暴力我不想设置评论，所以独立博客有设置这方面的权限。
而隐私是因为网上不仅有自己的朋友，还有自己的长辈、晚辈、同事等各种关系的人。
如果用国内的那些博客网站，手机号是必要信息，
而手机号又是实名的，所以只有独立博客能满足我了。
我是一个不懂编程的小白，发现推荐github+gridea方案的人不少且相对简单，于是就采用这个了。

1 注册和设置github

  1. 注册github后建立仓库，仓库名="username".github.io。
    • username就是github的用户名，因为显示博客需要用到github的page服务，也就是用github page做网站，所以仓库名用这种格式后会自动开启该服务。
    • 如果没有自动开启，可以在页面上方右边的“setting/pages”中开启，注意不是账号里面的“setting”。
  2. page里面选master分支，root目录，主题不用设置，因为主题是用gridea来实现的。
  3. 在账号的“settings/developers settings/Personal access tokens”中新建一个token。
    • 因为gridea使用token访问github，所以token就相当于一个密码。
    • token只需要勾选repo的所有权限即可，且记得提前保存该token，稍后要用。

2 下载和设置gridea

  1. 安装好gridea后打开页面左侧的远程设置相关信息，除cname可不填外，其他都要根据上述步骤的信息来填写。详细参考点这里

3 发布博文

  1. 上面两部设置好后，就可以用gridea写文章了。写好后可以先点击预览查看文章是否有误。
  2. 文章无误后点击“同步”即可将文章发布到github page，几分钟后博客内容就会刷新成功。

解决博文同步失败的问题

不论使用什么工具来同步博文到github，都必须首先点击gridea的“同步”，
因为这个同步不仅是上传文章到github，更关键的是来生成博文必要的配置文件。
但是，这套方案最大的问题也在于gridea同步绝大多数时候都不可用。
gridea后续有发布新版本，不知道解决了此问题没有，反正我没更新，
因为我不懂编程，动手能力差，我怕更新后把我现有的可用方案都给整失效了。

1 使用git同步

gridea的同步既然是提交到github的仓库，那么本质就是用git在提交吧。
这样的话自己装好git服务后，手动提交就OK了。
具体的提交工具有这么几种：

  1. 使用git自带的git bash。这种属于命令行工具，需要熟悉基本命令，remote→add→commit→push等等（我都忘了，还得去翻以前的笔记）。
  2. 直接使用github官方的图形工具“Github Desktop”，直观好用得多。
    • 登录后先关联仓库，具体步骤忘了……
    • push前一定要先fetch，免得冲突，因为冲突解决起来特别麻烦。
    • push前还要选好分支，应该是默认的master。
    • 网络正常情况下push失败的话，应该是仓库token过期，更新一下即可。
  3. 使用sourcetree或小乌龟图形工具。这些都是老牌工具了，使用方法和github的一样。

解决github不支持toc的问题

MD文档只要在最前面插入toc就可以自动为带“#”的标题生成目录，
可是github却不支持！而且这么多年都不支持！
好像是因为markdown语法并不是统一的，各家都有一些差异。
没办法，只能网上去找大神们的解决方案了。

1 使用vscode生成目录

由于github无法解析toc语法自动生成目录，
那就直接生成超链接目录，这种基础语法就能解析了。

  1. 安装vscode后打开软件
  2. Ctrl+Shift+P后输入“language”，选择“configue display language”，更改为中文。（也可以直接点击上方搜索栏输入，但必须先输入“>”，否则无搜索结果）
  3. 点击左侧栏的“扩展”，输入“markdown all in one”，安装该插件。
  4. 打开md文件，光标定位到想插入目录的位置，接着ctrl+shift+p后输入“Markdown All in One: Create Table of Contents”回车，此时便能看到生成后的超链接目录。
  5. 最后将生成后的目录连同正文粘贴到gridea，再发布到github即可。

2 为知笔记如何生成md文件

如果用的是typora、cmd markdown等md编辑器，不会有这个问题。
因为我用的是为知笔记，所以要记录一下如何解决这问题。
为知笔记虽然支持md语法，但生成时没有md这个格式可选择，
刚开始我也有点头疼，尝试在保存时直接改后缀名，等待为知笔记渲染，结果失败……
后来网友点醒了我，因为md文件本质是纯文本，那些加粗、引用、标题都是阅读器渲染的。
于是我直接保存为txt，然后再将后缀名改为md，这样就相当于生成md文件了。

3 解决md文章的格式问题

这个问题也只会出现在类似为知笔记这种既支持md也支持富文本的编辑器中。
如果在写文章的过程中，有意无意地选择了某些富文本格式，
那么文本里就会留下这些格式符号，虽然不影响md渲染，但可能会影响在vscode中的目录生成。
因为有些符号在传统编辑器中看不见，但在vscode中就能看见，
比如标题中多个几个空格，这样即便生成了目录，也无法实现超链接的跳转功能，等于没用。
所以这种情况下，只需要将为知笔记的文章粘贴到纯文本编辑器即可，
这样不仅能自动清除富文本格式，还能手动删掉那些多余的空格。
之后再重新粘贴回为知笔记就行了，只是要记得以后不能在md文件中使用富文本格式了，
必须用md语法来实现，md不支持的那就算了，反正要保持语法和格式的一致。

（记录：22-1-19）