127 lines
4.6 KiB
HTML
127 lines
4.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: LinuxDoc templates -->
|
|
<!--X-From-R13: Rnivq Znjlre <qnirNynsa.bet> -->
|
|
<!--X-Date: Sat, 15 Jul 2000 17:47:13 -0400 (EDT) -->
|
|
<!--X-Message-Id: 20000715144741.B134@localhost -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>LinuxDoc templates</title>
|
|
<link rev="made" href="mailto:dave@lafn.org">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03255.html">Date Prev</a>][<a href="msg03257.html">Date Next</a>][<a href="msg03253.html">Thread Prev</a>][<a href="msg03260.html">Thread Next</a>][<a href="maillist.html#03256">Date Index</a>][<a href="threads.html#03256">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>LinuxDoc templates</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
|
|
<li><em>Subject</em>: LinuxDoc templates</li>
|
|
<li><em>From</em>: David Lawyer <<A HREF="mailto:dave@lafn.org">dave@lafn.org</A>></li>
|
|
<li><em>Date</em>: Sat, 15 Jul 2000 14:47:42 -0700</li>
|
|
<li><em>Mail-followup-to</em>: ldp-discuss@lists.linuxdoc.org</li>
|
|
<li><em>Resent-date</em>: Sat, 15 Jul 2000 17:47:13 -0400 (EDT)</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Resent-message-id</em>: <OqzInD.A.83C.KwNc5@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
|
|
<li><em>User-agent</em>: Mutt/1.0pre3i</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
On Wed, Jul 12, 2000 at 01:42:29PM +0200, Stein Gjoen wrote:
|
|
>
|
|
> If you found the tags too cryptic and the docs unclear I would say
|
|
> we have a problem, no matter who you might be. I wrote the original
|
|
> LinuxDoc DTD Template and would like feedback from you and anyone
|
|
> else who have found anything unclear.
|
|
>
|
|
|
|
We have a proliferation of templates. There is the original
|
|
example.sgml dated 1994 by Mat Welsh. It needs improvement but may be
|
|
the best one so far. Then there is the revision of this by Taketoshi
|
|
Sano. There is also Stein Gjoen's template which serves the same
|
|
purpose. I've also started some drafts.
|
|
|
|
I think we need a few different templates. But they should all be in
|
|
a unified series. I've written a very elementary one (lesson 1 =
|
|
example1.sgml). It only uses only 5 tags (article>, <title>,
|
|
<author>, <sect>, <p> (paragraph). It assumes that the reader has no
|
|
idea what a tag is, etc.
|
|
|
|
Then the next one: example2.sgml will introduce some more tags so that
|
|
one may write a short and simple HOWTO. Then example3.sgml would
|
|
cover topics such as lists, fonts, etc. so that one may write a long
|
|
HOWTO. example4.sgml would cover more advanced topics such as tables
|
|
and keywords.
|
|
|
|
Each higher numbered example would include all the tags
|
|
introduced in lower numbered examples, but would not explain them
|
|
much. Then there would be a reference example that would have all the
|
|
tags of the other examples but with very terse explanations. It would
|
|
be used by persons who have first gone thru the other examples but
|
|
have forgotten some tags.
|
|
|
|
The text of these examples only explains the use of the tags. It
|
|
doesn't explain anything about the reasons for sgml, what a DTD is, or
|
|
even the coversion commands such as sgml2html. It's sole purpose is
|
|
to enable one to create a document in LinuxDoc.
|
|
|
|
David Lawyer
|
|
|
|
|
|
--
|
|
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
|
|
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
|
|
|
|
</pre>
|
|
|
|
<!--X-Body-of-Message-End-->
|
|
<!--X-MsgBody-End-->
|
|
<!--X-Follow-Ups-->
|
|
<hr>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg03255.html">Re: Network Administrators Guide</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03257.html">Feedback</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03253.html">Re: Document preparation help</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03260.html">New lurker to the list(:</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03256"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03256"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|