sphinx-doc#4246: Limit width of text body for all themes

Author: timhoffm

CHANGES

@@ -13,6 +13,8 @@ Incompatible changes
 * #3929: apidoc: Move sphinx.apidoc to sphinx.ext.apidoc
 * #4226: apidoc: Generate new style makefile (make-mode)
 * #4274: sphinx-build returns 2 as an exit code on argument error
+* #4246: Limit width of text body for all themes. Conifigurable via theme
+  options ``minbodywidth`` and ``maxbodywidth``.
 
 Deprecated
 ----------

doc/theming.rst

@@ -117,6 +117,12 @@ These themes are:
   - **sidebarwidth** (an integer): Width of the sidebar in pixels.  (Do not
     include ``px`` in the value.)  Defaults to 230 pixels.
 
+  - **minbodywidth** (an integer): Minimal width of the document body in
+    pixels.  Defaults to 450 pixels.
+
+  - **minbodywidth** (an integer): Maximal width of the document body in
+    pixels.  Defaults to 800 pixels.
+
 * **alabaster** -- `Alabaster theme`_ is a modified "Kr" Sphinx theme from @kennethreitz
   (especially as used in his Requests project), which was itself originally based on
   @mitsuhiko's theme used for Flask & related projects.

sphinx/themes/basic/static/basic.css_t

@@ -199,6 +199,11 @@ table.modindextable td {
 
 /* -- general body styles --------------------------------------------------- */
 
+div.body {
+    min-width: {{ theme_minbodywidth|toint }}px;
+    max-width: {{ theme_maxbodywidth|toint }}px;
+}
+
 div.body p, div.body dd, div.body li, div.body blockquote {
     -moz-hyphens: auto;
     -ms-hyphens: auto;

sphinx/themes/basic/theme.conf

@@ -7,4 +7,6 @@ sidebars = localtoc.html, relations.html, sourcelink.html, searchbox.html
 [options]
 nosidebar = false
 sidebarwidth = 230
+minbodywidth = 450
+maxbodywidth = 800
 navigation_with_keys = False