sphinx_rtd_theme主题¶

安装:

pip install sphinx_rtd_theme   // 我用这种方法好像没有起作用
cat config.py:
  html_theme = "sphinx_rtd_theme"
or
git clone https://github.com/rtfd/sphinx_rtd_theme.git
cp -r sphinx_rtd_theme/sphinx_rtd_theme ./source/_themes/
cat config.py:
  html_theme = "sphinx_rtd_theme"
  html_theme_path = ["_themes", ]

其他配置:

html_theme_options = {
    'canonical_url': '',
    'analytics_id': '',
    'logo_only': False,
    'display_version': True,
    'prev_next_buttons_location': 'bottom',
    'style_external_links': False,
    'vcs_pageview_mode': '',   // @todo  这个配置出错，原因未定
    # Toc options
    'collapse_navigation': True,
    'sticky_navigation': True,
    'navigation_depth': 4,
    'includehidden': True,
    'titles_only': False
}

备注

有问题时，一定记得来这儿查使用方法