Hi Lennart,
what yu=ou described is something that si already working (at least
for us), for your purposes you could just use the fluido-skin with
that configuration in site.xml
<skin>
<groupId>org.apache.maven.skins</groupId>
<artifactId>maven-fluido-skin</artifactId>
<version>1.0</version>
</skin>
<custom>
<fluidoSkin>
<sourceLineNumbersEnabled>true</sourceLineNumbersEnabled>
</fluidoSkin>
</custom>
source code snippets contained in
<source>
...
<source>
in XDoc and
+-----+
...
+-----+
in APT are auto-detected via google code prettifier and automatically
rendered, without the pain to configure elements by yourself.
Just wait a couple of hours that we have to release the skin, and code
is enhanced.
Let me know if you need help, I would more than pleased to provide my support!
All the best, have a nice weekend,
Simo
http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/
On Sat, Nov 26, 2011 at 1:58 PM, Lennart Jörelid
<lennart.jore...@gmail.com> wrote:
> Hello Simone,
>
> First - sorry for being short on the brink of incomprehensible in my
> response above.
>
> You are correct in that Doxia prepares HTML and the skin applies the style.
> However, to simplify site generation for the site developer, we need to
> create a
> set of markups understandable by Doxia (or, more precisely, the Doxia APT
> enhancements)
> indicating that the content in between them should be interpreted as "code"
> in a
> particular language - such as Java or XML.
>
> Say ... (crude XML form here, but just intended as an example) ...
>
> <code language="java" displayLineNumbers="yes" linkUrlsInCode="yes">
> ... java code goes here ...
> </code>
>
> That particular element would hook into the CSS or style sheets, to generate
> syntax highlighted code within the maven site, using something like
> the Syntax Highlighter (http://alexgorbatchev.com/SyntaxHighlighter/)
> or the Google code prettify (http://code.google.com/p/google-code-prettify/
> ).
>
> For example, I need this code-with-linenumbers feature for a patch to the
> jaxb2-maven-plugin to explain the correlation between annotations in java
> code,
> plugin XML configuration and resulting/generated XML schema files.
>
> However, I am at a loss regarding how to do it with the tools available in
> APT today,
> since there is no <code> element working similar to the example above -
> at least to my knowledge.
>
> I'll check out the code, file issues and such tomorrow.
> :)
>
> Fair?
>
> 2011/11/26 Simone Tripodi <simonetrip...@apache.org>
>
>> Hi all,
>> apologize but I have my own difficulties on understanding the issue;
>> why applying the code highlight should be a concern of the doxia
>> renderer?
>> I mean, Doxia has the task of generating the html code, the skin has
>> the task of applying styles on elements where class/id are already
>> set... I think that's why the issue has'n been fixed yet.
>>
>> @Lennart: do you mind filling an issue on
>> https://jira.codehaus.org/browse/MSKINS/ ? TIA!
>>
>> All the best, have a nice WE!
>> Simo
>>
>> http://people.apache.org/~simonetripodi/
>> http://simonetripodi.livejournal.com/
>> http://twitter.com/simonetripodi
>> http://www.99soft.org/
>>
>>
>>
>> On Sat, Nov 26, 2011 at 9:07 AM, Lukas Theussl <ltheu...@apache.org>
>> wrote:
>> > There is a feature request for that:
>> > https://jira.codehaus.org/browse/DOXIA-439
>> >
>> > It's not implemented yet...
>> >
>> > HTH,
>> > -Lukas
>> >
>> >
>> > On Sat, Nov 26, 2011 at 2:16 AM, Lennart Jörelid
>> > <lennart.jore...@gmail.com>wrote:
>> >
>> >> Hello Simone,
>> >>
>> >> Looking good.
>> >>
>> >> So ... given that this is a skin to maven, could you include the CSS
>> and JS
>> >> of the syntax highlighter (i.e.
>> >> http://alexgorbatchev.com/SyntaxHighlighter/
>> >> )?
>> >>
>> >> However, I guess my question is on a more fundamental level.
>> >> What do we need to do in an APT file (or one of the other site
>> >> documentation format files) to achieve pretty-printed/syntax colored
>> source
>> >> snippets in Java or XML?
>> >>
>> >> There seems to be no mention of exactly how to craft code snippet
>> examples
>> >> - as far as I can see - on the
>> >> http://maven.apache.org/doxia/references/doxia-apt.html (and friends)
>> >> pages.
>> >>
>> >> 2011/11/26 Simone Tripodi <simonetrip...@apache.org>
>> >>
>> >> > Hi Lennart,
>> >> > we are going to release the maven-fluido-skin[1] that does also code
>> >> > prettyprint ans syntax highlight.
>> >> > HTH!
>> >> > Simo
>> >> >
>> >> > [1] http://maven.apache.org/skins/maven-fluido-skin/
>> >> >
>> >> > http://people.apache.org/~simonetripodi/
>> >> > http://simonetripodi.livejournal.com/
>> >> > http://twitter.com/simonetripodi
>> >> > http://www.99soft.org/
>> >> >
>> >> >
>> >> >
>> >> > On Sat, Nov 26, 2011 at 1:15 AM, Lennart Jörelid
>> >> > <lennart.jore...@gmail.com> wrote:
>> >> > > Hello folks,
>> >> > >
>> >> > > I need to include some pretty-printed and syntax coloured code
>> snippets
>> >> > into the maven site of a set of projects.
>> >> > > After a tad of searching, I haven't found any plugin or extension to
>> >> > Doxia that seems to do this. There seems to be
>> >> > > several "box text and don't ruin its formatting"-type tags and
>> >> > operations - but I would like to pretty print and syntax
>> >> > > colour both Java and XML files.
>> >> > >
>> >> > > ... and I suppose this is fixed by some nice doxia-based utility
>> >> already.
>> >> > >
>> >> > > Could you point me in the correct direction?
>> >> > >
>> >> > > // Bästa hälsningar,
>> >> > > // [sw. "Best regards"
>> >> > > //
>> >> > > // Lennart Jörelid
>> >> > > // lennart.jore...@gmail.com
>> >> > >
>> >> > >
>> >> >
>> >> > ---------------------------------------------------------------------
>> >> > To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
>> >> > For additional commands, e-mail: dev-h...@maven.apache.org
>> >> >
>> >> >
>> >>
>> >>
>> >> --
>> >>
>> >> --
>> >> Lennart Jörelid
>> >>
>> >
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
>> For additional commands, e-mail: dev-h...@maven.apache.org
>>
>>
>
>
> --
>
> --
> Lennart Jörelid
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org
