OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] reference man pages as both seperate files +linked into one document

What I've done for my large documents is create a single master file, and then inserted most of the content in logically divided chunks which are entities. For me, I've used a book in three parts, and each <chapter> is a single file. A part would look like this:
<title>Part One</title>

>From there, it's relatively easy to treat the chapters as standalone documents (just add a DTD for "chapter" and it's independent; comment it out and it's part of the master document), or to convert them into another format all at once.


On Tue, 2004-02-24 at 10:51 -0800, Mike Cooper wrote:

That's good to know.  Unfortunately we have too much data to put in a single 
file and still manage it easily.

Thanks for the info though!


Michael Smith wrote:
> Mike Cooper <mcooper@MagniComp.com> writes:
>>I'm trying to create a number of reference (UNIX) man pages for seperate 
>>commands.  I need to have these each be a standalone document so I can 
>>create UNIX *roff man page files (using docbook2X), but also I need to 
>>create a single master "Reference Guide" which includes all of the 
>>otherwise standalone reference docs.  What's the best way of doing this?
> Keep them all in the same single master doc/file. You don't need to have
> them be standalone documents in order to use docbook2X. docbook2X
> automatically writes out a separate man page for each Refentry chunk it
> finds in your document. If it's not doing that, something's wrong.

To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]