[mylyn-docs-dev] Wikitext and maven

[Jeremie Bresson <dev@xxxxxxxx>]

A long time ago, I have described how you can use mylyn-wikitext to 
create the toc.xml files using a list of HTML pages as input. The idea 
was described on our blog [1].

I am happy to share with you, that I have created a maven plugin called 
“geneclipsetoc-maven-plugin” to do this task. The code is hosted on 
GitHub [2] and the Maven repository on Bintray [3].

There is not much code in my plugin. I am not sure yet if this code 
should be integrated in the Mylyn Wikitext project or if it should 
continue to live as a separate mini-project.
I would be happy to know the opinion of mylyn wikitext commiters about 
this.

I had to learn a lot of new stuff to be able to create this maven 
plugin. I hope that what I did is correct. One ugly point is my 
dependency to the SNAPTSHOT version of mylyn wikitext. I now better 
understand why Bug 421551 (publish current stable release to a Maven 
repository) [4] is important for the maven world.

For this last point I am very confident that I will be able to propose a 
solution. My approach is to convert the official P2 Update site to a 
plain maven repository using the Eclipse B3 tool. My next steps are:
* Figure out what the correct P2 update site I should use as input (It 
should be the P2 Update site where the wikitext jars corresponding to 
the official wikitext relesases are published).
* Do some extensive tests (with standalone maven projects consuming my 
repo).
* Write about the result.

I will keep you informed as soon as possible (my time is currently 
limited).

Best regards,

Jeremie.

[1] https://www.bsi-software.com/scout/toc-xml-from-existing-html/
[2] https://github.com/jmini/geneclipsetoc/
[3] http://dl.bintray.com/jmini/maven/
[4] https://bugs.eclipse.org/bugs/show_bug.cgi?id=421551