UniWiki:Manual of Style/Text formatting: Difference between revisions

Line 43:

The use of italics for emphasis on the UniWiki should follow good English print style. The most [[UniWiki:Manual of Style/Accessibility|accessible]] way to indicate emphasis is with the HTML {{tag|em}}. Emphasis may be used to draw attention to an important word or phrase within a sentence, when the point or thrust of the sentence may otherwise not be apparent to readers, or to stress a contrast:

:{{xt|Gellner accepts that knowledge must be knowledge ~~{{em|~~of}} something.}}

:{{xt|Gellner accepts that knowledge must be knowledge ''of'' something.}}

It may be preferable to avoid the need for emphasis by rewriting a sentence more explicitly. Use of emphasis more than once in a sentence is rarely helpful to readers, unless the emphasized terms are being directly compared.

~~{{em|~~Other, non-emphasis, uses of italics on Wikipedia should use <code><nowiki>''...''</nowiki></code> markup, not {{tag|em|o}}.}}

''Other, non-emphasis, uses of italics on Wikipedia should use <code><nowiki>''...''</nowiki></code> markup, not {{tag|em|o''.}}

===Names and titles===

Line 56:

* '''Major works of art and artifice,''' such as albums, books, video games, films, journals, magazines, epic poems, television programs, and radio shows. Medium of publication or presentation is not a factor; a video feature only released on video tape, disc or the Internet is considered a "film" for these purposes, and so on. ''(See {{section link|UniWiki:Manual of Style/Titles|Italics}} for details.)''

