[Doc] improve PDFs (#55471)

(cherry picked from commit 17051d8)
StarRocks · Jan 27, 2025 · e5054f2 · e5054f2
1 parent ac22073
commit e5054f2
Showing 1 changed file with 17 additions and 13 deletions.
diff --git a/docs/docusaurus/src/css/custom.css b/docs/docusaurus/src/css/custom.css
@@ -85,22 +85,26 @@ a {
     var(--ifm-transition-timing-default);
 }
 
-/* When we generate PDF files we do not need to show the feedback widget. */
+/* When we generate PDF files:
+ 
+ - avoid breaks in the middle of:
+   - code blocks
+   - admonitions (notes, tips, etc.)
+
+ - we do not need to show the:
+   - feedback widget.
+   - edit this page
+   - breadcrumbs
+
+ */
 @media print {
-    .theme-edit-this-page {
-        display: none;
-    }
+  .theme-code-block , .theme-admonition {
+     break-inside: avoid;
+  }
 }
+
 @media print {
-    .feedback_Ak7m {
+    .theme-edit-this-page , .feedback_Ak7m , .theme-doc-breadcrumbs   {
         display: none;
     }
-
-    .theme-doc-footer-edit-meta-row {
-        display: none;
-    };
-
-    .breadcrumbs {
-        display: none;
-    };
 }