npm - docgen-tool - Versions diffs - 2.1.3 → 3.0.1 - Mend

docgen-tool 2.1.3 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (113) hide show

package/docs/upgrading.html DELETED Viewed

@@ -1,124 +0,0 @@
-<!doctype html>
-<html>
- <head>
-  <meta http-equiv="X-UA-Compatible" content="IE=edge"><!--Prevent IE using compatibility mode on local or intranet pages. Do not put scripts before this line.-->
-  <meta name="viewport" content="width=device-width, user-scalable=yes"><!--Mobile device scaling-->
-  <meta charset="UTF-8">
-  <title>DocGen - a documentation tool</title>
-  <!--load stylesheets first (rationale: https://developers.google.com/speed/docs/best-practices/rtt#PutStylesBeforeScripts)-->
-  <link rel="stylesheet" href="require/webknife/framework.min.css" type="text/css">
-  <link rel="stylesheet" href="require/webknife/highlight.min.css" type="text/css">
-  <link rel="stylesheet" href="require/docgen.css" type="text/css">
-  <link rel="stylesheet" href="require/print.css" media="print">
-  <!--load scripts second-->
-  <script src="require/webknife/framework.min.js"></script>
-  <script src="require/webknife/framework.icons.js"></script>
-  <script src="require/webknife/highlight.min.js"></script>
-  <!--inline scripts last-->
-<script type="text/javascript">
-$(document).ready( function () {
-  $("#dg-toc").hide(); //hide the table of contents
-  //instantiate an svg injector to show SVG icons
-  var injector = new svgInject();
-  injector.inject();
-  //code syntax highlighting
-  $('pre code, .w-inline-code').each(function(i, block) {
-    hljs.highlightBlock(block);
-  });
-  //toggle visibility of table of contents
-  $("#dg-navigator").click(function()
-  {
-    $("#dg-toc").slideToggle("fast");
-    $(this).toggleClass("active");
-  });
-});
-</script>
-<script type="text/x-mathjax-config">
-//MathJax configuration is the same as used by math.stackexchange.com
-MathJax.Hub.Config({"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], linebreaks: { automatic:true }, EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50) },
-  tex2jax: { inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ], displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], processEscapes: true, ignoreClass: "tex2jax_ignore|dno" },
-  TeX: {  noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } }, Macros: { href: "{}" } },
-  messageStyle: "none"
-});
-</script>
-<link rel="stylesheet" href="require/katex/katex.min.css" type="text/css"><script type="text/javascript" src="require/katex/katex.min.js"></script><script type="text/javascript" src="require/katexInjector.js"></script><script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML-full"></script></head>
-<body>
-<div id="dg-toc"><div><table class="unstyled"><tr><td class="dg-tocGroup"><ul><li class="dg-tocHeading">Quick Start</li><li><a href="index.html">Overview</a></li><li><a href="installation.html">Installation</a></li><li><a href="upgrading.html">Upgrading</a></li></ul></td><td class="dg-tocGroup"><ul><li class="dg-tocHeading">User Guide</li><li><a href="running.html">Running DocGen</a></li><li><a href="writing-content.html">Writing content</a></li><li><a href="commonmark.html">CommonMark reference</a></li><li><a href="advanced-content.html">Advanced content</a></li></ul></td><td class="dg-tocGroup"><ul><li class="dg-tocHeading">Help</li><li><a href="troubleshooting.html">Troubleshooting</a></li><li><a href="version-control.html">Using with version control</a></li></ul></td><td class="dg-tocGroup"></td><td class="dg-tocGroup" id="dg-tocFixedColumn"><ul><li><span class="w-icon dg-tocIcon" data-name="person_group" title="archive"></span><a href="ownership.html">Ownership</a></li><li><span class="w-icon dg-tocIcon" data-name="refresh" title="archive"></span><a href="release-notes.html">Release Notes</a></li></ul><div><button class="w-icon-button" onclick="window.location=&apos;docgen.pdf&apos;;"><span class="w-icon" data-name="document"></span><span>PDF copy</span></button></div></td></tr></table></div></div>
-<div id="dg-navigator">Table of contents</div>
-<header>
- <div class="w-fixed-width">
-  <a id="dg-homelink" href="index.html">
-    <div id="dg-logo" style="background-image: url(files/images/logo.png); height: 42px; line-height: 42px; padding-left: 85px;">
-      <span id="dg-title">DocGen - a documentation tool</span> <span id="dg-web-title-version" style="font-weight:normal;">(2.1.3)</span>
-    </div>
-  </a>
-  <div>
-    <span id="dg-backlink"></span>
-  </div>
- </div>
-</header>
-<section id="dg-content"><div class="w-fixed-width"><div id="dg-innerContent"><h1 id="dg-autoTitle">Upgrading</h1><ul class="dg-pageToc"><li><a href="#docgen-1.0.*-to-docgen-2.0.0">DocGen 1.0.* to DocGen 2.0.0</a></li></ul><p>This section explains how to upgrade from old versions of DocGen.</p>
-<h2 id="docgen-1.0.*-to-docgen-2.0.0">DocGen 1.0.* to DocGen 2.0.0</h2>
-<p>DocGen 2 is not backwards compatible with DocGen 1, but the upgrade is easy with these instructions:</p>
-<ul>
-<li>Install DocGen 2 by following the <a href="installation.html">installation guide</a></li>
-<li>Create a replacement &apos;source&apos; directory, e.g: <strong><code>docgen scaffold -o $HOME/source</code></strong></li>
-<li>Migrate the source files
-<ul>
-<li>Copy the source (.txt) files from the old &apos;Src&apos; directory to the new &apos;source&apos; directory</li>
-<li>Remove the top-level page headings in each source file (DocGen now inserts these automatically, based on contents.json)</li>
-<li>Rename <em>&apos;change-log.txt&apos;</em> to <em>&apos;release-notes.txt&apos;</em></li>
-</ul>
-</li>
-<li>Migrate the attached content
-<ul>
-<li>Place a logo with filename &apos;logo.png&apos; in &apos;files/images&apos; directory (the logo is now part of the source)</li>
-<li>Copy the images from <em>&apos;Images&apos;</em> to <em>&apos;files/images&apos;</em></li>
-<li>Copy attached files from <em>&apos;Files&apos;</em> to <em>&apos;files&apos;</em></li>
-</ul>
-</li>
-<li>Migrate the metadata
-<ul>
-<li>Edit <em>&apos;parameters.json&apos;</em> with the relevant values from <em>&apos;doc-parameters.yml&apos;</em></li>
-<li>Edit <em>&apos;contents.json&apos;</em> with the relevant values from <em>&apos;table-of-contents.yml&apos;</em></li>
-</ul>
-</li>
-<li>Run DocGen: <strong><code>docgen -i $HOME/source -o $HOME/output</code></strong></li>
-<li>Check the styling in the latest version still works well with the old content</li>
-<li>Note that the PDF is no longer generated by default (pass the <em>&apos;-p&apos;</em> option)</li>
-</ul>
-<blockquote>
-<p>DocGen 1 tool-behaviours.yml has been replaced by command-line options. For help, see <strong><code>docgen run -h</code></strong>.</p>
-</blockquote>
-</div></div></section>
- <footer>
-  <div><p class="w-fixed-width"><span id="dg-web-footer">Version 2.1.3 released on 29/05/2015.</span></p></div>
-  <div class="w-fixed-width">
-    <p><span id="dg-copyright">&#xA9; 2015 <a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></p>
-    <p>
-      <span id="dg-marking">MIT License.</span>
-      <span id="dg-legalese"></span>
-      <span id="dg-attribution">Created by DocGen 2.1.3 on 29/05/2015 at 13:57:42.</span>
-    </p>
-  </div>
- </footer>
- </body>
-</html>

