On Wed, 2006-11-22 at 14:50, Paul Traina wrote:
> Mike Noyes wrote:
> > I believe, an even better solution is using DocBook XInclude from LEAF
> > to the Shorewall site. This is only possible if you're using DocBook XML
> > <reference> to generate man pages, and the docbook xml source is
> > available via uri.
>
> The only problem with that idea that I can think of, is that it
> vulnerable to Tom changing URLs or updating the documentation for
> Shorewall while we have not updated or changed ours.
Paul,
A broken XInclude would fail validation. It shouldn't go longer than a
day without notice. Also, our doc-build.sh script is robust enough to
bail on error, and leave the current documentation alone.
http://leaf.cvs.sourceforge.net/leaf/sourceforge/admin/doc-build.sh?revision=1.13&view=markup
Again, this is provided you have the docbook reference source available
via uri. DocBook XInclude won't work otherwise.
Note: this solution will provide LEAF a local current xslt->html
version of the Shorewall docbook reference (man page).
> Up to you.
Are you using DocBook v5, or 4.4? I haven't had time to learn the new v5
tool chain. The move to schema (RELAX NG) and XSLT 2 are both going to
require considerable time/effort to learn properly.
--
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: leaf, phpwebsite, phpwebsite-comm, sitedocs
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys - and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
leaf-devel mailing list
leaf-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/leaf-devel
