175 lines
7.0 KiB
HTML
175 lines
7.0 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
||
<!--X-Subject: Re: DocBook Walkthrough? -->
|
||
<!--X-From-R13: wqq <wqnavryqNqbqva.arg> -->
|
||
<!--X-Date: Wed, 17 May 2000 15:06:00 -0400 (EDT) -->
|
||
<!--X-Message-Id: 00051720270904.00445@charles -->
|
||
<!--X-Content-Type: text/plain -->
|
||
<!--X-Reference: 3920A2E2.E0CE2760@tiac.net -->
|
||
<!--X-Reference: 00051619581005.00889@charles -->
|
||
<!--X-Reference: 392204C0.556CF517@tiac.net -->
|
||
<!--X-Head-End-->
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
||
<html>
|
||
<head>
|
||
<title>Re: DocBook Walkthrough?</title>
|
||
<link rev="made" href="mailto:jdanield@dodin.net">
|
||
</head>
|
||
<body>
|
||
<!--X-Body-Begin-->
|
||
<!--X-User-Header-->
|
||
<!--X-User-Header-End-->
|
||
<!--X-TopPNI-->
|
||
<hr>
|
||
[<a href="msg02458.html">Date Prev</a>][<a href="msg02460.html">Date Next</a>][<a href="msg02448.html">Thread Prev</a>][<a href="msg02474.html">Thread Next</a>][<a href="maillist.html#02459">Date Index</a>][<a href="threads.html#02459">Thread Index</a>]
|
||
<!--X-TopPNI-End-->
|
||
<!--X-MsgBody-->
|
||
<!--X-Subject-Header-Begin-->
|
||
<h1>Re: DocBook Walkthrough?</h1>
|
||
<hr>
|
||
<!--X-Subject-Header-End-->
|
||
<!--X-Head-of-Message-->
|
||
<ul>
|
||
<li><em>To</em>: <A HREF="mailto:pac1@tiac.net">pac1@tiac.net</A>, "<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>" <<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>>, "<A HREF="mailto:basiclinux@topica.com">basiclinux@topica.com</A>" <<A HREF="mailto:basiclinux@topica.com">basiclinux@topica.com</A>></li>
|
||
<li><em>Subject</em>: Re: DocBook Walkthrough?</li>
|
||
<li><em>From</em>: jdd <<A HREF="mailto:jdanield@dodin.net">jdanield@dodin.net</A>></li>
|
||
<li><em>Date</em>: Wed, 17 May 2000 19:50:22 +0200</li>
|
||
<li><em>In-reply-to</em>: <<a href="msg02448.html">392204C0.556CF517@tiac.net</a>></li>
|
||
<li><em>References</em>: <<a href="msg02441.html">3920A2E2.E0CE2760@tiac.net</a>> <<a href="msg02445.html">00051619581005.00889@charles</a>> <<a href="msg02448.html">392204C0.556CF517@tiac.net</a>></li>
|
||
<li><em>Resent-date</em>: Wed, 17 May 2000 15:06:00 -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>: <t_wwqB.A.4UC.G2uI5@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 mer, 17 mai 2000, pac1@tiac.net <20> <20>crit
|
||
|
||
|
||
>
|
||
>I think it can be Plan the experiences, Plan what kind of information to
|
||
>gather, and where possible, plan on specific pieces of information to gather.
|
||
>Plan how the information about an experience is to be organized and used. Do
|
||
>we know how to do this today? No, I don't think we do. Should we learn how to
|
||
>do this? Would it result in better HOWTO's?
|
||
|
||
this is how things should be done if plenty of free time where available.
|
||
In fact, most of the time, I make the things as they come and write down
|
||
an abstract to be able to do this again. When the abstract grows, I write
|
||
a doc and, why not ? publish it on my site.
|
||
|
||
|
||
> I think today, we're at the level of creating "Documents" that can be presented
|
||
>in a variety of presentation formats", but the content of the various formats is
|
||
>fixed. Is this correct?
|
||
|
||
I would say that the content of the document is fixed, but the visual
|
||
aspect changes from one format to an other
|
||
|
||
|
||
>
|
||
>Since we are beginning to separate content from presentation format in a very
|
||
>formalized way, I think the capability of customizing not just the format but
|
||
>the content is already feasable.
|
||
|
||
I think this is very interesting, but very different from the present
|
||
things. make the content vary needs the various contents to be prepared by
|
||
the author, so he needs to know about the real format used. If so any
|
||
conditional could do the job. It's partly the case when one must keep jpg
|
||
and eps variant of images. It's the case in HTML when somebody use an ALT
|
||
text under an image for text browsers.
|
||
|
||
This is VERY HARD to maintain and keep up to date
|
||
|
||
, but m different
|
||
>documents in each of the n different output formats, all from ONE source.
|
||
|
||
it's the case with C source when compiled for different platforms
|
||
|
||
>
|
||
>There are 13 kinds of tasks I've found so far.
|
||
|
||
see the table of content of most Linux books or manuals... the actual
|
||
number is a matter of choice of the author.
|
||
|
||
|
||
>There are 6 levels of expertise related to things a Linux person may try to do.
|
||
>
|
||
>1. Unaware of availability or alternatives
|
||
>2. Initiate - Has made a choice but lacks knowlege of how to proceed to
|
||
>implement t
|
||
(...)
|
||
|
||
this also is a matter of choice.
|
||
|
||
>
|
||
>
|
||
>This is my central Point:
|
||
>
|
||
>What I'd like to see, is a central data store for the Total Available
|
||
>Documentation that can be used to produce the "appropriate" content for the
|
||
>different levels of expertise and perhaps also for different tasks. The
|
||
>CONTENT would vary, not just the presentation format.
|
||
|
||
in fact this is already implemented in many applications, when one can
|
||
choose the menu contents in function of his skill.
|
||
|
||
<<A HREF="http://www.dodin.net">http://www.dodin.net</A>> <<A HREF="mailto:jdanield@dodin.net">mailto:jdanield@dodin.net</A>>
|
||
QUI EST CET HOMME ? Aidez-moi <20> le retrouver
|
||
WHO'S THAT GUY ? Help me find him.
|
||
<A HREF="http://www.dodin.net/serge/index.html">http://www.dodin.net/serge/index.html</A>
|
||
|
||
|
||
--
|
||
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="02441" href="msg02441.html">Re: DocBook Walkthrough?</a></strong>
|
||
<ul><li><em>From:</em> pac1@tiac.net</li></ul></li>
|
||
<li><strong><a name="02445" href="msg02445.html">Re: DocBook Walkthrough?</a></strong>
|
||
<ul><li><em>From:</em> jdd <jdanield@dodin.net></li></ul></li>
|
||
<li><strong><a name="02448" href="msg02448.html">Re: DocBook Walkthrough?</a></strong>
|
||
<ul><li><em>From:</em> pac1@tiac.net</li></ul></li>
|
||
</ul></li></ul>
|
||
<!--X-References-End-->
|
||
<!--X-BotPNI-->
|
||
<ul>
|
||
<li>Prev by Date:
|
||
<strong><a href="msg02458.html">Re: experimental release of linuxdoc-tools (based on sgml-tools 1.0.9)</a></strong>
|
||
</li>
|
||
<li>Next by Date:
|
||
<strong><a href="msg02460.html">Re: experimental release of linuxdoc-tools (based on sgml-tools 1 .0.9)</a></strong>
|
||
</li>
|
||
<li>Previous by thread:
|
||
<strong><a href="msg02448.html">Re: DocBook Walkthrough?</a></strong>
|
||
</li>
|
||
<li>Next by thread:
|
||
<strong><a href="msg02474.html">Re: DocBook Walkthrough?</a></strong>
|
||
</li>
|
||
<li>Index(es):
|
||
<ul>
|
||
<li><a href="maillist.html#02459"><strong>Date</strong></a></li>
|
||
<li><a href="threads.html#02459"><strong>Thread</strong></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<!--X-BotPNI-End-->
|
||
<!--X-User-Footer-->
|
||
<!--X-User-Footer-End-->
|
||
</body>
|
||
</html>
|