Merge pull request #180 from scalableminds/draft-watermark

use sphinxmark to add draft watermark to all pages

Author: joshmoore

docs/_static/css/custom.css

@@ -0,0 +1,18 @@
+.bd-main .bd-content .bd-article-container {
+    flex-grow: 1;
+    max-width: 100%;
+}
+
+@media (min-width:960px) {
+    .bd-page-width {
+        max-width: 100rem;
+    }
+}
+
+footer {
+    display: none;
+}
+
+.sidebar-end-items {
+    margin-top: 0% !important;
+}

docs/_static/draft-watermark.png

@@ -28,9 +28,14 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-  'sphinxcontrib.mermaid'
+  'sphinxcontrib.mermaid',
+  'sphinxmark',
 ]
 
+sphinxmark_enable = True
+sphinxmark_div = 'bd-article-container'
+sphinxmark_image = 'draft-watermark.png'
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -52,6 +57,8 @@
   "github_url": "https://github.com/zarr-developers/zarr-specs",
   "twitter_url": "https://twitter.com/zarr_dev/",
   "show_prev_next": False,
+  "secondary_sidebar_items": ["page-toc"],
+  "footer_items": [],  # hidden in custom css
 }
 
 
@@ -60,6 +67,10 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
+html_css_files = [
+    'css/custom.css',
+]
+
 suppress_warnings = [
     # suppress "duplicate citation" warnings
     'ref.citation',

docs/conf.py

@@ -1,3 +1,4 @@
 sphinx
-pydata-sphinx-theme
+pydata-sphinx-theme==0.12.0
 sphinxcontrib-mermaid
+sphinxmark