Add a print stylesheet removing the DevDocs UI

7 years ago · b681c80ed0
parent c91bf6f369
commit b681c80ed0
4 changed files with 106 additions and 0 deletions
--- a/assets/stylesheets/application.css.scss
+++ b/assets/stylesheets/application.css.scss
@ -98,3 +98,7 @@
        'pages/webpack',
        'pages/yard',
        'pages/yii';
+
+html { // specificity hack
+  @import 'global/print';
+}
--- a/assets/stylesheets/global/_classes.scss
+++ b/assets/stylesheets/global/_classes.scss
@ -2,6 +2,19 @@
 // Utilities
 //

+/* Usage:
+ *
+ * @include print {
+ *   // print styles here
+ * }
+ *
+ */
+@mixin print {
+  @media print {
+    @content;
+  }
+}
+
 %border-box {
  -moz-box-sizing: border-box;
       box-sizing: border-box;
--- a/assets/stylesheets/global/_print.scss
+++ b/assets/stylesheets/global/_print.scss
@ -0,0 +1,85 @@
+// Style overrides for printing
+
+@include print {
+
+  ._header, ._sidebar, ._path, ._notif, ._toc, ._pre-clip, ._notice {
+    display: none !important;
+  }
+
+  // make the docs fill the page and scroll the <body> instead of ._container
+  body {
+    height: initial;
+    &::after {
+      content: '';
+      clear: both;
+    }
+  }
+  ._app {
+    height: initial;
+  }
+  ._container {
+    margin: 0;
+    padding: 0;
+    height: initial;
+
+    ._content {
+      margin: 0;
+    }
+  }
+
+  // Hide the scrollbars
+  ::-webkit-scrollbar {
+    display: none;
+  }
+
+  // empty the boxes.
+  %box,
+  %heading-box {
+    background: transparent;
+  }
+  %heading-box {
+    border-radius: 0;
+    border: {
+      top: none;
+      left: none;
+      right: none;
+    }
+  }
+
+
+  // Underline links, put the destination after the link text
+  %external-link {
+    text-decoration: underline;
+    &::after {
+      content: ' (' attr(href) ')';
+      background-image: none;
+      display: inline;
+      margin: 0;
+    }
+  }
+
+  // Link back to DevDocs
+  ._attribution-p {
+    background: transparent;
+    border: 2px solid $labelBackground;
+
+    &:after {
+      content: 'Exported from DevDocs (https://devdocs.io)';
+      font-style: italic;
+    }
+  }
+
+  // Fix page breaks
+  pre {
+    page-break-before: avoid;
+  }
+  pre {
+    orphans: 5;
+    widows: 5;
+  }
+
+  p {
+    orphans: 2;
+    widows: 2;
+  }
+}
--- a/assets/stylesheets/pages/_rdoc.scss
+++ b/assets/stylesheets/pages/_rdoc.scss
@ -27,6 +27,10 @@
    @extend %user-select-none;

    &:hover { text-decoration: underline; }
+
+    @include print {
+      display: none;
+    }
  }

  .method-description { position: relative; }