Build fails

[asolntsev]

On a clean laptop, I clone the project and run mvn test.
Build fails.

celesta>mvn test
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO] 
[INFO] celesta-parent                                                     [pom]
[INFO] celesta-documentation                                              [jar]
[INFO] celesta-sql                                                        [jar]
[INFO] celesta-core                                                       [jar]
[INFO] celesta-maven-plugin                                      [maven-plugin]
[INFO] celesta-system-services                                            [jar]
[INFO] celesta-unit                                                       [jar]
[INFO] celesta-test                                                       [jar]
[INFO] coverage-report                                                    [pom]
[INFO] 
[INFO] -----------------------< ru.curs:celesta-parent >-----------------------
[INFO] Building celesta-parent 7.4.39-SNAPSHOT                            [1/9]
[INFO]   from pom.xml

...

[INFO] asciidoctor: ERROR: synsql.adoc: line 5: Failed to generate image: Could not find the 'syntrax' executable in PATH; add it to the PATH or specify its location using the 'syntrax' document attribute
[INFO] asciidoctor: ERROR: synsql.adoc: line 31: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 44: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 63: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 78: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 96: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 132: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 466: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 156: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 164: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 177: Failed to generate image: no implicit conversion of nil into String
[INFO] asciidoctor: ERROR: synsql.adoc: line 190: Failed to generate image: no implicit conversion of nil into String

[INFO] Converted /Users/andrei/projects/celesta/celesta-documentation/src/main/asciidoc/ru/0000_Celesta.adoc
[ERROR] asciidoctor: ERROR: synsql.adoc: line 5: Failed to generate image: Could not find the 'syntrax' executable in PATH; add it to the PATH or specify its location using the 'syntrax' document attribute

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.377 s
[INFO] Finished at: 2023-06-27T19:26:21+03:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.asciidoctor:asciidoctor-maven-plugin:2.2.4:process-asciidoc (asciidoc-to-html-ru) on project celesta-documentation: Found 42 issue(s) of severity WARN or higher during conversion -> [Help 1]

[asolntsev]

I see this error in logs:

[ERROR] asciidoctor: ERROR: synsql.adoc: line 5: Failed to generate image: Could not find the 'syntrax' executable in PATH; add it to the PATH or specify its location using the 'syntrax' document attribute

I tried to install "syntrax", but with no success:

• brew install asciidoctor
• brew install syntaxerl

[inponomarev]

@asolntsev Thanks for the issue! jsyntrax is required to build 'railroad diagrams' in documentation.

You can use this command to build Celesta without the documentation

Or, you can follow this outline

1. Download and unzip the freshest jsyntrax release from GitHub
2. Set DIAGRAM_JSYNTRAX_HOME environment variable to the path to unzipped jsyntrax.
3. Build celesta-documentation module mvn generate-resources -pl :celesta-documentation

See also asciidoctor/asciidoctor-diagram#423 -- I think that after fixing the asciidoctor-diagram there will be no need to manually download jsyntrax and set this DIAGRAM_JSYNTRAX_HOME