fix: build site from zensical config

Author: MariusStorhaug

.github/workflows/Build-Site.yml

@@ -39,13 +39,15 @@ jobs:
           name: docs
           path: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs
 
-      - name: Install mkdocs-material
+      - name: Install site dependencies
         shell: pwsh
         run: |
           pip install mkdocs-material
           pip install mkdocs-git-authors-plugin
           pip install mkdocs-git-revision-date-localized-plugin
           pip install mkdocs-git-committers-plugin-2
+          pip install pyyaml
+          pip install tomli
 
       - name: Structure site
         uses: PSModule/GitHub-Script@8083ec1f733f00357ee4d0db0c6056686e483bc0 # v1.9.0
@@ -111,36 +113,70 @@ jobs:
                 Write-Host "Readme Target Path:   $readmeTargetPath"
             }
 
-            LogGroup 'Build docs - Create mkdocs.yml' {
+            LogGroup 'Build docs - Create mkdocs.yml from zensical.toml' {
                 $rootPath = Split-Path -Path $ModuleSourcePath -Parent
-                $possiblePaths = @(
-                    '.github/mkdocs.yml',
-                    'docs/mkdocs.yml',
-                    'mkdocs.yml'
-                )
-
-                $mkdocsSourcePath = $null
-                foreach ($path in $possiblePaths) {
-                    $candidatePath = Join-Path -Path $rootPath -ChildPath $path
-                    if (Test-Path -Path $candidatePath) {
-                        $mkdocsSourcePath = $candidatePath
-                        break
-                    }
-                }
+              $zensicalSourcePath = Join-Path -Path $rootPath -ChildPath '.github/zensical.toml'
 
-                if (-not $mkdocsSourcePath) {
-                    throw "Mkdocs source file not found in any of the expected locations: $($possiblePaths -join ', ')"
+              if (-not (Test-Path -Path $zensicalSourcePath)) {
+                throw "Zensical source file not found at expected location: .github/zensical.toml"
                 }
 
                 $mkdocsTargetPath = Join-Path -Path $SiteOutputPath -ChildPath 'mkdocs.yml'
 
-                Write-Host "Mkdocs Source Path:   $mkdocsSourcePath"
+              Write-Host "Zensical Source Path: $zensicalSourcePath"
                 Write-Host "Mkdocs Target Path:   $mkdocsTargetPath"
 
-                $mkdocsContent = Get-Content -Path $mkdocsSourcePath -Raw
-                $mkdocsContent = $mkdocsContent.Replace('-{{ REPO_NAME }}-', $ModuleName)
-                $mkdocsContent = $mkdocsContent.Replace('-{{ REPO_OWNER }}-', $env:GITHUB_REPOSITORY_OWNER)
-                $mkdocsContent | Set-Content -Path $mkdocsTargetPath -Force
+              $zensicalContent = Get-Content -Path $zensicalSourcePath -Raw
+              $zensicalContent = $zensicalContent.Replace('-{{ REPO_NAME }}-', $ModuleName)
+              $zensicalContent = $zensicalContent.Replace('-{{ REPO_OWNER }}-', $env:GITHUB_REPOSITORY_OWNER)
+
+              $zensicalInputPath = Join-Path -Path $SiteOutputPath -ChildPath 'zensical.toml'
+              $zensicalContent | Set-Content -Path $zensicalInputPath -Force
+
+              python3 -c @'
+      import pathlib
+
+      import yaml
+
+      try:
+        import tomllib
+      except ModuleNotFoundError:
+        import tomli as tomllib
+
+      source_path = pathlib.Path('outputs/site/zensical.toml')
+      target_path = pathlib.Path('outputs/site/mkdocs.yml')
+
+      with source_path.open('rb') as source_file:
+        zensical = tomllib.load(source_file)
+
+      project = zensical.get('project', {})
+      theme = dict(project.get('theme', {}))
+      theme.pop('variant', None)
+      theme = {'name': 'material', **theme}
+
+      markdown_extensions = []
+      for name, value in project.get('markdown_extensions', {}).items():
+        if value:
+          markdown_extensions.append({name: value})
+        else:
+          markdown_extensions.append(name)
+
+      mkdocs = {
+        'site_name': project.get('site_name'),
+        'repo_name': project.get('repo_name'),
+        'repo_url': project.get('repo_url'),
+        'theme': theme,
+        'plugins': project.get('plugins', ['search']),
+        'markdown_extensions': markdown_extensions,
+      }
+
+      if 'extra' in project:
+        mkdocs['extra'] = project['extra']
+
+      with target_path.open('w', encoding='utf-8') as target_file:
+        yaml.safe_dump(mkdocs, target_file, sort_keys=False, allow_unicode=True)
+      '@
+
                 Show-FileContent -Path $mkdocsTargetPath
             }