Date: Wed, 10 Jan 2001 10:27:16 +0000 From: Nik Clayton <nik@freebsd.org> To: Udo Erdelhoff <ue@nathan.ruhr.de> Cc: freebsd-doc@freebsd.org Subject: Re: Strange <!-- <br> --> sequences Message-ID: <20010110102716.A33645@canyon.nothing-going-on.org> In-Reply-To: <20010109225057.L4211@nathan.ruhr.de>; from ue@nathan.ruhr.de on Tue, Jan 09, 2001 at 10:50:57PM %2B0100 References: <20010106211512.L64806@nathan.ruhr.de> <20010108094923.A5107@canyon.nothing-going-on.org> <20010108163030.G4211@nathan.ruhr.de> <20010109122858.A6334@canyon.nothing-going-on.org> <20010109225057.L4211@nathan.ruhr.de>
next in thread | previous in thread | raw e-mail | index | archive | help
--KsGdsel6WgEHnImy
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
On Tue, Jan 09, 2001 at 10:50:57PM +0100, Udo Erdelhoff wrote:
> > Should anyone want to jump up and fix the markup in the
> > English FAQ to use <bibliography> then please do so, otherwise I'll get
> > to it in my copious free time.
>
> Hmm, there's a small problem: According to the information on the website,
> a <bibliography> element cannot be placed inside an <answer element>. And
> a quick test confirms this information (jade [....] document type does not
> allow element "BIBLIOGRAPHY" here).
Yep.
> In other words, the <bibliography> has to be placed at the of the
> chapter/FAQ and the answer entity can only contain references to
> the entries in the bibliography. Something like "The old 4.4BSD
> Manuals (cryptic string1, cryptic string2, ...) can also be used."
> That may be fine for a scientific article or a book in that context
> but I don't think it's a great idea for the FAQ.
Try the attached patch, which, IMHO, provides sufficient contextual
information for the reader, while keeping the book information together.
I've only converted one entry in the list, but that should be enough to
get an idea of what I mean.
Longer term we should probably have a
doc/en_US.ISO_8859-1/share/sgml/bilbiography.sgml file (or directory),
that contains biblio information that can be shared by all the documents
that want it.
> Form (SGML) should follow function (giving information about the
> 4.4BSD books), not the other way around.
If necessary, the stylesheets could probably be amended to insert some
of the bibliography information (which is stored in the <bibliography>
element) wherever <citetitle> or similar is used.
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
--KsGdsel6WgEHnImy
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename=d
Index: book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/faq/book.sgml,v
retrieving revision 1.135
diff -u -r1.135 book.sgml
--- book.sgml 2001/01/05 20:44:26 1.135
+++ book.sgml 2001/01/10 10:21:54
@@ -604,12 +604,8 @@
<itemizedlist>
<listitem>
- <para>4.4BSD System Manager's Manual <!-- <br> -->
- By Computer Systems Research Group, UC Berkeley <!-- <br> -->
- 1st Edition June 1994, 804 pages <!-- <br> -->
- <ulink
- URL="http://www.amazon.com/exec/obidos/ASIN/1-56592-080-5">ISBN</ulink>:
- 1-56592-080-5 <!-- <br> --></para>
+ <para><citetitle>4.4BSD System Manager's Manual</citetitle>,
+ <xref linkend="biblio-44sysman"></para>
</listitem>
<listitem>
@@ -11499,4 +11495,30 @@
thanks!</para>
</chapter>
+
+ <bibliography>
+ <title>Useful FreeBSD and Unix Books</title>
+
+ <biblioentry id="biblio-44sysman">
+ <biblioset relation="book">
+ <title>4.4BSD System Manager's Manual</title>
+
+ <corpauthor>Computer Systems Research Group, University of
+ California, Berkeley</corpauthor>
+
+ <publisher>
+ <publishername>O'Reilly and Associates</publishername>
+ </publisher>
+
+ <edition>1st</edition>
+
+ <pubdate>June 1994</pubdate>
+
+ <isbn><ulink
+ url="http://www.amazon.com/exec/obidos/ASIN/1-56592-080-5">;
+1-56592-080-5</ulink></isbn>
+ </biblioset>
+
+ </biblioentry>
+ </bibliography>
</book>
--KsGdsel6WgEHnImy--
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010110102716.A33645>