165 lines
6.4 KiB
HTML
165 lines
6.4 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: if SGML is so great... -->
|
|
<!--X-From-R13: Egrva Uwbra <ftwbraNznvy.alk.arg> -->
|
|
<!--X-Date: Mon, 8 May 2000 11:09:01 -0400 (EDT) -->
|
|
<!--X-Message-Id: 3916D858.C7331B34@mail.nyx.net -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF077F805E@email.cu-portland.edu -->
|
|
<!--X-Reference: 3912EDAD.C9E57A39@mail.nyx.net -->
|
|
<!--X-Reference: y5aaei2iz7e.fsf@kgh12351.nifty.ne.jp -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: if SGML is so great...</title>
|
|
<link rev="made" href="mailto:sgjoen@mail.nyx.net">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg02332.html">Date Prev</a>][<a href="msg02334.html">Date Next</a>][<a href="msg02313.html">Thread Prev</a>][<a href="msg02271.html">Thread Next</a>][<a href="maillist.html#02333">Date Index</a>][<a href="threads.html#02333">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: if SGML is so great...</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Taketoshi Sano <<A HREF="mailto:kgh12351@nifty.ne.jp">kgh12351@nifty.ne.jp</A>></li>
|
|
<li><em>Subject</em>: Re: if SGML is so great...</li>
|
|
<li><em>From</em>: Stein Gjoen <<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>></li>
|
|
<li><em>Date</em>: Mon, 08 May 2000 17:08:08 +0200</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="msg02264.html">A5F46F4ED18FD211ABEE00105AC6CF077F805E@email.cu-portland.edu</a>> <<a href="msg02278.html">3912EDAD.C9E57A39@mail.nyx.net</a>> <<a href="msg02313.html">y5aaei2iz7e.fsf@kgh12351.nifty.ne.jp</a>></li>
|
|
<li><em>Resent-date</em>: Mon, 8 May 2000 11:09:01 -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>: <lyc2eD.A.ACB.8htF5@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>
|
|
|
|
Taketoshi Sano wrote:
|
|
>
|
|
> Hi.
|
|
>
|
|
> at Fri, 05 May 2000 17:50:05 +0200,
|
|
> Stein Gjoen <sgjoen@mail.nyx.net> writes:
|
|
>
|
|
> > My long time goal of document accessibility and integration
|
|
> > have made me think we need tags for
|
|
> >
|
|
> > man pages: <manpage section="1">du</manpage>
|
|
> > that renders to du(1) in plain text and adds hyperlinks to HTML
|
|
> > pages and adds to the RELATED list in stub man pages. Some
|
|
> > commands have multiple man pages, such as mount(2) and mount(8)
|
|
> > so a section number is needed.
|
|
>
|
|
> This will be difficult task for Linuxdoc DTD. Just conditional
|
|
> writing can be done with the current sgml-tools v1, but "to include
|
|
> the output from the command" may not be done without some work-around.
|
|
|
|
Embedding entire man pages would be impractical, what I
|
|
had in mind was to add the equivalent of
|
|
<A HREF="http://www.ctyme.com/linuxdoc/MAN0291.htm">http://www.ctyme.com/linuxdoc/MAN0291.htm</A>
|
|
that is linking rather than embedding. The type of link
|
|
would be installation/distribution dependent and might require
|
|
post processing. I use Debian at home and that distribution
|
|
has cgi-scripts for rendering man pages into HTML and I
|
|
would guess most other distributions have similar features.
|
|
|
|
> > HOWTO: <howto>Multi Disk HOWTO</howto>
|
|
> > that renders to links to that HOWTO in the HTML pages
|
|
> > and adds to the RELATED list in stub man pages.
|
|
> >
|
|
> > In addition I wish the <file> tag rendering was changed to
|
|
> > file:///pathoffile URL in the HTML document, shown in courier
|
|
> > or similar font. This too would be handy in stub man pages.
|
|
>
|
|
> You can use:
|
|
>
|
|
> <htmlurl url="file:///pathoffile" name="some file">
|
|
> or
|
|
> <url url="file:///pathoffile">
|
|
>
|
|
> Is it not sufficient ?
|
|
|
|
This is what I use but I feel it is missing the markup
|
|
purposes of SGML in indicating this is a file. Is
|
|
<file><url url="file:///pathoffile"></file>
|
|
legal LinuxDoc DTD?
|
|
|
|
Also for file- and command-names I feel courier or similar
|
|
font is more convenient. If all this could be embedded
|
|
in the <file> tag it could be convenient.
|
|
|
|
> > Rendering of the hyperlinks would be installation dependent,
|
|
> > so on the LinuxDoc web pages it would refer to sample files
|
|
> > wheras on a home system it would point to the actual file.
|
|
>
|
|
> Perhaps, conditional writing can be used here.
|
|
|
|
It is possible we have to use post compilation scripts.
|
|
|
|
Regards,
|
|
Stein Gjoen
|
|
|
|
|
|
--
|
|
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="02264" href="msg02264.html">RE: if SGML is so great...</a></strong>
|
|
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
|
<li><strong><a name="02278" href="msg02278.html">Re: if SGML is so great...</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="02313" href="msg02313.html">Re: if SGML is so great...</a></strong>
|
|
<ul><li><em>From:</em> Taketoshi Sano <kgh12351@nifty.ne.jp></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg02332.html">Announce: template for big HOWTOs</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg02334.html">Re: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg02313.html">Re: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg02271.html">Re: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#02333"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#02333"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|