@qubit-ltd/jsdoc-theme 1.3.3
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.
- package/CHANGELOG.md +260 -0
- package/LICENSE +21 -0
- package/README.md +798 -0
- package/clean-jsdoc-theme-defaults.js +37 -0
- package/clean-jsdoc-theme-helper.js +186 -0
- package/helpers/Environment.html +3 -0
- package/helpers/down-arrow.js +9 -0
- package/helpers/i18n.js +106 -0
- package/i18n/en.json +76 -0
- package/i18n/zh.json +76 -0
- package/package.json +83 -0
- package/publish.js +1133 -0
- package/static/fonts/Inconsolata-Regular.ttf +0 -0
- package/static/fonts/OpenSans-Regular.ttf +0 -0
- package/static/fonts/WorkSans-Bold.ttf +0 -0
- package/static/scripts/core.js +720 -0
- package/static/scripts/core.min.js +23 -0
- package/static/scripts/resize.js +90 -0
- package/static/scripts/search.js +269 -0
- package/static/scripts/search.min.js +6 -0
- package/static/scripts/third-party/Apache-License-2.0.txt +202 -0
- package/static/scripts/third-party/fuse.js +1749 -0
- package/static/scripts/third-party/hljs-line-num-original.js +367 -0
- package/static/scripts/third-party/hljs-line-num.js +1 -0
- package/static/scripts/third-party/hljs-original.js +5260 -0
- package/static/scripts/third-party/hljs.js +1 -0
- package/static/scripts/third-party/popper.js +1287 -0
- package/static/scripts/third-party/tippy.js +1499 -0
- package/static/scripts/third-party/tocbot.js +757 -0
- package/static/scripts/third-party/tocbot.min.js +1 -0
- package/static/styles/clean-jsdoc-theme-base.css +1257 -0
- package/static/styles/clean-jsdoc-theme-dark.css +412 -0
- package/static/styles/clean-jsdoc-theme-light.css +482 -0
- package/static/styles/clean-jsdoc-theme-scrollbar.css +30 -0
- package/static/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
- package/static/styles/clean-jsdoc-theme.min.css +1 -0
- package/tmpl/augments.tmpl +10 -0
- package/tmpl/container.tmpl +261 -0
- package/tmpl/details.tmpl +207 -0
- package/tmpl/example.tmpl +3 -0
- package/tmpl/examples.tmpl +48 -0
- package/tmpl/exceptions.tmpl +32 -0
- package/tmpl/i18n-tooltips.tmpl +30 -0
- package/tmpl/icons.tmpl +77 -0
- package/tmpl/include-target-script-and-styles.tmpl +43 -0
- package/tmpl/layout.tmpl +169 -0
- package/tmpl/mainpage.tmpl +10 -0
- package/tmpl/members.tmpl +42 -0
- package/tmpl/method.tmpl +190 -0
- package/tmpl/mobile-sidebar.tmpl +21 -0
- package/tmpl/navbar-actions.tmpl +25 -0
- package/tmpl/navbar-menu.tmpl +25 -0
- package/tmpl/navbar.tmpl +14 -0
- package/tmpl/params.tmpl +131 -0
- package/tmpl/properties.tmpl +109 -0
- package/tmpl/returns.tmpl +19 -0
- package/tmpl/search.tmpl +17 -0
- package/tmpl/sidebar-items.tmpl +33 -0
- package/tmpl/sidebar-title.tmpl +8 -0
- package/tmpl/sidebar.tmpl +9 -0
- package/tmpl/source.tmpl +13 -0
- package/tmpl/toc.tmpl +4 -0
- package/tmpl/tutorial.tmpl +32 -0
- package/tmpl/type.tmpl +13 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
## Change Log
|
|
2
|
+
|
|
3
|
+
### In version 4.2.0
|
|
4
|
+
|
|
5
|
+
1. Add an option to include files list in homepage. Previously we are including it by default. From now the developer has to explicitly ask for it. For more [see](https:/github.com/ankitskvmdam/clean-jsdoc-theme#add-files-list-in-homepage)
|
|
6
|
+
|
|
7
|
+
### In version 4.0.0
|
|
8
|
+
|
|
9
|
+
This is the most performant version of `clean-jsdoc-theme`. Check
|
|
10
|
+
the [report on lighthouse](https://googlechrome.github.io/lighthouse/viewer/?psiurl=https%3A%2F%2Fankdev.me%2Fclean-jsdoc-theme%2Fv4%2Findex.html&strategy=desktop&category=performance&category=accessibility&category=best-practices&category=seo&category=pwa&utm_source=lh-chrome-ext)
|
|
11
|
+
.
|
|
12
|
+
|
|
13
|
+
### New
|
|
14
|
+
|
|
15
|
+
1. New dark and light theme. Now you can toggle between dark and light themes.
|
|
16
|
+
2. There is an option to change the default font size.
|
|
17
|
+
3. New search feature which doesn't cost KBs. [#search](https://github.com/ankitskvmdam/clean-jsdoc-theme#search)
|
|
18
|
+
4. Minify all generated files.
|
|
19
|
+
5. Added Table of content.
|
|
20
|
+
|
|
21
|
+
### Removed
|
|
22
|
+
|
|
23
|
+
1. Search options
|
|
24
|
+
2. `theme` options. Now it is `default_theme`
|
|
25
|
+
3. `overlay_scrollbar`. We found that you can include overlay scrollbar
|
|
26
|
+
using [`add_script_path`](https://github.com/ankitskvmdam/clean-jsdoc-theme#add-script-paths)
|
|
27
|
+
and [`include_js`](https://github.com/ankitskvmdam/clean-jsdoc-theme#add-custom-script-files) options.
|
|
28
|
+
4. `resizeable`. Now there is no option to resize sidebar.
|
|
29
|
+
|
|
30
|
+
### In version 3.3.2
|
|
31
|
+
|
|
32
|
+
### Feature
|
|
33
|
+
|
|
34
|
+
1. Add an option to excludes inherited symbols. (#96)[https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/96]
|
|
35
|
+
|
|
36
|
+
### In version 3.3.0
|
|
37
|
+
|
|
38
|
+
### Feature
|
|
39
|
+
|
|
40
|
+
1. Now there is an option to order the navbar section.
|
|
41
|
+
|
|
42
|
+
### Bug Fixes
|
|
43
|
+
|
|
44
|
+
1. Fix: Line height of empty line is render as 0 on Mozilla firefox.
|
|
45
|
+
2. Fix: Unnecessary errors with empty examples (#92)[https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/92]
|
|
46
|
+
3. Fix: Disabled source still produces 'details' block (
|
|
47
|
+
#90)[https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/90]
|
|
48
|
+
4. Fix: Tutorials that share their name with a class will have that classes methods dropdown (
|
|
49
|
+
#80)[https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/89]
|
|
50
|
+
|
|
51
|
+
### Options Removed
|
|
52
|
+
|
|
53
|
+
1. `menuLocation`: `menuLocation` theme_opts is removed. Now `sections` can be used to order the entire navbar section
|
|
54
|
+
|
|
55
|
+
### In version 3.2.8
|
|
56
|
+
|
|
57
|
+
### Bug Fixes
|
|
58
|
+
|
|
59
|
+
1. Fix: Search condition statement. (#81)[https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/81]
|
|
60
|
+
2. Fix: missing styles/heading.css. (#80)[https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/80]
|
|
61
|
+
|
|
62
|
+
### Feature
|
|
63
|
+
|
|
64
|
+
1. Feat: add menuLocation option to adjust the place to append extra links. (
|
|
65
|
+
#78)[https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/78]
|
|
66
|
+
|
|
67
|
+
### In version 3.2.7
|
|
68
|
+
|
|
69
|
+
### Bug Fix
|
|
70
|
+
|
|
71
|
+
1. Fix: quotes issue for codepen options.
|
|
72
|
+
2. Fix: source is not printing if source is the only key. (
|
|
73
|
+
#71)[https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/71]
|
|
74
|
+
3. Fix (css): font size of return type. (#70)[https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/70]
|
|
75
|
+
|
|
76
|
+
### In version 3.2.6
|
|
77
|
+
|
|
78
|
+
### Feature
|
|
79
|
+
|
|
80
|
+
1. Add an option to open code in codepen.
|
|
81
|
+
|
|
82
|
+
### Bug Fix
|
|
83
|
+
|
|
84
|
+
1. Fix the css of example
|
|
85
|
+
caption. [View changes.](https://github.com/ankitskvmdam/clean-jsdoc-theme/commit/1cba9400a6d9ae2991eb5b32282e7572510656c6)
|
|
86
|
+
2. Fix the overflow css of code
|
|
87
|
+
section. [View changes.](https://github.com/ankitskvmdam/clean-jsdoc-theme/commit/1cba9400a6d9ae2991eb5b32282e7572510656c6)
|
|
88
|
+
3. Fix the css of code block in dark theme.
|
|
89
|
+
|
|
90
|
+
### In version 3.2.4
|
|
91
|
+
|
|
92
|
+
### Bug Fix
|
|
93
|
+
|
|
94
|
+
1. When the codebase is large then search didn't
|
|
95
|
+
work. [#68](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/68)
|
|
96
|
+
|
|
97
|
+
### In version 3.2.3
|
|
98
|
+
|
|
99
|
+
### Bug Fix
|
|
100
|
+
|
|
101
|
+
1. On mobile screen navbar, main content and footer are not as expected after applying resize.
|
|
102
|
+
|
|
103
|
+
### In version 3.2.1
|
|
104
|
+
|
|
105
|
+
### Feature
|
|
106
|
+
|
|
107
|
+
1. Now there is an option to make navbar resizeable.
|
|
108
|
+
|
|
109
|
+
### In version 3.2.0
|
|
110
|
+
|
|
111
|
+
### Bug Fix
|
|
112
|
+
|
|
113
|
+
1. When passing HTML as title, an NPM Error occurs. In this release that error is fixed.
|
|
114
|
+
|
|
115
|
+
### Others
|
|
116
|
+
|
|
117
|
+
1. Remove filter support.
|
|
118
|
+
|
|
119
|
+
### In version 3.1.2
|
|
120
|
+
|
|
121
|
+
### New
|
|
122
|
+
|
|
123
|
+
1. Change ham animation.
|
|
124
|
+
|
|
125
|
+
### Others
|
|
126
|
+
|
|
127
|
+
1. Update readme file.
|
|
128
|
+
|
|
129
|
+
### In version 3.1.0
|
|
130
|
+
|
|
131
|
+
### Bug fixes
|
|
132
|
+
|
|
133
|
+
1. fix unclosed <div> in method.tmpl [#63](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/63)
|
|
134
|
+
|
|
135
|
+
### New
|
|
136
|
+
|
|
137
|
+
1. Add brand-new light and dark theme.
|
|
138
|
+
2. Add collapsible main section in navbar.
|
|
139
|
+
|
|
140
|
+
### Refactor
|
|
141
|
+
|
|
142
|
+
1. Refactor css and js to improve performance.
|
|
143
|
+
|
|
144
|
+
### In version 3.0.10
|
|
145
|
+
|
|
146
|
+
### Bug Fixes
|
|
147
|
+
|
|
148
|
+
1. Previously, we are enforcing below templates:
|
|
149
|
+
|
|
150
|
+
```js
|
|
151
|
+
// jsdoc config file
|
|
152
|
+
// ...other options.
|
|
153
|
+
templates: {
|
|
154
|
+
cleverLinks: true,
|
|
155
|
+
monospaceLinks: false,
|
|
156
|
+
default: {
|
|
157
|
+
outputSourceFiles: false,
|
|
158
|
+
}
|
|
159
|
+
},
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
In this release we removed this template rule.
|
|
163
|
+
|
|
164
|
+
### In version 3.0.9
|
|
165
|
+
|
|
166
|
+
#### Bug Fixes
|
|
167
|
+
|
|
168
|
+
1. On Mobile screen the ham icon is not visible. That is solved in this release.
|
|
169
|
+
2. Fix: Tooltip copied text color.
|
|
170
|
+
3. Fix: When copied code, `JAVASCRIPT\nCopied!` also got attached with it.
|
|
171
|
+
|
|
172
|
+
### In version 3.0.8
|
|
173
|
+
|
|
174
|
+
#### Feature
|
|
175
|
+
|
|
176
|
+
1. Add support for `@see` documentation link. [#59](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/59)
|
|
177
|
+
|
|
178
|
+
## In version 3.0.7
|
|
179
|
+
|
|
180
|
+
### Feature
|
|
181
|
+
|
|
182
|
+
1. Now left panel classes and modules can be
|
|
183
|
+
collapse. [Feature Request #57](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/57)
|
|
184
|
+
|
|
185
|
+
## In version 3.0.6
|
|
186
|
+
|
|
187
|
+
### Bug Fix
|
|
188
|
+
|
|
189
|
+
1. Fix body overflow.
|
|
190
|
+
2. Fix css for table.
|
|
191
|
+
|
|
192
|
+
## In version 3.0.4
|
|
193
|
+
|
|
194
|
+
### New
|
|
195
|
+
|
|
196
|
+
1. Update `search`. Now instead of boolean it accepts an object. This object is used to configure
|
|
197
|
+
search. [fuse.js options](https://fusejs.io/api/options.html)
|
|
198
|
+
|
|
199
|
+
## In version 3.0.2
|
|
200
|
+
|
|
201
|
+
### Bug Fix
|
|
202
|
+
|
|
203
|
+
1. Simplify the meta/script/link
|
|
204
|
+
declaration [Pull Request: [#56](https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/56)] [Thanks to [GMartigny](https://github.com/GMartigny)]
|
|
205
|
+
|
|
206
|
+
## In version 3.0.0
|
|
207
|
+
|
|
208
|
+
### New
|
|
209
|
+
|
|
210
|
+
1. Add an option to include css files.
|
|
211
|
+
2. Add an option to add js.
|
|
212
|
+
3. Add an option to include static folder.
|
|
213
|
+
4. OverlayScrollbar are now supported by default. If you don't want to use it pass an option to disable it.
|
|
214
|
+
|
|
215
|
+
### Breaking changes
|
|
216
|
+
|
|
217
|
+
1. `add_script_path` previously you have to pass an array of string, but now you have to pass an array of object where
|
|
218
|
+
keys are the attributes of the script tag
|
|
219
|
+
2. `add_style_path` previously you have to pass an array of string, but now you have to pass an array of object where
|
|
220
|
+
keys are the attributes of the link tag
|
|
221
|
+
3. `meta` previously you have to pass an array of string, but now you have to pass an array of object where keys are the
|
|
222
|
+
attributes of the meta tag
|
|
223
|
+
|
|
224
|
+
## In version 2.2.15
|
|
225
|
+
|
|
226
|
+
### New
|
|
227
|
+
|
|
228
|
+
1. Scrollable code area
|
|
229
|
+
|
|
230
|
+
## In version 2.2.14
|
|
231
|
+
|
|
232
|
+
### Bug Fix
|
|
233
|
+
|
|
234
|
+
1. Malformed HTML when parsing 'default' JSDoc
|
|
235
|
+
tags [issue: [#48](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/48)]
|
|
236
|
+
|
|
237
|
+
## In version 2.2.13
|
|
238
|
+
|
|
239
|
+
### New
|
|
240
|
+
|
|
241
|
+
1. Make the # before members and methods a clickable
|
|
242
|
+
anchor. [pull request: [#44](https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/44)] [Thanks to [GMartigny](https://github.com/GMartigny)]
|
|
243
|
+
|
|
244
|
+
### Other
|
|
245
|
+
|
|
246
|
+
1. Change jsdoc into a
|
|
247
|
+
peerDependency [pull request: [#45](https://github.com/ankitskvmdam/clean-jsdoc-theme/pull/45)][Thanks to [GMartigny](https://github.com/GMartigny)]
|
|
248
|
+
|
|
249
|
+
## In version 2.2.12
|
|
250
|
+
|
|
251
|
+
### New
|
|
252
|
+
|
|
253
|
+
1. Add dark theme.
|
|
254
|
+
|
|
255
|
+
### Bug fix
|
|
256
|
+
|
|
257
|
+
1. Fix typescript-eslint camelCase rule
|
|
258
|
+
issue [issue: [#37](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/37)]
|
|
259
|
+
2. Fix ordered list style [issue: [#40](https://github.com/ankitskvmdam/clean-jsdoc-theme/issues/40)]
|
|
260
|
+
3. Fix code overflow issue.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2019-2022 Ankit Kumar (अंकित कुमार)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|