This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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:
<part>
<title>Part One</title>
&chapter1;
&chapter2;
&chapter3;
</part>

>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.

a.


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!

	mike

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/.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]