You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
33 lines
968 B
33 lines
968 B
# Docdeployer
|
|
|
|
Usage:
|
|
```yml
|
|
steps:
|
|
- name: swagger-doc
|
|
image: hub.codefirst.iut.uca.fr/maxime.batista/codefirst-docdeployer
|
|
commands:
|
|
- /entrypoint.sh <arguments>
|
|
```
|
|
|
|
## `entrypoint.sh`
|
|
|
|
This command generates the documentation and deploys it on your CodeDoc space
|
|
|
|
### arguments
|
|
|
|
- `-l --loc [dir]` location of the documentation sources root - **required**
|
|
- `-t --type [docusaurus|doxygen|swagger]` type of documentation generator to use. - **required**
|
|
- `-d --dest [dir]` path to where to put the documentation outputs in your repository's CodeDoc space - **optional <u>!! cannot be absolute !!</u>**
|
|
|
|
Note !
|
|
For swagger, you have to pass the configuration file instead of a directory
|
|
|
|
usage examples :
|
|
|
|
```
|
|
/entrypoint.sh -l ./documentation/api/api-swagger.yml -t swagger -d api_documentation
|
|
/entrypoint.sh -l ./documentation/app -t docusaurus -d application_documentation
|
|
/entrypoint.sh -l ./src -t doxygen -d sourcecode_documentation
|
|
```
|
|
|