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

docs/developer/index.md

@@ -57,7 +57,7 @@ scripts.
 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
 
 Then, open powershell with **administrative** priviledges and run the

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

@@ -49,4 +49,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-hooks.py

@@ -0,0 +1,12 @@
+import subprocess
+import sys
+
+def markdownlint_hooks(files):
+    command = ["mdl-check.py"] + files
+    result = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    output = result.stdout.decode("utf-8") + result.stderr.decode("utf-8")
+    print(output)
+
+if __name__ == "__main__":
+    files = sys.argv[1:]
+    markdownlint_hooks(files)

script/mdl-check.py

@@ -0,0 +1,12 @@
+import subprocess
+import sys
+
+def mdl_check(files):
+    command = ["mdl"] + files
+    result = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    output = result.stdout.decode("utf-8") + result.stderr.decode("utf-8")
+    print(output)
+
+if __name__ == "__main__":
+    files = sys.argv[1:]
+    mdl_check(files)