Mkdocs¶

图片放大¶

参考：基于mkdocs-material实现的帮助中心(markdown + 中文搜索 + 图片放大)

基于 Gitalk 搭建评论系统¶

在你的 github 下新建一个专门用来放评论的仓库 comment，再申请一个申请 clientID 和 clientSecret，点击这个链接就可以申请了

Note

Application name 随便取

Homepage URL 就是你博客的主页地址

Authorization callback URL 保持和 Homepage URL 一样
找到 mkdocs-material 安装路径
Note

终端中输入
```
python3
import material
material
```
然后应该就能看到
```
<module 'material' from '/usr/local/lib/python3.8/site-packages/material/__init__.py'>
```
后面路径的上一级 /usr/local/lib/python3.8/site-packages/material 就是 mkdocs-material 的安装路径

Finder 中前往上面的路径，进入 /partials/intergrations，打开里面的 disqus.html

用下面的代码覆盖 disqus.html 里面的内容

<h2 id="__comments">{{ lang.t("meta.comments") }}</h2>
<form id="gitalk-form" onsubmit="return false;">
    <div id="gitalk-container"></div>
</form>
<link rel="stylesheet" href="https://unpkg.com/gitalk/dist/gitalk.css">
<script src="https://unpkg.com/gitalk/dist/gitalk.min.js"></script>
<script src="https://cdnjs.loli.net/ajax/libs/blueimp-md5/2.10.0/js/md5.min.js"></script>
<script>
    const gitalk = new Gitalk({
        clientID: '', // add yourself's
        clientSecret: '', // add yourself's
        repo: 'comment', // add yourself's
        owner: 'Stardusten',
        admin: ['Stardusten'],
        id: md5(location.pathname),      // Ensure uniqueness and length less than 50
        distractionFreeMode: false  // Facebook-like distraction free mode
    })
    gitalk.render('gitalk-container')
</script>

Warning

注意 repo 填的是 仓库名 而不是地址，否则就会出现 Failed: NOT Found

行间代码块语法高亮¶

Pygments 主题更换¶

下载对应主题的 css 样式文件，再在 Mkdocs.yml 的 extra_css: 项中加入即可

使用 highlight.js 替代 Pygments¶

Warning

强烈不建议这么做，一来 highlight.js 分词效果不如 pygments；二来 hightlight.js 是前端实现，影响网页加载速度；三来如果使用 hightlight.js，嵌套、缩进代码块等功能将无法使用