You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@forrest.apache.org by Nicola Ken Barozzi <ni...@apache.org> on 2003/02/05 16:47:46 UTC
Enabling Docbook sources
We have an initial docbook2document.xsl stylesheet and I want to enable
it in our sitemap, via the sourcetype thing.
The point is that we validate all docs, and so the docbook sources (I'm
using 4.1 now) aren't included in the catalog.
What should I put them? (ie which dir/subdir).
Any pointers about how to do it?
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
Re: Enabling Docbook sources
Posted by Nicola Ken Barozzi <ni...@apache.org>.
Jeff Turner wrote, On 06/02/2003 0.01:
> On Wed, Feb 05, 2003 at 04:47:46PM +0100, Nicola Ken Barozzi wrote:
>
>>We have an initial docbook2document.xsl stylesheet and I want to enable
>>it in our sitemap, via the sourcetype thing.
>
> Does the stylesheet actually work sufficiently to be useful? The
> original author seemed a bit skeptical (see comments at the top).
Yeah, read it. Actually, I'm not sure if it's the right approach, but
it's exactly why I want to enable it. Until it's enabled, I'm afraid
nobody will look at it.
Anyway, I wish to enable it for a real reason, that is to render the
"developing with Avalon" stuff in Avalon, which is in docbook. So I will
hopefully fix the most evident errors in the stylesheet (ATM I'm fixing
validation errors 8-)
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
Re: Enabling Docbook sources
Posted by Jeff Turner <je...@apache.org>.
On Wed, Feb 05, 2003 at 04:47:46PM +0100, Nicola Ken Barozzi wrote:
>
> We have an initial docbook2document.xsl stylesheet and I want to enable
> it in our sitemap, via the sourcetype thing.
Does the stylesheet actually work sufficiently to be useful? The
original author seemed a bit skeptical (see comments at the top).
--Jeff
> The point is that we validate all docs, and so the docbook sources (I'm
> using 4.1 now) aren't included in the catalog.
>
> What should I put them? (ie which dir/subdir).
> Any pointers about how to do it?
Re: Enabling Docbook sources
Posted by David Crossley <cr...@indexgeo.com.au>.
Nicola Ken Barozzi wrote:
>
> We have an initial docbook2document.xsl stylesheet and I want
> to enable
> it in our sitemap, via the sourcetype thing.
>
> The point is that we validate all docs, and so the docbook
> sources (I'm
> using 4.1 now) aren't included in the catalog.
>
> What should I put them? (ie which dir/subdir).
> Any pointers about how to do it?
See the temporary document for the Forrest-isation of
xml-commons docs.
http://cvs.apache.org/~crossley/commons/howto-forrest.html
The "entity resolver" docs are in DocBook and they are
processed with the DocBook DTDs and stylesheets.
The only thing that i had to do was in forrest.properties
project.catalog=/usr/share/sgml/docbook/xmlcatalog
However, there was a bug with the docbook/xmlcatalog
on my Linux. Please ask if you strike it.
--David
Re: Enabling Docbook sources
Posted by David Crossley <cr...@indexgeo.com.au>.
Nicola Ken Barozzi wrote:
> Steven Noels wrote,
> > Nicola Ken Barozzi wrote:
> >>
> >> We have an initial docbook2document.xsl stylesheet and I want to
> >> enable it in our sitemap, via the sourcetype thing.
> >>
> >> The point is that we validate all docs, and so the docbook sources
> >> (I'm using 4.1 now) aren't included in the catalog.
> >>
> >> What should I put them? (ie which dir/subdir).
The arrangement that you have come up with seems fine.
There was an unfinished thread about how to manage
sets of such external DTDs and stylesheets.
http://marc.theaimsgroup.com/?l=forrest-dev&m=104193531407115
One idea was to have some mechanism to download them and
install when required. I would still like to have that
mechanism, as well as shipping some popular sets of resources
by default.
So would Forrest just distribute the most recent versions?
--David
Re: Enabling Docbook sources
Posted by Nicola Ken Barozzi <ni...@apache.org>.
Steven Noels wrote, On 05/02/2003 17.18:
> Nicola Ken Barozzi wrote:
>
>>
>> We have an initial docbook2document.xsl stylesheet and I want to
>> enable it in our sitemap, via the sourcetype thing.
>
> 2 times cool!
When are we going to get Openoffice format support with embedded SVG? ;-)
>> The point is that we validate all docs, and so the docbook sources
>> (I'm using 4.1 now) aren't included in the catalog.
>>
>> What should I put them? (ie which dir/subdir).
>
> src\resources\schema\dtd\docbook{version} - given the complexity of db,
> we might go for:
>
> src\resources\schema\dtd\docbook\4.1\
> src\resources\schema\dtd\docbook\{vx}
Ok, fine. What about the entities?
What about:
src\resources\schema\docbook\4.1\dtd
src\resources\schema\docbook\4.1\entities
Actually, they are now (locally):
dtd/*
dtd/ent/*
so probably I would do the -less-hassle- version and go with
src\resources\schema\docbook\4.1\dtd
src\resources\schema\docbook\4.1\dtd\ent
What do our catalogue gurus have to say?
>> Any pointers about how to do it?
>
> add entries in the catalog and it should work.
>
> for the sourcetype thingy, there's an example in the sitemap IIRC
That's done already on my HD (really easy to set up, really easy )and it
works with locally available dtds. We still need to move other xml DTDs
there too BTW.
> very nice addition!
>
> </Steven>
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
Re: Enabling Docbook sources
Posted by Steven Noels <st...@outerthought.org>.
Nicola Ken Barozzi wrote:
>
> We have an initial docbook2document.xsl stylesheet and I want to enable
> it in our sitemap, via the sourcetype thing.
2 times cool!
> The point is that we validate all docs, and so the docbook sources (I'm
> using 4.1 now) aren't included in the catalog.
>
> What should I put them? (ie which dir/subdir).
src\resources\schema\dtd\docbook{version} - given the complexity of db,
we might go for:
src\resources\schema\dtd\docbook\4.1\
src\resources\schema\dtd\docbook\{vx}
> Any pointers about how to do it?
add entries in the catalog and it should work.
for the sourcetype thingy, there's an example in the sitemap IIRC
very nice addition!
</Steven>
--
Steven Noels http://outerthought.org/
Outerthought - Open Source, Java & XML Competence Support Center
Read my weblog at http://blogs.cocoondev.org/stevenn/
stevenn at outerthought.org stevenn at apache.org