Skip to content

Latest commit

 

History

History
73 lines (40 loc) · 2.51 KB

FAQ.adoc

File metadata and controls

73 lines (40 loc) · 2.51 KB
Raw

Frequently Asked Questions

Is Jamal for Java developers?

Not exclusively. Jamal is written in Java, therefore, you need a Java environment to run it, but it supports other environments. You do not need to know Java or be a Java programmer to use Jamal.

Is there support for Gradle?

Yes. You can use Jamal in your Gradle-built project. There is a separate Gradle plugin project. There is no Gradle extension the same way as there is an extension for Maven. The reason for that is, you do not need it. Gradle is configured using a powerful Groovy-based DSL that can invoke any Java API, hence it does not need any Jamal-like preprocessor.

Can I change the { and } macro opening and closing characters?

Yes, absolutely.

Note
 The macro opening and closing sequences are not necessarily single characters. It is possible to use multi-character sequences. You can define the macro starting string as a command line parameter. You can define it programmatically when you embed Jamal into an application providing the macro opening and closing string as the constructor argument to the Processor class. Last, but not least you can change the macro opening and closing strings using the sep macro.

The documentation of the sep macro is at

Note that even when you changed the opening and closing strings if you

  • import or include a file AND

  • the file starts with the characters {@

then { and } will be used as macro opening and closing strings inside the included file.

Also, when you use the IntelliJ Asciidoctor plugin with the Jamal preprocessor,

  • the macro opening string is {%, and

  • the macro closing string is %},

unless the file starts with the characters {@.

I installed the ASCIIDOC plugin, and it gives error for the Jamal documentation

It can only happen if you use a non-release, development version.

If you try to look at the git master HEAD version, there is a possibility that the documentation has errors. Check on GitHub if the build is broken. It usually is not. After that check that you have the latest version of the plugin is installed. When you edit the git master HEAD version, you are editing a not released version. The current documentation of Jamal may use the newest features, which were not released yet. To edit these, you need to install the non-released version. To do that run mvn install in the Jamal project directory first. After that cd jamal-asciidoc and sh ./install-asciidoc.sh.