Rendering Documentation with Docker Compose¶
This workflow is very similar to Rendering Documentation with Docker, it uses the same Docker image, but the commands for running it are slightly different.
This workflow is especially recommended for platforms where the source / run command may not work, but should work fine on all platforms.
重要
The workflow with Docker Compose is still being tested and optimized. Please help to improve our description by:
- Testing the workflow. Report your results in this issue
- Improving this page if you can
Install Docker and Docker Compose
Create a docker-compose.yml file
ちなみに
Some of our repositories already contain this, for example the t3contribute:start or this guide.
You can create the file in the project directory.
version: '3' services: t3docmake: image: t3docs/render-documentation:latest command: makehtml volumes: - ./:/PROJECT:ro - ./Documentation-GENERATED-temp:/RESULT
Run docker-compose
docker-compose run --rm t3docmake
See output of command for generated HTML start file
You can use one of these commands to open the generated file in the browser:
Linux:
xdg-open "Documentation-GENERATED-temp/Result/project/0.0.0/Index.html"
MacOS:
open "Documentation-GENERATED-temp/Result/project/0.0.0/Index.html"
Windows:
start "Documentation-GENERATED-temp/Result/project/0.0.0/Index.html"