This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: see also representation (was Re: "How do I represent...?")
- To: Norman Walsh <ndw at nwalsh dot com>
- Subject: Re: see also representation (was Re: DOCBOOK: "How do I represent...?")
- From: "John R. Daily" <jdaily at progeny dot com>
- Date: Mon, 05 Feb 2001 08:46:32 -0500
- Cc: docbook at lists dot oasis-open dot org
- References: <20010122222756.8F2561C@albus.indy.progeny.com><ulms3qjh2.fsf@openwave.com> <20010123145218.74F131F@albus.indy.progeny.com><oau269rdxx.fsf_-_@arroz.fake> <87n1c1ntkf.fsf@nwalsh.com>
> | "John R. Daily" <jdaily@progeny.com> writes:
> |
> | > * I would like to formalize the "See also" concept. I don't think a
> | > bibliography is what I'm aiming for, although if that should be used,
> | > that's fine. I intend to provide a unique document identifier to each
> | > document, and I would like to be able to provide a list of such
> | > identifiers in the meta-information for each document, perhaps with a
> | > relationship value to indicate the relevance of the other document.
>
> If you want to do cross-document links at the source level, OLink is your
> only hope. And it sounds like it might suit what you have in mind.
That doesn't look nearly as abstract as I'd hoped. Essentially, I want
authors to be able to insert something like the following:
<articleinfo>
...
<otherdocs>
<otherdoc relevance="1">112079</otherdoc>
<otherdoc relevance="2">24221</otherdoc>
<otherdoc relevance="2">365412</otherdoc>
</otherdocs>
</articleinfo>
The goal is to create a very abstract mechanism for something akin to
the "See Also" section of a manpage. The stylesheet could render this
information as appropriate by providing a generic URL for those IDs,
like "http://foo.bar.com/urn?112079", at some location in the document
as determined by the stylesheet maintainer.
The above structure is likely insufficient to support man pages
themselves; perhaps adding a "docname" attribute with values like
"sprintf(3)" would be sufficient.
-John