Merge pull request #178 from plotly/apidoc_theme

nicolaskruchten · web-flow · commit 21c84bdce031 · 2019-11-07T16:18:59.000-05:00
Apidoc theme
diff --git a/apidoc/_static/logo.png b/apidoc/_static/logo.png
diff --git a/apidoc/_static/plotly-style.css b/apidoc/_static/plotly-style.css
@@ -0,0 +1,13 @@
+.navbar-default {
+    background-color: #00004f;
+}
+.navbar {
+    min-height: 75px;
+}
+.navbar-brand {
+    font-family: "Open Sans", sans-serif;
+    padding: 10px 10px;
+}
+.body {
+    font-family: "Open Sans", sans-serif;
+}
diff --git a/apidoc/conf.py b/apidoc/conf.py
@@ -14,13 +14,13 @@
 #
 import os
 import sys
-
+import sphinx_bootstrap_theme
 # sys.path.insert(0, os.path.abspath("../packages/python/plotly"))
 
 
 # -- Project information -----------------------------------------------------
 
-project = "plotly"
+project = ""
 copyright = "2019, plotly team"
 author = "plotly team"
 
@@ -87,18 +87,18 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "alabaster"
+html_theme = "bootstrap"
+html_theme_path = sphinx_bootstrap_theme.get_html_theme_path()
 
+html_logo='logo.png'
 # 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 = {
-        #'nosidebar': True,
-        'analytics_id':'UA-39373211-1',
-        'logo':'logo.png',
-        'page_width': '70%',
-        'sidebar_width':'20%'
+        'analytics_id':'UA-39373211-1', # not supported by this theme
+        'bootswatch_theme': "flatly",
+        'source_link_position': "no"
         }
 
 # Add any paths that contain custom static files (such as style sheets) here,
@@ -203,3 +203,6 @@
 
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
+
+def setup(app):
+    app.add_stylesheet("plotly-style.css") # also can be a full URL
diff --git a/requirements.txt b/requirements.txt
@@ -18,6 +18,7 @@ networkx
 squarify
 scikit-image
 sphinx
+sphinx_bootstrap_theme
 recommonmark
 pathlib
 python-frontmatter
