spiegel_podman/docs/make.ps1

function Get-Podman-Commands-List{
    param (
        [string]$podmanClient,
        [string]$command
    );
    if(!$podmanClient) {
        $podmanClient="$PSScriptRoot\..\bin\windows\podman.exe"
    }
    if($command) {
        $podmanHelpCommand="help $command"
        Write-Host "Retrieving the list of ""podman $command"" subcommands."
    } else {
        $podmanHelpCommand="help"
        Write-Host "Retrieving the list of ""podman"" commands."
    }

    $helpLines = @(Invoke-Expression "$podmanClient $podmanHelpCommand")

    # Retrieve the list of subcommands of $command
    # e.g. "podman help machine" returns the list of
    #     "podman machine" subcommands: info, init, etc...
    $subCommands = @()
    $inCommands = $false
    foreach ($line in $helpLines) {
        if ($line -match "^\s*Available Commands:\s*$") {
            $inCommands = $true
            continue
        }
        # end of commands list
        if ($inCommands -and $line -match '^\s*Options:\s*$') {
            break
        }
        if (!$inCommands) {
            continue
        }
        # add command to list
        $name = ($line.Trim() -Split '\s+')[0]
        if ($name -and $name -ne 'help') {
            $subCommands += $name
        }
    }

    if ($command) {
        $subCommands = @($subCommands | ForEach-Object { "$command $_" })
    } else {
        $subCommands = @($subCommands)
    }

    $allCommands = @($subCommands)
    foreach ($subCommand in $subCommands) {
        $subSubCommands = @(Get-Podman-Commands-List -podmanClient "$podmanClient" -command "${subCommand}")
        if ($subSubCommands) {
            $allCommands += $subSubCommands
        }
    }

    return $allCommands
}

function Invoke-Markdown-Preprocess{
    $python = Get-Command -Name 'python' -ErrorAction SilentlyContinue

    if (!$python) {
        Write-Host 'Python not found. Python is required to expand @@option includes in the markdown sources.'
        Exit 1
    }

    Write-Host "Expanding @@option includes in markdown sources (using $($python.Source))..."
    & $python.Source "$PSScriptRoot\..\hack\markdown-preprocess"
    if ($LASTEXITCODE -ne 0) {
        Write-Host 'markdown-preprocess failed.'
        Exit 1
    }
}

function Build-Podman-For-Windows-HTML-Page{
    $srcFolder = "$PSScriptRoot\tutorials"
    $srcFile = "$srcFolder\podman-for-windows.md"
    $destFolder = "$PSScriptRoot\build\remote"
    $destFile = "$destFolder\podman-for-windows.html"
    $cssFile = "$PSScriptRoot\standalone-styling.css"
    $pandocOptions = "--ascii --from markdown-smart -c $cssFile --standalone " +
                     "--embed-resources --metadata title=""Podman for Windows"" " +
                     "-V title="

    Write-Host -NoNewline "Generating $destFile from $srcFile..."
    Push-Location $srcFolder
    New-Item -ItemType Directory -Force -Path $destFolder | Out-Null
    Invoke-Expression "pandoc $pandocOptions $srcFile > $destFile"
    Pop-Location
    Write-Host "done."
}

function Build-Podman-Remote-HTML-Page{
    $markdownFolder = "$PSScriptRoot\source\markdown"
    # Look for all podman-remote*.md files in the markdown folder
    Get-ChildItem -Path "$markdownFolder" -Filter "podman-remote*.md" | ForEach-Object {
        # Extract the command name from the file name
        $command = $_.Name -replace '^podman-(.*).1.md$','$1'
        # Generate the documentation HTML page
        Build-Podman-Command-HTML-Page -command $command
    }
}

# Rename podman-remote.html to podman.html to match remote-docs.sh
function Rename-Podman-Remote-HTML{
    $src = "$PSScriptRoot\build\remote\podman-remote.html"
    $dst = "$PSScriptRoot\build\remote\podman.html"
    if (!(Test-Path -Path $src -PathType Leaf)) {
        return
    }

    $content = Get-Content -Raw -Path $src

    $content = $content -creplace 'Podman\*-remote', 'Podman for Windows'
    $content = $content -creplace 'podman\*-remote', 'podman'
    $content = $content -creplace 'Podman-remote', 'Podman for Windows'
    $content = $content -creplace 'podman-remote', 'podman'
    $content = $content -creplace 'A remote CLI for Podman: ', ''

    Set-Content -Path $dst -Value $content -NoNewline
    Remove-Item -Path $src
}

function Find-Podman-Command-Markdown-File{
    param (
        [string]$command
    );
    # A podman command documentation can be in one of the following files
    $markdownFolder = "$PSScriptRoot\source\markdown"
    $srcFileMdIn = "$markdownFolder\podman-$command.1.md.in"
    $srcFileMd = "$markdownFolder\podman-$command.1.md"
    $linkFile = "$markdownFolder\links\podman-$command.1"

    # Use the already-preprocessed .md file over the raw .md.in template
    if (Test-Path -Path $srcFileMd -PathType Leaf) {
        return $srcFileMd
    } elseif (Test-Path -Path $srcFileMdIn -PathType Leaf) {
        return $srcFileMdIn
    } elseif (Test-Path -Path $linkFile -PathType Leaf) {
        # In $linkFile there is a link to a markdown file
        $srcFile = Get-Content -Path $linkFile
        # $srcFile is something like ".so man1/podman-attach.1"
        # and the markdown file is "podman-attach.1.md"
        $srcFile = $srcFile -replace ".so man1/", ""
        $srcFileMdIn = "$markdownFolder\$srcFile.md.in"
        $srcFileMd = "$markdownFolder\$srcFile.md"
        if (Test-Path -Path $srcFileMd -PathType Leaf) {
            return "$srcFileMd"
        } elseif (Test-Path -Path "$srcFileMdIn" -PathType Leaf) {
            return "$srcFileMdIn"
        }
    }
    return $null
}

function Build-Podman-Command-HTML-Page{
    param (
        [string]$command
    );

    $destFile = "$PSScriptRoot\build\remote\podman-$command.html"
    $srcFile = Find-Podman-Command-Markdown-File -command $command

    if (!$srcFile) {
        Write-Host "Couldn't find the documentation source file for $command. Skipping."
        continue
    }

    $pandocOptions = "--ascii --standalone --from markdown-smart " +
                     "--lua-filter=$PSScriptRoot\links-to-html.lua " +
                     "--lua-filter=$PSScriptRoot\use-pagetitle.lua"

    Write-Host -NoNewline "Generating $command documentation..."
    Invoke-Expression "pandoc $pandocOptions -o $destFile $srcFile" | Out-Null
    Write-Host "done."
}

# Expand @@option includes in the markdown sources
Invoke-Markdown-Preprocess

# Generate podman-for-windows.html
Build-Podman-For-Windows-HTML-Page

# Generate podman-remote*.html
Build-Podman-Remote-HTML-Page
# Rename the generated podman-remote*.html
Rename-Podman-Remote-HTML

# Get the list of podman commands on Windows
if ($args[1]) {
    $commands = Get-Podman-Commands-List "-podmanClient $args[1]"
}
else {
    $commands = Get-Podman-Commands-List
}

# Generate podman commands documentation
foreach ($command in $commands) {
    # Replace spaces with hyphens in the command name
    # e.g. machine os apply becomes machine-os-apply
    $command = $command -replace ' ', '-'
    Build-Podman-Command-HTML-Page -command $command
}