Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Should embedded figures/images be placed before or after they are referred to in text?

+0
−0

As the title question asks:

Should embedded figures/images be placed before or after they are referred to in text?

Which is more appropriate? Or does it depend on the setting/context?

History
Why does this post require moderator attention?
You might want to add some details to your flag.
Why should this post be closed?

This post was sourced from https://writers.stackexchange.com/q/15807. It is licensed under CC BY-SA 3.0.

0 comment threads

2 answers

+1
−0

In printed books or journals, figures and tables are placed on the same double page as the first reference. Where exactly they are placed depends on how their placement affects page breaks. Typesetters try to avoid ugly "widows" and "orphans", that is, one or two lines broken from a paragraph and pushed to the next page.

If page layout and logical text structure are not affected, place a table or figure immediately after the first reference to it:

... as Figure 1 shows:

enter image description here

Bla bla ...

For placement, think about when you would show and point at an illustration when speaking to someone. Usually you show the image while you refer to it, verbally. So place the image in your text in a way that mimics that deictic behavior. Colons are an ideal approximation.

If it cannot be placed immediately after that first reference, place it after the paragraph containing the first reference.

If that, too, is not possible, place it

  • on the same page, or
  • the same double page, or
  • on the following page or double page, or
  • the preceding page or double page,

in that order of preference.

If you submit an article to a journal, follow their style guide. Usually you must write "Figure 1" in the center of an empty line, sometimes in brackets, spaced with an empty line above and below, and place the figure in an appendix:

... as Figure 1 shows:

                                                                        [Figure 1]

Bla bla ...

History
Why does this post require moderator attention?
You might want to add some details to your flag.

This post was sourced from https://writers.stackexchange.com/a/15808. It is licensed under CC BY-SA 3.0.

0 comment threads

+0
−0

This depends in part on the type of writing (technical reference manual? novel with illustrations? etc) and how people will read it (printed book? online?).

If a reader follows a reasonable path1 through the document, there should never be a point where he's looking at something incomprehensible. This applies to text, code samples, diagrams, and screen shots. Therefore, unless the structure of your document itself provides this (e.g. through section titles and a consistent format, like in a catalogue), you should always have some explanatory text before the screen shot to provide context.

However, this principle applies to text too -- you don't want to have a page of text describing stuff that will only make sense after someone sees the image, either. So in my experience the norm is: text that sets the stage, then the image, then details that refer to the screen shot.

This is true with or without figure numbers and captions.

Contrary to this answer, I do not recommend placing an image in the middle of a sentence ("in this figure: (figure) we see..."). I've found that for many readers the image functions as its own "paragraph", and they find the dangling sentence fragments around it distracting. I'll do this in casual writing like on my blog, but I try to avoid it in formal writing like documentation or books.

All of this is for images where some textual explanation is needed. If you're writing a novel and are including maps or illustrations purely as supplementary material, then you can put those wherever you want as the text does not depend on them and they do not depend on the text.

1 At minimum (for non-reference doc), starting at the beginning and reading through. But also consider the case of someone who looks something up in the table of contents and jumps there, and, if applicable, the use of your documentation in online context-sensitive help.

History
Why does this post require moderator attention?
You might want to add some details to your flag.

0 comment threads

Sign up to answer this question »