Skip to content

Commit 1877e9e

Browse files
committed
Release 0.0.2
1 parent 65d2d0a commit 1877e9e

File tree

4 files changed

+41
-14
lines changed

4 files changed

+41
-14
lines changed

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
11

2+
#### v0.0.2 `June 10, 2023`
3+
4+
- **[DOC]** update readme, add table of contents and contributing info ([65d2d0a](https://github.com/dmh/modern-jsdoc-template/commit/65d2d0a))
5+
- **[TASK]** update demo files ([a592cf6](https://github.com/dmh/modern-jsdoc-template/commit/a592cf6))
6+
- **[TASK]** rename template forlder to default ([62d1a87](https://github.com/dmh/modern-jsdoc-template/commit/62d1a87))
7+
8+
***
9+
210
#### v0.0.1 `June 10, 2023`
311

412
- **[TASK]** rename package to modern-jsdoc-template ([bd7c85e](https://github.com/dmh/modern-jsdoc-template/commit/bd7c85e))

docs/index.html

Lines changed: 30 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -49,27 +49,38 @@ <h3> </h3>
4949
<img src="https://img.shields.io/node/v/modern-jsdoc-template" alt="node-current">
5050
<a href="https://standardjs.com"><img src="https://img.shields.io/badge/code_style-standard-brightgreen.svg" alt="JavaScript Style Guide"></a>
5151
<img src="https://img.shields.io/badge/API%20documentation-JSDoc-yellow" alt="JSDoc"></p>
52-
<h2 id="demo-documentation"><a href="https://dmh.github.io/modern-jsdoc-template"><strong>Demo Documentation</strong></a></h2>
52+
<h2 id="demo"><a href="https://dmh.github.io/modern-jsdoc-template"><strong>Demo</strong></a></h2>
53+
<h2 id="table-of-contents">Table of contents</h2>
54+
<ul>
55+
<li><a href="#why">Why?</a></li>
56+
<li><a href="#goal">Goal</a></li>
57+
<li><a href="#features">Features</a></li>
58+
<li><a href="#comparison-table">Comparison Table</a></li>
59+
<li><a href="#quick-start">Quick start</a></li>
60+
<li><a href="#contributing">Contributing</a></li>
61+
<li><a href="CHANGELOG.md">Changelog</a></li>
62+
<li><a href="#thanks">Thanks</a></li>
63+
</ul>
5364
<h2 id="why%3F">Why?</h2>
54-
<p><strong>Dark/Light theme</strong>
55-
This template enhances the simple and minimalistic JSDoc default template by incorporating a dark and light theme styling, similar to GitHub's dark and light theme. There are no other significant alterations.</p>
65+
<p><strong>Dark/Light theme</strong></p>
66+
<p>This template enhances the simple and minimalistic JSDoc default template by incorporating a dark and light theme styling, similar to GitHub's dark dimmed and light theme. There are no other significant alterations.</p>
5667
<h2 id="goal">Goal</h2>
57-
<p><strong>Minimal changes to the default theme.</strong>
58-
The JSDoc default theme has undergone minimal changes. The template only includes new styles and slight external script additions to the JSDoc default template. The main functionality and features remain unchanged. During the build process, most of the templates are copied from JSDoc without any modifications, ensuring alignment with the JSDoc default template in terms of features and functionality.</p>
68+
<p><strong>Minimal changes to the default theme.</strong></p>
69+
<p>The JSDoc default theme has undergone minimal changes. The template only includes new styles and slight external script additions to the JSDoc default template. The main functionality and features remain unchanged. During the build process, most of the templates are copied from JSDoc without any modifications, ensuring alignment with the JSDoc default template in terms of features and functionality.</p>
5970
<h2 id="features%3A">Features:</h2>
6071
<ul>
61-
<li><strong>Dark/Light theme</strong> similar to GitHub Light and Dark dimmed themes</li>
72+
<li><strong>Dark/Light theme</strong> similar to GitHub light and dark dimmed themes</li>
6273
<li><a href="https://github.com/highlightjs/highlight.js">Highlight.js</a> as a code syntax highlighter instead of <code>prettify.js</code></li>
6374
<li>Table of contents based on <a href="https://github.com/tscanlin/tocbot">tocbot.js</a></li>
6475
<li><a href="https://www.npmjs.com/package/@resultify/initial.css">initial.css</a> as a base root CSS styling</li>
6576
</ul>
66-
<h3 id="comparison-table">Comparison Table</h3>
77+
<h2 id="comparison-table">Comparison Table</h2>
6778
<table>
6879
<thead>
6980
<tr>
7081
<th></th>
7182
<th>JSDoc default template</th>
72-
<th>Dark JSDoc default template</th>
83+
<th>Modern JSDoc template</th>
7384
</tr>
7485
</thead>
7586
<tbody>
@@ -91,12 +102,12 @@ <h3 id="comparison-table">Comparison Table</h3>
91102
<tr>
92103
<td><strong>General CSS styling</strong></td>
93104
<td>JSDoc default</td>
94-
<td><strong>Dark theme</strong> (<em>similar to GitHub</em>)</td>
105+
<td><strong>Dark/Light theme</strong> (<em>similar to GitHub</em>)</td>
95106
</tr>
96107
<tr>
97108
<td><strong>Code syntax highlighter styles</strong></td>
98109
<td>JSDoc <code>prettify.js</code> theme</td>
99-
<td><strong>Dark theme</strong> (<em>similar to GitHub</em>)</td>
110+
<td><strong>Dark/Light theme</strong> (<em>similar to GitHub</em>)</td>
100111
</tr>
101112
<tr>
102113
<td><strong>Layout Template</strong></td>
@@ -146,7 +157,7 @@ <h2 id="quick-start">Quick start</h2>
146157
}
147158
},
148159
&quot;opts&quot;: {
149-
&quot;template&quot;: &quot;modern-jsdoc-template/template&quot;,
160+
&quot;template&quot;: &quot;modern-jsdoc-template/default&quot;,
150161
&quot;readme&quot;: &quot;./README.md&quot;,
151162
&quot;destination&quot;: &quot;./docs/&quot;,
152163
&quot;recurse&quot;: true,
@@ -162,6 +173,14 @@ <h2 id="quick-start">Quick start</h2>
162173
</ol>
163174
<pre class="prettyprint source lang-js"><code>npx jsdoc -c jsdoc.json
164175
</code></pre>
176+
<h2 id="contributing">Contributing</h2>
177+
<ol>
178+
<li>Clone/fork the repository and run <code>npm install</code> to install dependencies.</li>
179+
<li>Run <code>npm start</code> to start the development server with watcher.</li>
180+
<li>Add your changes to <code>src/*</code> files and test the result in browser on <code>http://localhost:8082</code></li>
181+
<li>Run <code>npm test</code> to run tests.</li>
182+
<li>Commit your changes and create a pull request.</li>
183+
</ol>
165184
<h2 id="thanks">Thanks</h2>
166185
<ul>
167186
<li><a href="https://jsdoc.app">JSDoc</a></li>

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "modern-jsdoc-template",
3-
"version": "0.0.1",
3+
"version": "0.0.2",
44
"description": "Modern JSDoc default template with a Dark/Light theme style that closely resembles the Dark/Light theme found on GitHub",
55
"keywords": [
66
"jsdoc",

0 commit comments

Comments
 (0)