Add versioned balenaCLI docs

Signed-off-by: Vipul Gupta (@vipulgupta2048) <[email protected]>

.cspell/balena-words.txt

@@ -4,6 +4,7 @@ balena-api
 balena-base-ui
 balena-build
 balena-builder
+balenacli
 balenahup
 balenalib
 balenista

.gitignore

@@ -45,6 +45,10 @@ pages/reference/base-images/base-images-ref.md
 # Ignore dynamic docs created for masterclasses
 shared/masterclass
 
+# Ignore dynamic balenaCLI version docs
+config/dictionaries/balenacli.json
+shared/balena-cli-versions/
+
 # Ignore dynamic assets generated for Getting Started
 static/img/device/**
 config/dictionaries/device.json

config/navigation.txt

@@ -149,7 +149,7 @@ Reference
     [/reference/api/overview]
     Resources[/reference/api/resources/$resource]
 
-  CLI[/reference/balena-cli]
+  CLI[/reference/balena-cli/$balenacli]
   SDKs
     Node.js SDK[/reference/sdk/node-sdk]
     Python SDK[/reference/sdk/python-sdk]

templates/balena-cli.html

@@ -0,0 +1,8 @@
+{% extends "default.html" %}
+
+{% block dynamicSwitchCustom %}
+<p class="dynamic-switch__append">
+</p>
+{% endblock %}
+
+<div id="output"></div>

tools/build.sh

@@ -16,6 +16,9 @@ node ./tools/generate-docs-contracts.js
 # Generate base images docs
 ./tools/build-base-images.sh
 
+# Generate balena-cli docs
+node tools/versioning.js https://github.com/balena-io/balena-cli/blob/master/docs/balena-cli.md
+
 # Convert .jpg, .jpeg, .png images to .webp format
 ./tools/convert-images-to-webp.sh
 

tools/fetch-external.sh

@@ -14,7 +14,7 @@ mkdir -p shared/masterclass/debugging/
 which jq && JQ="$(which jq)" || JQ="../../node_modules/node-jq/bin/jq"
 
 # get latest CLI docs
-curl --fail --show-error -o pages/reference/balena-cli.md -L https://github.com/balena-io/balena-cli/raw/master/docs/balena-cli.md &
+# curl --fail --show-error -o pages/reference/balena-cli.md -L https://github.com/balena-io/balena-cli/raw/master/docs/balena-cli.md &
 
 # Engine
 # get latest balena-engine debugging docs

tools/versioning.js

@@ -217,12 +217,12 @@ async function main() {
 
   // Parse repository details
   const { owner, name: repoName, filepath } = parseGithubUrl(repoUrl);
-  const versionsConfigFile = `./config/dictionaries/${(repoName).replaceAll(/-/g, "")}.json`
+  const versionsConfigFile = `./config/dictionaries/${repoName.replaceAll(/-/g, "")}.json`
   const versionedDocsFolder = path.join(__dirname, `../shared/${repoName}-versions`)
 
   try {
     // Fetch and process repository versions
-    const versions = await fetchGitHubTags(owner, repoName, githubToken);
+    const versions = await fetchGitHubTags(owner, repoName);
 
     // Write versions configuration
     await fsPromises.writeFile(versionsConfigFile, JSON.stringify(versions, null, 2));