Using Slate in Docker:
https://github.com/slatedocs/slate/wiki/Using-Slate-in-DockerConverting an OpenAPI/Swagger file to Markdown with the Widdershins CLI:
https://mermade.github.io/widdershins/ConvertingFilesBasicCLI.html1) сделано описание API путем генерации YAML в формат Mermade/widdershins
node widdershins C:/Dev/IdeaProjects/xrg-core/bo/bo-doc/src/main/openapi/gk/xrg_bo/boserver/doc/rest/Items.yaml -o
index.html.mdnode widdershins --environment env.json swagger.json -o
myOutput.mdnode widdershins -e env.json C:/Dev/IdeaProjects/xrg-core/bo/bo-doc/src/main/openapi/gk/xrg_bo/boserver/doc/rest/Incomings.yaml -o
index.html.md2) поднят контейнер Docker для рендерелки Slate
PS C:\Dev\Git\slate> docker stop slate
PS C:\Dev\Git\slate> docker build . -t slate
3) поднят сайт с описанием API Mobile GK на Slate
PS C:\Dev\Git\slate> docker run -d --rm --name slate -p 4567:4567 -v /build:/srv/slate/build -v /source:/srv/slate/source slate
'PS C:\Dev\Git\slate> docker run -d --rm --name slate -p 4567:4567 -v C:/Dev/Git/slate/build:/srv/slate/build -v C:/Dev/Git/slate/source:/srv/slate/source slate
To build your sources while the container is running, run:
docker exec -it slate /bin/bash -c "bundle exec middleman build"
ps Однако есть проблемки с генерацией под виндой в докеровских контейнерах. Поэтому приходится делать танцы с бубном для копирования исходника.
PS C:\Dev\Git\slate> docker exec -it slate /bin/bash
root@292a6c442db4:/srv/slate# df -lh
root@292a6c442db4:/srv/slate# ls /srv/slate/source
root@292a6c442db4:/srv/slate# ls *
root@292a6c442db4:/srv/slate# exit
docker cp source/. slate:/srv/slate/source