 elements, would warrant that feature even to
formats where classes cannot be set (due to some limitations of the
language).

Suggesting our users to port their existing sites to xdoc to have the
prettification feature wouldn't be so nice - the maven site itself is
written in APT and is a lot of documentation! - so what I suggest is
trying to understand when is not appropriate applying the current
document modification.
Maybe the License page - and few other cases that I don't know - are
just exceptions.

My 2 cents,
Simo

http://people.apache.org/~simonetripodi/
http://simonetripodi.livejournal.com/
http://twitter.com/simonetripodi
http://www.99soft.org/



2011/10/18 Ivan Habunek :
> Hi,
>
> One problem with using APT for writing docs is that code can only be
> included within the +-- tags. This is rendeder as two nested elements  class="source"> Then you add the prettpyrint class by javascript to all
>  elements within  elements.
>
> This does not allow for non-prettified  blocks and makes some pages
> look pretty weird, e.g.:
> http://people.apache.org/~olamy/maven/site/license.html
>
> The only reasonable alternative i discovered is using XDOC and specifying
> your own blocks as either:
> a) > b) > c) >
> This allows for much more flexibility, but requires usage of XDOC format to
> have code prettification. APT +-- syntax always produces plain  blocks.
>
> Again, the problem is that maven transforms  to
>  (why o why?) but this can also be fixed by
> javascript.
>
> To conclude, I'm migrating most of log4php docs to XDOC format because of
> this and some other APT limitations. It is a bit more difficult to write,
> but it is more flexible.
>
> If you like the solution I can transfer it to the sandbox.
>
> Regards,
> Ivan
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org