Skip to content

Commit 663d8c3

Browse files
committed
Added documentation
1 parent 0f231e3 commit 663d8c3

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

fj-doc-maven-plugin/README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,18 @@ All basic features are implemented.
1212

1313
*Since* : fj-doc 8.6.0
1414

15+
## Available goals
16+
17+
| goal | since | description |
18+
|--------|-------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
19+
| add | 8.6.0 | add Venus Doc Configuration to an existing project |
20+
| verify | 8.7.0 | verify the templates in a FreeMarker configuration (folder), note: it can be used on any Apache FreeMarker configuration, not only Fugerit Venus Doc. |
21+
22+
23+
## Goal : add
24+
25+
add Venus Doc Configuration to an existing project
26+
1527
*Quickstart* :
1628

1729
Default configuration :
@@ -54,3 +66,24 @@ mvn org.fugerit.java:fj-doc-maven-plugin:add \
5466
| mod-openrtf-ext | fj-doc-mod-openrtf-ext | rtf | Type handler based on [OpenRTF](https://github.com/LibrePDF/OpenRTF) |
5567
| base-json | fj-doc-base-json | | add support to use json documents as format for document template |
5668
| base-yaml | fj-doc-base-yaml | | add support to use yaml documents as format for document template |
69+
70+
71+
## Goal : verify
72+
73+
add Venus Doc Configuration to an existing project
74+
75+
*Quickstart* :
76+
77+
```shell
78+
mvn org.fugerit.java:fj-doc-maven-plugin:verify -DtemplateBasePath=./src/test/resources/fj_doc_test/template-fail
79+
```
80+
81+
verify the templates in a FreeMarker configuration (folder), note: it can be used on any Apache FreeMarker configuration, not only Fugerit Venus Doc.
82+
83+
| parameter | required | default | description |
84+
|---------------------|----------|---------------|--------------------------------------------------------------------------------------------------------------------|
85+
| templateBasePath | true | | Path to base folder containing FreeMarker templates |
86+
| freemarkerVersion | false | latest stable | FreeMarker configuration ( i.e. 2.3.33) |
87+
| templateFilePattern | false | | Filter on templates to be checked, regex on filename, i.e. ".{0,}[.]ftl" |
88+
| failOnErrors | true | true | If set to true the build will fail when template syntax errors will be found, otherwise errors will be only logged |
89+

0 commit comments

Comments
 (0)