Re: [xml] include XML file in another XML file

[Tomasz Kłoczko <kloczek rudy mif pg gda pl>]

On Fri, 22 Apr 2005, Thomas Schraitle wrote:
[..]
> As far as I can see from a quick look it is not well-formed:
>
> --- gdm.1 file ---
> <!DOCTYPE REFENTRY PUBLIC
> "-//Sun Microsystems//DTD DocBook V3.0-Based
> SolBook Subset V2.0//EN"
> ...
> ------------------
>
> You can't have the DOCTYPE declaration here, if you include this file from
> "gdmchooser.1".

I'll try describe what I'm tring to do in another way and what is my 
relal "problem :)
I want prepare some kind of temaplate solution which can be resused in 
many projests for maintain man pages documentation.

Final targer is: prepare man tool which will generate roff output (not 
rendered roff file but rendered output browsable by pager like more, less,
most) without [g]roff tool. All this must have possibilities also for
maintaining translated documentation.

First stage of this is prepare infrastructure for trannslation .. now it 
is ease using xml2po tool:

 (1)          (2)
 XML -------- <project>-man-pages.pot
  |            |.||
  |            |.||
  |            |.||                 (3)       (4)
  |            |.|+-<lang1>.po ---- XML ---> roff (translated to lang1)
  +--------------------------------/
  |            |.+--<lang2>.po ---- XML ---> roff (translated to lang2)
  +--------------------------------/
  .            ..
  .            .
  |            +----<langN>.po ---- XML ---> roff (translated to langN)
  +--------------------------------/
  +----------------------------------------- roff (english)

(1) source XML man pages in english

(2) reference .pot file for translate generated using:
    $ xml2po -o <project>-man-pages.pot <man1>.xml <man2>.xml

(3) translated XML documents generated using:
    $ xml2po -p <lang>.po <man1>.xml > <lang>/<man1>.xml

(4) roff files rendered xsltproc

For prepare all above some trings must be added in current 
manpages/docbook.xsl (in progress) but still this not real problem :)

This will allow maintain in any project one reference documents (1). 
Translators will have .po files which will have during mantaining some new 
entries, sometimes some prases will be deleted and sometimes some entries 
will be marked as fuzzy .. this is all what is known by translators.

Using XSLT will allow keep *all* generated roff files in ONE style :)
Also using above will allow make translators work easier .. and all 
translated versions better synced with english reference document.
It will allow prepare all in philosopy like "don't move .. improve" 
because for viewe/print man pages can be used all now avalaible tools.

After this can be done next stage: prepare man tool which will operate 
*directtly* on XML files (like in Solaris). .. but without using [g]roff. 
Using current code from xmlroff probably will allow in future prepare 
this kind of man tool in easier way.

But .. 
Some XML documents like from mine example vipw.xml contains description 
more than one commnad/man subject. Using current man tool and roff this
can be solved very easy by put in man tree file with ".so man8/vipw.8" 
inside man8/vigr.8.

In first variant it can be immplemented this kind man tool on run "man 
vigr" can work like in classic man by looking for known name file in some 
paths. For allow this must be possible generate something like roff .so link.

So my real question is not about SolBook and all around this but is it 
possible prepare neccessary in this varian kind XML .so link file ? :)

One of alternative can be of course also using symlinks .. but for now I 
want collect all possible sulution for this stage for prepare _now_ 
automake suit for allow conditionaly install just generated roff files or 
install XML ones on "make install DESTDIR=</install/prefix>" :)

kloczek
PS. Probably some core of above can be reused for better mantain national TLDP 
projests :)
After generate from current XML HOWTO TLDP files will be probaly possible 
browse all now avalaible HOWTO documetations using .. _man tool_ (by put 
all roff files in man/manh tree and _only_ modify man tool configuration 8_)
--
-----------------------------------------------------------
*Ludzie nie mają problemów, tylko sobie sami je stwarzają*
-----------------------------------------------------------
Tomasz Kłoczko, sys adm @zie.pg.gda.pl|*e-mail: kloczek rudy mif pg gda pl*