Jekyll博客TeXt搭建过程问题记录

背景

想搭建个个人博客，担心买的服务器可能会跑路，没有选择搭载在云服务器上。
再考虑到hexo等需要本地端要安装，感觉自己应该是轻度使用博客，嫌麻烦。最后选择用Github Page+Jekyll来实现。
这样的话，配置好后只需要git push写好的markdown文件即可。
经过一番物色，最后发现有大佬做好的主题很不错，想要的功能都准备好了。

搭建

直接看这篇快速开始，不是很稳定，需要你懂得上网。
按照中文的文档搭建即可，我是选择fork后更名为github.io，再git clone下来，这样不用安装Jekyll。
看完这个文档再来看下面的。

遇到的问题

git使用

可以参考我的博客git简要使用

gittalk

配置好会出现未找到相关issue进行评论的问题

• 首先，确保已经为你的username.github,io打开了issue
• 然后在你的blog的gittalk上登陆你的github账号
• 这样以后你在发布好博客预览时就会初始化gittalk

这可能不是最好的解决方法，如果哪位有较好的解决方法请评论里说一下^_^
也有大佬写了自动初始化gittalk的脚本，百度搜索就有

leancloud统计点击量为0

按文档配置好后发现每个文章的阅读量一直是0，后来把_config.yml的pageview provider:的leancloud加上双引号就成功了。

搜索引擎收录博客

写完博客后使用baidu和google都搜索不到，需要自己提交。
提交网址为：

• Google
  1.选择网址前缀
  2.选择html验证，把html文件下载后放到github.io的repo根目录就行
  3.验证成功后选择站点地图（TeXt已经把sitemap插件安装好了），添加https://username.github.io/sitemap.xml即可。
  sitemap文件就是能够让搜索引擎
• Baidu
  和google类似，不过据说

写个自己的about

直接更改根目录的about.md

yaml

yaml写在自己每篇博客的markdown文件开头，举个例子

---
title:Example
tag: example
key :2020-06-14example
---

其中key是任意的只需要每篇文章不同即可，用来区分gittalk的issue和leancloud统计的
真正的时间是看md文件名的

vscode替换图片

这个博客有个比较大的问题是：图片在构建博客后无法按照相对路径寻址，只能上传图床

解决

使用vscode的全局文本替换功能
将../imgsrc替换为https://xdo0.github.io/imgsrc

p.s.

之前尝试用GitHub action替换，试了几个github action market的，效果不好；也尝试自己写，发现太麻烦了

折叠块代码高亮

这个尝试使用highlight.js来实现：
在_layouts\page.html中添加：

<link rel="stylesheet"
      href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/11.6.0/styles/base16/tomorrow.min.css">
<script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/11.6.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>

其中default.min.css可以换成其他style的名字，来切换style，在highlightjs/cdn-release的目录里查看有哪些style
这样就可以在md文件里，因为highlight.js可以匹配<pre><code></></>来高亮代码块

<details><summary>Click to show the Code</summary>
<pre><code class='python'>
import os    
</code></pre>
</details>

都选择tomorrow的style效果最好

飞书文档转换为markdown

可以参考这里，其中飞书应用申请要看最新的README

这个博客使用的高亮不支持bash，可以用shell替代

欢迎参观我的博客：https://xdo0.github.io