Add Conversion of LICENSE.adoc to RTF Format

[alfeilex]

The license file displayed in the MSI installation needs to be in RTF format see here . The license we use for that is located in documentation/LICENSE.adoc. There isn’t a direct conversion from .adoc to RTF, but there are solutions available online suggesting that it’s possible to convert .adoc to DocBook and then to RTF.

Here’s some relevant links:

• https://docbkx-tools.sourceforge.net/docbkx-samples/manual.html
• https://www.oxygenxml.com/forum/feature-request/topic173.html
• https://nwalsh.com/docbook/procdiagram/xmlsgmlpub.png
• https://tldp.org/HOWTO/DocBook-OpenJade-SGML-XML-HOWTO/x456.html

Also we should have a look at the layout since the RTF seems to somehow mess up our table (it is also not possible to increase the size of the installer window or to scroll horizontally to read the entire license text):

[alfeilex]

I have already tried to use the asciidoctor-maven-plugin and docbkx-maven-plugin to create a pipeline. Finally, It worked out to convert LICENSE.adoc into Docbook with asciidoctor-maven-plugin and then into RTF with docbkx-maven-plugin. However, some elements, like the toc and links, do not map correctly, making the output look odd. it looks like, we need a special FO stylesheet for that or we should try openJade

snippet of documentation/pom.xml of my tested approach:

 <executions>
          <execution>
            <id>generate-doc</id>
            <phase>compile</phase>
            <goals>
              <goal>process-asciidoc</goal>
            </goals>
          </execution>
          <execution>
            <id>generate-docbook</id>
            <phase>compile</phase>
            <goals>
              <goal>process-asciidoc</goal>
            </goals>
            <!-- Is needed for the MSI installer .adoc->docbook->rtf -->
            <configuration>
              <sourceDocumentName>LICENSE.adoc</sourceDocumentName>
              <outputDirectory>${docgen.generated.docbooks}</outputDirectory>
              <backend>docbook</backend>
              <toc>no</toc>
              <attribute-missing>drop</attribute-missing>
            </configuration>
          </execution>
        </executions>
      </plugin>

      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>build-helper-maven-plugin</artifactId>
        <version>3.6.0</version>
        <executions>
        ...
      </plugin>
      <plugin>
        <groupId>com.agilejava.docbkx</groupId>
        <artifactId>docbkx-maven-plugin</artifactId>
        <version>2.0.14</version>
        <dependencies>
          <dependency>
            <groupId>org.docbook</groupId>
            <artifactId>docbook-xml</artifactId>
            <version>4.4</version>
            <type>pom</type>
            <scope>runtime</scope>
          </dependency>
          <dependency>
            <groupId>net.sf.offo</groupId>
            <artifactId>fop-hyph</artifactId>
            <version>2.0</version>
            <scope>runtime</scope>
          </dependency>
        </dependencies>
        <configuration>
          <sourceDirectory>${docgen.generated.docbooks}</sourceDirectory>
          <includes>LICENSE.xml</includes>
          <highlightSource>1</highlightSource>
        </configuration>
        <executions>
          <execution>
            <id>generate-rtf</id>
            <phase>process-classes</phase>
            <goals>
              <goal>generate-rtf</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>