[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: How to make "Debian Reference" as scalable SGML

On Tue, Feb 12, 2002 at 09:05:11AM -0800, Osamu Aoki wrote:
> On Tue, Feb 12, 2002 at 03:19:00PM +0100, Josip Rodin wrote:
> > 
> > The Installation manual (debian-boot repository, directory
> > boot-floppies/documentation) and
> Yes this one was a good start and my document is following this
> structure.  I made all parent SGML files to be auto generated from a
> single template file by a "sed" script in Makefile.  This was small
> improvement since I only need to maintain one parent file template when
> a chapter was added or chapter order needed to be changed.
> This structure still requires cut-and-paste and editing of contents
> across all language files if, for example, one wants to move one section
> in <sect> to to another section and make it into <chapt> when document
> grows its content.
> > the FAQ (debian-doc repo, directory manuals.sgml/faq) are examples of
> > how to split things into several files.
> This is similar in concept but file organization is not as nice as
> boot-floppies.
> > I'm not sure if that's exactly what you want but it seems similar
> > enough.
> Thanks:)  But these approaches were not sufficient for me.
> See my other posting for what I am planning.  problem is there are about
> 200 plus <chapt>, <sect>, <sect1> already exist and that makes 200 plus
> separate files for all 3 languages.  (Already Spanish may be added to
> make it 4.)
> I think this is the only simple solution to enable content
> reorganization without making process too complicated.  KISS.

My .02: boot-floppies is just one chapter per document. I can see
where putting one sect in each document might be advantageous; but I
would leave further subdivisions inside the docs (not go down to
sect1). Too often, one wants to easily create new subsections; and it
would be rather more difficult to keep updating the 'contents' file
when writing.

*------v--------- Installing Debian GNU/Linux 3.0 --------v------*
|      <http://www.debian.org/releases/woody/installmanual>      |
|   debian-imac (potato): <http://debian-imac.sourceforge.net>   |
|            Chris Tillman        tillman@azstarnet.com          |
|                   May the Source be with you                   |

Reply to: