--- title: 使用 teedoc 时的常见问题 keywords: teedoc, build, error, 出错, 问题, 无法运行 desc: 使用 teedoc 时的常见问题 --- 可以在[github issue](https://github.com/teedoc/teedoc/issues?q=) 查看大家提过的问题以及解决方法, 可以提交问题, 也欢迎发现问题修改代码并提交PR ## jinja2.exceptions.TemplateNotFound: base.html.j2 需要更新 `nbconvert`: ```shell pip3 install --upgrade nbconvert ``` ## 插件报错, 代码抛出错误 可以先尝试更新`teedoc`: ``` pip install -U teedoc ``` 然后再在相应的文档下面更新插件: ``` teedoc install ``` 如果仍然有问题, 可以到 github [提交 issue](https://github.com/teedoc/teedoc/issues/new) ## OSError: [Errno 28] inotify watch limit reached 只会在使用`teedoc serve`时出现, 即文件监测数量达到了系统设置的上限。 一般发生在有软件大量检测了文件,常见的情况有: * 编辑器如`vscode`打开了有非常多文件的文件夹, 关掉这类软件或者少打开文件(夹)一般就能解决问题, 参考 [error ENOSPC](https://code.visualstudio.com/docs/setup/linux#_visual-studio-code-is-unable-to-watch-for-file-changes-in-this-large-workspace-error-enospc) * 文档项目内的文档确实太多了,达到了监测的上限,这种情况一般很少出现,如果出现了,需要设置系统的监测上限值,具体方法请自行搜索 ## OSError: [WinError 10013] 以一种访问权限不允许的方式做了一个访问套接字的尝试。 一般这种情况重启可以解决。但是我们也可以指定使用别的端口来重新构建本地服务,比如 `teedoc serve --port=4969` 然后再访问[127.0.0.1:4969](127.0.0.1:4969)来查看新构建的界面