Difference between revisions of "UniWiki:Manual of Style/Captions"

From EVE University Wiki
Jump to: navigation, search
(Created page with "{{redirect|WP:CAP|the style guideline on capitalization in article titles|Wikipedia:Naming conventions (capitalization)|the style guideline on capitalization generally|Wikiped...")
 
Line 1: Line 1:
{{redirect|WP:CAP|the style guideline on capitalization in article titles|Wikipedia:Naming conventions (capitalization)|the style guideline on capitalization generally|Wikipedia:Manual of Style/Capital letters}}
+
{{UMoS guideline}}
{{style-guideline|WP:CAP|WP:CAPTION}}
 
{{Style}}  
 
 
 
 
A '''caption''', also known as a '''cutline''', is text that appears below an image. Most captions draw attention to something in the image that is not obvious, such as its relevance to the text. Captions can consist of a few words of description, or several sentences. Writing good captions can be difficult, and the examples below may be helpful. Along with the title, the lead, and section headings, captions are the most commonly read words in an article, so they should be succinct and informative.
 
A '''caption''', also known as a '''cutline''', is text that appears below an image. Most captions draw attention to something in the image that is not obvious, such as its relevance to the text. Captions can consist of a few words of description, or several sentences. Writing good captions can be difficult, and the examples below may be helpful. Along with the title, the lead, and section headings, captions are the most commonly read words in an article, so they should be succinct and informative.
  
