This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

RE: sect1 in preface


Godoy,

It is most unusual to xref an "informal" object. Standard publishing
practice is to place any object that has references to it in a "formal"
container. For example, if you need to reference a table, use <table> and
not <informaltable>. If you want to reference a graphic or other multimedia
object, place it in a <figure> rather than placing the <graphic> or whatever
directly inline.

Even if you are referencing lots of objects, I still recommend putting them
in formal containers for two reasons:

1. You can reference them ;-)

2. If you need to reference them, they should be important enough to warrant
a caption or title.

Gershon.

-----Original Message-----
From: owner-docbook@lists.oasis-open.org
[mailto:owner-docbook@lists.oasis-open.org]On Behalf Of Jorge Godoy
Sent: Wednesday, February 09, 2000 9:17 PM
To: docbook@lists.oasis-open.org
Subject: Re: DOCBOOK: sect1 in preface

On Wed, Feb 09, 2000 at 11:50:32AM -0500, Norman Walsh wrote:
> / Camille Begnis <camille@mandrakesoft.com> was heard to say:
> | Various probs indeed:
> | 1) xref does not seem to recognize referencies to mediaobject, nor
> | imageobject, nor imagedata. nsgmls is OK, but jade complains that the
> | system does not recognize this.
> | 	- How can I achieve that?
> | 	- If so, are figures automatically assigned a number?
>
> Put the object inside a formal wrapper (figure, for example) and
> xref to that. Xref has to generate text, so you have (basically)
> to point to something with a title.

And can't a <informalfigure> be used instead of <figure>? I don't want
to supply a title for every figure I use an <xref> to.

--
Godoy.	<godoy@conectiva.com.br>               GPG Fingerprint
                                         851B B620 626D 2AD0 E783
"Ser poeta não é minha ambição,          E932 1330 BE6D A4A3 0625
 é minha maneira de estar sozinho"
              - Fernando Pessoa.       Publicações @ Conectiva S.A.

Except where explicitly stated I speak on my own behalf.
Exceto onde explicitado as declarações aqui feitas são apenas minhas.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]