Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 4 Jun 1996 15:36:49 -0500 (EST)
From:      John Fieber <jfieber@indiana.edu>
To:        Greg Lehey <grog@lemis.de>
Cc:        FreeBSD Documenters <doc@freebsd.org>
Subject:   Re: How do I write this SGML stuff?
Message-ID:  <Pine.NEB.3.93.960604152205.422O-100000@Fieber-John.campusview.indiana.edu>
In-Reply-To: <199606041714.TAA13705@allegro.lemis.de>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 4 Jun 1996, Greg Lehey wrote:

> I've just been trying to convert my roff text on installing a second
> disk into SGML, and I find that I don't have any documentation.  I've
> guessed a lot from the table sources, but I've probably made a lot of
> mistakes, and I can't find how to do pictures and tables. 

This is a bit of a dilemma.  Currently the handbook is made
readable by the lowest common denominator, which means lynx,
which means no tables or graphics.  Adding support for tables
would be trivial.  In fact, it should already work for LaTeX
output, but I have not actually tried it.   The (lame) workaround
is ascii graphics in a <verb></verb> element.

> If there's
> no easy way to do that in SGML, is there a way to import PostScript?
> That would do just as easily.  If somebody can point me to
> documentation on the subject, I'd be grateful.

There is some documentation in /usr/src/share/sgml/FreeBSD/doc.
It needs to be changed to reflect how things really are, but it
should give you the basics.  Just ignore all the stuff on the
mechanics of making the conversions.

> On an allied subject, is there any way to just browse through the
> manual without having to remember where in the structure you are, 

What sort of cues would be most useful?  The one element that is
almost always on-screen in most browsers is <title> (in html that
is). I would target that for a more effective use, but space is
tight.  The general rule on <title> is that it should not be more
than 64 characters.  Any brilliant ideas on using this better are
most welcome.



-john

== jfieber@indiana.edu ===========================================
== http://fallout.campusview.indiana.edu/~jfieber ================





Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.93.960604152205.422O-100000>