问题描述
我在“源”文件夹中进行了一些最小的更新,并使用make html
命令重建了HTML。一切正常,我将文件夹同步到GitHub。但是,当我在“阅读文档”网站上重建文档时,在cat source/conf.py
之后出现了这样的错误:
AssertionError: wrong color format 'var(--jp-mirror-editor-variable-color)'
我只是在文档中添加了一些文本并修正了一些错字,仅此而已。为什么会发生此错误而构建失败?谢谢。
Traceback (most recent call last):
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/sphinx/cmd/build.py",line 303,in build_main
args.tags,args.verbosity,args.jobs,args.keep_going)
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/sphinx/application.py",line 228,in __init__
self.setup_extension(extension)
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/sphinx/application.py",line 449,in setup_extension
self.registry.load_extension(self,extname)
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/sphinx/registry.py",line 472,in load_extension
mod = __import__(extname,None,['setup'])
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/nbsphinx.py",line 41,in <module>
import nbconvert
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/nbconvert/__init__.py",line 4,in <module>
from .exporters import *
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/nbconvert/exporters/__init__.py",in <module>
from .slides import SlidesExporter
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/nbconvert/exporters/slides.py",line 12,in <module>
from ..preprocessors.base import Preprocessor
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/nbconvert/preprocessors/__init__.py",line 7,in <module>
from .csshtmlheader import CSSHTMLHeaderPreprocessor
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/nbconvert/preprocessors/csshtmlheader.py",line 14,in <module>
from jupyterlab_pygments import JupyterStyle
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/jupyterlab_pygments/__init__.py",in <module>
from .style import JupyterStyle
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/jupyterlab_pygments/style.py",line 10,in <module>
class JupyterStyle(Style):
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/pygments/style.py",line 101,in __new__
ndef[0] = colorformat(styledef)
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/pygments/style.py",line 58,in colorformat
assert False,"wrong color format %r" % text
AssertionError: wrong color format 'var(--jp-mirror-editor-variable-color)'
Exception occurred:
File "/home/docs/checkouts/readthedocs.org/user_builds/pkg_name/envs/latest/lib/python3.7/site-packages/pygments/style.py","wrong color format %r" % text
AssertionError: wrong color format 'var(--jp-mirror-editor-variable-color)'
The full traceback has been saved in /tmp/sphinx-err-scp_kb7h.log,if you want to report the issue to the developers.
Please also report this if it was a user error,so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
解决方法
这似乎与一个人使用的Pygments版本有关(有关详细信息,请参见此GitHub issue),该版本必须大于2.4.1。
就我而言,该问题已通过要求ReadTheDocs使用:Pygments==2.6.1
我也遇到了同样的问题。在我的情况下,由于笔记本电脑升起,我将笔记本电脑更新到最新版本,并将康达本身留给了一个很旧的笔记本电脑,因此可能会引起问题,但我运行了代码:{ {1}}对我来说很好用
,我面临着同样的问题。对我来说,这可以通过遵循Python command fails with AssertionError: wrong color format中的步骤(基本上是通过安装nbconvert==6.0.0rc0
)来解决。谢谢
我在使用 iPython 笔记本时遇到了这个问题,因为我有一个旧版本的 Pygments。使用
升级 Pygmentspip3 install --upgrade Pygments