Escape braces in CLI documentation when generating markdown

Using {{ term }} in markdown causes issues for vitepress. As a result,
we have to escape these characters when generating cli-reference.md from
the CLI help pages.

Signed-off-by: Angel Misevski <[email protected]>

Author: amisevsk

docs/package.json

@@ -23,5 +23,5 @@
     "cheerio": "1.0.0",
     "vue3-marquee": "^4.2.2"
   },
-  "packageManager": "pnpm@10.0.0"
+  "packageManager": "pnpm@10.12.4"
 }

docs/src/docs/cli/cli-reference.md

@@ -8,49 +8,6 @@ import VersionInfo from '@theme/components/VersionInfo.vue'
 </script>
 
 <VersionInfo />
-## kit cache
-
-Manage temporary files cached by Kit
-
-### Synopsis
-
-Manage files stored in the temporary KitOps cache dir ($KITOPS_HOME/cache)
-
-Normally, this directory is empty, but may contain leftover files from resumable
-downloads or files that were not cleaned up due to the command being cancelled.
-
-The $KITOPS_HOME location is system dependent:
-	- Linux: $XDG_DATA_HOME/kitops with a fall back to $HOME/.local/share/kitops
-	- MacOS: ~/Library/Caches/kitops
-	- Windows: %LOCALAPPDATA%\kitops
-
-
-### Examples
-
-```
-# Get information about size of cached files
-kit cache info
-
-# Clear files in cache
-kit cache clear
-		
-```
-
-### Options
-
-```
-  -h, --help   help for cache
-```
-
-### Options inherited from parent commands
-
-```
-      --config string      Alternate path to root storage directory for CLI
-      --log-level string   Log messages above specified level ('trace', 'debug', 'info', 'warn', 'error') (default 'info') (default "info")
-      --progress string    Configure progress bars for longer operations (options: none, plain, fancy) (default "plain")
-  -v, --verbose count      Increase verbosity of output (use -vv for more)
-```
-
 ## kit cache clear
 
 Clear temporary cache storage
@@ -105,24 +62,37 @@ kit cache info [flags]
   -v, --verbose count      Increase verbosity of output (use -vv for more)
 ```
 
-## kit dev
+## kit cache
 
-Run models locally (experimental)
+Manage temporary files cached by Kit
 
 ### Synopsis
 
-Start a local server and interact with a model in the browser
+Manage files stored in the temporary KitOps cache dir ($KITOPS_HOME/cache)
+
+Normally, this directory is empty, but may contain leftover files from resumable
+downloads or files that were not cleaned up due to the command being cancelled.
+
+The $KITOPS_HOME location is system dependent:
+	- Linux: $XDG_DATA_HOME/kitops with a fall back to $HOME/.local/share/kitops
+	- MacOS: ~/Library/Caches/kitops
+	- Windows: %LOCALAPPDATA%\kitops
+
 
 ### Examples
 
 ```
-kit dev start
+# Get information about size of cached files
+kit cache info
+
+# Clear files in cache
+kit cache clear
 ```
 
 ### Options
 
 ```
-  -h, --help   help for dev
+  -h, --help   help for cache
 ```
 
 ### Options inherited from parent commands
@@ -236,6 +206,35 @@ kit dev stop [flags]
   -v, --verbose count      Increase verbosity of output (use -vv for more)
 ```
 
+## kit dev
+
+Run models locally (experimental)
+
+### Synopsis
+
+Start a local server and interact with a model in the browser
+
+### Examples
+
+```
+kit dev start
+```
+
+### Options
+
+```
+  -h, --help   help for dev
+```
+
+### Options inherited from parent commands
+
+```
+      --config string      Alternate path to root storage directory for CLI
+      --log-level string   Log messages above specified level ('trace', 'debug', 'info', 'warn', 'error') (default 'info') (default "info")
+      --progress string    Configure progress bars for longer operations (options: none, plain, fancy) (default "plain")
+  -v, --verbose count      Increase verbosity of output (use -vv for more)
+```
+
 ## kit diff
 
 Compare two ModelKits
@@ -538,12 +537,12 @@ listed modelkit.
 
 Template placeholders:
 
-  {{ .Repo }} - repository name
-  {{ .Tags }} - slice of tags for the modelkit
-  {{ .Digest }} - digest of the modelkit
-  {{ .ModelName }} - name defined in the Kitfile
-  {{ .Size }} - total size of the modelkit
-  {{ .Author }} - author from the Kitfile
+  <code v-pre>{{ .Repo }}</code> - repository name
+  <code v-pre>{{ .Tags }}</code> - slice of tags for the modelkit
+  <code v-pre>{{ .Digest }}</code> - digest of the modelkit
+  <code v-pre>{{ .ModelName }}</code> - name defined in the Kitfile
+  <code v-pre>{{ .Size }}</code> - total size of the modelkit
+  <code v-pre>{{ .Author }}</code> - author from the Kitfile
 
 ```
 kit list [flags] [REPOSITORY]

docs/src/docs/cli/generate.sh

@@ -25,5 +25,9 @@ for file in $(find "$DOCS_DIR/" -name "kit_*.md" | sort); do
   sed -n '/### SEE ALSO/q;p' "$file" >> $DOCS_DIR/cli-reference.md
 done
 
+# Escape and {{ sections }}: see: https://github.com/vuejs/vitepress/discussions/480
+sed -i.bak 's|\({{[^}]*}}\)|<code v-pre>\1</code>|g' "$DOCS_DIR/cli-reference.md"
+rm -f "$DOCS_DIR/cli-reference.md.bak"
+
 # Remove generated files, keeping only the combined CLI reference doc
 rm -rf $DOCS_DIR/kit*.md

pkg/cmd/kitcache/cmd.go

@@ -18,12 +18,13 @@ package kitcache
 
 import (
 	"fmt"
-	fscache "github.com/kitops-ml/kitops/pkg/lib/filesystem/cache"
-	"github.com/kitops-ml/kitops/pkg/output"
 	"io"
 	"sort"
 	"text/tabwriter"
 
+	fscache "github.com/kitops-ml/kitops/pkg/lib/filesystem/cache"
+	"github.com/kitops-ml/kitops/pkg/output"
+
 	"github.com/spf13/cobra"
 )
 
@@ -45,8 +46,7 @@ The $KITOPS_HOME location is system dependent:
 kit cache info
 
 # Clear files in cache
-kit cache clear
-		`,
+kit cache clear`,
 	}
 	cmd.AddCommand(cacheInfoCommand())
 	cmd.AddCommand(cacheClearCommand())