320 lines
16 KiB
HTML
320 lines
16 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: Navigation, was Re: Idea : common dir and tree -->
|
|
<!--X-From-R13: "Uert Trethfba" <tsretNubbc.gvzbavhz.ftv.pbz> -->
|
|
<!--X-Date: Thu, 27 Jul 2000 18:47:47 -0400 (EDT) -->
|
|
<!--X-Message-Id: 10007271848.ZM12291@hoop.timonium.sgi.com -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: kpaefclyao.fsf@dagon.conectiva -->
|
|
<!--X-Reference: 20000720112249.A1041@guylhem.eyep.net -->
|
|
<!--X-Reference: 39771D72.31B51823@mail.nyx.net -->
|
|
<!--X-Reference: m3snt4y7rs.fsf@maya.linux.ca -->
|
|
<!--X-Reference: 3978024D.5F90AA8B@mail.nyx.net -->
|
|
<!--X-Reference: 397CB4E9.19C578E9@mindspring.com -->
|
|
<!--X-Reference: y5a7laafd6o.fsf@kgh12351.nifty.ne.jp -->
|
|
<!--X-Reference: 397DD8BB.A17154CF@mail.nyx.net -->
|
|
<!--X-Reference: 20000725233403.A934@guylhem.eyep.net -->
|
|
<!--X-Reference: 397E9BFF.570DBF51@mail.nyx.net -->
|
|
<!--X-Reference: 20000726070802.A2158@guylhem.eyep.net -->
|
|
<!--X-Reference: 397EDE5D.A371A902@mail.nyx.net -->
|
|
<!--X-Reference: 10007261342.ZM9302@hoop.timonium.sgi.com -->
|
|
<!--X-Reference: 39800D77.7C0C30EA@mail.nyx.net -->
|
|
<!--X-Reference: sgjoen@mail.nyx.net -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: Navigation, was Re: Idea : common dir and tree</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="msg03542.html">Date Prev</a>][<a href="msg03544.html">Date Next</a>][<a href="msg03529.html">Thread Prev</a>][<a href="msg03549.html">Thread Next</a>][<a href="maillist.html#03543">Date Index</a>][<a href="threads.html#03543">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: Navigation, was Re: Idea : common dir and tree</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Stein Gjoen <<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>></li>
|
|
<li><em>Subject</em>: Re: Navigation, was Re: Idea : common dir and tree</li>
|
|
<li><em>From</em>: "Greg Ferguson" <<A HREF="mailto:gferg@hoop.timonium.sgi.com">gferg@hoop.timonium.sgi.com</A>></li>
|
|
<li><em>Date</em>: Thu, 27 Jul 2000 18:48:41 -0400</li>
|
|
<li><em>Cc</em>: Guylhem Aznar <<A HREF="mailto:guylhem@metalab.unc.edu">guylhem@metalab.unc.edu</A>>, <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>In-reply-to</em>: Stein Gjoen <sgjoen@mail.nyx.net> "Re: Navigation, was Re: Idea : common dir and tree" (Jul 27, 12:22pm)</li>
|
|
<li><em>References</em>: <<a href="msg03353.html">kpaefclyao.fsf@dagon.conectiva</a>> <<a href="msg03361.html">20000720112249.A1041@guylhem.eyep.net</a>> <<a href="msg03363.html">39771D72.31B51823@mail.nyx.net</a>> <<a href="msg03374.html">m3snt4y7rs.fsf@maya.linux.ca</a>> <<a href="msg03389.html">3978024D.5F90AA8B@mail.nyx.net</a>> <<a href="msg03458.html">397CB4E9.19C578E9@mindspring.com</a>> <<a href="msg03482.html">y5a7laafd6o.fsf@kgh12351.nifty.ne.jp</a>> <<a href="msg03483.html">397DD8BB.A17154CF@mail.nyx.net</a>> <<a href="msg03491.html">20000725233403.A934@guylhem.eyep.net</a>> <<a href="msg03495.html">397E9BFF.570DBF51@mail.nyx.net</a>> <<a href="msg03500.html">20000726070802.A2158@guylhem.eyep.net</a>> <<a href="msg03504.html">397EDE5D.A371A902@mail.nyx.net</a>> <<a href="msg03510.html">10007261342.ZM9302@hoop.timonium.sgi.com</a>> <<a href="msg03529.html">39800D77.7C0C30EA@mail.nyx.net</a>></li>
|
|
<li><em>Resent-date</em>: Thu, 27 Jul 2000 18:47:47 -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>: <rNGpbD.A.ZvG.HxLg5@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 Jul 27, 12:22pm, Stein Gjoen wrote:
|
|
> Subject: Re: Navigation, was Re: Idea : common dir and tree
|
|
>
|
|
> Greg Ferguson wrote:
|
|
> > On Jul 26, 2:49pm, Stein Gjoen wrote:
|
|
> > > Subject: Re: Navigation, was Re: Idea : common dir and tree
|
|
> > > Guylhem Aznar wrote:
|
|
> > > ...
|
|
> > > > Would you have time to sum up the current agreed propositions,
|
|
> > > > including dir. tree?
|
|
> > >
|
|
> > > I'll try:
|
|
> > >
|
|
> > > Proposal v1.0
|
|
> [snip]
|
|
>
|
|
> > Some questions/comments:
|
|
> >
|
|
> > - With many potential files/HOWTOs, these additional sub-directories
|
|
> > (PDF, text, etc) will be virtually unnoticed. We need to provide
|
|
> > pointers to the sub-directories within the index.html files.
|
|
>
|
|
> Agreed. We might do it
|
|
> - logically by listing each format for each HOWTO, with links that
|
|
> point to the relevant sub directory
|
|
> - structurally by having pointers straight to each sub directory for
|
|
> those of us who like to browse more manually.
|
|
> I'd like to see both but this is in the end a web design issue
|
|
> rather than a file system layout issue.
|
|
>
|
|
> > - Will we utilize the single-page HOWTOs or the multi-page HOWTOs?
|
|
>
|
|
> Personally I don't like to page down huge numbers of short pages.
|
|
> How about making small HOWTOs (less then say 10 pages) into single
|
|
> files using --split=0 while the bigger HOWTOs remain splitted?
|
|
|
|
I think it might be better to keep it consistent, but I
|
|
suppose a determination based on *file size* could be done.
|
|
|
|
|
|
> > - What about HOWTOs that currently are contained in their own
|
|
> > sub-directory? We need to consider that (all DocBook-authored
|
|
> > HOWTOs are like that).
|
|
>
|
|
> I don't know how these work. Do they have to be in sub directories?
|
|
> If so that would have to be sub directories below HTML/ but it
|
|
> does make it harder to maintain the index.html files.
|
|
|
|
It's due to the naming convention used when processing the DocBook SGML.
|
|
We do not have names like Foobar-HOWTO.html, Foobar-HOWTO-1.html,
|
|
etc. Instead, the names are generated off the id attribute of
|
|
the chapters/sections, and the top-level file is index.html. This
|
|
is nice when the document is self-contained in it's own directory.
|
|
Otherwise, we would need to do more work to fix this...files would
|
|
get clobbered (same name) if not stored in their own sub-dirs.
|
|
|
|
If we use the single-file HTML HOWTOs, we don't run into this
|
|
problem...it becomes a non-issue; *unless* a HOWTO contains
|
|
graphics. Once again, there could be a chance that the filenames
|
|
used for graphics will not be unique amongst/across HOWTOs, and
|
|
things could get clobbered.
|
|
|
|
|
|
> > - Need to provide a commonly-shared image directory, such as what
|
|
> > we have now on www.linuxdoc.org (for call-outs, etc). Should be
|
|
> > at the same level as the other sub-dirs (unless we munge the
|
|
> > HTML to convert links/references).
|
|
>
|
|
> Sorry, I don't quite understand this.
|
|
|
|
Some graphics/admonitions are shared, such as footnote
|
|
markers, warning/caution symbols, etc. Those files are kept in
|
|
a shared directory - 'images' in the HOWTO area.
|
|
|
|
|
|
> > > text/ - same HOWTOS but as plain text
|
|
> > > ...
|
|
> > > PDF/ - same HOWTOS but as PDF
|
|
> > > ...
|
|
> > > PostScript/
|
|
> > > ...
|
|
> > > SGML/
|
|
> >
|
|
> > - Contains gzipped tar files or exploded (SGML) text + graphics files
|
|
> > for each HOWTO? Again, possibly in their own sub-dirs.
|
|
>
|
|
> If people install these files on their hard disk it is probably
|
|
> because they have the capacity and the need in which case I feel
|
|
> we can leave the files untarred and uncompressed.
|
|
>
|
|
> If we are to make an LDP CD-ROM I feel we should have the files
|
|
> uncompressed there since we then have all the space we need.
|
|
>
|
|
> > - Do we need a split for linuxdoc v. docbook (?):
|
|
> >
|
|
> > SGML/
|
|
> > docbook/
|
|
> > linuxdoc/
|
|
>
|
|
> I had hoped we didn't need that. The first few lines of each file
|
|
> identifies the DTD anyway.
|
|
|
|
I suppose so.
|
|
|
|
|
|
> > > ...
|
|
> > > HTML/
|
|
> > > ...
|
|
> >
|
|
> > - Is it just me, or is anyone else annoyed by upper/mixed-case? :-)
|
|
> > I'd personally like to see lower-case used for all the sub-dir
|
|
names,
|
|
> > but that's simply a personal preference.
|
|
>
|
|
> Normally I have mixed feelings about it but in this case I favour
|
|
> starting the main sub directories with a capital letter so they
|
|
> appear at the top of a directory listing. Perhaps text/ should
|
|
> then rather be Text/ to keep in the same style.
|
|
|
|
That won't ensure what you're trying to achieve (at least not with
|
|
a standard 'ls'), if all the HOWTOs are available at that level.
|
|
The first thing present will be the 3Dfx-HOWTO files, etc. You would
|
|
need to have something like 000_text, 000_html, 000_pdf...!
|
|
|
|
|
|
> The HOWTO/ directory will probably be full of HTML files so
|
|
> we should make the contents sub directories visible.
|
|
|
|
Right...so how is that best done? Again, I think putting the
|
|
HTML representations in the HTML sub-dir is the cleanest way
|
|
to achieve this goal. Plus, it's consistent with how the
|
|
other sub-dirs are used.
|
|
|
|
|
|
> > - What goes in the 'HTML' directory, given that all HTML HOWTOs will
|
|
> > be in /usr/share/HOWTO ? Is it still necessary?
|
|
>
|
|
> I might have misunderstood but I got the impression the majority
|
|
> wanted HTML HOWTOs in HTML/ and I guess it can be an advantage to
|
|
> keep the root clean as it will hold a lot of navigational files.
|
|
|
|
Exactly. Agreed. I didn't think that was what was being proposed, at
|
|
least not from the intial document you sent(?).
|
|
|
|
|
|
> > > GUIDES/ - the Guides in HTML format
|
|
> >
|
|
> > - Again, a decision on upper/lower/mixed case..perhaps:
|
|
> > HOWTO, FAQ, guides, etc. Again, my personal preference.
|
|
> >
|
|
> > > Contents:
|
|
> > >
|
|
> > > [...]
|
|
> > >
|
|
> > > The index.html marked with (*) is based on the main page you see
|
|
> > > when you browse <A HREF="http://www.LinuxDoc.org/">http://www.LinuxDoc.org/</A> with some minor exceptions:
|
|
> > > - the links from that page point to files on disk using relative
|
|
> > > file:// URLs. Remember many do not have online access.
|
|
> >
|
|
> > All links on www.linuxdoc.org are currently relative (and work
|
|
> > in a local/non-web-server environment). We needed to have it this
|
|
> > way for our mirror sites.
|
|
>
|
|
> That probably makes things a bit easier. We will still need some
|
|
> kind of script to turn http:// into file:// and add the extra links.
|
|
> I any case I suspect we are going to need a fair bit of scripts
|
|
> to maintain and produce all this.
|
|
>
|
|
> [...]
|
|
|
|
r,
|
|
|
|
|
|
|
|
--
|
|
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-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="03549" href="msg03549.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> Guylhem Aznar <guylhem@metalab.unc.edu></li></ul></li>
|
|
<li><strong><a name="03635" href="msg03635.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> David Lawyer <dave@lafn.org></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="03353" href="msg03353.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Jorge Godoy <godoy@conectiva.com></li></ul></li>
|
|
<li><strong><a name="03361" href="msg03361.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Guylhem Aznar <guylhem@metalab.unc.edu></li></ul></li>
|
|
<li><strong><a name="03363" href="msg03363.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="03374" href="msg03374.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Gary Lawrence Murphy <garym@canada.com></li></ul></li>
|
|
<li><strong><a name="03389" href="msg03389.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="03458" href="msg03458.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> David Merrill <dcmerrill@mindspring.com></li></ul></li>
|
|
<li><strong><a name="03482" href="msg03482.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Taketoshi Sano <kgh12351@nifty.ne.jp></li></ul></li>
|
|
<li><strong><a name="03483" href="msg03483.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="03491" href="msg03491.html">Re: Idea : common dir and tree (Rep:Re: Why not create packages?)</a></strong>
|
|
<ul><li><em>From:</em> Guylhem Aznar <guylhem@metalab.unc.edu></li></ul></li>
|
|
<li><strong><a name="03495" href="msg03495.html">Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="03500" href="msg03500.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> Guylhem Aznar <guylhem@metalab.unc.edu></li></ul></li>
|
|
<li><strong><a name="03504" href="msg03504.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="03510" href="msg03510.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> "Greg Ferguson" <gferg@hoop.timonium.sgi.com></li></ul></li>
|
|
<li><strong><a name="03529" href="msg03529.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg03542.html">Re: Boilerplate License Revision Proposal</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03544.html">Installing Linux With exsisting Win98 And Win 2000 O/S's</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03529.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03549.html">Re: Navigation, was Re: Idea : common dir and tree</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03543"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03543"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|