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
  1. package/LICENSE +35 -33
  2. package/{docgen → dist/docgen.js} +13 -24
  3. package/{source → dist/source}/docgen.js +380 -357
  4. package/dist/source/require/docgen.css +138 -0
  5. package/dist/source/require/katexInjector.js +18 -0
  6. package/dist/source/require/print.css +26 -0
  7. package/{source → dist/source}/templates/main.html +93 -93
  8. package/package.json +50 -20
  9. package/.npmignore +0 -2
  10. package/docs/advanced-content.html +0 -239
  11. package/docs/commonmark.html +0 -225
  12. package/docs/docgen.pdf +0 -0
  13. package/docs/files/images/logo.png +0 -0
  14. package/docs/files/images/overview.png +0 -0
  15. package/docs/files/images/pdf.png +0 -0
  16. package/docs/files/images/svg/icon.svg +0 -845
  17. package/docs/files/images/svg/overview.svg +0 -1345
  18. package/docs/files/images/text.png +0 -0
  19. package/docs/files/images/web.png +0 -0
  20. package/docs/index.html +0 -333
  21. package/docs/installation.html +0 -121
  22. package/docs/ownership.html +0 -164
  23. package/docs/release-notes.html +0 -148
  24. package/docs/require/docgen.css +0 -131
  25. package/docs/require/katexInjector.js +0 -22
  26. package/docs/require/print.css +0 -19
  27. package/docs/running.html +0 -123
  28. package/docs/troubleshooting.html +0 -105
  29. package/docs/upgrading.html +0 -124
  30. package/docs/version-control.html +0 -102
  31. package/docs/writing-content.html +0 -305
  32. package/index.html +0 -10
  33. package/source/example/contents.json +0 -12
  34. package/source/example/files/images/logo.png +0 -0
  35. package/source/example/index.txt +0 -4
  36. package/source/example/parameters.json +0 -37
  37. package/source/example/release-notes.txt +0 -1
  38. package/source/optional/katex/fonts/KaTeX_AMS-Regular.woff +0 -0
  39. package/source/optional/katex/fonts/KaTeX_Main-Bold.woff +0 -0
  40. package/source/optional/katex/fonts/KaTeX_Main-Italic.woff +0 -0
  41. package/source/optional/katex/fonts/KaTeX_Main-Regular.woff +0 -0
  42. package/source/optional/katex/fonts/KaTeX_Math-BoldItalic.woff +0 -0
  43. package/source/optional/katex/fonts/KaTeX_Math-Italic.woff +0 -0
  44. package/source/optional/katex/fonts/KaTeX_Math-Regular.woff +0 -0
  45. package/source/optional/katex/fonts/KaTeX_Size1-Regular.woff +0 -0
  46. package/source/optional/katex/fonts/KaTeX_Size2-Regular.woff +0 -0
  47. package/source/optional/katex/fonts/KaTeX_Size3-Regular.woff +0 -0
  48. package/source/optional/katex/fonts/KaTeX_Size4-Regular.woff +0 -0
  49. package/source/optional/katex/katex.min.css +0 -1
  50. package/source/optional/katex/katex.min.js +0 -6
  51. package/source/pdf-stylesheet.css +0 -53
  52. package/source/release-checklist.txt +0 -27
  53. package/source/require/docgen.css +0 -131
  54. package/source/require/katexInjector.js +0 -22
  55. package/source/require/print.css +0 -19
  56. package/source/require/webknife/fonts/DroidSansMono.woff +0 -0
  57. package/source/require/webknife/fonts/OpenSans.woff +0 -0
  58. package/source/require/webknife/fonts/OpenSansBold.woff +0 -0
  59. package/source/require/webknife/fonts/OpenSansBoldItalic.woff +0 -0
  60. package/source/require/webknife/fonts/OpenSansItalic.woff +0 -0
  61. package/source/require/webknife/framework.icons.js +0 -82
  62. package/source/require/webknife/framework.min.css +0 -3
  63. package/source/require/webknife/framework.min.js +0 -14
  64. package/source/require/webknife/highlight.min.css +0 -1
  65. package/source/require/webknife/highlight.min.js +0 -6
  66. package/source/user-guide/advanced-content.txt +0 -171
  67. package/source/user-guide/commonmark.txt +0 -156
  68. package/source/user-guide/contents.json +0 -57
  69. package/source/user-guide/files/images/logo.png +0 -0
  70. package/source/user-guide/files/images/overview.png +0 -0
  71. package/source/user-guide/files/images/pdf.png +0 -0
  72. package/source/user-guide/files/images/svg/icon.svg +0 -845
  73. package/source/user-guide/files/images/svg/overview.svg +0 -1345
  74. package/source/user-guide/files/images/text.png +0 -0
  75. package/source/user-guide/files/images/web.png +0 -0
  76. package/source/user-guide/index.txt +0 -245
  77. package/source/user-guide/installation.txt +0 -49
  78. package/source/user-guide/parameters.json +0 -37
  79. package/source/user-guide/release-notes.txt +0 -64
  80. package/source/user-guide/running.txt +0 -47
  81. package/source/user-guide/troubleshooting.txt +0 -32
  82. package/source/user-guide/upgrading.txt +0 -25
  83. package/source/user-guide/version-control.txt +0 -13
  84. package/source/user-guide/writing-content.txt +0 -269
  85. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_AMS-Regular.woff +0 -0
  86. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Main-Bold.woff +0 -0
  87. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Main-Italic.woff +0 -0
  88. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Main-Regular.woff +0 -0
  89. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Math-BoldItalic.woff +0 -0
  90. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Math-Italic.woff +0 -0
  91. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Math-Regular.woff +0 -0
  92. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Size1-Regular.woff +0 -0
  93. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Size2-Regular.woff +0 -0
  94. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Size3-Regular.woff +0 -0
  95. /package/{docs/require → dist/source/optional}/katex/fonts/KaTeX_Size4-Regular.woff +0 -0
  96. /package/{docs/require → dist/source/optional}/katex/katex.min.css +0 -0
  97. /package/{docs/require → dist/source/optional}/katex/katex.min.js +0 -0
  98. /package/{source → dist/source}/pdf-contents.xsl +0 -0
  99. /package/{docs → dist/source}/require/webknife/fonts/DroidSansMono.woff +0 -0
  100. /package/{docs → dist/source}/require/webknife/fonts/OpenSans.woff +0 -0
  101. /package/{docs → dist/source}/require/webknife/fonts/OpenSansBold.woff +0 -0
  102. /package/{docs → dist/source}/require/webknife/fonts/OpenSansBoldItalic.woff +0 -0
  103. /package/{docs → dist/source}/require/webknife/fonts/OpenSansItalic.woff +0 -0
  104. /package/{docs → dist/source}/require/webknife/framework.icons.js +0 -0
  105. /package/{docs → dist/source}/require/webknife/framework.min.css +0 -0
  106. /package/{docs → dist/source}/require/webknife/framework.min.js +0 -0
  107. /package/{docs → dist/source}/require/webknife/highlight.min.css +0 -0
  108. /package/{docs → dist/source}/require/webknife/highlight.min.js +0 -0
  109. /package/{source → dist/source}/templates/pdfCover.html +0 -0
  110. /package/{source → dist/source}/templates/pdfFooter.html +0 -0
  111. /package/{source → dist/source}/templates/pdfHeader.html +0 -0
  112. /package/{source → dist/source}/templates/redirect.html +0 -0
  113. /package/{source → dist/source}/templates/webCover.html +0 -0
