problems.md 1.7 KB
title: 使用 teedoc 时的常见问题 keywords: teedoc, build, error, 出错, 问题, 无法运行
desc: 使用 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来查看新构建的界面