openapi-to-docbook.ps1

# Takes the OpenAPI file
Param(
   [parameter(mandatory=$true)][string]$file
)
$name = [System.IO.Path]::GetFileNameWithoutExtension($file)
# Converts OpenAPI to Markdown documentation
npm install -g widdershins
widdershins $file --search false --expandBody --summary -o markdown.md 
# Converts Widdershin's markdown output to HTML, then to DocBook5
pandoc markdown.md -f markdown+raw_html -t html -o html.html
pandoc html.html -f html -t docbook5 -o docbook5.xml
# Injects required tags
'<?xml version="1.0" encoding="UTF-8"?><article xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"><info><title>OpenAPI Import</title></info>' + (Get-Content docbook5.xml -Raw) | Set-Content docbook5.xml
Add-Content -Path docbook5.xml -Value '</article>'
# Compress the file
Compress-Archive -Path docbook5.xml -DestinationPath import.zip