docgen-tool 3.0.0 → 3.0.2

package/source/user-guide/writing-content.txt

@@ -1,269 +0,0 @@
-<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>
-
-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 [JSON](http://json.org) files.
-
-Overview
---------
-
-DocGen transforms source files from an input directory into output files in an output directory.
-
-It takes every source file (plain text) specified in **contents.json** and converts it. Each source file becomes a 
-separate page in the website and a separate chapter in the PDF.
-
-DocGen adds metadata that is specified in **parameters.json**, and copies the images and files in the **files**
-directory to the output.
-
-> Always save input files with **UTF-8** encoding. This makes non-standard characters (ø © é etc) work.
-
-Metadata
---------
-
-**parameters.json**
-
-The parameters file is used to specify metadata describing the product. 
-
-- **title** - the product title
-- **name** - the product name (also used to name the PDF)
-- **version** - the release version
-- **date** - the release date
-- **organization** - the company or organization 
-- **author** - the lead author of the document
-- **owner** - the owner of the product
-- **contributors** - list of contributors
-- **website** - a link to the product website
-- **backlink** - a link back to product user interface (useful for integrated documentation)
-- **module** - module name (useful for larger products with submodules)
-- **id** - reference number (e.g. product id in a change management tool)
-- **summary** - a descriptive summary of the product
-- **marking** - license or other protective markings
-- **legalese** - document markings (confidentiality, disclaimers, smallprint etc)
-
-Values can be empty strings, but the elements are required in the JSON file. 
-
-Parameters with URLs can be either website URLs, or email addresses (specify *'mailto:name@address.com'*).
-
-**contents.json**
-
-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.
-
-**release-notes.txt**
-
-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.
-
-Plain text
-----------
-
-The simplest input format is just to write in plain text. Here is an example of the source and output:
-
-<div class="container codeContainer">
-
-    Example paragraph.
-
-</div>
-<div class="container exampleContainer">
-
-Example paragraph.
-
-</div><br class="w-clear"/>
-
-<p class="dg-forceBreak"></p>
-
-CommonMark (Markdown)
----------------------
-
-[CommonMark](http://commonmark.org/) (also known as [MarkDown](http://daringfireball.net/projects/markdown/)) 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:
-
-<div class="container codeContainer">
-
-    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
-      # "Hello World" in Ruby:
-      5.times { puts "Hello!" }
-</div>
-<div class="container exampleContainer">
-
-<p class="dg-fakeHeading" style="font-size: 18px; padding-bottom: 4px;">CommonMark Example</p>
-
-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
-    # "Hello World" in Ruby:
-    5.times { puts "Hello!" }
-</div><br class="w-clear"/>
-
-For more examples, see the [CommonMark reference](commonmark.html).
-
-HTML
-----
-
-For more complex pages not covered by CommonMark's syntax, simply use inline HTML:
-
-<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>
-  <tr>
-    <td>Foo</td>
-    <td>Bar</td>
-    <td>Baz</td>
-  </tr>
-</table>
-</div><br class="w-clear"/>
-
-For more examples, see [writing advanced content](advanced-content.html).
-
-> 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">"html": true</code> in a page object in *contents.json*.
-
-Embedding images
-----------------
-
-Diagrams (in image form, e.g. JPEG, PNG, GIF etc) should be put the *files/images* directory, and embedded as images.
-
-<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"/>
-
-Attaching files
----------------
-
-Other files you want to attach should go into *files* directory.
-
-<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"/>
-
-Mathematical Expressions
-------------------------
-
-[LaTeX](http://en.wikipedia.org/wiki/LaTeX) is the most common markup format for mathematical expressions.
-
-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:
-
-- **[KaTeX](http://khan.github.io/KaTeX/)** is fast, lightweight, and [supports fewer features](http://github.com/Khan/KaTeX/wiki/Function-Support-in-KaTeX)
-- **[MathJax](https://www.mathjax.org/)** is slower, larger, and [supports more features](http://docs.mathjax.org/en/latest/tex.html#supported-latex-commands)
-
-The document author decides which one (or both) to use.
-
-<p class="dg-forceBreak"></p>
-
-### Mathematics using KaTeX
-
-KaTeX is the recommended choice. It is bundled with DocGen but must be enabled by passing the 
-**-m** option.
-
-<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"/>
-
-### Mathematics using MathJax
-
-MathJax is the fallback choice for expressions not yet supported by KaTex. When required, MathJax can be enabled by 
-passing the **-n** option.
-
-> DocGen uses the same MathJax configuration as the popular [Stack Exchange](http://math.stackexchange.com) websites.
-
-<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,  & \text{if $n$ is even} \\
-    3n+1, & \text{if $n$ is odd}
-    \end{cases}
-$$</code></pre>
-</div>
-<div class="container exampleContainer">
-$$
-f(n) = \begin{cases}
-    n/2,  & \text{if $n$ is even} \\
-    3n+1, & \text{if $n$ is odd}
-    \end{cases}
-$$
-</div><br class="w-clear"/>

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "compilerOptions": {
-    "outDir": "./dist",
-    "allowJs": true,
-    "target": "es5"
-  },
-  "files": ["./docgen.js"]
-}