diff --git a/docs/_static/css/theme_overrides.css b/docs/_static/css/theme_overrides.css new file mode 100644 index 0000000..b018c1f --- /dev/null +++ b/docs/_static/css/theme_overrides.css @@ -0,0 +1,17 @@ +/* override table width restrictions */ +@media screen and (min-width: 767px) { + + .wy-table-responsive table td { + /* !important prevents the common CSS stylesheets from overriding + this as on RTD they are loaded after this stylesheet */ + white-space: normal !important; + } + + .wy-table-responsive { + overflow: visible !important; + } + + .wy-nav-content { + max-width: 1500px !important; + } + } \ No newline at end of file diff --git a/docs/_static/img/320px-Open-ZFS-Secondary-Logo-Colour-halfsize.png b/docs/_static/img/logo/320px-Open-ZFS-Secondary-Logo-Colour-halfsize.png similarity index 100% rename from docs/_static/img/320px-Open-ZFS-Secondary-Logo-Colour-halfsize.png rename to docs/_static/img/logo/320px-Open-ZFS-Secondary-Logo-Colour-halfsize.png diff --git a/docs/_static/img/480px-Open-ZFS-Secondary-Logo-Colour-halfsize.png b/docs/_static/img/logo/480px-Open-ZFS-Secondary-Logo-Colour-halfsize.png similarity index 100% rename from docs/_static/img/480px-Open-ZFS-Secondary-Logo-Colour-halfsize.png rename to docs/_static/img/logo/480px-Open-ZFS-Secondary-Logo-Colour-halfsize.png diff --git a/docs/_static/img/800px-Open-ZFS-Secondary-Logo-Colour-halfsize.png b/docs/_static/img/logo/800px-Open-ZFS-Secondary-Logo-Colour-halfsize.png similarity index 100% rename from docs/_static/img/800px-Open-ZFS-Secondary-Logo-Colour-halfsize.png rename to docs/_static/img/logo/800px-Open-ZFS-Secondary-Logo-Colour-halfsize.png diff --git a/docs/_static/img/logo/logo_main.png b/docs/_static/img/logo/logo_main.png new file mode 100644 index 0000000..cc86e84 Binary files /dev/null and b/docs/_static/img/logo/logo_main.png differ diff --git a/docs/conf.py b/docs/conf.py index ac6e6f7..5be480e 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -6,6 +6,8 @@ # full list see the documentation: # http://www.sphinx-doc.org/en/master/config +import sphinx_rtd_theme + # -- Path setup -------------------------------------------------------------- # If extensions (or modules to document with autodoc) are in another directory, @@ -43,6 +45,7 @@ extensions = [ 'sphinx.ext.githubpages', 'sphinx.ext.intersphinx', "sphinx_issues", + "sphinx_rtd_theme", ] # Add any paths that contain templates here, relative to this directory. @@ -81,23 +84,30 @@ pygments_style = None # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # -html_theme = 'alabaster' +html_theme = 'sphinx_rtd_theme' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. # html_theme_options = { - 'logo': '/img/320px-Open-ZFS-Secondary-Logo-Colour-halfsize.png', -# 'page_width': 'auto', -# 'body_max_width': 'auto', + 'logo_only': True, + 'style_nav_header_background': '#29667e', } +html_logo = '_static/img/logo/logo_main.png' + # 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'] +html_context = { + 'css_files': [ + '_static/css/theme_overrides.css', # override wide tables in RTD theme + ], + } + # Custom sidebar templates, must be a dictionary that maps document names # to template names. #