package/docs/version-control.html DELETED Viewed

@@ -1,102 +0,0 @@
-<!doctype html>
-<html>
- <head>
-  <meta http-equiv="X-UA-Compatible" content="IE=edge"><!--Prevent IE using compatibility mode on local or intranet pages. Do not put scripts before this line.-->
-  <meta name="viewport" content="width=device-width, user-scalable=yes"><!--Mobile device scaling-->
-  <meta charset="UTF-8">
-  <title>DocGen - a documentation tool</title>
-  <!--load stylesheets first (rationale: https://developers.google.com/speed/docs/best-practices/rtt#PutStylesBeforeScripts)-->
-  <link rel="stylesheet" href="require/webknife/framework.min.css" type="text/css">
-  <link rel="stylesheet" href="require/webknife/highlight.min.css" type="text/css">
-  <link rel="stylesheet" href="require/docgen.css" type="text/css">
-  <link rel="stylesheet" href="require/print.css" media="print">
-  <!--load scripts second-->
-  <script src="require/webknife/framework.min.js"></script>
-  <script src="require/webknife/framework.icons.js"></script>
-  <script src="require/webknife/highlight.min.js"></script>
-  <!--inline scripts last-->
-<script type="text/javascript">
-$(document).ready( function () {
-  $("#dg-toc").hide(); //hide the table of contents
-  //instantiate an svg injector to show SVG icons
-  var injector = new svgInject();
-  injector.inject();
-  //code syntax highlighting
-  $('pre code, .w-inline-code').each(function(i, block) {
-    hljs.highlightBlock(block);
-  });
-  //toggle visibility of table of contents
-  $("#dg-navigator").click(function()
-  {
-    $("#dg-toc").slideToggle("fast");
-    $(this).toggleClass("active");
-  });
-});
-</script>
-<script type="text/x-mathjax-config">
-//MathJax configuration is the same as used by math.stackexchange.com
-MathJax.Hub.Config({"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], linebreaks: { automatic:true }, EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50) },
-  tex2jax: { inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ], displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], processEscapes: true, ignoreClass: "tex2jax_ignore|dno" },
-  TeX: {  noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } }, Macros: { href: "{}" } },
-  messageStyle: "none"
-});
-</script>
-<link rel="stylesheet" href="require/katex/katex.min.css" type="text/css"><script type="text/javascript" src="require/katex/katex.min.js"></script><script type="text/javascript" src="require/katexInjector.js"></script><script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML-full"></script></head>
-<body>
-<div id="dg-toc"><div><table class="unstyled"><tr><td class="dg-tocGroup"><ul><li class="dg-tocHeading">Quick Start</li><li><a href="index.html">Overview</a></li><li><a href="installation.html">Installation</a></li><li><a href="upgrading.html">Upgrading</a></li></ul></td><td class="dg-tocGroup"><ul><li class="dg-tocHeading">User Guide</li><li><a href="running.html">Running DocGen</a></li><li><a href="writing-content.html">Writing content</a></li><li><a href="commonmark.html">CommonMark reference</a></li><li><a href="advanced-content.html">Advanced content</a></li></ul></td><td class="dg-tocGroup"><ul><li class="dg-tocHeading">Help</li><li><a href="troubleshooting.html">Troubleshooting</a></li><li><a href="version-control.html">Using with version control</a></li></ul></td><td class="dg-tocGroup"></td><td class="dg-tocGroup" id="dg-tocFixedColumn"><ul><li><span class="w-icon dg-tocIcon" data-name="person_group" title="archive"></span><a href="ownership.html">Ownership</a></li><li><span class="w-icon dg-tocIcon" data-name="refresh" title="archive"></span><a href="release-notes.html">Release Notes</a></li></ul><div><button class="w-icon-button" onclick="window.location=&apos;docgen.pdf&apos;;"><span class="w-icon" data-name="document"></span><span>PDF copy</span></button></div></td></tr></table></div></div>
-<div id="dg-navigator">Table of contents</div>
-<header>
- <div class="w-fixed-width">
-  <a id="dg-homelink" href="index.html">
-    <div id="dg-logo" style="background-image: url(files/images/logo.png); height: 42px; line-height: 42px; padding-left: 85px;">
-      <span id="dg-title">DocGen - a documentation tool</span> <span id="dg-web-title-version" style="font-weight:normal;">(2.1.3)</span>
-    </div>
-  </a>
-  <div>
-    <span id="dg-backlink"></span>
-  </div>
- </div>
-</header>
-<section id="dg-content"><div class="w-fixed-width"><div id="dg-innerContent"><h1 id="dg-autoTitle">Using with version control</h1><ul class="dg-pageToc"><li><a href="#recommended-practice">Recommended practice</a></li></ul><p>One of the benefits of using DocGen for product software documentation is that its plain text source files are easy to
-version control in sync with the product.</p>
-<h2 id="recommended-practice">Recommended practice</h2>
-<p>It is recommended to store the documentation <strong>source files</strong> (DocGen input directory) in the same version control
-repository as the product code. This allows each release of the product to have a matching version of its
-documentation.</p>
-<blockquote>
-<p>It is not necessary to version control the DocGen output, because this can always be regenerated. If the DocGen
-output is version controlled, file renames, additions, and deletions have to be performed manually in the
-version control tool.</p>
-</blockquote>
-</div></div></section>
- <footer>
-  <div><p class="w-fixed-width"><span id="dg-web-footer">Version 2.1.3 released on 29/05/2015.</span></p></div>
-  <div class="w-fixed-width">
-    <p><span id="dg-copyright">&#xA9; 2015 <a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></p>
-    <p>
-      <span id="dg-marking">MIT License.</span>
-      <span id="dg-legalese"></span>
-      <span id="dg-attribution">Created by DocGen 2.1.3 on 29/05/2015 at 13:57:42.</span>
-    </p>
-  </div>
- </footer>
- </body>
-</html>