:~~{{em|~~Minor works}} (and any specifically-titled subdivisions of italicized major works) are given in double quotation marks. ''See below: [[#When not to use italics|When not to use italics]] for details.''

:''Minor works'' (and any specifically-titled subdivisions of italicized major works) are given in double quotation marks. ''See below: [[#When not to use italics|When not to use italics]] for details.''

:These cases are well-established conventions recognized in most style guides. Do not apply italics to other categories or instances because you feel they are creative or artful (e.g. game or sport moves, logical arguments, "artisanal" products, schools of practice or thought, etc.).

Line 129:

Here, the cross-referenced article does not topically make a good target for a running-text link from the phrase "[[Wikipedia:Demographics of France|largest population in Europe]]", or any other text in the sentence, but has been deemed relevant enough to mention in passing without relegating it to the "See also" section at the bottom of the article. In any case where such a link in running text [[UniWiki:Manual of Style/Linking#Piped links|would be proper]], it is preferred over a parenthetical, explicit cross-reference.

Like hatnotes, these parenthetical cross-references are set off by being italicized in their entirety, as [[UniWiki:Manual of Style/Self-references to avoid|UniWiki self-references]], and not part of the article content proper. Unlike some traditional reference works, the convention that has evolved on the UniWiki is ~~{{em|~~not}} to individually italicize "see" or "see also". The UniWiki's own article titles are not put in quotation marks in such cross-references.

Like hatnotes, these parenthetical cross-references are set off by being italicized in their entirety, as [[UniWiki:Manual of Style/Self-references to avoid|UniWiki self-references]], and not part of the article content proper. Unlike some traditional reference works, the convention that has evolved on the UniWiki is ''not'' to individually italicize "see" or "see also". The UniWiki's own article titles are not put in quotation marks in such cross-references.

=== When not to use italics ===

Line 164:

#Colors used in templates such as [[Wikipedia:Wikipedia:Categories, lists, and navigation templates#Navigation templates|navboxes]] and [[Wikipedia:Wikipedia:Infobox|infoboxes]], and in [[Wikipedia:Wikipedia:Table|tables]], should not make reading difficult, including for colorblind or otherwise visually impaired readers.

#Colors that are useful for identification and are ~~{{em|~~appropriate, representative, and accessible}} may be used with discretion and common sense. In general, text color should not be anything other than black or white (excluding the standard colors of hyperlinks), and background colors should contrast the text color enough to make the template easily readable.

#Colors that are useful for identification and are ''appropriate, representative, and accessible'' may be used with discretion and common sense. In general, text color should not be anything other than black or white (excluding the standard colors of hyperlinks), and background colors should contrast the text color enough to make the template easily readable.

#An "appropriate, representative" color, when intended to identify with an organization's logo or branding, should use the most prominent ~~{{em|~~accessible}} color in the logo. A representative color useful in a navbox is often already present in an article's infobox (if included).

#An "appropriate, representative" color, when intended to identify with an organization's logo or branding, should use the most prominent ''accessible'' color in the logo. A representative color useful in a navbox is often already present in an article's infobox (if included).

#In the case that no properly identifying, accessible color exists; or the subject of the template or table should not be identified with a particular color (e.g., an average biography), the default colors provided by the template or the table class should be used.

#If an article includes several navboxes whose colors conflict with each other, discretion should be used to minimize the visual disruption by using the default colors for navboxes.

@@ Line 43: / Line 43: @@
 The use of italics for emphasis on the UniWiki should follow good English print style. The most [[UniWiki:Manual of Style/Accessibility|accessible]] way to indicate emphasis is with the HTML {{tag|em}}. Emphasis may be used to draw attention to an important word or phrase within a sentence, when the point or thrust of the sentence may otherwise not be apparent to readers, or to stress a contrast:
-:{{xt|Gellner accepts that knowledge must be knowledge {{em|of}} something.}}
+:{{xt|Gellner accepts that knowledge must be knowledge ''of'' something.}}
 It may be preferable to avoid the need for emphasis by rewriting a sentence more explicitly. Use of emphasis more than once in a sentence is rarely helpful to readers, unless the emphasized terms are being directly compared.
-{{em|Other, non-emphasis, uses of italics on Wikipedia should use <code><nowiki>''...''</nowiki></code> markup, not {{tag|em|o}}.}}
+''Other, non-emphasis, uses of italics on Wikipedia should use <code><nowiki>''...''</nowiki></code> markup, not {{tag|em|o''.}}
 ===Names and titles===
@@ Line 56: / Line 56: @@
 * '''Major works of art and artifice,''' such as albums, books, video games, films, journals, magazines, epic poems, television programs, and radio shows. Medium of publication or presentation is not a factor; a video feature only released on video tape, disc or the Internet is considered a "film" for these purposes, and so on. ''(See {{section link|UniWiki:Manual of Style/Titles|Italics}} for details.)''
-:{{em|Minor works}} (and any specifically-titled subdivisions of italicized major works) are given in double quotation marks. ''See below: [[#When not to use italics|When not to use italics]] for details.''
+:''Minor works'' (and any specifically-titled subdivisions of italicized major works) are given in double quotation marks. ''See below: [[#When not to use italics|When not to use italics]] for details.''
 :These cases are well-established conventions recognized in most style guides. Do not apply italics to other categories or instances because you feel they are creative or artful (e.g. game or sport moves, logical arguments, "artisanal" products, schools of practice or thought, etc.).
@@ Line 129: / Line 129: @@
 Here, the cross-referenced article does not topically make a good target for a running-text link from the phrase "[[Wikipedia:Demographics of France|largest population in Europe]]", or any other text in the sentence, but has been deemed relevant enough to mention in passing without relegating it to the "See also" section at the bottom of the article.  In any case where such a link in running text [[UniWiki:Manual of Style/Linking#Piped links|would be proper]], it is preferred over a parenthetical, explicit cross-reference.
-Like hatnotes, these parenthetical cross-references are set off by being italicized in their entirety, as [[UniWiki:Manual of Style/Self-references to avoid|UniWiki self-references]], and not part of the article content proper. Unlike some traditional reference works, the convention that has evolved on the UniWiki is {{em|not}} to individually italicize "see" or "see also". The UniWiki's own article titles are not put in quotation marks in such cross-references.
+Like hatnotes, these parenthetical cross-references are set off by being italicized in their entirety, as [[UniWiki:Manual of Style/Self-references to avoid|UniWiki self-references]], and not part of the article content proper. Unlike some traditional reference works, the convention that has evolved on the UniWiki is ''not'' to individually italicize "see" or "see also". The UniWiki's own article titles are not put in quotation marks in such cross-references.
 === When not to use italics ===
@@ Line 164: / Line 164: @@
 #Colors used in templates such as [[Wikipedia:Wikipedia:Categories, lists, and navigation templates#Navigation templates|navboxes]] and [[Wikipedia:Wikipedia:Infobox|infoboxes]], and in [[Wikipedia:Wikipedia:Table|tables]], should not make reading difficult, including for colorblind or otherwise visually impaired readers.
-#Colors that are useful for identification and are {{em|appropriate, representative, and accessible}} may be used with discretion and common sense. In general, text color should not be anything other than black or white (excluding the standard colors of hyperlinks), and background colors should contrast the text color enough to make the template easily readable.
+#Colors that are useful for identification and are ''appropriate, representative, and accessible'' may be used with discretion and common sense. In general, text color should not be anything other than black or white (excluding the standard colors of hyperlinks), and background colors should contrast the text color enough to make the template easily readable.
-#An "appropriate, representative" color, when intended to identify with an organization's logo or branding, should use the most prominent {{em|accessible}} color in the logo. A representative color useful in a navbox is often already present in an article's infobox (if included).
+#An "appropriate, representative" color, when intended to identify with an organization's logo or branding, should use the most prominent ''accessible'' color in the logo. A representative color useful in a navbox is often already present in an article's infobox (if included).
 #In the case that no properly identifying, accessible color exists; or the subject of the template or table should not be identified with a particular color (e.g., an average biography), the default colors provided by the template or the table class should be used.
 #If an article includes several navboxes whose colors conflict with each other, discretion should be used to minimize the visual disruption by using the default colors for navboxes.