wzasd's Blog

➠ 前往博客🚀🚀🚀

基于Material for MkDocs V8.1.8

• master分支
  博客的源文件，包括CNAME等

1. 在master分支上进行blog的写作
2. 调用serve.sh脚本进行本地预览
3. 写作完毕后先提交到repo
4. 通过 github 的 ci 直接部署到 iO page 即可

常见问题

1. 操作流程
   • fork项目或者随便怎么样
   • 安装python环境、pip之后跟随Getting started进行安装
   • 执行mkdocs serve --dirtyreload进行写作时的动态预览

2.创建 CI 的脚本

• 选择 Github 首页 Actions 的选项

  • 选择 New workflow
  • 复制代码
  • 讲 github.io Pages 设置成 gh-deploy分支
  • 每次推送 master 都会执行 ci 部署到 io 页

  name: ci 
  on:
    push:
      branches:
        - master 
  jobs:
    deploy:
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v2
        - uses: actions/setup-python@v2
          with:
            python-version: 3.x
        - run: pip install mkdocs-material 
        - run: mkdocs gh-deploy --force

3. FAQ

若出现如下报错：

Config value: 'plugins'. Error: The "git-revision-date-localized" plugin is not installed

请查阅对应repo上面的安装介绍https://github.com/timvink/mkdocs-git-revision-date-localized-plugin
目前来看，安装即可mkdocs-git-revision-date-localized-plugin即可

下面的问题同样是插件问题：

Config value: 'plugins'. Error: The "minify" plugin is not installed

执行pip install mkdocs-minify-plugin安装插件

执行mkdocs serve时出错：

ERROR   -  Error reading page 'android\3rd-library\glide1.md': 'NoneType' object has no attribute 'end'
...
markdown\htmlparser.py", line 95, in line_offset
    return re.match(r'([^\n]*\n){{{}}}'.format(self.lineno-1), self.rawdata).end()
AttributeError: 'NoneType' object has no attribute 'end'

仔细看堆栈时markdown插件报错，将其降级到3.2.1版本即可：

pip uninstall markdown
pip install -v markdown==3.2.1

下面命令是常用的pip命令：

## 列出所有安装的包
$ pip list
Package                                   Version
----------------------------------------- ----------
Babel                                     2.9.0
click                                     7.1.2
future                                    0.18.2
gitdb                                     4.0.5
GitPython                                 3.1.12
htmlmin                                   0.1.12
importlib-metadata                        3.4.0
Jinja2                                    2.11.2
joblib                                    1.0.0
jsmin                                     2.2.2
livereload                                2.6.3
lunr                                      0.5.8
Markdown                                  3.2.1
MarkupSafe                                1.1.1
mkdocs                                    1.1.2
mkdocs-git-revision-date-localized-plugin 0.8
mkdocs-material                           6.2.5
mkdocs-material-extensions                1.0.1
mkdocs-minify-plugin                      0.4.0
nltk                                      3.5
pip                                       21.0
Pygments                                  2.7.4
pymdown-extensions                        8.1
pytz                                      2020.5
PyYAML                                    5.3.1
regex                                     2020.11.13
setuptools                                47.1.0
six                                       1.15.0
smmap                                     3.0.4
tornado                                   6.1
tqdm                                      4.56.0
typing-extensions                         3.7.4.3
zipp                                      3.4.0

## 输出指定包的相关信息
$ pip show markdown
Name: Markdown
Version: 3.2.1
Summary: Python implementation of Markdown.
Home-page: https://Python-Markdown.github.io/
Author: Manfred Stienstra, Yuri takhteyev and Waylan limberg
Author-email: waylan.limberg@icloud.com
License: BSD License
Location: c:\users\liuya\appdata\local\programs\python\python37\lib\site-packages
Requires: setuptools