[DO NOT DELETE] Added directives for mkdocs-pdf-export-plugin

README.md

@@ -405,3 +405,20 @@ The following list of words should be avoided:
 - Various 
 - Automatically
 - Finally
+
+
+## Note: mkdocs-pdf-export-plugin
+
+Install the required dependencies before installing the [plugin itself](https://github.com/shauser/mkdocs-pdf-export-plugin) as shown below. The plugin allows to export the documentation into pdf document(s).
+
+```bash
+brew install cairo pango gdk-pixbuf libffi
+```
+
+Install [pyenv](https://github.com/pyenv/pyenv) to control python versions and install python3 (3.7.0) through it.
+
+After that, create a virtual environment as below, and use it to serve mkdocs:
+
+```bash
+virtualenv -p python3 .virtualenv-3.7.0
+```

docs/extra/css/pdf.css

@@ -0,0 +1,17 @@
+@page {
+    /*size: a4 portrait;*/
+    margin: 25mm 10mm 25mm 10mm;
+    counter-increment: page;
+    font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif;
+    white-space: pre;
+    color: grey;
+    @top-left {
+        content: '© 2018 Exabyte Inc.';
+    }
+    @top-center {
+        content: string(chapter);
+    }
+    @top-right {
+        content: 'Page ' counter(page);
+    }
+}

mkdocs.yml

@@ -12,6 +12,7 @@ extra_css:
     - extra/css/images.css
     - extra/css/super-fences.css
     - extra/css/properties.css
+    - extra/css/pdf.css
 
 extra_javascript:
     - extra/js/giffer.js
@@ -29,6 +30,16 @@ extra:
           link: https://github.com/exabyte-io
         - type: linkedin
           link: https://www.linkedin.com/company/exabyte-io
+
+# Pass ENABLE_PDF_EXPORT=1 to enable export
+plugins:
+    - search
+    - pdf-export:
+        verbose: true
+        media_type: print
+        combined: true
+        enabled_if_env: ENABLE_PDF_EXPORT
+
 markdown_extensions:
     - markdown_include.include:
         base_path: esse