Difference between revisions of "UniWiki:Manual of Style/Captions"
(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...") |
|||
(15 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{UMoS guideline}} |
− | |||
− | |||
− | |||
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 | + | 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 == | ||
Line 20: | Line 17: | ||
=== Clear identification of the subject === | === 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 | + | 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: ([[Wikipedia:Louvre|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 [[Wikipedia:J.D. Salinger|J. D. Salinger]] and the image depicts him, his name should not be linked. |
=== Succinctness === | === Succinctness === | ||
− | |||
− | |||
− | + | "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 [[Wikipedia:Wikipedia:Image description page|image description page]]. | |
− | |||
===Technical images=== | ===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. | 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. | ||
− | + | === Establishing relevance to the article === | |
− | + | 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 [[Wikipedia:Wikipedia:How_to_edit_a_page#The_wiki_markup|here]] for how to do this). | |
− | |||
− | 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 [[Wikipedia:How_to_edit_a_page#The_wiki_markup|here]] for how to do this) | ||
=== Providing context for the picture === | === 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. | + | A picture captures only one moment in time. What happened before and after? What happened outside the frame? For [[Wikipedia:The Last Supper|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 [[Wikipedia:Holy Communion|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 === | === 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 I of England|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. | + | The caption should lead the reader into the article. For example, in [[Wikipedia:History of the Peerage|History of the Peerage]], a caption for [[Wikipedia:Image:William I of England.jpg|Image:William I of England.jpg]] might say "[[Wikipedia:William I of England|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 === | === Wording === | ||
− | + | ||
− | *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."). | + | * 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 [[Wikipedia:Great Depression|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". | + | * 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". | + | * 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 [[Wikipedia:NATO|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. | + | * 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. |
− | * | + | * The UniWiki 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 === | === Formatting and punctuation === | ||
− | + | ||
* Captions normally start with a capital letter. | * 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. | * 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 | + | * Most captions are not complete sentences, but merely [[Wikipedia:Sentence fragment|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, 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) | ** "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) | ||
Line 64: | Line 56: | ||
=== Infoboxes and leading images === | === Infoboxes and leading images === | ||
− | An infobox image and, in the absence of an infobox, a photograph or other image in the article's [[ | + | An infobox image and, in the absence of an infobox, a photograph or other image in the article's [[UniWiki:Manual of Style/Lead section|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. | * '''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" | + | * '''Short caption''' — Infoboxes for things that change over time should usually mention the year of the image briefly (e.g. "Cosby in 2010" [[Wikipedia:Bill Cosby|Bill Cosby]]. 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." [[Wikipedia:Michael Jackson|Michael Jackson]]. As an additional example, animals may differ from the one pictured, e.g. Noisy miner "Subspecies ''leachi''" in [[Wikipedia:Noisy miner|Noisy miner]], photographs captioned simply "Male" and "Female" for [[Wikipedia:Lion|Lion]], and "Publicity photo for ''Jailhouse Rock'' (1957)" for [[Wikipedia:Elvis Presley|Elvis Presley]]. 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", | + | * '''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", [[Wikipedia:Maya Angelou|Maya Angelou]]. 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 [[UniWiki:Manual of Style/Infoboxes]]. [[Wikipedia:BioShock Infinite|BioShock Infinite]] 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. | Additional descriptive information about the image should be contained in the image description on the image's page. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Tips for describing pictures == | == Tips for describing pictures == | ||
Line 89: | Line 72: | ||
**Who took it? (Generally, this is only included in the caption if the photographer is notable) | **Who took it? (Generally, this is only included in the caption if the photographer is notable) | ||
**Why was it taken? | **Why was it taken? | ||
− | * | + | **See [[Wikipedia:Proper right|proper right]] for ways of unambiguously describing right and left in images. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | Keep in mind that not all of this information needs to be included in the caption, since the [[Wikipedia:Image description page|image description page]] should offer more complete information about the picture | + | Keep in mind that not all of this information needs to be included in the caption, since the [[Wikipedia:Wikipedia:Image description page|image description page]] should offer more complete information about the picture. |
== Credits == | == Credits == | ||
− | + | ||
− | + | 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 [[UniWiki:Manual of Style/Infoboxes]]. | |
− | 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 [[ | ||
== See also == | == See also == | ||
− | * [[ | + | * [[UniWiki:Manual of Style#Captions]] – Main UMoS entry for captions with formatting recommendations |
− | *[[ | + | * [[UniWiki:Manual of Style/Accessibility#Images]] |
− | *[[Wikipedia:Alternative text for images]] | + | * [[Wikipedia:Wikipedia:Alternative text for images|Wikipedia:Alternative text for images]] |
− | *[[Wikipedia:Images]] | + | * [[Wikipedia:Wikipedia:Images|Wikipedia:Images]] |
− | *[[Wikipedia: | + | * [[Wikipedia:Wikipedia:Picture tutorial|Wikipedia:Picture tutorial]] |
− | + | * [[Wikipedia:Wikipedia:Uploading images|Wikipedia:Uploading images]] | |
− | *[[Wikipedia:Uploading images | ||
− | |||
== Notes == | == Notes == |
Latest revision as of 06:35, 20 January 2017
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.
There are several criteria for a good caption. A good caption
- clearly identifies the subject of the picture, without detailing the obvious;
- is succinct;
- establishes the picture's relevance to the article;
- provides context for the picture;
- 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
"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.
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.
Establishing relevance to the article
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
- 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.
- The UniWiki 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
- 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" Bill Cosby. 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." Michael Jackson. As an additional example, animals may differ from the one pictured, e.g. Noisy miner "Subspecies leachi" in Noisy miner, photographs captioned simply "Male" and "Female" for Lion, and "Publicity photo for Jailhouse Rock (1957)" for Elvis Presley. 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", Maya Angelou. 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 UniWiki:Manual of Style/Infoboxes. BioShock Infinite 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.
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?
- See proper right for ways of unambiguously describing right and left in images.
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.
Credits
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 UniWiki:Manual of Style/Infoboxes.
See also
- UniWiki:Manual of Style#Captions – Main UMoS entry for captions with formatting recommendations
- UniWiki:Manual of Style/Accessibility#Images
- Wikipedia:Alternative text for images
- Wikipedia:Images
- Wikipedia:Picture tutorial
- Wikipedia:Uploading images