Merge pull request #1052 from sphinx-contrib/cleanup-documentation

Cleanup documentation

Author: jdknight

doc/advanced-extensions.rst

@@ -38,6 +38,10 @@ this node with Sphinx Confluence Builder:
     def depart_custom_node(self, node):
         self.body.append(self.context.pop())
 
+.. raw:: latex
+
+    \newpage
+
 Confluence Storage Format Translator Helpers
 --------------------------------------------
 

doc/conf.py

@@ -81,6 +81,10 @@
 # -- Options for Latex output --------------------------------------------
 
 latex_elements = {
+    # explicit verbatim spacing (looks better?)
+    'sphinxsetup': r'''
+        verbatimsep=0.75em,
+    ''',
     # remove empty pages
     'extraclassoptions': 'openany,oneside',
     # custom title
@@ -104,11 +108,18 @@
     # disable hyphenatation
     # disable justified text
     # remove italics from links
+    # new page for each section 
+    # minimize spacing between admonitions
     'preamble': r'''
         \usepackage{datetime2}
         \usepackage[none]{hyphenat}
         \usepackage[document]{ragged2e}
         \def\sphinxcrossref#1{#1}
+        \newcommand{\sectionbreak}{\newpage}
+        \NewDocumentEnvironment{ScbShrinkAdmonition}{O{}}
+            {\vspace{-.6\baselineskip}}{\vspace{-.6\baselineskip}}
+        \BeforeBeginEnvironment{sphinxadmonition}{\begin{ScbShrinkAdmonition}}
+        \AfterEndEnvironment{sphinxadmonition}{\end{ScbShrinkAdmonition}}
     ''',
 }