当前,我可以找到的方法是获取readthedocs.org使用的当前设计 Assets 的唯一方法是安装full theme并构建它,这需要SASS等。

我只想获取一组静态文件,这些文件可以让我在本地查看在readthedocs上构建的内容。有没有一种方法可以在不通过上述链接自己构建 Assets 的情况下进行此操作?目的是使新手可以轻松地为文档做出贡献。

最佳答案

如果您要为主题做贡献/开发,则只需要构建主题即可。您可以使用pip install sphinx_rtd_theme安装主题。然后,您可以在Sphinx conf.py中使用主题。另请:http://read-the-docs.readthedocs.org/en/latest/theme.html

# on_rtd is whether we are on readthedocs.org
import os
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'

if not on_rtd:  # only import and set the theme if we're building docs locally
    import sphinx_rtd_theme
    html_theme = 'sphinx_rtd_theme'
    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

# otherwise, readthedocs.org uses their theme by default, so no need to specify it

关于python - 使用readthedocs.org使用的静态 Assets 进行本地Sphinx构建的简单方法是什么?,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/24702540/

10-12 18:19