1
1
# Documentation Github Pages Action
2
2
3
- A composite Github Action to generate code, OpenAPI and AsyncAPI documentation and to deploy it on Github Pages.
3
+
4
+ [ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-yellow.svg?style=plastic )] ( https://opensource.org/licenses/MIT )
5
+ ![ Version] ( https://img.shields.io/github/v/release/smartoperatingblock/documentation-ghp-action?style=plastic )
6
+
7
+ A composite ** Github Action** to generate * code* , * OpenAPI* and * AsyncAPI* documentation and to deploy it on Github Pages.
4
8
5
9
## Setup
6
10
Choose the types of documentation you want to generate by putting true on this input parameters:
7
- - ` should-generate-code-documentaion `
11
+ - ` should-generate-code-documentation `
8
12
- ` should-generate-openapi-documentaion `
9
13
- ` should-generate-asyncapi-documentaion `
10
14
@@ -18,6 +22,23 @@ For every selected type specify the command, input file and destination folder o
18
22
19
23
## Example
20
24
21
- An example of action usage with all types of documentations
25
+ An example of how to use the action with all types of documentations and inputs:
22
26
``` yaml
27
+ jobs :
28
+ documentation :
29
+ runs-on : ubuntu-latest
30
+ steps :
31
+ - name : Checkout
32
+ uses : actions/checkout@v3
33
+ - uses : SmartOperatingBlock/documentation-ghp-action@1.0.0
34
+ with :
35
+ should-generate-code-documentation : true
36
+ code-documentation-generation-command : ./gradlew dokkaHtml
37
+ code-documentation-dst-folder : ' build/code-doc/'
38
+ should-generate-openapi-documentation : true
39
+ openapi-documentation-input-file : ' docs/openapi/openapi.yml'
40
+ openapi-documentation-dst-folder : ' build/openapi-doc/'
41
+ should-generate-asyncapi-documentation : true
42
+ asyncapi-documentation-input-file : ' docs/asyncapi/asyncapi.yml'
43
+ asyncapi-documentation-dst-folder : ' build/asyncapi-doc/'
23
44
` ` `
0 commit comments