doc: switch to sphinx_rtd_theme

Signed-off-by: Kefu Chai <[email protected]>
mitsu-ko · Mar 4, 2021 · 275c6bd · 275c6bd
1 parent cb7c0b4
commit 275c6bd
Show file tree

Hide file tree

Showing 5 changed files with 18 additions and 337 deletions.
diff --git a/admin/doc-requirements.txt b/admin/doc-requirements.txt
@@ -8,6 +8,7 @@ pcpp
 prettytable
 sphinx-autodoc-typehints
 sphinx-prompt
+sphinx_rtd_theme
 Sphinx-Substitution-Extensions
 typed-ast
 sphinxcontrib-openapi
diff --git a/doc/_themes/ceph/static/ceph.css_t b/doc/_themes/ceph/static/ceph.css_t
@@ -0,0 +1 @@
+@import url("css/theme.css");
diff --git a/doc/_themes/ceph/static/nature.css_t b/doc/_themes/ceph/static/nature.css_t
diff --git a/doc/_themes/ceph/theme.conf b/doc/_themes/ceph/theme.conf
@@ -1,4 +1,4 @@
 [theme]
-inherit = basic
-stylesheet = nature.css
+inherit = sphinx_rtd_theme
+stylesheet = ceph.css
 pygments_style = tango
diff --git a/doc/conf.py b/doc/conf.py
@@ -44,6 +44,20 @@ def is_release_eol(codename):
 
 # HTML output options
 html_theme = 'ceph'
+html_theme_options = {
+    'logo_only': True,
+    'display_version': False,
+    'prev_next_buttons_location': 'bottom',
+    'style_external_links': False,
+    'vcs_pageview_mode': '',
+    'style_nav_header_background': 'white',
+    # Toc options
+    'collapse_navigation': True,
+    'sticky_navigation': True,
+    'navigation_depth': 4,
+    'includehidden': True,
+    'titles_only': False
+}
 html_theme_path = ['_themes']
 html_title = "Ceph Documentation"
 html_logo = 'logo.png'