@qubit-ltd/jsdoc-theme 1.5.1 → 1.5.2
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/README.md +7 -7
- package/helpers/i18n.js +2 -2
- package/package.json +6 -8
- package/publish.js +23 -23
- package/static/scripts/core.js +3 -3
- package/static/scripts/resize.js +2 -2
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# qubit-jsdoc-theme
|
|
2
2
|
|
|
3
|
-
[](https://github.com/qubit-ltd/jsdoc-theme) [](https://github.com/qubit-ltd/jsdoc-theme/fork)  [](https://github.com/qubit-ltd/jsdoc-theme/issues) [](https://github.com/qubit-ltd/jsdoc-theme/graphs/contributors) [](https://github.com/qubit-ltd/jsdoc-theme/blob/master/LICENSE)
|
|
4
4
|
|
|
5
5
|
<br>
|
|
6
6
|
|
|
@@ -826,8 +826,8 @@ For the base theme changelog, see [clean-jsdoc-theme changelog](https://github.c
|
|
|
826
826
|
## Developing
|
|
827
827
|
|
|
828
828
|
```bash
|
|
829
|
-
git clone https://github.com/
|
|
830
|
-
cd
|
|
829
|
+
git clone https://github.com/qubit-ltd/jsdoc-theme.git
|
|
830
|
+
cd jsdoc-theme
|
|
831
831
|
npm install
|
|
832
832
|
npm install jsdoc --no-save
|
|
833
833
|
npm run build
|
|
@@ -844,7 +844,7 @@ This will generate demo documentation in the `output` folder.
|
|
|
844
844
|
|
|
845
845
|
## Contributing
|
|
846
846
|
|
|
847
|
-
We welcome contributions! Please feel free to submit issues and pull requests on [GitHub](https://github.com/
|
|
847
|
+
We welcome contributions! Please feel free to submit issues and pull requests on [GitHub](https://github.com/qubit-ltd/jsdoc-theme).
|
|
848
848
|
|
|
849
849
|
## Acknowledgments
|
|
850
850
|
|
|
@@ -852,8 +852,8 @@ This project is based on the excellent [clean-jsdoc-theme](https://github.com/an
|
|
|
852
852
|
|
|
853
853
|
## Contributors
|
|
854
854
|
|
|
855
|
-
<a href="https://github.com/
|
|
856
|
-
<img src="https://contrib.rocks/image?repo=
|
|
855
|
+
<a href="https://github.com/qubit-ltd/jsdoc-theme/graphs/contributors">
|
|
856
|
+
<img src="https://contrib.rocks/image?repo=qubit-ltd/jsdoc-theme" alt="qubit-jsdoc-theme-contributors" />
|
|
857
857
|
</a>
|
|
858
858
|
|
|
859
859
|
## Thanks
|
|
@@ -862,7 +862,7 @@ Thanks to [fuse.js](https://fusejs.io/), [hljs](https://highlightjs.org/), [tipp
|
|
|
862
862
|
|
|
863
863
|
## Contact
|
|
864
864
|
|
|
865
|
-
If you like this project, please give it a <a href="https://github.com/
|
|
865
|
+
If you like this project, please give it a <a href="https://github.com/qubit-ltd/jsdoc-theme" data-icon="octicon-star" aria-label="Star qubit-ltd/jsdoc-theme on GitHub">star</a>.
|
|
866
866
|
|
|
867
867
|
Mail: <a href="mailto:starfish.hu@gmail.com">starfish.hu@gmail.com</a> <br>
|
|
868
868
|
|
package/helpers/i18n.js
CHANGED
|
@@ -17,7 +17,7 @@ function loadTranslations(language) {
|
|
|
17
17
|
__dirname,
|
|
18
18
|
"..",
|
|
19
19
|
"i18n",
|
|
20
|
-
`${language}.json
|
|
20
|
+
`${language}.json`,
|
|
21
21
|
);
|
|
22
22
|
|
|
23
23
|
try {
|
|
@@ -29,7 +29,7 @@ function loadTranslations(language) {
|
|
|
29
29
|
} catch (error) {
|
|
30
30
|
console.warn(
|
|
31
31
|
`Failed to load translations for language: ${language}`,
|
|
32
|
-
error.message
|
|
32
|
+
error.message,
|
|
33
33
|
);
|
|
34
34
|
}
|
|
35
35
|
return false;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qubit-ltd/jsdoc-theme",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.2",
|
|
4
4
|
"description": "A customized JSDoc theme based on clean-jsdoc-theme, enhanced with properties table and constructor detection features for Qubit projects.",
|
|
5
5
|
"main": "publish.js",
|
|
6
6
|
"author": "Haixing Hu (starfish.hu@gmail.com)",
|
|
@@ -12,18 +12,16 @@
|
|
|
12
12
|
"lint:style": "stylelint-config-prettier-check && stylelint static/styles/",
|
|
13
13
|
"lint": "npm run lint:js && npm run lint:style",
|
|
14
14
|
"prepublishOnly": "npm run lint && npm run build",
|
|
15
|
-
"deploy": "npm run lint && npm run build && npm publish --registry='https://
|
|
16
|
-
"deploy:public": "npm run lint && npm run build && npm publish --registry='https://registry.npmjs.org/' --access public",
|
|
17
|
-
"deploy:all": "npm run deploy && npm publish --registry='https://registry.npmjs.org/' --access public"
|
|
15
|
+
"deploy": "npm run lint && npm run build && npm publish --registry='https://registry.npmjs.org/' --access public"
|
|
18
16
|
},
|
|
19
17
|
"repository": {
|
|
20
18
|
"type": "git",
|
|
21
|
-
"url": "git+https://github.com/
|
|
19
|
+
"url": "git+https://github.com/qubit-ltd/jsdoc-theme.git"
|
|
22
20
|
},
|
|
23
21
|
"bugs": {
|
|
24
|
-
"url": "https://github.com/
|
|
22
|
+
"url": "https://github.com/qubit-ltd/jsdoc-theme/issues"
|
|
25
23
|
},
|
|
26
|
-
"homepage": "https://github.com/
|
|
24
|
+
"homepage": "https://github.com/qubit-ltd/jsdoc-theme",
|
|
27
25
|
"files": [
|
|
28
26
|
"publish.js",
|
|
29
27
|
"tmpl/**/*",
|
|
@@ -62,7 +60,7 @@
|
|
|
62
60
|
"jsdoc": "^4.0.4",
|
|
63
61
|
"postcss": "^8.5.6",
|
|
64
62
|
"postcss-scss": "^4.0.9",
|
|
65
|
-
"prettier": "^
|
|
63
|
+
"prettier": "^3.3.3",
|
|
66
64
|
"stylelint": "^14.9.1",
|
|
67
65
|
"stylelint-config-prettier": "^9.0.3",
|
|
68
66
|
"stylelint-config-sass-guidelines": "^9.0.0",
|
package/publish.js
CHANGED
|
@@ -153,7 +153,7 @@ function updateItemName(item) {
|
|
|
153
153
|
|
|
154
154
|
if (attributes && attributes.length) {
|
|
155
155
|
itemName = `${itemName}<span class="signature-attributes">${attributes.join(
|
|
156
|
-
", "
|
|
156
|
+
", ",
|
|
157
157
|
)}</span>`;
|
|
158
158
|
}
|
|
159
159
|
|
|
@@ -307,9 +307,9 @@ function prefixModuleToItemAnchor(item) {
|
|
|
307
307
|
"a",
|
|
308
308
|
modulename,
|
|
309
309
|
methodname,
|
|
310
|
-
anchorLink
|
|
310
|
+
anchorLink,
|
|
311
311
|
);
|
|
312
|
-
}
|
|
312
|
+
},
|
|
313
313
|
);
|
|
314
314
|
|
|
315
315
|
return prettyAnchor || anchor;
|
|
@@ -355,14 +355,14 @@ function generateSourceFiles(sourceFiles, packageInfo, encoding = "utf8") {
|
|
|
355
355
|
kind: "source",
|
|
356
356
|
title: sourceOutFile.replace(".html", ""),
|
|
357
357
|
code: helper.htmlsafe(
|
|
358
|
-
fs.readFileSync(sourceFiles[file].resolved, encoding)
|
|
358
|
+
fs.readFileSync(sourceFiles[file].resolved, encoding),
|
|
359
359
|
),
|
|
360
360
|
};
|
|
361
361
|
} catch (e) {
|
|
362
362
|
logger.error(
|
|
363
363
|
"Error while generating source file %s: %s",
|
|
364
364
|
file,
|
|
365
|
-
e.message
|
|
365
|
+
e.message,
|
|
366
366
|
);
|
|
367
367
|
}
|
|
368
368
|
|
|
@@ -371,7 +371,7 @@ function generateSourceFiles(sourceFiles, packageInfo, encoding = "utf8") {
|
|
|
371
371
|
[source],
|
|
372
372
|
sourceOutFile,
|
|
373
373
|
false,
|
|
374
|
-
packageInfo
|
|
374
|
+
packageInfo,
|
|
375
375
|
);
|
|
376
376
|
});
|
|
377
377
|
}
|
|
@@ -453,7 +453,7 @@ function buildSidebarMembers({
|
|
|
453
453
|
if (!hasOwnProp.call(itemsSeen, item.longname)) {
|
|
454
454
|
currentItem.anchor = linktoFn(
|
|
455
455
|
item.longname,
|
|
456
|
-
item.name.replace(/^module:/, "")
|
|
456
|
+
item.name.replace(/^module:/, ""),
|
|
457
457
|
);
|
|
458
458
|
|
|
459
459
|
if (methods.length) {
|
|
@@ -721,7 +721,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
721
721
|
|
|
722
722
|
if (
|
|
723
723
|
example.match(
|
|
724
|
-
/^\s*<caption>([\s\S]+?)<\/caption>(\s*[\n\r])([\s\S]+)$/i
|
|
724
|
+
/^\s*<caption>([\s\S]+?)<\/caption>(\s*[\n\r])([\s\S]+)$/i,
|
|
725
725
|
)
|
|
726
726
|
) {
|
|
727
727
|
caption = RegExp.$1;
|
|
@@ -788,7 +788,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
788
788
|
staticFilePaths =
|
|
789
789
|
conf.default.staticFiles.include || conf.default.staticFiles.paths || [];
|
|
790
790
|
staticFileFilter = new (require("jsdoc/src/filter").Filter)(
|
|
791
|
-
conf.default.staticFiles
|
|
791
|
+
conf.default.staticFiles,
|
|
792
792
|
);
|
|
793
793
|
staticFileScanner = new (require("jsdoc/src/scanner").Scanner)();
|
|
794
794
|
|
|
@@ -797,7 +797,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
797
797
|
const extraStaticFiles = staticFileScanner.scan(
|
|
798
798
|
[filePath],
|
|
799
799
|
10,
|
|
800
|
-
staticFileFilter
|
|
800
|
+
staticFileFilter,
|
|
801
801
|
);
|
|
802
802
|
|
|
803
803
|
extraStaticFiles.forEach((fileName) => {
|
|
@@ -866,7 +866,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
866
866
|
|
|
867
867
|
// output pretty-printed source files by default
|
|
868
868
|
outputSourceFiles = Boolean(
|
|
869
|
-
conf.default && conf.default.outputSourceFiles !== false
|
|
869
|
+
conf.default && conf.default.outputSourceFiles !== false,
|
|
870
870
|
);
|
|
871
871
|
|
|
872
872
|
// add template helpers
|
|
@@ -901,7 +901,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
901
901
|
view.excludeInherited = Boolean(themeOpts.exclude_inherited);
|
|
902
902
|
view.baseURL = getBaseURL(themeOpts);
|
|
903
903
|
view.shouldRemoveScrollbarStyle = Boolean(
|
|
904
|
-
themeOpts.shouldRemoveScrollbarStyle
|
|
904
|
+
themeOpts.shouldRemoveScrollbarStyle,
|
|
905
905
|
);
|
|
906
906
|
attachModuleSymbols(find({ longname: { left: "module:" } }), members.modules);
|
|
907
907
|
|
|
@@ -926,7 +926,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
926
926
|
[{ kind: "globalobj" }],
|
|
927
927
|
globalUrl,
|
|
928
928
|
true,
|
|
929
|
-
packageInfo
|
|
929
|
+
packageInfo,
|
|
930
930
|
);
|
|
931
931
|
}
|
|
932
932
|
|
|
@@ -950,7 +950,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
950
950
|
.concat(includeFilesListInHomepage ? files : []),
|
|
951
951
|
indexUrl,
|
|
952
952
|
true,
|
|
953
|
-
packageInfo
|
|
953
|
+
packageInfo,
|
|
954
954
|
);
|
|
955
955
|
|
|
956
956
|
// set up the lists that we'll use to generate pages
|
|
@@ -975,7 +975,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
975
975
|
myModules,
|
|
976
976
|
helper.longnameToUrl[longname],
|
|
977
977
|
true,
|
|
978
|
-
packageInfo
|
|
978
|
+
packageInfo,
|
|
979
979
|
);
|
|
980
980
|
}
|
|
981
981
|
|
|
@@ -985,7 +985,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
985
985
|
myClasses,
|
|
986
986
|
helper.longnameToUrl[longname],
|
|
987
987
|
true,
|
|
988
|
-
packageInfo
|
|
988
|
+
packageInfo,
|
|
989
989
|
);
|
|
990
990
|
}
|
|
991
991
|
|
|
@@ -995,7 +995,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
995
995
|
myNamespaces,
|
|
996
996
|
helper.longnameToUrl[longname],
|
|
997
997
|
true,
|
|
998
|
-
packageInfo
|
|
998
|
+
packageInfo,
|
|
999
999
|
);
|
|
1000
1000
|
}
|
|
1001
1001
|
|
|
@@ -1005,7 +1005,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
1005
1005
|
myMixins,
|
|
1006
1006
|
helper.longnameToUrl[longname],
|
|
1007
1007
|
true,
|
|
1008
|
-
packageInfo
|
|
1008
|
+
packageInfo,
|
|
1009
1009
|
);
|
|
1010
1010
|
}
|
|
1011
1011
|
|
|
@@ -1015,7 +1015,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
1015
1015
|
myExternals,
|
|
1016
1016
|
helper.longnameToUrl[longname],
|
|
1017
1017
|
true,
|
|
1018
|
-
packageInfo
|
|
1018
|
+
packageInfo,
|
|
1019
1019
|
);
|
|
1020
1020
|
}
|
|
1021
1021
|
|
|
@@ -1025,7 +1025,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
1025
1025
|
myInterfaces,
|
|
1026
1026
|
helper.longnameToUrl[longname],
|
|
1027
1027
|
true,
|
|
1028
|
-
packageInfo
|
|
1028
|
+
packageInfo,
|
|
1029
1029
|
);
|
|
1030
1030
|
}
|
|
1031
1031
|
});
|
|
@@ -1084,7 +1084,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
1084
1084
|
}
|
|
1085
1085
|
} catch (error) {
|
|
1086
1086
|
console.error(
|
|
1087
|
-
"There was some error while creating search array for tutorial."
|
|
1087
|
+
"There was some error while creating search array for tutorial.",
|
|
1088
1088
|
);
|
|
1089
1089
|
console.error(error);
|
|
1090
1090
|
}
|
|
@@ -1096,7 +1096,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
1096
1096
|
generateTutorial(
|
|
1097
1097
|
`Tutorial: ${child.title}`,
|
|
1098
1098
|
child,
|
|
1099
|
-
helper.tutorialToUrl(child.name)
|
|
1099
|
+
helper.tutorialToUrl(child.name),
|
|
1100
1100
|
);
|
|
1101
1101
|
saveChildren(child);
|
|
1102
1102
|
});
|
|
@@ -1113,7 +1113,7 @@ exports.publish = async function (taffyData, opts, tutorials) {
|
|
|
1113
1113
|
path.join(outdir, "data", "search.json"),
|
|
1114
1114
|
JSON.stringify({
|
|
1115
1115
|
list: searchList,
|
|
1116
|
-
})
|
|
1116
|
+
}),
|
|
1117
1117
|
);
|
|
1118
1118
|
}
|
|
1119
1119
|
};
|
package/static/scripts/core.js
CHANGED
|
@@ -179,7 +179,7 @@ function bringElementIntoView(element, updateHistory = true) {
|
|
|
179
179
|
setTimeout(
|
|
180
180
|
// eslint-disable-next-line no-undef
|
|
181
181
|
() => tocbotInstance.updateTocListActiveElement(element),
|
|
182
|
-
60
|
|
182
|
+
60,
|
|
183
183
|
);
|
|
184
184
|
}
|
|
185
185
|
var navbar = document.querySelector(".navbar-container");
|
|
@@ -431,7 +431,7 @@ function localUpdateFontSize(fontSize) {
|
|
|
431
431
|
html.style.fontSize = fontSize + "px";
|
|
432
432
|
|
|
433
433
|
var fontSizeText = document.querySelector(
|
|
434
|
-
"#b77a68a492f343baabea06fad81f651e"
|
|
434
|
+
"#b77a68a492f343baabea06fad81f651e",
|
|
435
435
|
);
|
|
436
436
|
|
|
437
437
|
if (fontSizeText) {
|
|
@@ -621,7 +621,7 @@ function highlightActiveLinkInSidebar() {
|
|
|
621
621
|
if (!element) {
|
|
622
622
|
try {
|
|
623
623
|
element = document.querySelector(
|
|
624
|
-
`.sidebar a[href*='${targetURL.split("#")[0]}']
|
|
624
|
+
`.sidebar a[href*='${targetURL.split("#")[0]}']`,
|
|
625
625
|
);
|
|
626
626
|
} catch (e) {
|
|
627
627
|
console.error(e);
|
package/static/scripts/resize.js
CHANGED
|
@@ -11,7 +11,7 @@ var NAVBAR_OPTIONS = {};
|
|
|
11
11
|
var mainSection = document.querySelector("#main");
|
|
12
12
|
var localStorageResizeObject = JSON.parse(
|
|
13
13
|
// eslint-disable-next-line no-undef
|
|
14
|
-
localStorage.getItem(NAVBAR_RESIZE_LOCAL_STORAGE_KEY)
|
|
14
|
+
localStorage.getItem(NAVBAR_RESIZE_LOCAL_STORAGE_KEY),
|
|
15
15
|
);
|
|
16
16
|
|
|
17
17
|
/**
|
|
@@ -66,7 +66,7 @@ var NAVBAR_OPTIONS = {};
|
|
|
66
66
|
NAVBAR_RESIZE_LOCAL_STORAGE_KEY,
|
|
67
67
|
JSON.stringify({
|
|
68
68
|
width: navbar.style.width,
|
|
69
|
-
})
|
|
69
|
+
}),
|
|
70
70
|
);
|
|
71
71
|
}
|
|
72
72
|
|