Difference between revisions of "Help:Style guide"
From Tangowiki
(→Weblinks) |
(→Special symbols) |
||
| (13 intermediate revisions by the same user not shown) | |||
| Line 18: | Line 18: | ||
==Special symbols== | ==Special symbols== | ||
| − | |||
| − | |||
===Apostrophe=== | ===Apostrophe=== | ||
The apostrophe ’ or ' is used in these cases: | The apostrophe ’ or ' is used in these cases: | ||
| Line 28: | Line 26: | ||
<small> | <small> | ||
| − | {| class="wikitable" | + | {| class="wikitable" style="border-color:#fff;" |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
|- | |- | ||
| − | | style="font-size: 150%; background-color:# | + | ! Symbol !! Example !! description !! Short codes !! Unicode HEX code, NAME !! HTML |
| + | |- | ||
| + | | style="font-size:150%;background-color:#a2c59b;"| ’ | ||
| + | | style="background-color:#a2c59b;" | D’Agostino | ||
| + | | correct apostrophe, looks like a "9", correct "single comma quotation mark" | ||
| + | | Windows: Alt+0146<br />Mac: Alt+Shift+# | ||
| + | | U+2019, RIGHT SINGLE QUOTATION MARK | ||
| + | | <syntaxhighlight lang="html5">’</syntaxhighlight> | ||
| + | |- | ||
| + | | style="font-size: 150%;background-color:#e5dd8c;"| ’ | ||
| + | | style="background-color:#e5dd8c;" | D'Agostino | ||
| + | | "typewriter apostrophe", substitute character, straight tail | ||
| + | | Mac: Shift+# | ||
| + | | U+0027, APOSTROPHE | ||
| + | | <syntaxhighlight lang="html5">'</syntaxhighlight> | ||
| + | |- | ||
| + | | style="font-size: 150%;background-color:#c590a4;"| ‘ | ||
| + | | style="background-color:#c590a4;" | D‘Agostino | ||
| + | | single turned comma quotation mark | ||
| + | | | ||
| + | | U+2018, LEFT SINGLE QUOTATION MARK | ||
| + | | <syntaxhighlight lang="html5">‘</syntaxhighlight> | ||
| + | <!--|- | ||
| + | | style="font-size: 150%;background-color:#c590a4;"| ‚ | ||
| + | | style="background-color:#c590a4;" | D‚Agostino | ||
| + | | → use the one above! ↑, used as opening single quotation mark in some languages | ||
| + | | | ||
| + | | U+201A, SINGLE LOW-9 QUOTATION MARK | ||
| + | | <syntaxhighlight lang="html5">‚</syntaxhighlight> | ||
| + | --> | ||
| + | |- | ||
| + | | style="font-size:150%; background-color:#c590a4;"| ′ | ||
| + | | style="background-color:#c590a4;" | D′Agostino | ||
| + | | Prime, units for mathematics, linguistics and music | ||
| + | | | ||
| + | | U+2032 | ||
| + | | <syntaxhighlight lang="html5">′</syntaxhighlight><syntaxhighlight lang="html5">′</syntaxhighlight> | ||
| + | <!-- | ||
| + | |- | ||
| + | | style="font-size: 150%;" | | ||
| + | | | ||
| + | | single reversed comma quotation mark, has same semantic as 2018, but differs in appearance | ||
| + | | | ||
| + | | U+201B, SINGLE HIGH-REVERSED-9 QUOTATION MARK | ||
| + | | --> | ||
| + | |- | ||
| + | | style="font-size:150%;background-color:#c590a4;"| ´ | ||
| + | | style="background-color:#c590a4;" | D´Agostino | ||
| + | | Akut | ||
| + | | ´ | ||
| + | | U+00B4 | ||
| + | | <syntaxhighlight lang="html5">´</syntaxhighlight><syntaxhighlight lang="html5">´</syntaxhighlight> | ||
| + | |- | ||
| + | | style="font-size: 150%;background-color:#c590a4;"| ` | ||
| + | | style="background-color:#c590a4;" | D`Agostino | ||
| + | |Grave | ||
| + | |Mac: Shift+´ | ||
| + | | U+0060 | ||
| + | | <syntaxhighlight lang="html5">`</syntaxhighlight> | ||
|} | |} | ||
</small> | </small> | ||
| − | + | <!---- for later | |
<small> | <small> | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 65: | Line 105: | ||
| style="font-size:150%; background-color:#c590a4;"| || double reversed comma quotation mark, has same semantic as 201C, but differs in appearance|| || U+201F, DOUBLE HIGH-REVERSED-9 QUOTATION MARK || | | style="font-size:150%; background-color:#c590a4;"| || double reversed comma quotation mark, has same semantic as 201C, but differs in appearance|| || U+201F, DOUBLE HIGH-REVERSED-9 QUOTATION MARK || | ||
|- | |- | ||
| − | | style="font-size:150%; background-color:#c590a4;"| ″ || Double prime || || U+2033 || < | + | | style="font-size:150%; background-color:#c590a4;"| ″ || Double prime || || U+2033 || <syntaxhighlight lang="html5">″</syntaxhighlight><syntaxhighlight lang="html5">″ </syntaxhighlight> |
|- | |- | ||
| − | | style="font-size:150%; background-color:#c590a4;"| ‴ || Triple prime || || U+2034 || < | + | | style="font-size:150%; background-color:#c590a4;"| ‴ || Triple prime || || U+2034 || <syntaxhighlight lang="html5">‴</syntaxhighlight> <syntaxhighlight lang="html5">‴</syntaxhighlight> |
|} | |} | ||
</small> | </small> | ||
| − | + | ||
| + | The usage of apostrophes is language specific. For example, in the German language, the usage of the "99"+"66" (201E, 201C) as quotation marks is correct: <code>This is not „real“ German.</code> <ref>See more on this on [https://en.wikipedia.org/wiki/Quotation_mark quotation mark on Wikipedia].</ref> | ||
| + | --> | ||
==See also== | ==See also== | ||
| Line 76: | Line 118: | ||
==Weblinks== | ==Weblinks== | ||
| − | *[http://en.wikipedia.org/wiki/Prime_(symbol) Prime (symbol) | + | *[https://en.wikipedia.org/wiki/Apostrophe Wikipedia: Apostrophe] |
| − | *[https://en.wikipedia.org/wiki/Quotation_mark Quotation mark | + | *[http://en.wikipedia.org/wiki/Prime_(symbol) Wikipedia: Prime (symbol)] |
| + | *[https://en.wikipedia.org/wiki/Quotation_mark Wikipedia: Quotation mark] | ||
*[http://www.unicode.org/charts/PDF/U2000.pdf Unicode chart "General punctuation"] (PDF) | *[http://www.unicode.org/charts/PDF/U2000.pdf Unicode chart "General punctuation"] (PDF) | ||
| + | *[http://www.typewolf.com/cheatsheet Typewolf typography cheatsheet] | ||
==References== | ==References== | ||
<references /> | <references /> | ||
Latest revision as of 12:33, 16 August 2015
This style guide tries to help with writing text for the wiki. It shall describe no rules, really – instead recommendations, guidelines and best practices.
Know the rules before you break them.
Contents
Writing text for the wiki
In free text, stick to a clear and simple language. Enjoy your own text! There is no "wrong", only "could be improved". Like in an encyclopedia, the writing style shall be neutral, factual, objective, descriptive, non-personal.
- Write in neutral style. Neutral means, do not write opinonated. If there are opposing opinions to a subject, include all of them and investigate their plausibility.
- Use hard facts. If there exist hard facts, include them wherever possible. Hard facts are the basis of all texts.
- Cite your sources. Whether you use quotations, you quote a sentence from a source, rephrase a thought or an opinion or you became influenced in your writing by a certain source – always cite it. See Cite a source for more on how to quote.
- Be objective, not subjective. Do not write "I" in texts. There is no first person.
- Use common words. Remember that your readers might be non-native speakers of the English language. If the translation into their language is not yet available, they might as well do with English. Here, rather opt for "simple" words than their "complicated" siblings.[1]
- Do not advertise. TangoWiki is no place for advertisement. Text parts like "the best festival in the world, get now 20 % discount if you book until Sunday" won't last long – they will either get re-written or deleted entirely. Platforms like personal websites are a better place for this. This has two exceptions:
- One might argue that it might still be of good influence for events and places to be present in the wiki. Factual, objective information is of high use for the reader. So to call it, "indirect advertisment".
- If you love advertising, please help out with promoting TangoWiki to the world.
Special symbols
Apostrophe
The apostrophe ’ or ' is used in these cases:
- Omission of letters: Juan D’Arienzo
- Possessive case: D’Agostino’s film
The correct apostrophe is a point with a downwards tail curving clockwise, like in the comma (the "9"). Its look also depends on the typeface in use!
| Symbol | Example | description | Short codes | Unicode HEX code, NAME | HTML |
|---|---|---|---|---|---|
| ’ | D’Agostino | correct apostrophe, looks like a "9", correct "single comma quotation mark" | Windows: Alt+0146 Mac: Alt+Shift+# |
U+2019, RIGHT SINGLE QUOTATION MARK | ’ |
| ’ | D'Agostino | "typewriter apostrophe", substitute character, straight tail | Mac: Shift+# | U+0027, APOSTROPHE | ' |
| ‘ | D‘Agostino | single turned comma quotation mark | U+2018, LEFT SINGLE QUOTATION MARK | ‘ | |
| ′ | D′Agostino | Prime, units for mathematics, linguistics and music | U+2032 | ′′ | |
| ´ | D´Agostino | Akut | ´ | U+00B4 | ´´ |
| ` | D`Agostino | Grave | Mac: Shift+´ | U+0060 | ` |
See also
- Form guidelines for quick help in creating articles with forms
Weblinks
- Wikipedia: Apostrophe
- Wikipedia: Prime (symbol)
- Wikipedia: Quotation mark
- Unicode chart "General punctuation" (PDF)
- Typewolf typography cheatsheet
References
- ↑ "[…] so prefer let to permit, people to persons, buy to purchase, colleague to peer, way out to exit, present to gift, rich to wealthy, show to demonstrate, break to violate. "The Economist: Introduction to the writing style guide.
