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
