removed ruby/gem dependencies in env.ps1 and updated the docs, added markdownlint-hook.ps1, docs.ps1, and docker.ps1

docs/developer/index.md

@@ -35,28 +35,24 @@ software packages. But errors might crop up due to missing
 environment variables. The potential errors are:
 
 1. `npm is not recognized.........` in `base.ps1`.
-1. `gem is not recognized.........` in `env.ps1`
 
 If you encounter these errors,
-remember to include _node_ and _ruby_ installation locations in
+remember to include _node_ installation locations in
 **PATH** environment variable
 (`Settings --> search for "system environment variables"`
 `--> Advanced --> Environment Variables --> PATH`).
 
 The `base.ps1` and `env.ps1` scripts can be run again after setting
 the correct **PATH** environment variable.
 
-#### Pre-install Nodejs and Ruby Software
+#### Pre-install Nodejs
 
 Another way to solve the **PATH** environment problem is to
-install Nodejs and Ruby software packages before running the powershell
+install the Nodejs software package before running the powershell
 scripts.
 
 1. Install the latest stable version of NodeJS from the
    [official NodeJS website](https://nodejs.org/en).
-1. Install Ruby from
-   [official Ruby website](https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-3.1.2-1/rubyinstaller-devkit-3.1.2-1-x64.exe)
-   and follow all the defaults during the installation.
 
 #### Run Scripts
 

script/docs.ps1

@@ -0,0 +1,47 @@
+# Get the version
+if ($args) {
+    $Version = $args[0]
+} else {
+    $Version = "development"
+}
+
+# Set environment variables
+$env:VERSION = $Version
+$env:COMMIT_HASH = (git rev-parse --short HEAD)
+$env:MKDOCS_ENABLE_PDF_EXPORT = 1
+
+Write-Output "Version: $Version"
+
+# Remove the site directory if it exists
+if (Test-Path "site") {
+    Remove-Item "site" -Recurse -Force
+}
+
+# Generate and publish documents
+Write-Output "Generate and publish documents..."
+& mkdocs build --config-file mkdocs.yml --site-dir "site/online/$Version"
+
+# Copy redirect page
+Copy-Item "docs/redirect-page.html" "site/index.html"
+
+# Checkout webpage-docs branch
+git checkout webpage-docs
+
+# Clean up irrelevant files
+if (Test-Path "$Version") {
+    Remove-Item "$Version" -Recurse -Force
+}
+
+# Move PDF file to top directory
+if (Test-Path "site/online/$Version") {
+    Move-Item "site/online/$Version/pdf/DTaaS-docs.pdf" ".\DTaaS-$Version.pdf"
+    Move-Item "site/online/$Version" ".\$Version"
+}
+
+# Move index.html to top directory and remove site directory
+Move-Item "site/index.html" "."
+Remove-Item "site" -Recurse -Force
+
+# Commit changes
+git add .
+git commit --no-verify -m "docs for $env:COMMIT_HASH commit"

script/env.ps1

@@ -24,17 +24,8 @@ if (-not ([Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarg
 # Install mkdocs
 pip install mkdocs
 
-# Install Ruby: https://github.com/oneclick/rubyinstaller2/releases/download/RubyInstaller-3.1.2-1/rubyinstaller-devkit-3.1.2-1-x64.exe
-choco install -y ruby
-
-# Ensure Ruby scripts directory is added to PATH
-if (-not ([Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) -like "*Ruby*")) {
-    Write-Host "Adding Ruby scripts to PATH..."
-    [Environment]::SetEnvironmentVariable("Path", "$env:Path;$(Get-Command ruby | Select-Object -ExpandProperty Directory)", [EnvironmentVariableTarget]::Machine)
-}
-
 # Install markdownlint
-gem install mdl
+choco install markdownlint-cli
 
 # Install mkdocs plugins
 pip install mkdocs-material python-markdown-math mkdocs-open-in-new-tab mkdocs-with-pdf qrcode
@@ -49,4 +40,4 @@ if (-not ([Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarg
 choco install -y shellcheck
 
 # Install madge for generating dependency graphs of typescript projects
-npm install -g madge
+npm install -g madge

script/markdownlint-hook.ps1

@@ -0,0 +1,10 @@
+# This script is used by the pre-commit hook to check the markdown files without exiting the commit process.
+
+# Invoke markdownlint and capture the output
+$output = markdownlint $args
+
+# Print the output
+Write-Output $output
+
+# Exit with code 0 to indicate success
+Exit 0