hdoc-tools 0.61.0 → 0.62.0

package/hdoc-ver.js

@@ -1,45 +1,45 @@
-(() => {
-	const fs = require("node:fs");
-	const path = require("node:path");
-
-	exports.run = (source_path) => {
-		console.log("Retrieving book version...\n");
-
-		// Get document ID
-		const hdocbook_project_config_path = path.join(
-			source_path,
-			"hdocbook-project.json",
-		);
-		let hdocbook_project;
-		try {
-			hdocbook_project = JSON.parse(
-				fs.readFileSync(hdocbook_project_config_path, "utf8"),
-			);
-		} catch (e) {
-			console.error("File not found: hdocbook-project.json:");
-			console.log(e, "\n");
-			console.error("hdoc ver needs to be run in the root of a HDoc Book.\n");
-			process.exit(1);
-		}
-		const doc_id = hdocbook_project.docId;
-
-		const book_path = path.join(source_path, doc_id);
-		const hdocbook_path = path.join(book_path, "hdocbook.json");
-
-		let hdocbook_config;
-		try {
-			hdocbook_config = JSON.parse(fs.readFileSync(hdocbook_path, "utf8"));
-		} catch (e) {
-			console.error("File not found: hdocbook.json");
-			console.log(e, "\n");
-			console.error("hdoc ver needs to be run in the root of a HDoc Book.\n");
-			process.exit(1);
-		}
-		if (hdocbook_config.version && hdocbook_config.version !== "") {
-			console.log(`Book version: ${hdocbook_config.version}\n`);
-		} else {
-			console.error("Error - this book has no version defined.\n");
-			process.exit(1);
-		}
-	};
-})();
+(() => {
+	const fs = require("node:fs");
+	const path = require("node:path");
+
+	exports.run = (source_path) => {
+		console.log("Retrieving book version...\n");
+
+		// Get document ID
+		const hdocbook_project_config_path = path.join(
+			source_path,
+			"hdocbook-project.json",
+		);
+		let hdocbook_project;
+		try {
+			hdocbook_project = JSON.parse(
+				fs.readFileSync(hdocbook_project_config_path, "utf8"),
+			);
+		} catch (e) {
+			console.error("File not found: hdocbook-project.json:");
+			console.log(e, "\n");
+			console.error("hdoc ver needs to be run in the root of a HDoc Book.\n");
+			process.exit(1);
+		}
+		const doc_id = hdocbook_project.docId;
+
+		const book_path = path.join(source_path, doc_id);
+		const hdocbook_path = path.join(book_path, "hdocbook.json");
+
+		let hdocbook_config;
+		try {
+			hdocbook_config = JSON.parse(fs.readFileSync(hdocbook_path, "utf8"));
+		} catch (e) {
+			console.error("File not found: hdocbook.json");
+			console.log(e, "\n");
+			console.error("hdoc ver needs to be run in the root of a HDoc Book.\n");
+			process.exit(1);
+		}
+		if (hdocbook_config.version && hdocbook_config.version !== "") {
+			console.log(`Book version: ${hdocbook_config.version}\n`);
+		} else {
+			console.error("Error - this book has no version defined.\n");
+			process.exit(1);
+		}
+	};
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "hdoc-tools",
-	"version": "0.61.0",
+	"version": "0.62.0",
 	"description": "Hornbill HDocBook Development Support Tool",
 	"main": "hdoc.js",
 	"bin": {
@@ -48,6 +48,17 @@
 	},
 	"author": "Hornbill Technologies Ltd",
 	"license": "ISC",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/hornbill/hdoc-tools.git"
+	},
+	"homepage": "https://github.com/hornbill/hdoc-tools#readme",
+	"bugs": {
+		"url": "https://github.com/hornbill/hdoc-tools/issues"
+	},
+	"engines": {
+		"node": ">=20"
+	},
 	"dependencies": {
 		"@huggingface/transformers": "3.8.1",
 		"@mermaid-js/layout-elk": "0.2.1",

package/templates/doc-header-non-git.html

@@ -1,20 +1,20 @@
-<div class="document-header">
-    <div class="hb-container-horizontal">
-        <div class="hb-center-v hb-container-expand">
-            <ul class="ps-0 nav-bar-nav-list noeffects after-fslash overflow-ellipsis">{{breadcrumbs}}</ul>
-        </div> 
-        <div class="toolbar-right hb-center-v">
-        </div>
-    </div> 
-    
-    <h1>{{title}}</h1>
-    
-    <div class="hb-container-horizontal">
-        <div class="hb-center-v hb-container-expand">
-            <ul class="ps-0 nav-bar-nav-list noeffects after-bullets overflow-ellipsis text-light-2">
-                <li class="ps-0 mt-0 nav-bar-item">{{doc-type}}</li>
-                <li class="ps-0 mt-0 nav-bar-item">{{reading-time}} minutes to read</li> 
-            </ul>
-        </div> 
-    </div>
+<div class="document-header">
+    <div class="hb-container-horizontal">
+        <div class="hb-center-v hb-container-expand">
+            <ul class="ps-0 nav-bar-nav-list noeffects after-fslash overflow-ellipsis">{{breadcrumbs}}</ul>
+        </div> 
+        <div class="toolbar-right hb-center-v">
+        </div>
+    </div> 
+    
+    <h1>{{title}}</h1>
+    
+    <div class="hb-container-horizontal">
+        <div class="hb-center-v hb-container-expand">
+            <ul class="ps-0 nav-bar-nav-list noeffects after-bullets overflow-ellipsis text-light-2">
+                <li class="ps-0 mt-0 nav-bar-item">{{doc-type}}</li>
+                <li class="ps-0 mt-0 nav-bar-item">{{reading-time}} minutes to read</li> 
+            </ul>
+        </div> 
+    </div>
 </div>

package/templates/doc-header.html

@@ -1,27 +1,27 @@
-<div class="document-header">
-    <div class="hb-container-horizontal">
-        <div class="hb-center-v hb-container-expand">
-            <ul class="ps-0 nav-bar-nav-list noeffects after-fslash overflow-ellipsis">{{breadcrumbs}}</ul>
-        </div> 
-        <div class="toolbar-right hb-center-v">
-            <a target="_blank" class="toolbar-action" href="{{edit-url}}" aria-label="Edit this page on GitHub">
-                <i class="bi bi-pencil" aria-hidden="true"></i>
-            </a> 
-        </div>
-    </div> 
-    
-    <h1>{{title}}</h1>
-    
-    <div class="hb-container-horizontal">
-        <div class="hb-center-v hb-container-expand">
-            <ul class="ps-0 nav-bar-nav-list noeffects after-bullets overflow-ellipsis text-light-2">
-                <li class="ps-0 mt-0 nav-bar-item">{{doc-type}}</li>
-                <li class="ps-0 mt-0 nav-bar-item">{{last-update}}</li>
-                <li class="ps-0 mt-0 nav-bar-item">{{reading-time}} minutes to read</li> 
-                <li class="ps-0 mt-0 nav-bar-item">
-                    <a class="link c-pointer" data-bs-toggle="modal" data-bs-target="#contributersModal">{{contributor-count}} contributors</a>
-                </li>
-            </ul>
-        </div> 
-    </div>
+<div class="document-header">
+    <div class="hb-container-horizontal">
+        <div class="hb-center-v hb-container-expand">
+            <ul class="ps-0 nav-bar-nav-list noeffects after-fslash overflow-ellipsis">{{breadcrumbs}}</ul>
+        </div> 
+        <div class="toolbar-right hb-center-v">
+            <a target="_blank" class="toolbar-action" href="{{edit-url}}" aria-label="Edit this page on GitHub">
+                <i class="bi bi-pencil" aria-hidden="true"></i>
+            </a> 
+        </div>
+    </div> 
+    
+    <h1>{{title}}</h1>
+    
+    <div class="hb-container-horizontal">
+        <div class="hb-center-v hb-container-expand">
+            <ul class="ps-0 nav-bar-nav-list noeffects after-bullets overflow-ellipsis text-light-2">
+                <li class="ps-0 mt-0 nav-bar-item">{{doc-type}}</li>
+                <li class="ps-0 mt-0 nav-bar-item">{{last-update}}</li>
+                <li class="ps-0 mt-0 nav-bar-item">{{reading-time}} minutes to read</li> 
+                <li class="ps-0 mt-0 nav-bar-item">
+                    <a class="link c-pointer" data-bs-toggle="modal" data-bs-target="#contributersModal">{{contributor-count}} contributors</a>
+                </li>
+            </ul>
+        </div> 
+    </div>
 </div>

package/templates/init/.github/workflows/hdocbuild_onpull.yml

@@ -1,17 +1,17 @@
-name: HDocBuildPull
-
-on:
-  # Triggers the workflow on pull request opened or reopened events
-  pull_request_target:
-    types: [opened, reopened]
-    paths-ignore:
-      - '.github/**'
-
-jobs:
-  call-workflow-pull-validate:
-    uses: Hornbill-Docs/hdoc-library/.github/workflows/hdocbuild_shared_pull.yml@main
-    with:
-      branch: ${{ github.event.pull_request.head.sha }}
-      server_url: ${{ github.server_url }}
-      repo: ${{ github.repository }}
+name: HDocBuildPull
+
+on:
+  # Triggers the workflow on pull request opened or reopened events
+  pull_request_target:
+    types: [opened, reopened]
+    paths-ignore:
+      - '.github/**'
+
+jobs:
+  call-workflow-pull-validate:
+    uses: Hornbill-Docs/hdoc-library/.github/workflows/hdocbuild_shared_pull.yml@main
+    with:
+      branch: ${{ github.event.pull_request.head.sha }}
+      server_url: ${{ github.server_url }}
+      repo: ${{ github.repository }}
       run_id: ${{ github.run_id }}

package/templates/init/.github/workflows/hdocbuild_onpush.yml

@@ -1,15 +1,15 @@
-name: HDocBuildPush
-on:
-  # Triggers the workflow on push requests
-  push:
-    paths-ignore:
-      - '.github/**'
-  
-  # Allows us to run this workflow manually from the Actions tab
-  workflow_dispatch:
-  
-jobs:
-  call-workflow-push-validate:
-    uses: Hornbill-Docs/hdoc-library/.github/workflows/hdocbuild_shared_push.yml@main
-    with:
-      branch: ${{ github.event.inputs.branch }}
+name: HDocBuildPush
+on:
+  # Triggers the workflow on push requests
+  push:
+    paths-ignore:
+      - '.github/**'
+  
+  # Allows us to run this workflow manually from the Actions tab
+  workflow_dispatch:
+  
+jobs:
+  call-workflow-push-validate:
+    uses: Hornbill-Docs/hdoc-library/.github/workflows/hdocbuild_shared_push.yml@main
+    with:
+      branch: ${{ github.event.inputs.branch }}

package/templates/init/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 Hornbill Docs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 Hornbill Docs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/init/README.md

@@ -1,9 +1,9 @@
-# HDocBook documentation
-This is an example of a simple static content documentation project that is compatible with the Hornbill Docs system
-
-Make sure that you have installed hdoc-tools   
-
-  npm install hdoc-tools -g
-
-To preview the documentation in a browser, you can open a terminal window and run the dev preview server with the 
-command `hdoc serve` and in a local browser go to the url `http://localhost:3000`
+# HDocBook documentation
+This is an example of a simple static content documentation project that is compatible with the Hornbill Docs system
+
+Make sure that you have installed hdoc-tools   
+
+  npm install hdoc-tools -g
+
+To preview the documentation in a browser, you can open a terminal window and run the dev preview server with the 
+command `hdoc serve` and in a local browser go to the url `http://localhost:3000`

package/templates/init/_hdocbook/index.md

@@ -1,5 +1,5 @@
----
-layout: article-toc
----
-# Welcome 
+---
+layout: article-toc
+---
+# Welcome 
 This is your first page

package/templates/init/gitignore

@@ -1,9 +1,9 @@
-_work/
-node_modules/
-package-lock.json
-.wsuo
-.DS_Store
-VSWorkspaceState.json
-slnx.state
-slnx.sqlite
+_work/
+node_modules/
+package-lock.json
+.wsuo
+.DS_Store
+VSWorkspaceState.json
+slnx.state
+slnx.sqlite
 validated-links.txt

package/templates/init/resources/README.md

@@ -1,3 +1,3 @@
-You should store any files and resources that used in the creation of this hdocbook, but do not form part of the published content.
-
+You should store any files and resources that used in the creation of this hdocbook, but do not form part of the published content.
+
 These files are included in the build and final content output but we should keep in the source code repo for future revisions.  For example, if you were to create an image used in the content, say, in Photoshop, you will create the image and put that into the appropriate content location.  However, you may also want to put the Photoshop source file into this **resources** folder in order to keep for the future, should anyone need to modify the image, we have the original source file.

package/templates/pdf/css/custom-block.css

@@ -1,90 +1,90 @@
-.custom-block {
-  border: 1px solid transparent;
-  border-radius: 8px;
-  padding: 16px 16px 8px;
-  line-height: 24px;
-  font-size: var(--htl-default-font-size);
-  color: var(--htl-c-text-2);
-}
-
-.custom-block.info {
-  border-color: var(--htl-custom-block-info-border);
-  color: var(--htl-custom-block-info-text);
-  background-color: var(--htl-custom-block-info-bg);
-}
-
-.custom-block.info code {
-  background-color: var(--htl-custom-block-info-code-bg);
-}
-
-.custom-block.tip {
-  border-color: var(--htl-custom-block-tip-border);
-  color: var(--htl-custom-block-tip-text);
-  background-color: var(--htl-custom-block-tip-bg);
-}
-
-.custom-block.tip code {
-  background-color: var(--htl-custom-block-tip-code-bg);
-}
-
-.custom-block.warning {
-  border-color: var(--htl-custom-block-warning-border);
-  color: var(--htl-custom-block-warning-text);
-  background-color: var(--htl-custom-block-warning-bg);
-}
-
-.custom-block.warning code {
-  background-color: var(--htl-custom-block-warning-code-bg);
-}
-
-.custom-block.danger {
-  border-color: var(--htl-custom-block-danger-border);
-  color: var(--htl-custom-block-danger-text);
-  background-color: var(--htl-custom-block-danger-bg);
-}
-
-.custom-block.danger code {
-  background-color: var(--htl-custom-block-danger-code-bg);
-}
-
-.custom-block.details {
-  border-color: var(--htl-custom-block-details-border);
-  color: var(--htl-custom-block-details-text);
-  background-color: var(--htl-custom-block-details-bg);
-}
-
-.custom-block.details code {
-  background-color: var(--htl-custom-block-details-code-bg);
-}
-
-.custom-block-title {
-  font-weight: 700;
-}
-
-.custom-block p + p {
-  margin: 8px 0;
-}
-
-.custom-block.details summary {
-  margin: 0 0 8px;
-  font-weight: 700;
-}
-
-.custom-block.details summary + p {
-  margin: 8px 0;
-}
-
-.custom-block a {
-  color: inherit;
-  font-weight: 600;
-  text-decoration: underline;
-  transition: opacity 0.25s;
-}
-
-.custom-block a:hover {
-  opacity: 0.6;
-}
-
-.custom-block code {
-  font-size: var(--htl-custom-block-code-font-size);
-}
+.custom-block {
+  border: 1px solid transparent;
+  border-radius: 8px;
+  padding: 16px 16px 8px;
+  line-height: 24px;
+  font-size: var(--htl-default-font-size);
+  color: var(--htl-c-text-2);
+}
+
+.custom-block.info {
+  border-color: var(--htl-custom-block-info-border);
+  color: var(--htl-custom-block-info-text);
+  background-color: var(--htl-custom-block-info-bg);
+}
+
+.custom-block.info code {
+  background-color: var(--htl-custom-block-info-code-bg);
+}
+
+.custom-block.tip {
+  border-color: var(--htl-custom-block-tip-border);
+  color: var(--htl-custom-block-tip-text);
+  background-color: var(--htl-custom-block-tip-bg);
+}
+
+.custom-block.tip code {
+  background-color: var(--htl-custom-block-tip-code-bg);
+}
+
+.custom-block.warning {
+  border-color: var(--htl-custom-block-warning-border);
+  color: var(--htl-custom-block-warning-text);
+  background-color: var(--htl-custom-block-warning-bg);
+}
+
+.custom-block.warning code {
+  background-color: var(--htl-custom-block-warning-code-bg);
+}
+
+.custom-block.danger {
+  border-color: var(--htl-custom-block-danger-border);
+  color: var(--htl-custom-block-danger-text);
+  background-color: var(--htl-custom-block-danger-bg);
+}
+
+.custom-block.danger code {
+  background-color: var(--htl-custom-block-danger-code-bg);
+}
+
+.custom-block.details {
+  border-color: var(--htl-custom-block-details-border);
+  color: var(--htl-custom-block-details-text);
+  background-color: var(--htl-custom-block-details-bg);
+}
+
+.custom-block.details code {
+  background-color: var(--htl-custom-block-details-code-bg);
+}
+
+.custom-block-title {
+  font-weight: 700;
+}
+
+.custom-block p + p {
+  margin: 8px 0;
+}
+
+.custom-block.details summary {
+  margin: 0 0 8px;
+  font-weight: 700;
+}
+
+.custom-block.details summary + p {
+  margin: 8px 0;
+}
+
+.custom-block a {
+  color: inherit;
+  font-weight: 600;
+  text-decoration: underline;
+  transition: opacity 0.25s;
+}
+
+.custom-block a:hover {
+  opacity: 0.6;
+}
+
+.custom-block code {
+  font-size: var(--htl-custom-block-code-font-size);
+}