Not every Wikipedia image needs a caption; some images are simply decorative. Relatively few may be genuinely self-explanatory. In addition to a caption, [[Alt attribute|alt text]]—for visually impaired readers—should be added to informative (but not purely decorative) images;<ref>{{cite web |url=http://www.w3.org/QA/Tips/altAttribute.html |title=Use the <code>alt</code> attribute to describe the function of each visual |author=Hazaël-Massieux D |date=2007-05-28 |accessdate=2009-07-06 |work=W3C Quality Assurance Tips for Webmasters }}</ref><ref name="H37">{{cite web|url=http://www.w3.org/TR/2014/NOTE-WCAG20-TECHS-20140311/H37|title=H37: Using alt attributes on img elements – Techniques for WCAG 2.0|work=[[World Wide Web Consortium]]|accessdate=20 April 2014}}</ref><ref name="H67">{{cite web|url=http://www.w3.org/TR/WCAG20-TECHS/H67.html|title=H67: Using null alt text and no title attribute on img elements for images that AT should ignore – Techniques for WCAG 2.0|work=[[World Wide Web Consortium]]|accessdate=20 April 2014}}</ref> see [[Wikipedia:Alternative text for images]].
+
Not every UniWiki image needs a caption; some images are simply decorative. Relatively few may be genuinely self-explanatory. In addition to a caption, [[Wikipedia:Alt attribute|alt text]]—for visually impaired readers—should be added to informative (but not purely decorative) images; see [[Wikipedia:Wikipedia:Alternative text for images|Wikipedia:Alternative text for images]].
  
 
== Some criteria for a good caption ==
 
== Some criteria for a good caption ==

Revision as of 06:18, 20 January 2017

This page is a part of the UniWiki's Manual of Style. It is a general guideline intended to harmonize article style across the UniWiki, though it is best treated with common sense, and exceptions may apply. Any substantive edit to this page should be approved by the Wiki Manager. When in doubt, discuss first on the talk page.

A caption, also known as a cutline, is text that appears below an image. Most captions draw attention to something in the image that is not obvious, such as its relevance to the text. Captions can consist of a few words of description, or several sentences. Writing good captions can be difficult, and the examples below may be helpful. Along with the title, the lead, and section headings, captions are the most commonly read words in an article, so they should be succinct and informative.

Not every UniWiki image needs a caption; some images are simply decorative. Relatively few may be genuinely self-explanatory. In addition to a caption, alt text—for visually impaired readers—should be added to informative (but not purely decorative) images; see Wikipedia:Alternative text for images.

Some criteria for a good caption

There are several criteria for a good caption. A good caption

  1. clearly identifies the subject of the picture, without detailing the obvious;
  2. is succinct;
  3. establishes the picture's relevance to the article;
  4. provides context for the picture;
  5. draws the reader into the article.

Different people read articles in different ways. Some people start at the top and read each word until the end. Others read the first paragraph and scan through for other interesting information, looking especially at pictures and captions. Those readers, even if the information is adjacent in the text, will not find it unless it is in the caption. However, it is best not to tell the whole story in the caption, but use the caption to make the reader curious about the subject.

Another way of approaching the job: imagine you're giving a lecture based on the encyclopedia article, and you are using the image to illustrate the lecture. What would you say while attention is on the image? What do you want your audience to notice in the image, and why? Corollary: if you have nothing to say about it, then the image probably does not belong in the article.

Clear identification of the subject

One of a caption's primary purposes is to identify the subject of the picture. Make sure your caption does that, without leaving readers to wonder what the subject of the picture might be. Be as unambiguous as practical in identifying the subject. What the picture is is important, too. If the illustration is a painting, the painter's Wikilinked name, the title, and a date give context. The present location may be added in parentheses: (Louvre). Sometimes the date of the image is important: there is a difference between "King Arthur" and "King Arthur in a 19th-century watercolor". If the image of the painting is on the page for the artist's biography, wikilinking the artist's name is not needed. See below for more details. If the image depicts the subject of the article, it need not be wikilinked. For instance, if the article is about J. D. Salinger and the image depicts him, his name should not be linked.

Succinctness

Large automobile engine with Bugatti logo
Mechanical engineers design and build power plants and engines, such as this Volkswagen Group-designed Bugatti W16 engine.

"Succinctness" means using no superfluous or needless words. It is not the same as "brevity", which means using a relatively small number of words. Succinct captions have more power than verbose ones. More than three lines of text in a caption may be distracting; sometimes increasing the pixel width of the image brings better visual balance, or further information can be provided in the article text. And remember that readers wanting full detail can click through to the image description page.

Non-visual media

Because non-visual media imparts no visual information regarding the content of its file, it is often desirable to include a longer description than is typically acceptable with image captions. As with image captions, care should be taken to include enough relevant information in-line so the media file's relevance to the article is made explicit irrespective of the caption. As a general rule, retain broader points in the article body, including specific points in the media file's description field. For example, the statement: "'Yesterday' is one of the Beatles' best-known songs" might be more appropriate for the article body than the statement: "The string arrangement on 'Yesterday' utilises counterpoint, which complements McCartney's vocals by reinforcing the tonic", which might be more appropriate as an ogg file description, especially if the text pertains to the contents of the media file or supports its fair-use rationale.

Technical images

Technical images like charts and diagrams may have captions that are much longer than other images. Prose should still be succinct, but the significance of the image should be fully explained. Any elements not included in a legend or clearly labelled should be defined in the caption. A substantial, full discussion of a technical image may be confined to the caption if it improves the structure of the prose in the main article.

For maps and other images with a legend, the {{legend}} template can be used in the caption instead of (or in addition to) including the legend explaining the color used in the image. This makes the legend more readable, and allows for easy translation into other languages.

Establishing relevance to the article

Large empty tanker underway at sea
... structures and vehicles of all sizes ...

A good caption explains why a picture belongs in an article. "The 1965 Ford Mustang introduced the whiz-bang super-speeder" tells us why it is worth the trouble to show a photo of a 1965 Ford Mustang rather than just any year of that model car. "It was the only one I could find with a suitable license" probably is not a worthy caption reason. Links to relevant sections within the article may help draw the reader in (see here for how to do this).

Providing context for the picture

A picture captures only one moment in time. What happened before and after? What happened outside the frame? For The Last Supper, "Jesus dines with his disciples" tells something, but add "on the eve of his crucifixion" and it tells much more about the significance. Add "With this meal, Jesus established the tradition of Holy Communion" to get more context if you do not cover that in the article. In such a caption the name of the painter and date provide information on the cultural point of view of the particular representation.

Drawing the reader into the article

The caption should lead the reader into the article. For example, in History of the Peerage, a caption for Image:William I of England.jpg might say "William of Normandy overthrew the Anglo-Saxon monarchs, bringing a new style of government." Then the reader gets curious about that new form of government and reads text to learn what it is.

Wording

Template:Shortcut

  • While a short caption is often appropriate, if it might be seen as trivial ("People playing Monopoly"), consider extending it so that it adds value to the image and is related more logically to the surrounding text ("A product of the Great Depression, Monopoly continues to be played today.").
  • Sometimes the title-and-subtitle style with a colon works: "Neoclassicism: antiquity recreated in an 18th-century mode".
  • It is usually unnecessary to state what kind of image is being shown. In the case of a map of the world which clearly shows countries that are members of NATO you can just use the caption "NATO members", rather than "Map of NATO members".
  • An artist's rendition of a subject of history should be identified as such to avoid confusing details of actual events or portrait likenesses with artistic renditions of them, which are not always accurate.
  • Wikipedia has its technical means of getting readers to the full-size version of the image; therefore amending the caption with a direct link to the image (for example, "click for larger view") is not appropriate.

Formatting and punctuation

Template:Shortcut

  • Captions normally start with a capital letter.
  • The text of captions should not be specially formatted (with italics, for example), except in ways that would apply if it occurred in the main text.
  • Most captions are not complete sentences, but merely sentence fragments, which should not end with a period. If any complete sentence occurs in a caption, then all sentences, and any sentence fragments, in that caption should end with a period.
    • "The Conservatory during Macquarie Night Lights, a summer festival" (no final period), but
    • "The Conservatory during Macquarie Night Lights. The Conservatory was spotlit for the occasion." (final period for complete sentence and another to conclude the preceding sentence fragment)

Special situations

Captions of images in infoboxes and other special situations call for special consideration.

Infoboxes and leading images

An infobox image and, in the absence of an infobox, a photograph or other image in the article's lead section, serves to illustrate the topic of the article, as such, the caption should work singularly towards that purpose. Depending on the nature of the subject and the image used, the ideal caption can range from none at all to a regular full-sentence caption. The following examples serve to describe the range of situations for particular infobox images:

  • No caption — Infoboxes normally display the page name as the title of the infobox. If nothing more than the page name needs to be said about the image, then the caption should be omitted as being redundant with the title of the infobox.
  • Short caption — Infoboxes for things that change over time should usually mention the year of the image briefly (e.g. "Cosby in 2010" Template:Oldid. If the image is of a person doing that for which they are known at an otherwise common event, the correct verb delivers the message: "Jackson performs in 1988." Template:Oldid. As an additional example, animals may differ from the one pictured, e.g. Noisy miner "Subspecies leachi" in Template:Oldid, photographs captioned simply "Male" and "Female" for Template:Oldid, and "Publicity photo for Jailhouse Rock (1957)" for Template:Oldid. While more detail could be added, consider carefully whether it might distract the reader from the subject of the article or inform the reader about the importance of the subject.
  • Full sentence caption — When the caption can convey the significance of the article by explaining the significance or context of the image, it should. For example, "Angelou recites her poem, 'On the Pulse of Morning', at President Bill Clinton's inauguration, January 1993", Template:Oldid. In this situation, take extra care that both the image and the caption stay sharply focused on the whole of the article's subject per MOS:INFOBOX. Template:Oldid gives an example of an informative yet brief full-sentence caption describing the key element (the singular protagonist) depicted and its relationship to the article's subject. The need for a full-length caption in an infobox can generally indicate one of two things: 1) an exceptionally appropriate image or 2) an image that doesn't really belong in the infobox. Consider this distinction carefully as it depends on how precisely the image applies to the subject as a whole.

Additional descriptive information about the image should be contained in the image description on the image's page.

Other special situations

Several types of images warrant special treatment:

  • Periodic table snippets for each element – no caption needed
  • Infobox images with mission insignia – no caption needed, but if there is a description of the symbolism, it should be included on the image description page
  • Other images (especially within infoboxes) where the purpose of the image is clearly nominative, that is, that the picture serves as the typical example of the subject of the article and offers no further information – no caption needed.
  • Chemical compound diagrams (as in TNT) could benefit from a mention of the role of the structure in the properties of the compound.
  • Group portraits of a few people (presumably related to the article) should list the names of the individuals so that readers can identify individuals. Larger groups should have an index photo with numbered silhouettes and a key listing each person's name.
  • Portraits of a person in an article about that person should be captioned with the year. If the photo is of a special occasion, such as Wernher von Braun surrendering to the Americans, the caption should follow the usual style.

Tips for describing pictures

Here are some details people might want to know about the picture (all are linkable):

  • What is noteworthy about the subject of the picture? If there is an article on the subject of the picture, link to it.
  • For photographs:
    • Where was it taken?
    • When was it taken?
    • Who took it? (Generally, this is only included in the caption if the photographer is notable)
    • Why was it taken?
  • For works of art (see WikiProject Visual arts Art Manual of Style for fuller details):
    • Who is the artist?
    • What is the title or subject?
    • When was the piece completed?
    • See proper right for ways of unambiguously describing right and left in images.
  • Usually less significant are:
    • What is the medium (oil on canvas/marble/mixed media ...)?
    • Where is it located?
    • What are its dimensions?

Keep in mind that not all of this information needs to be included in the caption, since the image description page should offer more complete information about the picture. If it does not, it may be possible to add it there from reliable sources such as the website of the museum that owns the image.

Credits

Template:Shortcut

"The Raven" depicts a mysterious raven's midnight visit to a mourning narrator, as illustrated by Édouard Manet (1875), digitally restored.

Unless relevant to the subject, do not credit the image author or copyright holder in the article. It is assumed that this is not necessary to fulfill attribution requirements of the GFDL or Creative Commons licenses as long as the appropriate credit is on the image description page. If the artist or photographer is independently notable, though, then a wikilink to the artist's biography may be appropriate, but image credits in the infobox image are discouraged, even if the artist is notable, since the infobox should only contain key facts of the article's subject, per MOS:INFOBOX.

See also

Notes

External links