使用 teedoc 时的常见问题

可以在github issue 查看大家提过的问题以及解决方法， 可以提交问题， 也欢迎发现问题修改代码并提交PR

jinja2.exceptions.TemplateNotFound: base.html.j2

需要更新 nbconvert：

pip3 install --upgrade nbconvert

插件报错, 代码抛出错误

可以先尝试更新teedoc:

pip install -U teedoc

然后再在相应的文档下面更新插件:

teedoc install

如果仍然有问题, 可以到 github 提交 issue

OSError: [Errno 28] inotify watch limit reached

只会在使用teedoc serve时出现， 即文件监测数量达到了系统设置的上限。
一般发生在有软件大量检测了文件，常见的情况有：

• 编辑器如vscode打开了有非常多文件的文件夹， 关掉这类软件或者少打开文件（夹）一般就能解决问题， 参考 error ENOSPC
• 文档项目内的文档确实太多了，达到了监测的上限，这种情况一般很少出现，如果出现了，需要设置系统的监测上限值，具体方法请自行搜索

OSError: [WinError 10013] 以一种访问权限不允许的方式做了一个访问套接字的尝试。

一般这种情况重启可以解决。但是我们也可以指定使用别的端口来重新构建本地服务，比如 teedoc serve --port=4969
然后再访问127.0.0.1:4969来查看新构建的界面