cli/aux-print: Improve pdf generation

Signed-off-by: Jorge Marques <[email protected]>
analogdevicesinc · Dec 13, 2024 · 1874281 · 1874281
1 parent 02763ed
commit 1874281
Show file tree

Hide file tree

Showing 4 changed files with 14 additions and 7 deletions.
diff --git a/adi_doctools/cli/aux_print.py b/adi_doctools/cli/aux_print.py
@@ -39,9 +39,20 @@ def sanitize_singlehtml(file) -> str:
 
     bwrap = root.xpath("//div[@class='bodywrapper']")[0]
 
-    # Remove first H1
+    # Remove first H1 and replace with break-before
+    # if next if not a section (e.g. introduction)
     h1_ = bwrap.xpath(".//h1")[0]
-    h1_.getparent().remove(h1_)
+    e_p = h1_.getparent()
+    e_n = h1_.getnext()
+    if e_n.tag != 'section':
+        if 'class' in e_n.attrib and "toctree-wrapper" in e_n.attrib['class']:
+            pass
+        else:
+            ele_break = etree.Element("span")
+            ele_break.attrib['class'] = "break-before"
+            e_p.insert(e_p.index(h1_), ele_break)
+    e_p.remove(h1_)
+
 
     # Add description
     ele_desc = etree.Element("span")

diff --git a/adi_doctools/theme/cosmic/style/element.scss b/adi_doctools/theme/cosmic/style/element.scss
@@ -142,7 +142,7 @@ img {
     .break-after {
         break-after: always;
     }
-    .break-before {
+    .break-before, h2 {
         break-before: always;
     }
 }

diff --git a/adi_doctools/theme/cosmic/style/weasyprint.css b/adi_doctools/theme/cosmic/style/weasyprint.css
@@ -79,7 +79,6 @@
 
 h2 {
     string-set: heading content();
-    break-before: always;
 }
 
 footer {

diff --git a/docs/index.rst b/docs/index.rst
@@ -11,9 +11,6 @@ on the directives and roles packaged on this repository.
 And read the :ref:`cli` for information about the command line interface
 provided by Doctools.
 
-Contents
-===============================================================================
-
 .. toctree::
    :maxdepth: 1
-Original file line number
+Diff line change
@@ Expand Up / @@ -79,7 +79,6 @@ @@
     h2 {
         string-set: heading content();
-        break-before: always;
     }
     footer {
@@ Expand Down @@