228 lines
8.8 KiB
HTML
228 lines
8.8 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: First pass for LDP-Author-Guide -->
|
|
<!--X-From-R13: [nex Ybznevafxv <znexxNptvcp.pbz> -->
|
|
<!--X-Date: Wed, 28 Jun 2000 07:40:21 -0400 (EDT) -->
|
|
<!--X-Message-Id: 3959E424.60C498E8@cgipc.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 3958ABD8.4F171F49@cgipc.com -->
|
|
<!--X-Reference: 00062720534604.02953@charles -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: First pass for LDP-Author-Guide</title>
|
|
<link rev="made" href="mailto:markk@cgipc.com">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03062.html">Date Prev</a>][<a href="msg03064.html">Date Next</a>][<a href="msg03077.html">Thread Prev</a>][<a href="msg03068.html">Thread Next</a>][<a href="maillist.html#03063">Date Index</a>][<a href="threads.html#03063">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: First pass for LDP-Author-Guide</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: jdd <<A HREF="mailto:jdanield@dodin.net">jdanield@dodin.net</A>></li>
|
|
<li><em>Subject</em>: Re: First pass for LDP-Author-Guide</li>
|
|
<li><em>From</em>: Mark Komarinski <<A HREF="mailto:markk@cgipc.com">markk@cgipc.com</A>></li>
|
|
<li><em>Date</em>: Wed, 28 Jun 2000 07:40:20 -0400</li>
|
|
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
|
|
<li><em>References</em>: <<a href="msg03054.html">3958ABD8.4F171F49@cgipc.com</a>> <<a href="msg03058.html">00062720534604.02953@charles</a>></li>
|
|
<li><em>Reply-to</em>: <A HREF="mailto:markk@cgipc.com">markk@cgipc.com</A></li>
|
|
<li><em>Resent-date</em>: Wed, 28 Jun 2000 07:40:21 -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>: <6h6WSD.A._nC.7QeW5@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>Sender</em>: <A HREF="mailto:markk@mail.cgipc.com">markk@mail.cgipc.com</A></li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
jdd wrote:
|
|
>
|
|
> I'm just reading your work. First I think this work must be done and that
|
|
> you make a very valuable effort. Don't take any remark for a flame. I'm
|
|
> not fluent in english but want only to help.
|
|
|
|
Got it.
|
|
|
|
> I use linuxdoc now for 2 years and never manage to make docbook run nicely
|
|
> on my PC (may be soon done!).
|
|
>
|
|
> SGML is not XML
|
|
>
|
|
> this paragraph is for me a perfect nonsense (it doesn't mean anything). I
|
|
> heard about XML for now more than one year and never understand exactly
|
|
> what it is :-)
|
|
>
|
|
> some time I see it as a data base format, sometimes as a document one.
|
|
> Only sure it is text and tags. what else?
|
|
|
|
Sounds like XML alright. My impression (someone correct me when I go astray)
|
|
is that XML can store binary data within tags, while SGML cannot. This
|
|
makes XML much better for things like storing pictures, encrypted data, etc.
|
|
Rumor is that MS Word's XML support is just putting their proprietary data
|
|
in XML tags, which doesn't help anyone at all.
|
|
|
|
The SGML paragraph was rather hastily added after the discussion from
|
|
yesterday.
|
|
|
|
> "A catalogue is a text file containing the translation rules of the
|
|
> public identifier to system's files."
|
|
>
|
|
> this (chap 5, creating and modifying catalog) is a perfect example of what
|
|
> should not be done. what is the public identifier?
|
|
|
|
Jorge's first language isn't Engligh either. I don't want to modify too
|
|
much of his stuff to make it sound better (yet) until I get an okay from
|
|
him.
|
|
|
|
> please fine tune the words and langage. HOWTO users are frequently not data
|
|
> processing aware
|
|
>
|
|
> what I mean is that trying to explain a difficult word by a more difficult
|
|
> one is bad. say, f.e.
|
|
> a catalog is a text file. (this I understand : I can read it with vi)
|
|
> In that file are translation rules, that is explainations of how the tags
|
|
> of the source file will be uses to make paragraphs or titles # is it
|
|
> right?
|
|
> I still don't know what is the public identifier to system file ?
|
|
>
|
|
> if, after reading the few example, the pretending author always prentends
|
|
> to use docbook, he's VERY courageous...
|
|
>
|
|
> For New Authors
|
|
>
|
|
> this paragraph is very confusing. It seems to say that "you may write
|
|
> your documentation in the format of your choice"
|
|
>
|
|
> and
|
|
>
|
|
> "another LDP volunteer will translate your document into DocBook"
|
|
>
|
|
> I don't think this is the "normal" subscription method. anyway I will
|
|
> probably very difficult to to this txt to docbook translation (if not, why
|
|
> discuss about docbook!)
|
|
|
|
Ask the powers-that-be. We're hashing this discussion around in another thread
|
|
(or is that one done?). The idea is that if an author doesn't know DocBook, they
|
|
can write it in .txt, send it to the LDP, get it translated into DB, then use
|
|
the LAG to maintain the document.
|
|
|
|
> jade & co
|
|
>
|
|
> this paragraph is horrible.
|
|
>
|
|
> think as you where a very beginner (as of docbook, of course). how can you
|
|
> make a choice between jade and openjade?
|
|
|
|
I can't. Some applications require the use of jade (i.e. autoconf looks
|
|
specifically for jade, others look for both).
|
|
|
|
> we absolutely need a ONE SOURCE rpm (or tgz) that install all this stuff
|
|
> in one step.
|
|
|
|
No no no! Then we're getting into software maintenance and that would
|
|
only increase the existing overhead. RPM-based distros have the Cygnus
|
|
DocBook tools, which includes Jade, the DSSSL, and DB 3.1. I already
|
|
documented this, and also document the "do it by hand" method after installing
|
|
all the tools separately.
|
|
|
|
> "this is the successor to the sgmltools projec"
|
|
>
|
|
> what is the interest of saying this ? oldtimers knows this already and
|
|
> beginners don't have to.
|
|
|
|
I still document sgmltools (for some reason).
|
|
|
|
> I think it would be a VERY goog idea to write an LDP-history-guide (on the
|
|
> Internet all is too soon forgotten), but not here.
|
|
>
|
|
> please, choose betxeen cygnus and sgml_lite, how can I do that ? or at a
|
|
> minimum say: beginners, do that, others lurk by that
|
|
|
|
Cygnus is easy install for RPM-based distros.
|
|
|
|
> I stop reading this and download the recommended book (but still in
|
|
> english, I know many people that dont like hundred page's english books.
|
|
|
|
That's why I bought it, and I'm sure that's why ORA and Norman decided
|
|
to release the source.
|
|
|
|
> just a word : what about non english writers? you propose help for
|
|
> translating from txt to docbook, what about translating from - says -
|
|
> french to english? may be valuables authors don't speak english...
|
|
|
|
Uhm...can I get a ruling from higher-ups?
|
|
|
|
-Mark
|
|
|
|
--
|
|
--------------------------------------------------------------------
|
|
Carlo Gavazzi IPC | Mark F. Komarinski, RHCE - Compat. Engineer|
|
|
176 Second Ave | markk@cgipc.com - www.cgipc.com |
|
|
Waltham, MA 02451 USA | Ph: 781-266-1138 Fx: 781-290-4810 |
|
|
|
|
|
|
--
|
|
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>
|
|
<ul><li><strong>Follow-Ups</strong>:
|
|
<ul>
|
|
<li><strong><a name="03068" href="msg03068.html">Re: First pass for LDP-Author-Guide</a></strong>
|
|
<ul><li><em>From:</em> jdd <jdanield@dodin.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="03054" href="msg03054.html">First pass for LDP-Author-Guide</a></strong>
|
|
<ul><li><em>From:</em> Mark Komarinski <markk@cgipc.com></li></ul></li>
|
|
<li><strong><a name="03058" href="msg03058.html">Re: First pass for LDP-Author-Guide</a></strong>
|
|
<ul><li><em>From:</em> jdd <jdanield@dodin.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg03062.html">Re: First pass for LDP-Author-Guide</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03064.html">Proposed new HOWTO - Lotus Domino</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03077.html">Re: First pass for LDP-Author-Guide</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03068.html">Re: First pass for LDP-Author-Guide</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03063"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03063"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|