a little bit of documentation.

Author: MaxMelcher

.vscode/launch.json

@@ -13,7 +13,7 @@
             "args": [
                 "-v",
                 "-p..\\AzureDevOps.WikiPDFExport.Test\\Tests\\AzureDevOps.WikiPDFExport.wiki",
-                "--attachments-path=..\\AzureDevOps.WikiPDFExport.Test\\Tests\\AzureDevOps.WikiPDFExport.wiki\\.attachments\\",
+//                "--attachments-path=..\\AzureDevOps.WikiPDFExport.Test\\Tests\\AzureDevOps.WikiPDFExport.wiki\\.attachments\\",
 //               "-p..\\AzureDevOps.WikiPDFExport.Test\\Tests\\Code",
 //                "-p..\\AzureDevOps.WikiPDFExport.Test\\Tests\\Azure-Platform-Design",
 //                "-p..\\AzureDevOps.WikiPDFExport.Test\\Tests\\1k",
@@ -29,19 +29,18 @@
                 "--footer-template=<div style='padding-right: 10px; padding-top:2px; margin: 0; -webkit-print-color-adjust: exact; border-top:1px solid grey; color: grey; width: 100%; text-align: right; font-size: 6px;'>Print: <span class='date'></span> Page: </span><span class='pageNumber'></span>/<span class='totalPages'></span></div>",
                 //"--css=styles.css", //not needed, its the default now.
                 "--open",
-                //"--footer-hide-line"
                 //"--footer-url=C:\\Git\\AzureDevOps.WikiPDFExport\\AzureDevOps.WikiPDFExport\\bin\\Debug\\netcoreapp3.1\\example-footer.html",
                 //"--header-url=C:\\Git\\AzureDevOps.WikiPDFExport\\AzureDevOps.WikiPDFExport\\bin\\Debug\\netcoreapp3.1\\example-header.html"
                 //"-s..\\AzureDevOps.WikiPDFExport.Test\\Tests\\Real\\AzureDevOps.WikiPDFExport\\TEST%2DPAGE.md"
                 //"-s..\\AzureDevOps.WikiPDFExport\\TEST%2DPAGE.md",
                 //"--mermaidjs-path=mermaid.min.js",
                 //"--chrome-path=c:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
-                //"--disableTelemetry",
+                "--disableTelemetry",
                 "--mermaid",
                 //"--filter=tags:test,tags:license"
-                // "-c"
-                // "--organization=https://dev.azure.com/mmelcher",
-                 "--pat=7dmhcnemllrx6rn2z5zoh35res6nnl5xnfkyzput3pueaoqrvwr" //add a 'q' to the end. valid until August 2022.
+                "--highlight-code",
+                "--organization=https://dev.azure.com/mmelcher",
+                 "--pat=wdsenlsthdajotbtmej3t7pcqq2zqudf57at352ely4blsdjesfa" //add a 'a' to the end. valid until August 2022.
             ],
             "cwd": "${workspaceFolder}/AzureDevOps.WikiPDFExport",
             "console": "internalConsole",

AzureDevOps.WikiPDFExport/WikiPDFExporter.cs

@@ -240,7 +240,9 @@ public async Task Export()
                     {
                         var css = File.ReadAllText(cssPath);
                         var style = $"<style>{css}</style>";
-                        header.Add(style);
+
+                        //adding the css to the footer to overwrite the mermaid, katex, highlightjs styles. 
+                        footer.Add(style);
                     }
 
                     //build the html for rendering

AzureDevOps.WikiPDFExport/devopswikistyle.css

@@ -33,6 +33,15 @@ html >*:last-child {
     margin: 0 0 16px 0
 }
 
+pre {
+    white-space: pre-wrap !important; /* needed to wrap long code lines */
+}
+
+table td
+{
+    word-break: break-all !important; /* need to wrap large tables */
+}
+
  table {
     border-collapse: collapse;
     border-spacing: 0;

AzureDevOps.WikiPDFExport/export.pdf

@@ -21,12 +21,14 @@ If you need more control over the output, please see the Configuration Options b
 The tool currently supports the following:
 * Export all wiki pages (and sub pages) in the correct order including styles and formatting.
 * Includes pictures (remote and relative urls)
-* Creates PDF bookmarks to all pages for easier navigation within the PDF
 * If you link to other wiki pages, the link in the PDF will work, too. 
 * Everything self-contained. Download the .exe file, run it, done.
+* It is fast. A PDF with 160 pages is created in less than a second.
 * Tool can be used as part of a build, see [BuildTask](AzureDevOps.WikiPDFExport/Build-Task.md)
 * Supports emoticons :) ⚠ ℹ
-* It is fast. A PDF with 160 pages is created in less than a second. 1000 pages in ~8 seconds.
+* Mermaid supported 
+* Workitems can be referenced and will be included in the pdf as link with the current status, e.g. #7.
+* Math/Latex formulas are rendered
 
 ## 🛰 Requirements
 
@@ -95,6 +97,7 @@ So far the following limitations are known:
 * The tool, sometimes shows an error "Qt: Could not initialize OLE (error 80010106)" - this can be ignored.
 * If headers are not formatted properly (#Header instead of # Header), they are rendered incorrectly. I might fix that in the future.
 * The tool lacks proper testing because I only have two realistic wikis available. Want to contribute one?
+* Currently, no pdf bookmarks are created (see [chromium issue](https://bugs.chromium.org/p/chromium/issues/detail?id=781797)).  
 
 ## ⚖ License
 See [license](/AzureDevOps.WikiPDFExport/License.md)