atw: Re: Caption placement
- From: James Hunt <jameshunt@xxxxxxxxxxxxx>
- To: austechwriter@xxxxxxxxxxxxx
- Date: Wed, 6 Dec 2006 22:12:12 +1000
Software manuals and engineering manuals, which most of us write, are
not exactly either books or scientific/academic papers, but the
typesetting conventions in those fields obviously influence us. I
suggest that rather than seek for universal rules, we should consider
our readers. Consistency of presentation is important, but ease of
reading should influence the conventions we use.
If all of the tables and figures are small (occupying only a small
fraction of a page), and simple in appearance, then it doesn't matter
much whether the captions are above or below the objects. When you
are looking at the table or figure, the caption will always be in the
periphery of vision, and searching for the caption is not hard.
If the tables are long, and are very likely to break over a page end,
then the captions should come before the tables, and should have a
continuation tag at the bottom of each page and a repeating caption
at the top of the next page. (Yes, I know you can't do that
automatically with Word.) Such a caption/ system is easy for the
reader to find and follow.
Large figures occupying most of a page should also be preceded by
their captions; again, to make the captions easy to find. Some
publishing packages support multi-page figures made up of several sub-
figures, which may be large, each with a sub-caption. To make it easy
to find the captions and sub-captions, they should precede their
respective figures and sub-figures.
A contributor to this thread observed that -
"The caption includes explanations for labelled elements and perhaps
of the overall figure..."
-but this appears to conflate two different entities, "caption" and
"legend". If your figures have legends, then it would be reasonable
to place the legends in consistent positions with respect to the
figures, throughout the manual. If the reader will not understand a
figure without knowing what the colours/hatchings/symbols mean, then
put the legend near the top of the figure.
Consistency within a single manual or manual suite is useful, but
typesetting conventions are often nationally based.
We are quite used to titles and captions where a word precedes the
number part: for example, Chapter 1, Table 45, Figure 6, Example
2,... In Hungarian documents, the order is reversed. [Native
speakers may have to imagine the acute accents in the following.]
"Part II" becomes "II. rész" , "Table 6" becomes "6. táblázat", and
so on.
There is more than one way to be consistent...
James Hunt
----------------
On 06 Dec 2006, at 8:31 PM, Allan Charlton wrote:
Hi Debbie
I think you'll find it's standard practice in academic documents.
Look at the scientific journals, the conferences, and so on. If I'm
pressed, I can find a link to the APA style guide, but any
university library shouyld have a link.
Try http://library.uws.edu.au/citing.phtml for a start. You might
have to search a bit from the library site. If you get stuck, mail
me.
Allan
allancharlton@xxxxxxxxxxxxxx
Debbie Hope wrote:
The 'house' style of my current workplace dictates captions in
documents are placed *above* a table and *below* a figure / graphic.
**************************************************
To post a message to austechwriter, send the message to
austechwriter@xxxxxxxxxxxxxx
To subscribe to austechwriter, send a message to austechwriter-request@xxxxxxxxxxxxx with
"subscribe" in the Subject field.
To unsubscribe, send a message to austechwriter-request@xxxxxxxxxxxxx with
"unsubscribe" in the Subject field.
To search the austechwriter archives, go to
www.freelists.org/archives/austechwriter
To contact the list administrator, send a message to
austechwriter-admins@xxxxxxxxxxxxx
**************************************************
- Follow-Ups:
- atw: Re: Caption placement
- From: hedley . finger
- References:
- atw: Caption placement
- From: Debbie Hope
- atw: Re: Caption placement
- From: Allan Charlton
Other related posts:
- » atw: Re: Caption placement
- » atw: Re: Caption placement
- » atw: Re: Caption placement
- » atw: Re: Caption placement
- » atw: Re: Caption placement
- » atw: Re: Caption placement
- » atw: Re: Caption placement
- » atw: Re: Caption placement
Hi DebbieI think you'll find it's standard practice in academic documents. Look at the scientific journals, the conferences, and so on. If I'm pressed, I can find a link to the APA style guide, but any university library shouyld have a link. Try http://library.uws.edu.au/citing.phtml for a start. You might have to search a bit from the library site. If you get stuck, mail me.
Allan allancharlton@xxxxxxxxxxxxxx Debbie Hope wrote:
The 'house' style of my current workplace dictates captions in documents are placed *above* a table and *below* a figure / graphic.
- atw: Re: Caption placement
- From: hedley . finger
- atw: Caption placement
- From: Debbie Hope
- atw: Re: Caption placement
- From: Allan Charlton