package/docs/writing-content.html DELETED Viewed

@@ -1,305 +0,0 @@
-<!doctype html>
-<html>
- <head>
-  <meta http-equiv="X-UA-Compatible" content="IE=edge"><!--Prevent IE using compatibility mode on local or intranet pages. Do not put scripts before this line.-->
-  <meta name="viewport" content="width=device-width, user-scalable=yes"><!--Mobile device scaling-->
-  <meta charset="UTF-8">
-  <title>DocGen - a documentation tool</title>
-  <!--load stylesheets first (rationale: https://developers.google.com/speed/docs/best-practices/rtt#PutStylesBeforeScripts)-->
-  <link rel="stylesheet" href="require/webknife/framework.min.css" type="text/css">
-  <link rel="stylesheet" href="require/webknife/highlight.min.css" type="text/css">
-  <link rel="stylesheet" href="require/docgen.css" type="text/css">
-  <link rel="stylesheet" href="require/print.css" media="print">
-  <!--load scripts second-->
-  <script src="require/webknife/framework.min.js"></script>
-  <script src="require/webknife/framework.icons.js"></script>
-  <script src="require/webknife/highlight.min.js"></script>
-  <!--inline scripts last-->
-<script type="text/javascript">
-$(document).ready( function () {
-  $("#dg-toc").hide(); //hide the table of contents
-  //instantiate an svg injector to show SVG icons
-  var injector = new svgInject();
-  injector.inject();
-  //code syntax highlighting
-  $('pre code, .w-inline-code').each(function(i, block) {
-    hljs.highlightBlock(block);
-  });
-  //toggle visibility of table of contents
-  $("#dg-navigator").click(function()
-  {
-    $("#dg-toc").slideToggle("fast");
-    $(this).toggleClass("active");
-  });
-});
-</script>
-<script type="text/x-mathjax-config">
-//MathJax configuration is the same as used by math.stackexchange.com
-MathJax.Hub.Config({"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], linebreaks: { automatic:true }, EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50) },
-  tex2jax: { inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ], displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], processEscapes: true, ignoreClass: "tex2jax_ignore|dno" },
-  TeX: {  noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } }, Macros: { href: "{}" } },
-  messageStyle: "none"
-});
-</script>
-<link rel="stylesheet" href="require/katex/katex.min.css" type="text/css"><script type="text/javascript" src="require/katex/katex.min.js"></script><script type="text/javascript" src="require/katexInjector.js"></script><script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML-full"></script></head>
-<body>
-<div id="dg-toc"><div><table class="unstyled"><tr><td class="dg-tocGroup"><ul><li class="dg-tocHeading">Quick Start</li><li><a href="index.html">Overview</a></li><li><a href="installation.html">Installation</a></li><li><a href="upgrading.html">Upgrading</a></li></ul></td><td class="dg-tocGroup"><ul><li class="dg-tocHeading">User Guide</li><li><a href="running.html">Running DocGen</a></li><li><a href="writing-content.html">Writing content</a></li><li><a href="commonmark.html">CommonMark reference</a></li><li><a href="advanced-content.html">Advanced content</a></li></ul></td><td class="dg-tocGroup"><ul><li class="dg-tocHeading">Help</li><li><a href="troubleshooting.html">Troubleshooting</a></li><li><a href="version-control.html">Using with version control</a></li></ul></td><td class="dg-tocGroup"></td><td class="dg-tocGroup" id="dg-tocFixedColumn"><ul><li><span class="w-icon dg-tocIcon" data-name="person_group" title="archive"></span><a href="ownership.html">Ownership</a></li><li><span class="w-icon dg-tocIcon" data-name="refresh" title="archive"></span><a href="release-notes.html">Release Notes</a></li></ul><div><button class="w-icon-button" onclick="window.location=&apos;docgen.pdf&apos;;"><span class="w-icon" data-name="document"></span><span>PDF copy</span></button></div></td></tr></table></div></div>
-<div id="dg-navigator">Table of contents</div>
-<header>
- <div class="w-fixed-width">
-  <a id="dg-homelink" href="index.html">
-    <div id="dg-logo" style="background-image: url(files/images/logo.png); height: 42px; line-height: 42px; padding-left: 85px;">
-      <span id="dg-title">DocGen - a documentation tool</span> <span id="dg-web-title-version" style="font-weight:normal;">(2.1.3)</span>
-    </div>
-  </a>
-  <div>
-    <span id="dg-backlink"></span>
-  </div>
- </div>
-</header>
-<section id="dg-content"><div class="w-fixed-width"><div id="dg-innerContent"><h1 id="dg-autoTitle">Writing content</h1><ul class="dg-pageToc"><li><a href="#overview">Overview</a></li><li><a href="#metadata">Metadata</a></li><li><a href="#plain-text">Plain text</a></li><li><a href="#commonmark-(markdown)">CommonMark (Markdown)</a></li><li><a href="#html">HTML</a></li><li><a href="#embedding-images">Embedding images</a></li><li><a href="#attaching-files">Attaching files</a></li><li><a href="#mathematical-expressions">Mathematical Expressions</a></li><li><a href="#mathematics-using-katex">Mathematics using KaTeX</a></li><li><a href="#mathematics-using-mathjax">Mathematics using MathJax</a></li></ul><style>
-.container {
-  box-sizing: border-box;
-  float:left;
-  width: 480px;
-}
-.codeContainer {
-  margin: 0 20px 0 0;
-}
-.codeContainer pre {
-  margin: 0;
-}
-.codeContainer code {
-}
-.codeContainer p {
-  margin: 0;
-  padding: 0;
-}
-.exampleContainer {
-  margin: 0;
-  border: 1px solid #666;
-  border-radius: 6px;
-  padding: 0 18px 0 18px;
-}
-.exampleContainer img {
-  margin-top: 5px;
-}
-#content table {
-  width: 400px!important;
-}
-.hljs-change {
-  background-color: transparent!important;
-}
-</style>
-<p>Content for a DocGen website is authored in plain text, using any text editor. Image files can be embedded, and
-other types of files can be attached as links. Additionally, website metadata is configured
-via <a href="http://json.org">JSON</a> files.</p>
-<h2 id="overview">Overview</h2>
-<p>DocGen transforms source files from an input directory into output files in an output directory.</p>
-<p>It takes every source file (plain text) specified in <strong>contents.json</strong> and converts it. Each source file becomes a
-separate page in the website and a separate chapter in the PDF.</p>
-<p>DocGen adds metadata that is specified in <strong>parameters.json</strong>, and copies the images and files in the <strong>files</strong>
-directory to the output.</p>
-<blockquote>
-<p>Always save input files with <strong>UTF-8</strong> encoding. This makes non-standard characters (&#xF8; &#xA9; &#xE9; etc) work.</p>
-</blockquote>
-<h2 id="metadata">Metadata</h2>
-<p><strong>parameters.json</strong></p>
-<p>The parameters file is used to specify metadata describing the product.</p>
-<ul>
-<li><strong>title</strong> - the product title</li>
-<li><strong>name</strong> - the product name (also used to name the PDF)</li>
-<li><strong>version</strong> - the release version</li>
-<li><strong>date</strong> - the release date</li>
-<li><strong>organization</strong> - the company or organization</li>
-<li><strong>author</strong> - the lead author of the document</li>
-<li><strong>owner</strong> - the owner of the product</li>
-<li><strong>contributors</strong> - list of contributors</li>
-<li><strong>website</strong> - a link to the product website</li>
-<li><strong>backlink</strong> - a link back to product user interface (useful for integrated documentation)</li>
-<li><strong>module</strong> - module name (useful for larger products with submodules)</li>
-<li><strong>id</strong> - reference number (e.g. product id in a change management tool)</li>
-<li><strong>summary</strong> - a descriptive summary of the product</li>
-<li><strong>marking</strong> - license or other protective markings</li>
-<li><strong>legalese</strong> - document markings (confidentiality, disclaimers, smallprint etc)</li>
-</ul>
-<p>Values can be empty strings, but the elements are required in the JSON file.</p>
-<p>Parameters with URLs can be either website URLs, or email addresses (specify <em>&apos;mailto:name@address.com&apos;</em>).</p>
-<p><strong>contents.json</strong></p>
-<p>The contents file specifies the names, locations, order, and hierarchy of the source files. It is used to generate both
-the web and PDF table of contents.</p>
-<p><strong>release-notes.txt</strong></p>
-<p>The release notes source file is a mandatory source file (that does not need to be listed in contents.json). Use it to
-summarize the change history for each version of the product.</p>
-<h2 id="plain-text">Plain text</h2>
-<p>The simplest input format is just to write in plain text. Here is an example of the source and output:</p>
-<div class="container codeContainer">
-<pre><code>Example paragraph.
-</code></pre>
-</div>
-<div class="container exampleContainer">
-<p>Example paragraph.</p>
-</div><br class="w-clear">
-<p class="dg-forceBreak"></p>
-<h2 id="commonmark-(markdown)">CommonMark (Markdown)</h2>
-<p><a href="http://commonmark.org/">CommonMark</a> (also known as <a href="http://daringfireball.net/projects/markdown/">MarkDown</a>) is a
-human-friendly plain text markup format. The source format is easy to read and write, and the CommonMark parser
-translates it into HTML. DocGen uses the <a href="https://markdown-it.github.io">markdown-it</a> implementation
-of CommonMark. Here is an example of the source and output:</p>
-<div class="container codeContainer">
-<pre><code>CommonMark Example
-------------------
-Paragraphs are text blocks separated by new lines.
-Text can be styled: *emphasised* and **strong**.
-Here is an [example link](http://www.google.com).
-  # To make a code block, just indent with a tab
-  # &quot;Hello World&quot; in Ruby:
-  5.times { puts &quot;Hello!&quot; }
-</code></pre>
-</div>
-<div class="container exampleContainer">
-<p class="dg-fakeHeading" style="font-size: 18px; padding-bottom: 4px;">CommonMark Example</p>
-<p>Paragraphs are text blocks separated by new lines.</p>
-<p>Text can be styled: <em>emphasised</em> and <strong>strong</strong>.</p>
-<p>Here is an <a href="http://www.google.com">example link</a>.</p>
-<pre><code># To make a code block, just indent with a tab
-# &quot;Hello World&quot; in Ruby:
-5.times { puts &quot;Hello!&quot; }
-</code></pre>
-</div><br class="w-clear">
-<p>For more examples, see the <a href="commonmark.html">CommonMark reference</a>.</p>
-<h2 id="html">HTML</h2>
-<p>For more complex pages not covered by CommonMark&apos;s syntax, simply use inline HTML:</p>
-<div class="container codeContainer">
-<pre><code>&lt;table&gt;
-  &lt;tr&gt;
-    &lt;td&gt;Foo&lt;/td&gt;
-    &lt;td&gt;Bar&lt;/td&gt;
-    &lt;td&gt;Baz&lt;/td&gt;
-  &lt;/tr&gt;
-&lt;/table&gt;</code></pre>
-</div>
-<div class="container exampleContainer">
-<table class="w-table w-fixed w-stripe">
-  <tr>
-    <td>Foo</td>
-    <td>Bar</td>
-    <td>Baz</td>
-  </tr>
-</table>
-</div><br class="w-clear">
-<p>For more examples, see <a href="advanced-content.html">writing advanced content</a>.</p>
-<blockquote>
-<p>Inline HTML is still parsed by the CommonMark parser (HTML is allowed in CommonMark documents). In DocGen, it is also
-possible to bypass the CommonMark parser altogether and specify a pure HTML input page, by setting
-<code class="w-inline-code">&quot;html&quot;: true</code> in a page object in <em>contents.json</em>.</p>
-</blockquote>
-<h2 id="embedding-images">Embedding images</h2>
-<p>Diagrams (in image form, e.g. JPEG, PNG, GIF etc) should be put the <em>files/images</em> directory, and embedded as images.</p>
-<div class="container codeContainer">
-<pre><code>![](files/images/logo.png)</code></pre>
-</div>
-<div class="container exampleContainer">
-<img src="files/images/logo.png">
-</div><br class="w-clear">
-<h2 id="attaching-files">Attaching files</h2>
-<p>Other files you want to attach should go into <em>files</em> directory.</p>
-<div class="container codeContainer">
-<pre><code>[attachment](user_guide.pdf)</code></pre>
-</div>
-<div class="container exampleContainer">
-<a href="user_guide.pdf">attachment</a>
-</div><br class="w-clear">
-<h2 id="mathematical-expressions">Mathematical Expressions</h2>
-<p><a href="http://en.wikipedia.org/wiki/LaTeX">LaTeX</a> is the most common markup format for mathematical expressions.</p>
-<p>Modern web browsers do not yet consistently support a common standard for authoring mathematical expressions. For this
-reason, extra libraries are needed. DocGen supports two widely-used web mathematics libraries out-the-box:</p>
-<ul>
-<li><strong><a href="http://khan.github.io/KaTeX/">KaTeX</a></strong> is fast, lightweight, and <a href="http://github.com/Khan/KaTeX/wiki/Function-Support-in-KaTeX">supports fewer features</a></li>
-<li><strong><a href="https://www.mathjax.org/">MathJax</a></strong> is slower, larger, and <a href="http://docs.mathjax.org/en/latest/tex.html#supported-latex-commands">supports more features</a></li>
-</ul>
-<p>The document author decides which one (or both) to use.</p>
-<p class="dg-forceBreak"></p>
-<h3 id="mathematics-using-katex">Mathematics using KaTeX</h3>
-<p>KaTeX is the recommended choice. It is bundled with DocGen but must be enabled by passing the
-<strong>-m</strong> option.</p>
-<div class="container codeContainer">
-<pre><code>&lt;div class=&quot;dg-katexMath&quot;&gt;
-f(x) = \int_{-\infty}^\infty
-    \hat f(\xi)\,e^{2 \pi i \xi x}
-    \,d\xi
-&lt;/div&gt;</code></pre>
-</div>
-<div class="container exampleContainer">
-<div class="dg-katexMath">
-f(x) = \int_{-\infty}^\infty
-    \hat f(\xi)\,e^{2 \pi i \xi x}
-    \,d\xi
-</div>
-</div><br class="w-clear">
-<h3 id="mathematics-using-mathjax">Mathematics using MathJax</h3>
-<p>MathJax is the fallback choice for expressions not yet supported by KaTex. When required, MathJax can be enabled by
-passing the <strong>-n</strong> option.</p>
-<blockquote>
-<p>DocGen uses the same MathJax configuration as the popular <a href="http://math.stackexchange.com">Stack Exchange</a> websites.</p>
-</blockquote>
-<p class="w-error">
-Because MathJax is a large library, it is not bundled with DocGen, but is served from a third-party CDN
-(content delivery network). This means users need an active Internet connection for the MathJax feature to work.
-</p>
-<p class="w-error">
-MathJax can be slow to render. When used with the PDF feature, it may be necessary to allow more rendering time by
-passing the <br><strong>-d [milliseconds]</strong> option.
-</p>
-<div class="container codeContainer">
-<pre><code>$$
-f(n) = \begin{cases}
-    n/2,  &amp; \text{if $n$ is even} \\
-    3n+1, &amp; \text{if $n$ is odd}
-    \end{cases}
-$$</code></pre>
-</div>
-<div class="container exampleContainer">
-$$
-f(n) = \begin{cases}
-    n/2,  &amp; \text{if $n$ is even} \\
-    3n+1, &amp; \text{if $n$ is odd}
-    \end{cases}
-$$
-</div><br class="w-clear">
-</div></div></section>
- <footer>
-  <div><p class="w-fixed-width"><span id="dg-web-footer">Version 2.1.3 released on 29/05/2015.</span></p></div>
-  <div class="w-fixed-width">
-    <p><span id="dg-copyright">&#xA9; 2015 <a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></p>
-    <p>
-      <span id="dg-marking">MIT License.</span>
-      <span id="dg-legalese"></span>
-      <span id="dg-attribution">Created by DocGen 2.1.3 on 29/05/2015 at 13:57:42.</span>
-    </p>
-  </div>
- </footer>
- </body>
-</html>

package/index.html DELETED Viewed

@@ -1,10 +0,0 @@
-<!doctype html>
-<html>
-<head>
- <title>DocGen - a documentation tool</title>
- <meta http-equiv="REFRESH" content="0;url=docs/index.html">
-</head>
-<body>
- <a href="docs/index.html" style="color:#ccc;font-size:12px">Redirect to homepage</a>
-</body>
-</html>

package/source/example/contents.json DELETED Viewed

@@ -1,12 +0,0 @@
-[
-	{
-		"heading" : "Quick Start",
-		"column" : 1,
-		"pages" : [
-			{
-				"title": "Overview",
-				"source": "index.txt"
-			}
-		]
-	}
-]

package/source/example/files/images/logo.png DELETED Viewed

Binary file

package/source/example/index.txt DELETED Viewed

@@ -1,4 +0,0 @@
-This is the empty template page for DocGen.
-To get started, edit **index.txt** and run DocGen. For more help see the
-[user guide](http://mtmacdonald.github.io/docgen/).

package/source/example/parameters.json DELETED Viewed

@@ -1,37 +0,0 @@
-{
-	"title" : "DocGen - empty template",
-	"name": "",
-	"version" : "1.0.0",
-	"date" : "XX/XX/XXXX",
-	"organization" : {
-		"name" : "",
-		"url" : ""
-	},
-	"author" : {
-		"name" : "",
-		"url" : ""
-	},
-	"owner" : {
-		"name" : "",
-		"url" : ""
-	},
-	"contributors" : [
-		{
-			"name" : "",
-			"url" : ""
-		}
-	],
-	"website" : {
-		"name" : "",
-		"url" : ""
-	},
-	"backlink" : {
-		"name" : "",
-		"url" : ""
-	},
-	"module" : "",
-	"id" : "",
-	"summary" : "",
-	"marking" : "",
-	"legalese" : ""
-}