Binary file
Binary file
package/docs/index.html DELETED
@@ -1,333 +0,0 @@
1
- <!doctype html>
2
- <html>
3
- <head>
4
- <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.-->
5
- <meta name="viewport" content="width=device-width, user-scalable=yes"><!--Mobile device scaling-->
6
- <meta charset="UTF-8">
7
- <title>DocGen - a documentation tool</title>
8
-
9
- <!--load stylesheets first (rationale: https://developers.google.com/speed/docs/best-practices/rtt#PutStylesBeforeScripts)-->
10
- <link rel="stylesheet" href="require/webknife/framework.min.css" type="text/css">
11
- <link rel="stylesheet" href="require/webknife/highlight.min.css" type="text/css">
12
- <link rel="stylesheet" href="require/docgen.css" type="text/css">
13
- <link rel="stylesheet" href="require/print.css" media="print">
14
-
15
- <!--load scripts second-->
16
-
17
- <script src="require/webknife/framework.min.js"></script>
18
- <script src="require/webknife/framework.icons.js"></script>
19
- <script src="require/webknife/highlight.min.js"></script>
20
-
21
- <!--inline scripts last-->
22
-
23
- <script type="text/javascript">
24
-
25
- $(document).ready( function () {
26
- $("#dg-toc").hide(); //hide the table of contents
27
-
28
- //instantiate an svg injector to show SVG icons
29
- var injector = new svgInject();
30
- injector.inject();
31
-
32
- //code syntax highlighting
33
- $('pre code, .w-inline-code').each(function(i, block) {
34
- hljs.highlightBlock(block);
35
- });
36
-
37
- //toggle visibility of table of contents
38
- $("#dg-navigator").click(function()
39
- {
40
- $("#dg-toc").slideToggle("fast");
41
- $(this).toggleClass("active");
42
- });
43
-
44
- });
45
- </script>
46
-
47
- <script type="text/x-mathjax-config">
48
- //MathJax configuration is the same as used by math.stackexchange.com
49
- MathJax.Hub.Config({"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], linebreaks: { automatic:true }, EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50) },
50
- tex2jax: { inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ], displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], processEscapes: true, ignoreClass: "tex2jax_ignore|dno" },
51
- TeX: { noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } }, Macros: { href: "{}" } },
52
- messageStyle: "none"
53
- });
54
- </script>
55
-
56
- <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>
57
-
58
- <body>
59
-
60
- <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>
61
- <div id="dg-navigator">Table of contents</div>
62
-
63
- <header>
64
- <div class="w-fixed-width">
65
- <a id="dg-homelink" href="index.html">
66
- <div id="dg-logo" style="background-image: url(files/images/logo.png); height: 42px; line-height: 42px; padding-left: 85px;">
67
- <span id="dg-title">DocGen - a documentation tool</span> <span id="dg-web-title-version" style="font-weight:normal;">(2.1.3)</span>
68
- </div>
69
- </a>
70
- <div>
71
- <span id="dg-backlink"></span>
72
- </div>
73
- </div>
74
- </header>
75
-
76
- <section id="dg-content"><div id="dg-innerContent"><h1 id="dg-autoTitle" class="dg-hiddenTitle">Overview</h1><style>
77
- #dg-content, #dg-innerContent {
78
- padding-top: 0;
79
- }
80
- #banner, #banner-buttons {
81
- margin: 0;
82
- }
83
-
84
- #banner {
85
- color: #385691;
86
- font-weight: bold;
87
- padding-top: 30px;
88
- background-color: #f7f7f7;
89
- box-shadow: inset 0px 5px 5px 0px #e7e7e7;
90
- }
91
-
92
- #banner img {
93
- padding: 25px 0 25px 0;
94
- }
95
-
96
- #banner-buttons {
97
- background-color: #f7f7f7;
98
- padding: 20px 0 20px 0;
99
- background-color: #999;
100
- }
101
-
102
- .spaced {
103
- margin-right: 15px;
104
- }
105
-
106
- .heading-text {
107
- font-size: 16px;
108
- text-align: center;
109
- }
110
-
111
- .segment {
112
- border-bottom: 2px solid #4d4d4d;
113
- padding: 20px 0 20px 0;
114
- }
115
-
116
- .how-it-works li {
117
- vertical-align: top;
118
- display: inline-block;
119
- width: 290px;
120
- margin: 10px;
121
- padding: 0;
122
- border: 2px solid #4d4d4d;
123
- border-radius: 10px 10px 0 0;
124
- }
125
-
126
- .how-it-works li p:first-of-type {
127
- margin: 0;
128
- border: none;
129
- background-color: #4d4d4d;
130
- color: white;
131
- padding: 18px 10px 18px 10px;
132
- text-align: center;
133
- font-style: italic;
134
- font-weight: bold;
135
- border-radius: 7px 7px 0 0;
136
- }
137
-
138
- .how-it-works li p:first-of-type a {
139
- color: white;
140
- }
141
-
142
- .how-it-works li p:last-of-type {
143
- padding:0;
144
- margin:0;
145
- height: 400px;
146
- background-repeat:no-repeat;
147
- }
148
-
149
- .features {
150
- margin: 0;
151
- padding: 0;
152
- width: 100%;
153
- }
154
-
155
- .features li {
156
- vertical-align: top;
157
- display: inline-block;
158
- width: 220px;
159
- margin: 10px;
160
- }
161
-
162
- .features li span {
163
- vertical-align: middle;
164
- margin-right: 5px;
165
- }
166
-
167
- .features li p:first-of-type {
168
- margin: 0;
169
- padding: 0 0 3px 0;
170
- font-size: 14px;
171
- font-weight: bold;
172
- color: #385691;
173
- border: none;
174
- }
175
-
176
- .features li p:last-of-type {
177
- padding-top: 5px;
178
- margin: 0;
179
- }
180
-
181
- </style>
182
-
183
- <div id="banner" class="segment"><div class="w-fixed-width">
184
- <p class="w-massive w-center w-no-underline">Better documentation for software products.</p>
185
- <img class="w-center" src="files/images/overview.png" alt="overview">
186
- </div></div>
187
-
188
- <div id="banner-buttons" class="segment"><div class="w-fixed-width">
189
- <span class="w-center">
190
- <a href="https://github.com/mtmacdonald/docgen/releases" class="w-button-link w-colored w-large spaced">Download</a>
191
- <a href="https://github.com/mtmacdonald/docgen/issues" class="w-button-link w-dark">Report Issues</a>
192
- </span>
193
- </div></div>
194
-
195
- <div class="segment" style="border-bottom: none; margin-bottom:0; padding-bottom:0;"><div class="w-fixed-width">
196
- <p class="heading-text">
197
- <strong>DocGen</strong> is a <strong>static website generator</strong> that&apos;s ideal for making technical user guides for software products.
198
- </p>
199
-
200
- <h2 class="dg-hiddenTitle" id="features">Features</h2>
201
- <ul class="features">
202
- <li>
203
- <p><span class="w-icon" data-name="monitor"></span><span>Self-contained website</span></p>
204
- <p>Creates a static website that works on any server, or as local files (CD, shared drive etc).</p>
205
- </li>
206
- <li>
207
- <p><span class="w-icon" data-name="document"></span><span>Optional PDF</span></p>
208
- <p>Also publishes the website content as a single PDF, using <a href="http://wkhtmltopdf.org">wkhtmltopdf</a>.</p>
209
- </li>
210
- <li>
211
- <p><span class="w-icon" data-name="edit"></span><span>Human-friendly input</span></p>
212
- <p>Write in plain text, or the human-friendly <a href="http://commonmark.org">CommonMark</a> format
213
- (Markdown).</p>
214
- </li>
215
- <li>
216
- <p><span class="w-icon" data-name="gear_a"></span><span>Easy to version control</span></p>
217
- <p>Easily version control software documentation in sync with its product.</p>
218
- </li>
219
- <li>
220
- <p><span class="w-icon" data-name="clipboard"></span><span>Table of contents</span></p>
221
- <p>Automatically creates tables of contents, with links and PDF page numbers.</p>
222
- </li>
223
- <li>
224
- <p><span class="w-icon" data-name="code"></span><span>Code syntax highlighting</span></p>
225
- <p>Automatically highlights code blocks, using <a href="https://highlightjs.org">Highlight.js</a>, with language detection.</p>
226
- </li>
227
- <li>
228
- <p><span class="w-icon" data-name="compose"></span><span>Mathematical expressions</span></p>
229
- <p>Displays mathematical expressions without plugins, using either
230
- <a href="http://khan.github.io/KaTeX/">KaTeX</a> or
231
- <a href="https://www.mathjax.org">MathJax</a>.</p>
232
- </li>
233
- <li>
234
- <p><span class="w-icon" data-name="star"></span><span>Branding and metadata</span></p>
235
- <p>Easily brand with a logo, attribute ownership, and attach release notes.</p>
236
- </li>
237
- </ul>
238
-
239
- <p class="heading-text">DocGen makes it easy for anyone to create high-quality technical documentation.</p>
240
-
241
- </div></div>
242
-
243
- <div style="padding-top:20px;"><div class="w-fixed-width">
244
-
245
- <p class="dg-forceBreak"></p>
246
- <h2 id="how-it-works">How it works</h2>
247
-
248
- <ul class="how-it-works" id="how-it-works">
249
- <li>
250
- <p>&quot;You write in plain text or human-friendly <a href="http://commonmark.org">CommonMark</a>&quot;</p>
251
- <p style="background-image:url(&apos;files/images/text.png&apos;);"></p>
252
- </li>
253
- <li>
254
- <p>&quot;DocGen styles and publishes all your content as a website&quot;</p>
255
- <p style="background-image:url(&apos;files/images/web.png&apos;);"></p>
256
- </li>
257
- <li>
258
- <p>&quot;DocGen also creates an equivalent PDF copy&quot;</p>
259
- <p style="background-image:url(&apos;files/images/pdf.png&apos;);"></p>
260
- </li>
261
- </ul>
262
-
263
- <table style="width:600px; border:none; padding:0;" class="w-table w-fixed w-stripe">
264
- <tr style="border:none; padding:0;">
265
-
266
- <td style="border:none; text-align:left; padding:0; vertical-align: top;"><ul>
267
- <li class="list-heading">Flexible Input Formats</li>
268
- <li>Plain text</li>
269
- <li>CommonMark (Markdown)</li>
270
- <li>HTML</li>
271
- <li>LaTeX mathematical expressions</li>
272
- <li>Image diagrams</li>
273
- <li>Attach other documents</li>
274
- </ul></td>
275
-
276
- <td style="border:none; text-align:left; padding:0; vertical-align: top;"><ul>
277
- <li class="list-heading">Configurable Metadata</li>
278
- <li>Branding (logo, title, organization)</li>
279
- <li>License, copyright, and legal markings</li>
280
- <li>Ownership and attribution</li>
281
- <li>Version information</li>
282
- <li>Release notes (change log)</li>
283
- </ul></td>
284
-
285
- </tr>
286
- </table>
287
-
288
- <blockquote>
289
- DocGen is probably not the right tool for precision PDF layout. Or for product configurators which need to output
290
- variants based on a common template. Docgen is intended more for free-form, human generated content which is regularly
291
- updated and refactored, and standardised for each product release.
292
- </blockquote>
293
-
294
- <h2 id="browser-support">Browser support</h2>
295
-
296
- Output created by DocGen works in modern browsers (desktop and mobile devices).
297
-
298
- <ul><li>tested in <a href="http://windows.microsoft.com/en-us/internet-explorer/download-ie">Internet Explorer 9+</a>,
299
- <a href="http://www.google.com/chrome">Chrome</a>,
300
- <a href="https://www.mozilla.org/en-US/firefox/new">Firefox</a>,
301
- <a href="https://www.apple.com/safari">Safari</a></li></ul>
302
-
303
- <h2 id="quick-start">Quick start</h2>
304
-
305
- <ul>
306
- <li class="list-heading">In just three commands:</li>
307
- <li>Install DocGen</li>
308
- <li>Scaffold an empty template</li>
309
- <li>Generate a static website</li>
310
- </ul>Enter these commands in the terminal:<p></p>
311
-
312
- <pre><code>sudo npm install -g docgen-tool
313
- docgen scaffold
314
- docgen run -o $HOME/docgen-example</code></pre>
315
-
316
- <p>See the <a href="installation.html">installation guide</a> for more detailed instructions.</p>
317
-
318
- </div></div></div></section>
319
-
320
- <footer>
321
- <div><p class="w-fixed-width"><span id="dg-web-footer">Version 2.1.3 released on 29/05/2015.</span></p></div>
322
- <div class="w-fixed-width">
323
- <p><span id="dg-copyright">&#xA9; 2015 <a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></p>
324
- <p>
325
- <span id="dg-marking">MIT License.</span>
326
- <span id="dg-legalese"></span>
327
- <span id="dg-attribution">Created by DocGen 2.1.3 on 29/05/2015 at 13:57:42.</span>
328
- </p>
329
- </div>
330
- </footer>
331
-
332
- </body>
333
- </html>
@@ -1,121 +0,0 @@
1
- <!doctype html>
2
- <html>
3
- <head>
4
- <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.-->
5
- <meta name="viewport" content="width=device-width, user-scalable=yes"><!--Mobile device scaling-->
6
- <meta charset="UTF-8">
7
- <title>DocGen - a documentation tool</title>
8
-
9
- <!--load stylesheets first (rationale: https://developers.google.com/speed/docs/best-practices/rtt#PutStylesBeforeScripts)-->
10
- <link rel="stylesheet" href="require/webknife/framework.min.css" type="text/css">
11
- <link rel="stylesheet" href="require/webknife/highlight.min.css" type="text/css">
12
- <link rel="stylesheet" href="require/docgen.css" type="text/css">
13
- <link rel="stylesheet" href="require/print.css" media="print">
14
-
15
- <!--load scripts second-->
16
-
17
- <script src="require/webknife/framework.min.js"></script>
18
- <script src="require/webknife/framework.icons.js"></script>
19
- <script src="require/webknife/highlight.min.js"></script>
20
-
21
- <!--inline scripts last-->
22
-
23
- <script type="text/javascript">
24
-
25
- $(document).ready( function () {
26
- $("#dg-toc").hide(); //hide the table of contents
27
-
28
- //instantiate an svg injector to show SVG icons
29
- var injector = new svgInject();
30
- injector.inject();
31
-
32
- //code syntax highlighting
33
- $('pre code, .w-inline-code').each(function(i, block) {
34
- hljs.highlightBlock(block);
35
- });
36
-
37
- //toggle visibility of table of contents
38
- $("#dg-navigator").click(function()
39
- {
40
- $("#dg-toc").slideToggle("fast");
41
- $(this).toggleClass("active");
42
- });
43
-
44
- });
45
- </script>
46
-
47
- <script type="text/x-mathjax-config">
48
- //MathJax configuration is the same as used by math.stackexchange.com
49
- MathJax.Hub.Config({"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], linebreaks: { automatic:true }, EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50) },
50
- tex2jax: { inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ], displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], processEscapes: true, ignoreClass: "tex2jax_ignore|dno" },
51
- TeX: { noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } }, Macros: { href: "{}" } },
52
- messageStyle: "none"
53
- });
54
- </script>
55
-
56
- <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>
57
-
58
- <body>
59
-
60
- <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>
61
- <div id="dg-navigator">Table of contents</div>
62
-
63
- <header>
64
- <div class="w-fixed-width">
65
- <a id="dg-homelink" href="index.html">
66
- <div id="dg-logo" style="background-image: url(files/images/logo.png); height: 42px; line-height: 42px; padding-left: 85px;">
67
- <span id="dg-title">DocGen - a documentation tool</span> <span id="dg-web-title-version" style="font-weight:normal;">(2.1.3)</span>
68
- </div>
69
- </a>
70
- <div>
71
- <span id="dg-backlink"></span>
72
- </div>
73
- </div>
74
- </header>
75
-
76
- <section id="dg-content"><div class="w-fixed-width"><div id="dg-innerContent"><h1 id="dg-autoTitle">Installation</h1><ul class="dg-pageToc"><li><a href="#supported-platform">Supported platform</a></li><li><a href="#dependencies">Dependencies</a></li><li><a href="#optional-dependencies-(only-for-pdf)">Optional dependencies (only for PDF)</a></li><li><a href="#quick-install-with-npm">Quick install with NPM</a></li><li><a href="#install-by-direct-download">Install by direct download</a></li></ul><p>This section explains how to install DocGen.</p>
77
- <h2 id="supported-platform">Supported platform</h2>
78
- <p><em>&apos;Supported platform&apos;</em> means the software required to <strong>run</strong> the DocGen tool. The static website <strong>produced</strong> by
79
- DocGen will work on all modern browsers on all all major operating systems
80
- (see <a href="index.html#browser-support">browser support</a>).</p>
81
- <p class="w-information">
82
- The supported platform for this version of DocGen is:
83
- <strong>Ubuntu 14.04</strong> with <strong>Node.js 0.12.0</strong>
84
- and <strong>wkhtmltopdf 0.12.2.1 </strong>(with patched qt).
85
- </p>
86
- <p>While other operating systems and dependency versions may work, they are not tested or officially supported.</p>
87
- <h2 id="dependencies">Dependencies</h2>
88
- <p>DocGen requires <strong><a href="https://nodejs.org">Node.js</a></strong>. To install on Ubuntu Linux, enter these terminal commands:</p>
89
- <pre><code>curl -sL https://deb.nodesource.com/setup_0.12 | sudo bash -
90
- sudo apt-get install -y nodejs
91
- </code></pre>
92
- <p>This method uses the
93
- <a href="https://nodesource.com/blog/nodejs-v012-iojs-and-the-nodesource-linux-repositories">NodeSource Linux Repositories</a>
94
- (recommended).</p>
95
- <p>For other platforms (not supported), see the <a href="https://nodejs.org/download">download page</a> or vendor instructions.</p>
96
- <h2 id="optional-dependencies-(only-for-pdf)">Optional dependencies (only for PDF)</h2>
97
- <p>For optional PDF support, DocGen requires <strong><a href="http://wkhtmltopdf.org">wkhtmltopdf</a></strong>. See the wkthmltopdf website for
98
- installation instructions.</p>
99
- <h2 id="quick-install-with-npm">Quick install with NPM</h2>
100
- <p>The quickest way to install DocGen is with <strong><a href="https://www.npmjs.com">npm</a></strong> (the JavaScript package manager). Enter
101
- these terminal commands:</p>
102
- <pre><code>sudo npm install -g docgen-tool
103
- </code></pre>
104
- <h2 id="install-by-direct-download">Install by direct download</h2>
105
- <p>DocGen can also be installed by <a href="https://github.com/mtmacdonald/docgen">direct download</a>.</p>
106
- </div></div></section>
107
-
108
- <footer>
109
- <div><p class="w-fixed-width"><span id="dg-web-footer">Version 2.1.3 released on 29/05/2015.</span></p></div>
110
- <div class="w-fixed-width">
111
- <p><span id="dg-copyright">&#xA9; 2015 <a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></p>
112
- <p>
113
- <span id="dg-marking">MIT License.</span>
114
- <span id="dg-legalese"></span>
115
- <span id="dg-attribution">Created by DocGen 2.1.3 on 29/05/2015 at 13:57:42.</span>
116
- </p>
117
- </div>
118
- </footer>
119
-
120
- </body>
121
- </html>
@@ -1,164 +0,0 @@
1
- <!doctype html>
2
- <html>
3
- <head>
4
- <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.-->
5
- <meta name="viewport" content="width=device-width, user-scalable=yes"><!--Mobile device scaling-->
6
- <meta charset="UTF-8">
7
- <title>DocGen - a documentation tool</title>
8
-
9
- <!--load stylesheets first (rationale: https://developers.google.com/speed/docs/best-practices/rtt#PutStylesBeforeScripts)-->
10
- <link rel="stylesheet" href="require/webknife/framework.min.css" type="text/css">
11
- <link rel="stylesheet" href="require/webknife/highlight.min.css" type="text/css">
12
- <link rel="stylesheet" href="require/docgen.css" type="text/css">
13
- <link rel="stylesheet" href="require/print.css" media="print">
14
-
15
- <!--load scripts second-->
16
-
17
- <script src="require/webknife/framework.min.js"></script>
18
- <script src="require/webknife/framework.icons.js"></script>
19
- <script src="require/webknife/highlight.min.js"></script>
20
-
21
- <!--inline scripts last-->
22
-
23
- <script type="text/javascript">
24
-
25
- $(document).ready( function () {
26
- $("#dg-toc").hide(); //hide the table of contents
27
-
28
- //instantiate an svg injector to show SVG icons
29
- var injector = new svgInject();
30
- injector.inject();
31
-
32
- //code syntax highlighting
33
- $('pre code, .w-inline-code').each(function(i, block) {
34
- hljs.highlightBlock(block);
35
- });
36
-
37
- //toggle visibility of table of contents
38
- $("#dg-navigator").click(function()
39
- {
40
- $("#dg-toc").slideToggle("fast");
41
- $(this).toggleClass("active");
42
- });
43
-
44
- });
45
- </script>
46
-
47
- <script type="text/x-mathjax-config">
48
- //MathJax configuration is the same as used by math.stackexchange.com
49
- MathJax.Hub.Config({"HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], linebreaks: { automatic:true }, EqnChunk: (MathJax.Hub.Browser.isMobile ? 10 : 50) },
50
- tex2jax: { inlineMath: [ ["$", "$"], ["\\\\(","\\\\)"] ], displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], processEscapes: true, ignoreClass: "tex2jax_ignore|dno" },
51
- TeX: { noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } }, Macros: { href: "{}" } },
52
- messageStyle: "none"
53
- });
54
- </script>
55
-
56
- <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>
57
-
58
- <body>
59
-
60
- <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>
61
- <div id="dg-navigator">Table of contents</div>
62
-
63
- <header>
64
- <div class="w-fixed-width">
65
- <a id="dg-homelink" href="index.html">
66
- <div id="dg-logo" style="background-image: url(files/images/logo.png); height: 42px; line-height: 42px; padding-left: 85px;">
67
- <span id="dg-title">DocGen - a documentation tool</span> <span id="dg-web-title-version" style="font-weight:normal;">(2.1.3)</span>
68
- </div>
69
- </a>
70
- <div>
71
- <span id="dg-backlink"></span>
72
- </div>
73
- </div>
74
- </header>
75
-
76
- <section id="dg-content"><div class="w-fixed-width"><div id="dg-innerContent"><style>
77
-
78
- #dg-coverInfo {
79
- margin-top: 100px;
80
- margin-bottom: 50px;
81
- width: 100%;
82
- }
83
-
84
- #dg-coverInfo {
85
- border-collapse: separate; /*http://stackoverflow.com/questions/7625586/*/
86
- }
87
-
88
- #dg-coverInfo th {
89
- background-color: #385691;
90
- color: white;
91
- font-size: 34px;
92
- padding: 20px;
93
- border: 1px solid #385691;
94
- border-radius: 10px 10px 0 0;
95
- }
96
-
97
- #dg-coverInfo tr td {
98
- border-top: 2px solid #385691;
99
- border-left: 2px solid #385691;
100
- border-bottom: none;
101
- border-right: none;
102
- padding-top: 20px;
103
- padding-bottom: 20px;
104
- }
105
-
106
- #dg-coverInfo td:last-child {
107
- border-right: 2px solid #385691;
108
- }
109
-
110
- #dg-coverInfo .dg-finalRow td {
111
- border-bottom: 2px solid #385691;
112
- }
113
-
114
- #dg-summary {
115
- margin-bottom: 100px;
116
- }
117
-
118
- </style>
119
-
120
- <table class="w-table w-fixed" id="dg-coverInfo">
121
- <thead>
122
- <tr>
123
- <th colspan="3" id="dg-title">DocGen - a documentation tool</th>
124
- </tr>
125
- </thead>
126
- <tfoot>
127
- </tfoot>
128
- <tbody>
129
- <tr>
130
- <td><strong>Owner: </strong> <span id="dg-owner"><a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></td>
131
- <td><strong>Version: </strong> <span id="dg-version">2.1.3</span></td>
132
- <td><strong>Released: </strong> <span id="dg-release-date">29/05/2015</span></td>
133
- </tr>
134
- <tr>
135
- <td><strong>Author: </strong> <span id="dg-author"><a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></td>
136
- <td colspan="2"><strong>Contributors: </strong> <span id="dg-contributors"></span></td>
137
- </tr>
138
- <tr class="dg-finalRow">
139
- <td><strong>Module: </strong> <span id="dg-module"></span></td>
140
- <td><strong>ID: </strong> <span id="dg-id"></span></td>
141
- <td><strong>Link: </strong> <span id="dg-website"><a href="https://github.com/mtmacdonald/docgen">Github</a></span></td>
142
- </tr>
143
- <tr>
144
- </tr></tbody>
145
- </table>
146
-
147
- <h1>Summary</h1>
148
- <p id="dg-summary">DocGen is a command-line documentation tool for software products. It takes plain text or CommonMark (Markdown) as input, and generates both a static website and a PDF copy.</p>
149
- </div></div></section>
150
-
151
- <footer>
152
- <div><p class="w-fixed-width"><span id="dg-web-footer">Version 2.1.3 released on 29/05/2015.</span></p></div>
153
- <div class="w-fixed-width">
154
- <p><span id="dg-copyright">&#xA9; 2015 <a href="https://github.com/mtmacdonald">Mark Macdonald</a></span></p>
155
- <p>
156
- <span id="dg-marking">MIT License.</span>
157
- <span id="dg-legalese"></span>
158
- <span id="dg-attribution">Created by DocGen 2.1.3 on 29/05/2015 at 13:57:42.</span>
159
- </p>
160
- </div>
161
- </footer>
162
-
163
- </body>
164
- </html>