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

Re: Procedure for uploading new material?

"Oliver Elphick" <olly@lfix.co.uk> writes:

> I've incorporated the suggested changes.  Should I continue to upload 
> through the list?  It is certainly likely that there will be further
> changes, after all.

Would it be possible to set up a home page at your ISP and put it
under there (both source and HTML)?  That way the latest version is
easy accessible for everybody. 

>   >
>   >As far as the integration is concerned, you could keep your chapter in
>   >a separate file and write in another file an empty framework to keep
>   >SGML happy.  Using so-called entities you "include" your chapter into
>   >the framework.  That's how I'm organizing the manual to keep including
>   >source updates easy. 
> That's what I did; the particular point I had was that I had to alter
> debiandoc.dtd in order to define the entity for inclusion into the
> skeleton manual.  That seems quite undesirable.  Have I misunderstood
> how to do this in SGML?

Yes, since you can very easy declare your own entities outside the DTD
by following these steps: 

1. create a file containing the following declaration: 

	<!entity Basics	system "basics.sgml">
                 ^^^^^^         ^^^^^^^^^^^
              entity name       file with entity contents

   (add as much declarations as you need)

2. include this file in the main document as follows: 

	<!doctype debiandoc system
	   <!entity % entities system "user.entities">
                                    file with entity declarations

   ("user.entities" is just a random name for the file :-)

3. use the entity declaration as 

	&entity name; 

   e.g. as follows: 


That's all.  Hope this helps!



Ardo van Rangelrooij
home email: ardo.van.rangelrooij@tip.nl, ardo@debian.org
home page:  http://www.tip.nl/users/ardo.van.rangelrooij
PGP fp:     3B 1F 21 72 00 5C 3A 73  7F 72 DF D9 90 78 47 F9

TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
debian-doc-request@lists.debian.org . 
Trouble?  e-mail to templin@bucknell.edu .

Reply to: