old-www/pub/Linux/docs/ldp-archived/mail_archives/ldp-docbook/msg00260.html

147 lines
5.8 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: linuxdoc / docbook question -->
<!--X-From-R13: "Uert Trethfba" <tsretNubbc.gvzbavhz.ftv.pbz> -->
<!--X-Date: Sat, 9 Sep 2000 17:03:38 &#45;0400 (EDT) -->
<!--X-Message-Id: 10009091703.ZM24084@hoop.timonium.sgi.com -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: 000501c01a04$6f5c86a0$1c8f28d8@talcon1 -->
<!--X-Reference: randy@talcon.com -->
<!--X-Head-End-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>Re: linuxdoc / docbook question</title>
<link rev="made" href="mailto:gferg@hoop.timonium.sgi.com">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg00259.html">Date Prev</a>][<a href="msg00261.html">Date Next</a>][<a href="msg00259.html">Thread Prev</a>][<a href="msg00261.html">Thread Next</a>][<a href="maillist.html#00260">Date Index</a>][<a href="threads.html#00260">Thread Index</a>]
<!--X-TopPNI-End-->
<!--X-MsgBody-->
<!--X-Subject-Header-Begin-->
<h1>Re: linuxdoc / docbook question</h1>
<hr>
<!--X-Subject-Header-End-->
<!--X-Head-of-Message-->
<ul>
<li><em>To</em>: &quot;Randy Tata&quot; &lt;<A HREF="mailto:randy@talcon.com">randy@talcon.com</A>&gt;, &lt;<A HREF="mailto:ldp-docbook@lists.linuxdoc.org">ldp-docbook@lists.linuxdoc.org</A>&gt;, <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
<li><em>Subject</em>: Re: linuxdoc / docbook question</li>
<li><em>From</em>: &quot;Greg Ferguson&quot; &lt;<A HREF="mailto:gferg@hoop.timonium.sgi.com">gferg@hoop.timonium.sgi.com</A>&gt;</li>
<li><em>Date</em>: Sat, 9 Sep 2000 17:03:36 -0400</li>
<li><em>In-reply-to</em>: &quot;Randy Tata&quot; &lt;randy@talcon.com&gt; &quot;linuxdoc / docbook question&quot; (Sep 8, 10:19pm)</li>
<li><em>References</em>: &lt;<a href="msg00259.html">000501c01a04$6f5c86a0$1c8f28d8@talcon1</a>&gt;</li>
<li><em>Resent-date</em>: Sat, 9 Sep 2000 17:03:38 -0400 (EDT)</li>
<li><em>Resent-from</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
<li><em>Resent-message-id</em>: &lt;MISUCB.A.HSC.IYqu5@murphy&gt;</li>
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-docbook-request@lists.debian.org">ldp-docbook-request@lists.debian.org</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
&gt; I've written a HOWTO about setting up a software based CD Server
&gt; under Linux. I originally wrote it in word, then grabbed the first
&gt; template from the LDP Author Guide and copied/pasted everything
&gt; into the template (in vim). The template I used was the &quot;linuxdoc&quot;
&gt; template. The problem is that when I tried using jade to render
&gt; to HTML, there were tons of errors, unsupported tags, etc. Apparently
&gt; the template I grabbed was the wrong one, and I should have grabbed
&gt; the &quot;docbook&quot; template ????
Yes, that is true. There are no DSSSL stylesheets available for
transforming a linuxdoc SGML instance into it's various output
formats using the jade engine (at least nothing I know of).
If you wish to keep the document in the old linuxdoc DTD, then
there is a different toolset you can use to process the content:
LinuxDoc-Tools
Sano Taketoshi &lt;sano@debian.org&gt;
<A HREF="http://www.debian.org/~sano/linuxdoc-tools/">http://www.debian.org/~sano/linuxdoc-tools/</A>
&gt; I really have spent a lot of time writing this howto, and will
&gt; transcribe it all to the other template if I must. Would it
&gt; be easier to render the different formats if I use the &quot;docbook&quot;
&gt; template??
Well, the tools I have pointed out are pretty easy to use.
There are some limitations in using the linuxdoc DTD over
DocBook - lack of table support, lack of graphics/images -
are two that come immediately to mind. The LDP supports both
the linuxdoc and DocBook DTDs although we *recommend* (but
don't force!) using DocBook for any HOWTOs under development.
If you go to DocBook, then yes, you should be able to use
jade, DSSSL, etc. (the tools you currently have installed).
There is a linxudoc to DocBook translation filter that
utilizes the jade engine; although I recommend that you
look over (and possibly edit) the filtered output if you
use it:
from Reuben Thomas' pages:
DocBook hints / Converting LinuxDoc to DocBook
<A HREF="http://www.cl.cam.ac.uk/~rrt1001/docbook.html">http://www.cl.cam.ac.uk/~rrt1001/docbook.html</A>
regards,
--
Greg Ferguson - s/w engr / mtlhd | gferg@sgi.com
SGI Tech Pubs - <A HREF="http://techpubs.sgi.com">http://techpubs.sgi.com</A> |
Linux Doc Project - <A HREF="http://www.linuxdoc.org">http://www.linuxdoc.org</A> |
--
To UNSUBSCRIBE, email to ldp-docbook-request@lists.debian.org
with a subject of &quot;unsubscribe&quot;. 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-->
<ul><li><strong>References</strong>:
<ul>
<li><strong><a name="00259" href="msg00259.html">linuxdoc / docbook question</a></strong>
<ul><li><em>From:</em> &quot;Randy Tata&quot; &lt;randy@talcon.com&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg00259.html">linuxdoc / docbook question</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg00261.html">broken link in HOWTO-HOWTO</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg00259.html">linuxdoc / docbook question</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg00261.html">broken link in HOWTO-HOWTO</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#00260"><strong>Date</strong></a></li>
<li><a href="threads.html#00260"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>