Re: First pass for LDP-Author-Guide

[Stein Gjoen <sgjoen@mail.nyx.net>]

Dan York wrote:

> 13. As a potential new HOWTO author, it would be extremely helpful
>     if there was a "template" SGML document available that I could
>     download, open up, and start editing.  It seems that most of
>     the HOWTOs have similar sections... like an "About this Guide",
>     Feedback, Copyrights and Trademarks, Acknowledgements and Thanks, etc.
>     There's also a basic way that it seems you want a section/chapter
>     to be created. The template could include the tags to start a
>     couple of sections.

Such a template does exist. I wrote one in LinuxDoc DTD, available as
	SGML http://www.nyx.net/~sgjoen/template.sgml
	HTML http://www.nyx.net/~sgjoen/template.html
and it has also been translated into DocBook DTD. I wrote it to be
included or at least referenced from the author's section of the
LinuxDoc site. BTW it was updated recently with an updated copyright.

>     If someone could create a shell of a HOWTO, with stuff like
>     "YOUR NAME HERE" or other obvious pointers of stuff to change,
>     then newbies to DocBook like me can download that, open it up,
>     make the appropriate changes, and start writing.

The Template can be used for that, some guidelines are in <em></em>
with sample text in plain font. Additionally the SGML is commented
to show you how you go about producing links, tables and more. It
was made by extracting the structure of my Multi Disk HOWTO
	http://www.nyx.net/~sgjoen/disk.html
so it is based on a practical case of a large HOWTO.

>     If such a template exists, I apologize but I don't know about it.
>     It would be very helpful if there was a link to such a template
>     here.

My home page containsa few other miscellania on LDP, see
	http://www.nyx.net/~sgjoen/home.html

Regards,
   Stein Gjoen


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org