[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [gemoc-dev] Decide for an asciidoc compatible codehighlighter
|
Hi all,
My preferences might go to Pygments for the simple reason that it would make the languages available in LaTeX as well through the package "minted".
But I haven't really looked in detail in the pros and cons of each library, so still debatable of course :)
Cheers,
Erwan
Le vendredi 18 janvier 2019 à 10:39 +0100, Didier Vojtisek a écrit :
> Hi
>
> when writing documentation for GEMOC we use asciidoc as it provides higher level presentation support.
>
> I terms of code highlighting most systems suport classic languages (java, html, xml, etc) however in GEMOC we use and define a wider variety of
> languages.
> ocl, xtend, (xtend+k3), aql, ale, oclinecore, ecl, moccml for example.
>
> In the current documentation, I used a special tool chain to be able to have local highlighter configuration : asciidoc to docbook -> docbook to
> html add then add custom highlighting rule to this docbook to html. (for example https://download.eclipse.org/gemoc/docs/nightly/index.html
> supports ecl in the 2.2 section :-) )
> This compilation chain is quite cumbersome and would be simplier if we can just rely on asciidoctor.
> Unfortunatly, even if it supports 5 hightlighter technologies (see https://asciidoctor.org/docs/user-manual/#available-source-highlighters ) none of
> them is locally configurable and require to do a pull request to add a new language.
>
> So my proposition is that we decide to use one of the 5 technologies and then progressively contribute our languages.
>
> => Do you have any preference between Coderay, highlightjs, prettify, pygments, and rouge ?
>
> => once decided, does one of you wish to contribute too ? (AQL + ALE -> Fabien ? ECL -> Julien ?, ... )
>
> my preference goes to highlightjs or pygments (highlightjs because it already supports 185 languages, and pygments because it support both html and
> pdf, however pdf support is low priority for us)
>
> Didier
>
> not checked but an additionnal concern can also be the compatibility of the highlighter with markdown used at github ?
> _______________________________________________
> gemoc-dev mailing list
> gemoc-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/gemoc-dev
--
Erwan Bousse
Associate Professor, Université de Nantes
NaoMod research group, LS2N research laboratory