另一个选择是在

source/_static

.wy-nav-content {
    max-width: none;
}

或

.wy-nav-content {
    max-width: 1200px !important;
}

确保目录在

source/conf.py

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']

然后在

source/_templates/layout.html

{% extends "!layout.html" %}
{% block extrahead %}
    <link href="{{ pathto("_static/style.css", True) }}" rel="stylesheet" type="text/css">
{% endblock %}

假设您调用了样式表

style.css

如果有人正在寻找更简单的答案...... 结合来自的想法 https://samnicholls.net/2016/06/15/how-to-sphinx-readthedocs/ 和上面的建议，我发现获取自定义窗口宽度的最简单方法如下：

1. 在

   conf.py

   中，添加一个添加自定义样式表的函数：

   def setup(app):
       app.add_css_file('my_theme.css')
   

2. 在

   conf.py

   ，状态/调整：

   html_static_path = ['_static'] 
   

3. Create a

   _static

   folder/directory if it doesn't exist.

4. 在包含以下行的

   my_theme.css

   文件夹中创建一个名为

   _static

   的文件：

   .wy-nav-content {
       max-width: 1200px !important;
   }
   

Sphinx 1.8.0b1（2018 年 9 月发布）中添加的 HTML 选项简化了该过程。 Read The Docs Documentation 中的recommendation是adding custom css to the theme via the

html_css_files

html_css_files = [
    'custom.css',
]

将custom.css放在html静态路径文件夹中（默认为_static文件夹）。

custom.css的内容：

.wy-nav-content {
    max-width: 75% !important;
}

首先我必须说，在我的 sphinx quickstart 期间，我为我的 sources 和我的 build.

这是一个3个步骤的过程：

1。为您的样式创建文档：

在哪里？

1. 在我的

   conf.py

   所在的同一目录中（在我的例子中是

   source

   ），我为我的自定义静态文件（样式表、javascript）创建了一个文件夹。我叫它

   custom

   .
2. 在里面我为我的样式表创建了一个子文件夹：

   source/custom/css

   .
3. 在这个子文件夹中，我将创建我的自定义样式：

   source/custom/css/my_theme.css

   .

2。告诉狮身人面像

现在我们必须告诉 sphinx 将此文档吐到

build/_static/css

conf.py

html_static_path = ['custom']       # Directory for static files.

完成。现在，如果我们构建，我们将在同一目录中拥有RTD样式（

theme.css

my_theme.css

build/_static/css

3。选择我们的自定义主题

现在我们要告诉狮身人面像使用我们的自定义

my_theme.css

conf.py

html_style = 'css/my_theme.css'     # Choosing my custom theme.

在我们的自定义样式表中，第一行应该导入

theme.css

@import url("theme.css");

我们准备开始覆盖样式。

更新：还有更简单的方法。

1。把你的定制放在里面

source/_static/css/my_theme.css

.

在您的自定义样式表中，第一行应该导入

theme.css

@import url("theme.css");

这样，您不必担心弄乱默认样式，如果您的自定义样式表不起作用，请删除并重新开始。

2。在

conf.py

中添加以下行：

html_style = 'css/my_theme.css' 

这里的解决方案有点老套。如果你想包含样式，并有一个 css 覆盖并让它在 RTD 上工作，你会想要这样的东西。

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()]
  html_style = 'css/custom.css'
else:
  html_context = { 
    'css_files': [
        'https://media.readthedocs.org/css/sphinx_rtd_theme.css',
        'https://media.readthedocs.org/css/readthedocs-doc-embed.css',
        '_static/css/custom.css',
    ],  
  }   

我自己对此进行了测试，它似乎在本地和 RTD 上都能正常工作。很大程度上抄袭自 https://blog.deimos.fr/2014/10/02/sphinxdoc-and-readthedocs-theme-tricks-2/

1. 来源