Fix documentation browser resizing behavior

Remove hardcoded dimensions from a few CSS parameters to prevent
layout problems when readers resize their browsers to have a narrower
window.

Set a max-width: 60em on the main content so that text remains
readable on wide browser windows.

ticket: 7503 (new)
target_version: 1.11
tags: pullup

diff --git a/doc/_static/kerb.css b/doc/_static/kerb.css
index f283496623b277cf85ea3c726c26a2d4e5208333..eb93bc48a86e6b7eecb750d16d6ed3591bae693f 100644 (file)
--- a/doc/_static/kerb.css
+++ b/doc/_static/kerb.css
@@ -16,6 +16,9 @@ div.body {
 div.header, div.content, div.footer {
   margin-left: auto;
   margin-right: auto;
+  padding-left: 1em;
+  padding-right: 1em;
+  max-width: 60em;
 }
 
 div.header-wrapper {
@@ -107,6 +110,10 @@ div.sidebar li.toctree-l4 a {
   display: none;
 }
 
+div.sidebar input[type=text] {
+  width: auto;
+}
+
 /* Other body styles */
 
 dt:target, .highlighted {

diff --git a/doc/conf.py b/doc/conf.py
index 53898aec7d46dfa5bf6aa13efd8126d0ceb07cb4..44fe812574e6af443b9dcd498ce17e84cd0bdd9b 100644 (file)
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -107,8 +107,8 @@ html_theme = 'agogo'
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = { "linkcolor": "#a63019", "footerbg":  "#59121e",
-                       "bgcolor": "#59121e", "documentwidth": "900px",
-                       "pagewidth": "960px", "sidebarwidth": "40px" }
+                       "bgcolor": "#59121e", "documentwidth": "80%",
+                       "pagewidth": "auto", "sidebarwidth": "20%" }
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []