170 lines
7.5 KiB
HTML
170 lines
7.5 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
||
<!--X-Subject: Re: restructuring -->
|
||
<!--X-From-R13: Xbetr Ubqbl <tbqblNpbarpgvin.pbz.oe> -->
|
||
<!--X-Date: Mon, 14 Feb 2000 09:20:41 -0500 (EST) -->
|
||
<!--X-Message-Id: 20000214103406.I15687@conectiva.com.br -->
|
||
<!--X-Content-Type: text/plain -->
|
||
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF077F7C2B@email.cu-portland.edu -->
|
||
<!--X-Head-End-->
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
||
<html>
|
||
<head>
|
||
<title>Re: restructuring</title>
|
||
<link rev="made" href="mailto:godoy@conectiva.com.br">
|
||
</head>
|
||
<body>
|
||
<!--X-Body-Begin-->
|
||
<!--X-User-Header-->
|
||
<!--X-User-Header-End-->
|
||
<!--X-TopPNI-->
|
||
<hr>
|
||
[<a href="msg01452.html">Date Prev</a>][<a href="msg01454.html">Date Next</a>][<a href="msg01560.html">Thread Prev</a>][<a href="msg01457.html">Thread Next</a>][<a href="maillist.html#01453">Date Index</a>][<a href="threads.html#01453">Thread Index</a>]
|
||
<!--X-TopPNI-End-->
|
||
<!--X-MsgBody-->
|
||
<!--X-Subject-Header-Begin-->
|
||
<h1>Re: restructuring</h1>
|
||
<hr>
|
||
<!--X-Subject-Header-End-->
|
||
<!--X-Head-of-Message-->
|
||
<ul>
|
||
<li><em>To</em>: Gregory Leblanc <<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>></li>
|
||
<li><em>Subject</em>: Re: restructuring</li>
|
||
<li><em>From</em>: Jorge Godoy <<A HREF="mailto:godoy@conectiva.com.br">godoy@conectiva.com.br</A>></li>
|
||
<li><em>Date</em>: Mon, 14 Feb 2000 10:34:07 -0200</li>
|
||
<li><em>Cc</em>: "Ldp-Discuss \(E-mail\)" <<A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A>></li>
|
||
<li><em>In-reply-to</em>: <<a href="msg01437.html">A5F46F4ED18FD211ABEE00105AC6CF077F7C2B@email.cu-portland.edu</a>>; from GLeblanc@cu-portland.edu on Sun, Feb 13, 2000 at 12:40:04PM -0800</li>
|
||
<li><em>Mail-followup-to</em>: Gregory Leblanc <GLeblanc@cu-portland.edu>,"Ldp-Discuss (E-mail)" <ldp-discuss@lists.linuxdoc.org></li>
|
||
<li><em>References</em>: <<a href="msg01437.html">A5F46F4ED18FD211ABEE00105AC6CF077F7C2B@email.cu-portland.edu</a>></li>
|
||
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
||
<li><em>Resent-date</em>: 14 Feb 2000 12:36:50 -0000</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>: <h0y25B.A.JXD.gb_p4@murphy></li>
|
||
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-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>
|
||
On Sun, Feb 13, 2000 at 12:40:04PM -0800, Gregory Leblanc wrote:
|
||
|
||
> What will go into the LDP/DocBook directory? Will that be our home for
|
||
> documents originally authored in DocBook? What are the advantages of
|
||
> converting LinuxDoc documents to DocBook via a script? All of the output
|
||
> formats that we use can be created from either DocBook or LinuxDoc source,
|
||
> correct?
|
||
|
||
I think that DocBook SGML documents would go in there.
|
||
Documents originally authored in DocBook will be in that directory,
|
||
together with douments converted from LinuxDoc.
|
||
The only advantage I see for a script conversion is speed. And,
|
||
besides, the author of the LinuxDoc version can take a look at the
|
||
DocBook version and start maintaining and improving it's document
|
||
right in DocBook and then conversion will be no more needed.
|
||
All output generated is not all we can use with DocBook. DocBook has
|
||
much more tags than LinuxDoc and when translating from a limited code
|
||
to another not so limited all we can do is one-by-one
|
||
conversion. There's no context conversion and there's plenty room for
|
||
improvements in the output. But, this same output is a very good
|
||
beginning.
|
||
|
||
> If they're equivalent, perhaps we should allow DocBook source for
|
||
> any documents, and put only native DocBook documents in
|
||
> LDP/HOWTO/sgml-source/DocBook and cousins. The
|
||
> LDP/HOWTO/sgml-source/LinuxDoc directory should contain native LinuxDoc
|
||
> sources. I just thought of another reason to have the LinuxDoc to DocBook
|
||
> translations. Having those translations will make it easier for authors
|
||
> (when the time comes) to start writing in DocBook instead. I would like to
|
||
> see the LDP/DocBook directory go away, and become part of the
|
||
> document type
|
||
|
||
Me too. I would like to see just one directory but, with DocBook,
|
||
author's may use graphics and pictures. I think it's better having a
|
||
separate directory for DocBook documents and placing each document in
|
||
it's own directory. See that a directory for each document is a
|
||
generalization for documents with it's own pictures. For proper
|
||
formatting, authors should use relative paths and keep pictures and
|
||
graphics below this directory.
|
||
|
||
> directories. Perhaps the best way to keep things clean would be to create
|
||
> an sgml-source directory with three subfolders. The first, DocBook, to hold
|
||
> native DocBook directories. The second, LinuxDoc, to hold native LinuxDoc
|
||
> documents. The third, LinuxDoc2DocBook, to hold DocBook documents that were
|
||
> translated from LinuxDoc. I think that this is a better long-term strategy,
|
||
> so that we don't have to change things again very soon. I'm going to go
|
||
> read the FSSTND and FHS today, to see where things should go. Once
|
||
> we have
|
||
|
||
Why creating this third directory? Documents, even when converted to
|
||
DocBook, have only two types: DocBook or LinuxDoc. I think that
|
||
maintaining this third directory is adding more management problems
|
||
than needed.
|
||
|
||
> things hammered out into a final format, we should start to contact the
|
||
> maintainers of the many distributions to ask them to move things around to
|
||
> work with our new layout. I'll volunteer to do this, but I'm getting ahead
|
||
> of myself here. Let's have some comments, either agree or disagree, I'd
|
||
> just like to see more than three or four opinions. Thanks,
|
||
|
||
As Guylhem said and explained we'll have to contact them. The
|
||
mirroring size is increasing. Our mirror has something near 135MB (was
|
||
that size on Friday).
|
||
|
||
--
|
||
Godoy. <godoy@conectiva.com.br> GPG Fingerprint
|
||
851B B620 626D 2AD0 E783
|
||
"Ser poeta n<>o <20> minha ambi<62><69>o, E932 1330 BE6D A4A3 0625
|
||
<20> minha maneira de estar sozinho"
|
||
- Fernando Pessoa. Publica<63><61>es @ Conectiva S.A.
|
||
|
||
Except where explicitly stated I speak on my own behalf.
|
||
Exceto onde explicitado as declara<72><61>es aqui feitas s<>o apenas minhas.
|
||
|
||
|
||
--
|
||
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-->
|
||
<ul><li><strong>References</strong>:
|
||
<ul>
|
||
<li><strong><a name="01437" href="msg01437.html">RE: restructuring</a></strong>
|
||
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
||
</ul></li></ul>
|
||
<!--X-References-End-->
|
||
<!--X-BotPNI-->
|
||
<ul>
|
||
<li>Prev by Date:
|
||
<strong><a href="msg01452.html">Re: sgmltools v1</a></strong>
|
||
</li>
|
||
<li>Next by Date:
|
||
<strong><a href="msg01454.html">Re: LDP integration with LWN and Freshmeat</a></strong>
|
||
</li>
|
||
<li>Previous by thread:
|
||
<strong><a href="msg01560.html">Re: restructuring</a></strong>
|
||
</li>
|
||
<li>Next by thread:
|
||
<strong><a href="msg01457.html">Re: restructuring</a></strong>
|
||
</li>
|
||
<li>Index(es):
|
||
<ul>
|
||
<li><a href="maillist.html#01453"><strong>Date</strong></a></li>
|
||
<li><a href="threads.html#01453"><strong>Thread</strong></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<!--X-BotPNI-End-->
|
||
<!--X-User-Footer-->
|
||
<!--X-User-Footer-End-->
|
||
</body>
|
||
</html>
|