From d58fd14944d8ad588598ba7e51c5d87b1b85c3b0 Mon Sep 17 00:00:00 2001
From: Simon Ruggier <Simon.Ruggier@gmail.com>
Date: Sat, 5 Oct 2024 00:18:51 -0400
Subject: [PATCH 1/3] Add print styles to remove navigation elements and excess
 whitespace

This makes it much easier to export the documentation to PDF or paper
for offline reading.
---
 components/content.tsx |  6 +++---
 components/nav.tsx     |  2 +-
 package-lock.json      | 11 +++++++++++
 package.json           |  1 +
 styles/styles.scss     | 19 +++++++++++++++++++
 5 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/components/content.tsx b/components/content.tsx
index 731cd9a9..1069758d 100644
--- a/components/content.tsx
+++ b/components/content.tsx
@@ -6,7 +6,7 @@ import Link from "next/link";
 function Footer({ next, prev, mdPath }) {
   let edit = `https://github.com/tokio-rs/website/edit/master/content/${mdPath}`;
   return (
-    <div className="tk-doc-footer">
+    <div className="tk-doc-footer is-hidden-print">
       <div className="level">
         <div className="level-left">
           <div className="level-item tk-prev">
@@ -98,7 +98,7 @@ function TableOfContents({ headings }) {
   }, [headings]);
 
   return (
-    <aside className="column is-one-third tk-content-summary">
+    <aside className="column is-one-third tk-content-summary is-hidden-print">
       <ul className="tk-content-summary-menu">{list}</ul>
     </aside>
   );
@@ -134,7 +134,7 @@ export default function Content({
   return (
     <>
       <div className="columns is-marginless tk-docs">
-        <div className="column is-one-quarter tk-docs-nav">
+        <div className="column is-one-quarter tk-docs-nav is-hidden-print">
           <Menu href={href} menu={menu}>
             {isBlogRoute && (
               <div className="all-posts-link">
diff --git a/components/nav.tsx b/components/nav.tsx
index b722bd3a..cfbc19a8 100644
--- a/components/nav.tsx
+++ b/components/nav.tsx
@@ -39,7 +39,7 @@ const Navigation: FC<{ blog: Blog }> = ({ blog }) => {
 
   return (
     <nav
-      className="navbar is-spaced"
+      className="navbar is-spaced is-hidden-print"
       role="navigation"
       aria-label="main navigation"
     >
diff --git a/package-lock.json b/package-lock.json
index 1fdb6155..f7cac4aa 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -10,6 +10,7 @@
       "dependencies": {
         "@next/font": "^13.1.1",
         "bulma": "^0.8.2",
+        "bulma-print": "^1.0.1",
         "classnames": "^2.3.1",
         "glob": "^7.1.7",
         "gray-matter": "^4.0.3",
@@ -384,6 +385,11 @@
       "resolved": "https://registry.npmjs.org/bulma/-/bulma-0.8.2.tgz",
       "integrity": "sha512-vMM/ijYSxX+Sm+nD7Lmc1UgWDy2JcL2nTKqwgEqXuOMU+IGALbXd5MLt/BcjBAPLIx36TtzhzBcSnOP974gcqA=="
     },
+    "node_modules/bulma-print": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/bulma-print/-/bulma-print-1.0.1.tgz",
+      "integrity": "sha512-lyfhUwnrugsNfHs2tnBwhUGXrPipkiRXayjUJgwmA/NSWYn4PeZiqaUAzHOI4o7nx0k/pFTHxNFjh9pYgJa39A=="
+    },
     "node_modules/caniuse-lite": {
       "version": "1.0.30001442",
       "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001442.tgz",
@@ -2452,6 +2458,11 @@
       "resolved": "https://registry.npmjs.org/bulma/-/bulma-0.8.2.tgz",
       "integrity": "sha512-vMM/ijYSxX+Sm+nD7Lmc1UgWDy2JcL2nTKqwgEqXuOMU+IGALbXd5MLt/BcjBAPLIx36TtzhzBcSnOP974gcqA=="
     },
+    "bulma-print": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/bulma-print/-/bulma-print-1.0.1.tgz",
+      "integrity": "sha512-lyfhUwnrugsNfHs2tnBwhUGXrPipkiRXayjUJgwmA/NSWYn4PeZiqaUAzHOI4o7nx0k/pFTHxNFjh9pYgJa39A=="
+    },
     "caniuse-lite": {
       "version": "1.0.30001442",
       "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001442.tgz",
diff --git a/package.json b/package.json
index 605d434f..a5a56ef8 100644
--- a/package.json
+++ b/package.json
@@ -14,6 +14,7 @@
   "dependencies": {
     "@next/font": "^13.1.1",
     "bulma": "^0.8.2",
+    "bulma-print": "^1.0.1",
     "classnames": "^2.3.1",
     "glob": "^7.1.7",
     "gray-matter": "^4.0.3",
diff --git a/styles/styles.scss b/styles/styles.scss
index 5053ab90..2858bcec 100644
--- a/styles/styles.scss
+++ b/styles/styles.scss
@@ -74,6 +74,7 @@ $footer-background-color: black;
 $footer-color: white;
 
 @import "../node_modules/bulma/bulma.sass";
+@import "../node_modules/bulma-print/bulma-print";
 
 // Darken colors
 @function darken($color) {
@@ -511,6 +512,24 @@ a:active {
   }
 }
 
+@media print {
+  .columns {
+    display: block !important;
+    margin: 0 !important;
+  }
+  .tk-content,
+  .tk-markdown {
+    width: 100% !important;
+    padding: 0 !important;
+  }
+  .section {
+    padding: 0 !important;
+  }
+  body {
+    margin: revert !important;
+  }
+}
+
 .tk-docs {
   .tk-docs-nav {
     background-color: $light-gray;

From 8b0c88c2c160d3f7b9a25dc7764542f927624c48 Mon Sep 17 00:00:00 2001
From: Simon Ruggier <Simon.Ruggier@gmail.com>
Date: Sat, 5 Oct 2024 22:31:57 -0400
Subject: [PATCH 2/3] Wrap code blocks while printing

The scroll bars are fine in a browser, but not so useful in a PDF file
or on a printed page.
---
 styles/styles.scss | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/styles/styles.scss b/styles/styles.scss
index 2858bcec..5e2b40b0 100644
--- a/styles/styles.scss
+++ b/styles/styles.scss
@@ -528,6 +528,10 @@ a:active {
   body {
     margin: revert !important;
   }
+  pre {
+    white-space: pre-wrap !important;
+    overflow-wrap: break-word !important;
+  }
 }
 
 .tk-docs {

From 666e62daf67a32b5742c8a4825fe477e59b7b4ce Mon Sep 17 00:00:00 2001
From: Simon Ruggier <Simon.Ruggier@gmail.com>
Date: Sat, 5 Oct 2024 22:40:48 -0400
Subject: [PATCH 3/3] Avoid breaking code blocks across pages while printing,
 if possible

---
 styles/styles.scss | 1 +
 1 file changed, 1 insertion(+)

diff --git a/styles/styles.scss b/styles/styles.scss
index 5e2b40b0..968dfd08 100644
--- a/styles/styles.scss
+++ b/styles/styles.scss
@@ -531,6 +531,7 @@ a:active {
   pre {
     white-space: pre-wrap !important;
     overflow-wrap: break-word !important;
+    break-inside: avoid !important;
   }
 }