cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ovidiu Predescu <ovi...@cup.hp.com>
Subject Re: Documentation: short alternative to @docname@?
Date Thu, 25 Oct 2001 16:40:32 GMT
On Wed, 24 Oct 2001 18:36:45 +0200, "Gianugo Rabellino" <gianugo@rabellino.it> wrote:

> > > while writing the user documentation I came across quite often
> > > to the need of writing "Cocoon" instead than "Apache Cocoon" for
> > > fluency and readability. Since I'm stricly sticking to the use
> > > of @docname@ and @doctitle@, I'm unwilling to write the "Cocoon"
> > > term directly in the phrase: couldn't it be the case to have
> > > another macro that expands to "Cocoon" only ("shortname" or
> > > "appname" maybe)?
> > In the XML documents I write, I use simple XML elements, which I
> > transform to the right content using a stylesheet. The example you
> > give would look something like this:
> 
> This is a good suggestion Ovidiu, but I'm looking for a more general
> solution that integrates well with the actual setup. Using these "xml
> macros" is fine, but in that case I'd rather stick to my .vimrc (no,
> it's not a .emacs, I still have to see the light ;-P) to save keystrokes
> and use custom placeholders... anyway, it stands as a good point :)

[offtopic] As with Cocoon, seeing the light often takes a little bit
of time and patience. Try XEmacs for a shorter path to
illumination. ;-)

> (a question - haven't tried it myself: how can you manage to strip the
> "term" namespace declaration from the resulting doc? Is it something
> being done by the XML serializer who recognizes that after the
> transformation there are no "term" prefixed element left or will you end
> up with a document that - redundantly - declares this namespace?).

You can use the exclude-result-prefixes attribute of the
xsl:stylesheet element. Just add the prefixes to be excluded separated
by spaces. Of course the resulting document should not need those
prefixes, otherwise the XSLT processor will still output them.

Regards,

-- 
Ovidiu Predescu <ovidiu@cup.hp.com>
http://orion.rgv.hp.com/ (inside HP's firewall only)
http://sourceforge.net/users/ovidiu/ (my SourceForge page)
http://www.geocities.com/SiliconValley/Monitor/7464/ (GNU, Emacs, other stuff)

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


Mime
View raw message