Difference between revisions of "User:Fyahweather/An Editor's Handbook"
Fyahweather (talk | contribs) (I'll take a break.) |
m (Removed templates) |
||
(9 intermediate revisions by 4 users not shown) | |||
Line 8: | Line 8: | ||
==Maintenance Templates== | ==Maintenance Templates== | ||
Remember that for many of these a | can be put after the word to add additional notes. | Remember that for many of these a | can be put after the word to add additional notes. | ||
− | |||
− | |||
=== Article Status === | === Article Status === | ||
Line 21: | Line 19: | ||
* {{tl|Strategy-WIP}} | * {{tl|Strategy-WIP}} | ||
− | {{ | + | {{ambox |
− | {{ | + | | style = margin:1em 0; border:none; border-top:1px solid #ccc; border-bottom:1px solid #ccc; background:none; font-style:italic; |
− | {{ | + | | image = DisamMap.png |
+ | | imagewidth = 48px | ||
+ | | contents = {{ambox/message | ||
+ | | 2style = font-weight: normal; font-style:{{lang|en=italic|zh-hans=normal|zh-hant=normal}}; | ||
+ | | 3style = font-size: 90%; font-style:{{lang|en=italic|zh-hans=normal|zh-hant=normal}}; | ||
+ | | 2 = This disambiguation page lists articles with a similar title or acronym. | ||
+ | | 3 = If an [{{fullurl:Special:WhatLinksHere/{{{page-title|{{FULLPAGENAME}}}}}|namespace=0}} internal link] led you here, you may wish to change the link to point directly to the intended article. | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Crafting anvil.png | ||
+ | | imagewidth = 24px | ||
+ | | contents = {{ambox/message | ||
+ | | 1 = You are so small! Is funny to me! | ||
+ | | 3 = '''This {{#ifeq:{{{type|}}}|section|section|article}} is a [[:Category:Stubs|stub]]'''. As such, it is not complete. You can help Team Fortress Wiki by [{{fullurl:{{FULLPAGENAME}}|action=edit}} expanding it]. | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Dead Heat Icon.png | ||
+ | | style = margin: 1em 10%; | ||
+ | | contents = {{ambox/message | ||
+ | | 1 = Let's go, let's go, let's go! | ||
+ | | 2 = This article documents a recent item or map addition. It may contain speculation, broken links or inaccuracies. | ||
+ | | 3 = You can help improve it by [{{fullurl:{{FULLPAGENAMEE}}|action=edit}} editing this page] to include new information. | ||
+ | }} | ||
+ | }} | ||
{{beta}} | {{beta}} | ||
{{unreleased}} | {{unreleased}} | ||
Line 34: | Line 59: | ||
* {{tl|Cleanup}} | * {{tl|Cleanup}} | ||
* {{tl|Rewrite}} | * {{tl|Rewrite}} | ||
− | |||
* {{tl|retranslate}} | * {{tl|retranslate}} | ||
* {{tl|Expandlist}} | * {{tl|Expandlist}} | ||
− | {{ | + | {{Ambox |
− | {{ | + | | image = Tam O'Shatter Icon.png |
− | {{ | + | | type = style |
− | {{ | + | | contents = {{ambox/message |
− | {{ | + | | 1 = Oh dear, I've made quite a mess. |
+ | | 2 = This page has been marked for general cleanup. Reason given: ''none given'' | ||
+ | | 3 = Please see [[Help:Style guide|Team Fortress Wiki style guide]] for information on how to improve this article. | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Five Second Plan Icon.png | ||
+ | | imagewidth = 48px | ||
+ | | contents = {{ambox/message | ||
+ | | 2style = font-weight: normal; | ||
+ | | 2 = This article or section '''may need to be rewritten entirely''' to comply with Team Fortress Wiki's [[Help:Style guide|'''quality standards''']]. | ||
+ | | 3 = [{{fullurl:{{FULLPAGENAMEE}}|action=edit}} You can help]. The [[{{TALKPAGENAMEE}}|discussion page]] may contain suggestions. | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Icon-merge-arrows.png | ||
+ | | contents = {{ambox/message | ||
+ | | 2 = The [[{{BASEPAGENAME}}|English version]] of the article has undergone changes. This page may require retranslation. | ||
+ | | 3 = You can [{{fullurl:{{BASEPAGENAME}}|action=edit}} view the page source here]. If you need help, post on the [[{{TALKPAGENAME}}|talk page]] or view the [[Help:Language translation|guide to language translation]]. | ||
+ | }} | ||
+ | }} | ||
==== File Content ==== | ==== File Content ==== | ||
Line 51: | Line 97: | ||
* {{tl|Externally linked}} | * {{tl|Externally linked}} | ||
− | {{ | + | {{Ambox |
− | {{ | + | | type = content |
− | {{ | + | | image = Cooking The Books Icon.png |
− | + | | contents = {{ambox/message | |
+ | | 1 = Bloody hell, you're awful! | ||
+ | | 2 = This image file requires improvement: <span style="font-weight:normal;">(on low quality settings - needs retaking with AA to full, and improved cutting out. Also the flamethrower is very distracting.)</span> | ||
+ | | 3 = You can help Team Fortress Wiki by [[Help:Images#Uploading_images|uploading a new version]] (see [[Team Fortress Wiki:Images|image guidelines]]). | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Freezer Burn Icon.png | ||
+ | | contents = {{ambox/message | ||
+ | | 1 = What are you lookin' at?! | ||
+ | | 2 = This page would benefit from the addition of one or more images. | ||
+ | | 3 = Please add a suitable image, then remove this notice. | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Thats_a_wrap.png | ||
+ | | contents= {{ambox/message | ||
+ | | 1 = You prancin' show ponies! | ||
+ | | 2 = This page would benefit from the addition of one or more videos. | ||
+ | | 3 = Please add a suitable video, then remove this notice. | ||
+ | }} | ||
+ | }} | ||
==== Page Organization ==== | ==== Page Organization ==== | ||
Line 60: | Line 129: | ||
* {{tlx|Move|Proposed target title}} | * {{tlx|Move|Proposed target title}} | ||
* {{tlx|Merge|Proposed merger target}} | * {{tlx|Merge|Proposed merger target}} | ||
− | * {{ | + | * {{tlx|Split|Time limit for split}} |
− | |||
− | {{ | + | {{Ambox |
− | {{ | + | | type = delete |
− | {{Merge| | + | | image = Pdadestroy.png |
− | {{ | + | | contents = {{ambox/message |
− | {{ | + | | 2 = This user page has been marked for deletion. See [[{{TALKPAGENAME}}|discussion on the talk page]]. |
+ | | 3 = Reason given: ''none given'' | ||
+ | | 4 = <hr style="margin:0.25em 0em; background:#BB7070;" /> Administrators: [[Special:Whatlinkshere/{{FULLPAGENAME}}|links]]{{n}}[{{fullurl:{{FULLPAGENAME}}|action=history}} history] ([{{fullurl:{{FULLPAGENAME}}|diff=0}} last]){{n}}[{{fullurl:Special:Log|page={{FULLPAGENAMEE}}}} logs]{{n}} [{{fullurl:{{FULLPAGENAME}}|action=delete}} '''delete'''] | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Icon Page move.png | ||
+ | | contents = {{ambox/message | ||
+ | | 1 = Gotta' move that gear up! | ||
+ | | 2 = It has been proposed that [[User:Fyahweather/An Editor's Handbook]] be renamed and moved to [[An Editor's Guide]]. | ||
+ | | 3 = Discussion to support or oppose the move should be on this article's talk page, usually under the heading "[[User talk:Fyahweather/An Editor's Handbook#Requested Move]]." If, after a few days, a clear consensus for the page move is reached, one of the [[Help:Group rights|administrators]] will move the article and remove this notice.<br>The creator of this move request has not set an expiry date. | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Icon Page merge.png | ||
+ | | contents = {{ambox/message | ||
+ | | 1 = We go together, Doctor! | ||
+ | | 2 = It has been suggested that this {{ #if: {{NAMESPACE}} | page | article }} or section be merged with ''[[Editing]]''. | ||
+ | | 3 = Discussion to support or oppose the merge should be on this article's talk page{{#if:{{{section|}}}||, usually}} under the heading "[[{{TALKPAGENAME}}#{{{section|Merge}}}|{{{section|Merge}}}]]". | ||
+ | }} | ||
+ | }} | ||
+ | {{Ambox | ||
+ | | type = content | ||
+ | | image = Robbed Royal Icon.png | ||
+ | | contents = {{ambox/message | ||
+ | | 1 = Dis map ain't big enough for da two of us! | ||
+ | | 2 = It has been suggested that this {{ #if: {{NAMESPACE}} | page | article }} or section be split into multiple new {{ #if: {{NAMESPACE}} | pages | articles }}. | ||
+ | | 3 = Discussion to support or oppose the split should be on this article's talk page{{#if:{{{section|}}}||, usually}} under the heading "[[{{TALKPAGENAME}}#{{{section|Split}}}|{{{section|Split}}}]]".<br>The creator of this split request has set an expiry date of '''6/27/99'''. | ||
+ | }} | ||
+ | }} | ||
== Creating a Custom Signature == | == Creating a Custom Signature == | ||
Line 98: | Line 197: | ||
:: You can include this template by using the following code: | :: You can include this template by using the following code: | ||
<pre style="margin-left:75px"><nowiki>{{Featured article candidate}}</nowiki></pre> | <pre style="margin-left:75px"><nowiki>{{Featured article candidate}}</nowiki></pre> | ||
− | {{Featured article candidate}} | + | {{Ambox |
+ | |image=Silvertrophy.png | ||
+ | |type=content | ||
+ | |contents= | ||
+ | ''"Now that there was a fine piece 'a work."''<br>'''[[User:Fyahweather/An Editor's Handbook]] is a [[:Category:Featured articles|featured article]] candidate.'''<br> <small>This page has been identified as possibly meeting the featured article criteria.</small> | ||
+ | }} | ||
+ | |||
:3. Lastly, you need to add the article to the list of [[Team Fortress Wiki:Projects/Featured articles/Nominations|nominated]] articles. | :3. Lastly, you need to add the article to the list of [[Team Fortress Wiki:Projects/Featured articles/Nominations|nominated]] articles. | ||
Line 288: | Line 393: | ||
;Pronunciation | ;Pronunciation | ||
− | :If a word is too difficult to pronounce, the correct pronunciation isn't something most people know, or the word is not part of the English language, then the correct | + | :If a word is too difficult to pronounce, the correct pronunciation isn't something most people know, or the word is not part of the English language, then the correct [[w:IPA|IPA]] pronunciation (if not English) in the Merriam-Webster pronunciation (if English or a place name) should be provided. (Along with a recording of the word being said clearly and correctly.) |
:Leave some silence at the end of a recording for browsers and players which truncate sound files. | :Leave some silence at the end of a recording for browsers and players which truncate sound files. | ||
Line 335: | Line 440: | ||
*<nowiki>''text here''</nowiki> ''italicizes'' the word. | *<nowiki>''text here''</nowiki> ''italicizes'' the word. | ||
− | *<nowiki>'''text here'''</nowiki> ''boldens'' the word. | + | *<nowiki>'''text here'''</nowiki> '''boldens''' the word. |
*<nowiki>'''''text here'''''</nowiki> '''''boldens and italicizes''''' the word. | *<nowiki>'''''text here'''''</nowiki> '''''boldens and italicizes''''' the word. | ||
*<nowiki>[[link here]]</nowiki> makes a link to [[Page]] | *<nowiki>[[link here]]</nowiki> makes a link to [[Page]] | ||
*<nowiki>[[link here|substituted words]]</nowiki> makes a link to [[Page]], but in different words, such as [[Page|Edition]]. | *<nowiki>[[link here|substituted words]]</nowiki> makes a link to [[Page]], but in different words, such as [[Page|Edition]]. | ||
*<nowiki>[[Category:Gameplay]]</nowiki> puts a page in the Gameplay category. | *<nowiki>[[Category:Gameplay]]</nowiki> puts a page in the Gameplay category. | ||
+ | |||
+ | ==Quotes== | ||
+ | To make a quote, use <nowiki>{{Quotation|Speaker|Spoken words|sound=file name here}} </nowiki> Alternatively, cut the sound area out if there is no file available or the text is written, and use <nowiki>{{Quotation|Speaker|Spoken words}} </nowiki> | ||
+ | {{Quotation|'''The Medic'''|Gesundheit!|sound=Medic_battlecry06.wav}} | ||
+ | {{Quotation|'''Back Scratcher''' publicity blurb|When asked about it, the Pyro claims to have found it in the garden and has been using it as a backscratcher, though we must admit we have always wondered how the bent teeth and bloodstains got there. Now we know.}} |
Latest revision as of 18:43, 20 January 2023
“ | Take that, booksmarts!
Click to listen
— The Bad Editor
|
” |
This Editor's Handbook is designed to compile all useful templates and style guides an editor may need.
Maintenance Templates
Remember that for many of these a | can be put after the word to add additional notes.
Article Status
Use these to tell others about the status of the article.
{{disambignote}}
{{Stub}}
{{Recent addition}}
{{beta}}
{{unreleased}}
{{Strategy-WIP}}
This disambiguation page lists articles with a similar title or acronym. If an internal link led you here, you may wish to change the link to point directly to the intended article. |
“You are so small! Is funny to me!” This article is a stub. As such, it is not complete. You can help Team Fortress Wiki by expanding it. |
“Let's go, let's go, let's go!” This article documents a recent item or map addition. It may contain speculation, broken links or inaccuracies. You can help improve it by editing this page to include new information. |
“Ok guys, bad news: we lost that last one.” This article documents beta/cut/unused/experimental content for Team Fortress 2. It may contain speculation, broken links or errors. |
“Ok guys, bad news: we lost that last one.” This article documents unreleased content. It may contain speculation, broken links, or errors. |
The strategy articles are due for complete revision. Suggestions for how revisions should be done are welcomed here. If you're feeling bold, go ahead and start editing right away. |
Requests
Use these to request improvement, addition, or organization.
Page Content
{{Cleanup}}
{{Rewrite}}
{{retranslate}}
{{Expandlist}}
“Oh dear, I've made quite a mess.” This page has been marked for general cleanup. Reason given: none given Please see Team Fortress Wiki style guide for information on how to improve this article. |
This article or section may need to be rewritten entirely to comply with Team Fortress Wiki's quality standards. You can help. The discussion page may contain suggestions. |
The English version of the article has undergone changes. This page may require retranslation. You can view the page source here. If you need help, post on the talk page or view the guide to language translation. |
File Content
{{Improveimage|Notes for improvement}}
{{Needimage}}
{{Needvideo}}
{{Externally linked}}
“Bloody hell, you're awful!” This image file requires improvement: (on low quality settings - needs retaking with AA to full, and improved cutting out. Also the flamethrower is very distracting.) You can help Team Fortress Wiki by uploading a new version (see image guidelines). |
“What are you lookin' at?!” This page would benefit from the addition of one or more images. Please add a suitable image, then remove this notice. |
“You prancin' show ponies!” This page would benefit from the addition of one or more videos. Please add a suitable video, then remove this notice. |
Page Organization
{{Delete|Reason for deletion}}
{{Move|Proposed target title}}
{{Merge|Proposed merger target}}
{{Split|Time limit for split}}
This user page has been marked for deletion. See discussion on the talk page. Reason given: none given Administrators: links – history (last) – logs – delete |
“Gotta' move that gear up!” It has been proposed that User:Fyahweather/An Editor's Handbook be renamed and moved to An Editor's Guide. Discussion to support or oppose the move should be on this article's talk page, usually under the heading "User talk:Fyahweather/An Editor's Handbook#Requested Move." If, after a few days, a clear consensus for the page move is reached, one of the administrators will move the article and remove this notice. The creator of this move request has not set an expiry date. |
“We go together, Doctor!” It has been suggested that this page or section be merged with Editing. Discussion to support or oppose the merge should be on this article's talk page, usually under the heading "Merge". |
“Dis map ain't big enough for da two of us!” It has been suggested that this page or section be split into multiple new pages. Discussion to support or oppose the split should be on this article's talk page, usually under the heading "Split". The creator of this split request has set an expiry date of 6/27/99. |
Creating a Custom Signature
- 1. Navigate to User:USERNAME/Sig
- Note: Replace USERNAME with your Team Fortress Wiki username.
- 2. Edit the page, and include everything that you want to be in your sig. For example, to recreate the default signature, you'd add something like:
[[User:USERNAME|USERNAME]]
- 3. Save the page
- 4. Go to Special:Preferences
- 5. In the "Signature" field, add the following:
{{SUBST:User:USERNAME/Sig}}
- 6. Check the box marked "Treat signatures as Wikitext (without an automatic link)"
That's it. Next time you use ~~~~ it will be replaced with the contents of your /Sig page.
Example: Fyahweather
Featuring Articles
Nominating an article for featured article review, is a three step process.
- 1. Ensure the article meets all of the featured article criteria.
- 2. Next the featured article candidate template should be included on the article's talk page.
- You can include this template by using the following code:
{{Featured article candidate}}
"Now that there was a fine piece 'a work." User:Fyahweather/An Editor's Handbook is a featured article candidate. This page has been identified as possibly meeting the featured article criteria. |
- 3. Lastly, you need to add the article to the list of nominated articles.
- To do this, click here and type the article's name in the subject surrounded by double squared brackets (example:
[[ArticleName]]
) and in the text add the reason why you think the article is worthy of nomination
- To do this, click here and type the article's name in the subject surrounded by double squared brackets (example:
To support or object an article nomination, click the edit link next to that article's section, and your opinion in the following format.
Supporting and Objecting
Support
'''Support''': Why you support this article's nomination
Support: This article is well written, containing a good demonstration, lengthy detail, and useful information.
Object
'''Object''': Why you object to this article's nomination
'''Oppose''': Why you oppose this article's nomination
Object: This article does not have painted images.
Oppose: This article is constantly beset by vandalism.
Comment
'''Comment''': Your comment
Comment: The article has been nominated for feature twice.
Archiving
New Archives
If the page has never been archived before,
- 1. First, open the page you are archiving for editting and copy all the code for the page. Save this code to a document for safe keeping.
- 2. Add the Talk Archive template to the top of the page using the code below
{{Talk archive | arc1name=DATE | arc1link=/DATE }}
- Note: Replace DATE with today's month and year
- 3. Remove all the content from the page, except any headers or templates that are still necessary, such as the header on the Wiki Discussion page.
- Note: Be sure to create an edit summary that explains that you are archiving the page.
- 4. Save your changes, this will create the template on the page, now with a link to a page that does not exist.
- 5. Open the page that does not yet exist by clicking the red link in the Talk Archive template. This page is the new archive.
- 6. Paste all the code from the page you are archiving and save it to the new page.
Talk archives | |
11/9/11 |
Adding a New Archive
If the discussion page already has been archived once before, your job is made easier.
- 1. Open the discussion page for editing and copy all the code for the page except the talk archive template and any headers. Save this code to a document for safe keeping.
- 2. Add two more lines to the Talk Archive template to create a new archive:
{{Talk archive | arc1name=April 2011 | arc1link=/April 2011 | arc2name=DATE | arc2link=/DATE }}
- Note: Replace DATE with today's month and year
- 3. Remove all the content from the page, except any headers or templates that are still necessary, such as the header on the Wiki Discussion page.
- Note: Be sure to create an edit summary that explains that you are archiving the page.
- 4. Save your changes, this will add the new link to the template, which links to a page that does not exist.
- 5. Open the page that does not yet exist by clicking the red link in the Talk Archive template. This page is the new archive.
- 6. Paste all the code from the page you are archiving and save it to the new page.
Style
A
- A or an?
- Use "an" before a silent H, e.g. "an hour", "an heir", "an honorable man", "an honest woman". Use "a" before a strong H, e.g. "a hero", "a hotel", "a historian" (but don't change a direct quote if the speaker says, for example, "an historic"). With abbreviations, be guided by pronunciation, e.g. "an LSE student".
- Abbreviations and acronyms
- Use all capitals if an abbreviation is pronounced as the individual letters, e.g. BBC, VAT, etc; if it is an acronym (pronounced as a word) spell it out with an initial capital, e.g. Nasa, Nato, unless it can be considered to have entered the language as an everyday word, such as 'awol', 'laser', and, more recently, 'pin' and 'sim card'.
- If an abbreviation or acronym that readers may not immediately recognize is to be used more than once, put it in brackets at first mention, e.g. Association of Chief Police Officers (ACPO), Seasonal affective disorder (Sad). This saves people having to search back through the article to find the original reference.
- Use common sense; however, it is not necessary to spell out well-known ones such as EU, UN, CIA, FBI, CD, Nasa, etc.
- Cap up single letters in such expressions as "C-list", "F-word", "the word assassin contains four S's", etc.
- Adverbs
- Do not use hyphens after adverbs ending in '-ly', e.g. "a hotly disputed penalty", "a constantly evolving world", "genetically modified food", etc; but hyphens are needed with short and common adverbs, e.g. "ever-forgiving family", "ill-prepared report", "much-loved character", "well-founded suspicion".
- Affect/effect
- '"Affect" and '"effect'" have no senses in common. As a verb, '"affect" is most commonly used in the sense of "to influence", e.g. "how smoking affects health". As a noun, "effect" means "to bring about or execute", e.g. "layoffs designed to effect savings". Thus, the sentence "These measures may affect savings" could imply that the measures may reduce savings that have already been realized, whereas the sentence "These measures may effect savings'" implies that the measures will cause new savings to come about.[1]
- American/British English
- Both American and British English are proper. However, a page should remain consistent throughout in regard to its use of one or the other. For instance, "defence" and "defense" are both correct spellings of the word, and both are acceptable. Regardless, no page should have occurrences of both "defence" and "defense" within it.
- Apostrophes
- They indicate a missing letter or letters ("can't", "we'd") or a possessive ("David's book").
- Contractions can affect the tone of an article and make it appear informal and even inelegant: "what's more" may work but "what is more" may be more appropriate.
- The possessive in words and names ending in 's' normally takes an apostrophe followed by a second 's', e.g. Jones's, James's, but be guided by pronunciation and use the plural apostrophe where it helps, e.g. Mephistopheles', Waters', Hedges' rather than Mephistopheles's, Waters's, Hedges's.
- Plural nouns that do not end in 's' take an apostrophe and 's' in the possessive, e.g. "children's games", "old folk's home", "people's republic", etc.
- Phrases such as "butcher's knife", "collector's item", "cow's milk", "goat's cheese", "hangman's noose", "writer's cramp", etc. are treated as singular.
- Use apostrophes in phrases such as "two days' time", "12 years' imprisonment", and "six weeks' holiday" – where the time period (two days) modifies a noun (time) – but not in "nine months pregnant" or "three weeks old" – where the time period is adverbial (modifying an adjective such as pregnant or old). If in doubt, test with a singular such as "one day's time" or "one month pregnant".
- As or since?
- "As" is causal: "I cannot check the online style guide as the connection is down".
- "Since" is temporal: "Luckily, I have had the style book on my desk since it was published".
- Average, mean, and median.
- Although we loosely refer to the "average" in many contexts, e.g. pay, there are two useful averages worth distinguishing.
- What is commonly known as the "average" is the "mean": "Everyone's wages are added up and divided by the number of wage earners". The "median" is described as "the value below which 50% of employees fall", i.e. it is the wage earned by the middle person when everyone's wages are lined up from smallest to largest. (For even numbers, there are two middle people, but you calculate the mean average of their two wages.)
- The "median" is often a more useful guide than the "mean", which can be distorted by figures at one extreme or the other.
C
- Colon
- Use this between two sentences, or parts of sentences, where the first introduces a proposition that is resolved by the second, e.g. "Fowler put it like this to deliver the goods invoiced in the preceding words".
- A colon should also be used (rather than a comma) to introduce a quotation, e.g. "He was an expert on punctuation", or to precede a list, e.g. "He was an expert on the following: the colon, the comma, and the full stop."
- This is an example of the tendency to use a semi-colon where only a colon will do: "Being a retired soap 'treasure' must be a bit like being in the army reserves; when a ratings war breaks out, it's time to dust off your uniform and wait by the phone."
- There is a distinction between a colon and a semicolon; many writers seem to think they are interchangeable, but to make it clear they are not.
- (see semicolon)
- Commas
- A misplaced comma can sabotage a sentence, as in this example: "Neocon economists often claim a large, black economy turbo-powers growth..." (The writer was talking about a big, black economy, not a big and black one, which is not the same.)
- Contractions
- Do not overuse contractions such as "aren't", "can't", "couldn't," "hasn't", "don't", "I'm", "it's", and "there's"; while they might make a piece more colloquial or easier to read, they can be an irritant and a distraction, and make a serious article sound frivolous.
H
- Hyphens
- Use one word whenever possible; hyphens tend to clutter up text (particularly when the computer breaks already hyphenated words at the end of lines).
- Inventions, ideas, and new concepts often begin life as two words, then become hyphenated, before finally becoming accepted as one word. Why wait? "Wire-less" and "down-stairs" were once hyphenated.
- Words such as "handspring", "madhouse", and "talkshow" are all one word, as are" thinktank" (not a tank that thinks), "longlist" (not necessarily a long list), and "shortlist" (which need not be short).
- Prefixes such as 'macro-', 'micro-', 'mega-', 'mini-', 'multi-', 'over-', 'super-', and 'under-' rarely need hyphens. Examples are listed separately. Follow http://www.dictionary.com when a word or phrase is not specifically listed in this guide.
- There is no need to use hyphens with most compound adjectives, where the meaning is clear and unambiguous without, e.g. "civil rights movement", "financial services sector", "work inspection powers", etc.
- Hyphens should, however, be used to form short compound adjectives, e.g. "two-tonne vessel", "stand-up comedian"," three-year deal", "19th-century artist", etc.
- Also use hyphens where not using one would be ambiguous, e.g. to distinguish "black-cab drivers come under attack" from "black cab-drivers come under attack".
- Do not use hyphens after adverbs ending in '-ly', e.g. "politically naive", "wholly owned", but when an adverb is also an adjective, e.g. "hard". The hyphen is required to avoid ambiguity – it's not a "hard, pressed person", but a "hard-pressed one"; an "ill-prepared report", rather than an "ill, prepared one".
- Use hyphens with short and common adverbs, e.g. "much-needed grammar lesson", "well-established principle of style" (note though that in the construction "the principle of style is well established" there is no need to hyphenate).
I
- If not
- This can be ambiguous. Does "it is the most beautiful castle in France, if not the whole of Europe" mean "and maybe in the whole of Europe" or "but not in the whole of Europe"?
- Into or in to?
- One word if you go "into a room", but two words in such sentences as "I called in to complain", "I listened in to their conversation", and "I went in to see my friend".
- It's or its
- "It's" is the shortened form of "it is" or "it has", e.g. "it's a big dog"; "it's been ages since I saw her". "Its" is the possessive form of "it", e.g. "the dog is eating its bone".
M
- May or might?
- "May" implies that the possibility remains open whereas "might" suggests that the possibility no longer remains open. "They may have played tennis, or they may have gone boating" suggests I don't know what they did; "they might have played tennis if the weather had been dry" means they didn't, because it wasn't.
N
- No doubt that, no question that
- These are opposites, e.g. "There was no doubt that he was lying" means he was lying; "There was no question that he was lying" means he wasn't, although the two are routinely confused.
- No one
- Not "no-one".
- Numbers
- When used within a sentence, spell out from one to nine; integers from 10 to 999,999 thereafter use m or bn for sums of money, quantities, or inanimate objects in copy, e.g. "£10m", "5bn tonnes of coal", "30m doses of vaccine" – but million or billion for people or animals, e.g. "1 million people", "3 billion rabbits", etc; spell trillion in full at first mention, then tn; in headlines use m, bn, or tn.
P
- Pronunciation
- If a word is too difficult to pronounce, the correct pronunciation isn't something most people know, or the word is not part of the English language, then the correct IPA pronunciation (if not English) in the Merriam-Webster pronunciation (if English or a place name) should be provided. (Along with a recording of the word being said clearly and correctly.)
- Leave some silence at the end of a recording for browsers and players which truncate sound files.
Q
- Quotation marks
- Use double quotes at the start and end of a quoted section, with single quotes for quoted words within that section. Place full points and commas inside the quotes for a complete quoted sentence, otherwise the point comes outside, e.g.
- "Anna said, 'Your style guide needs updating,' and I said, 'I agree.' "
- but: "Anna said updating the guide was 'a difficult and time-consuming task'."
- When beginning a quote with a sentence fragment that is followed by a full sentence, punctuate according to the final part of the quote, e.g. The minister called the allegations "blatant lies. But in a position such as mine, it is only to be expected."
- For parentheses in direct quotes, use square brackets.
R
- Re or re-?
- Use 're-' (with hyphen) when followed by the vowels 'e' or 'u' (not pronounced as "yu"), e.g. "re-entry", "re-examine", "re-urge".
- Use 're' (no hyphen) when followed by the vowels 'a', 'i', 'o', 'u' (pronounced as "yu"), or any consonant, e.g. "rearm", "rearrange", "reassemble", "reiterate", "reorder", "reuse", "rebuild", "reconsider".
- Exceptions are "re-read" or where confusion with another word would arise, e.g. "re-cover"/"recover", "re-form"/"reform", "re-creation"/"recreation", "re-sign"/"resign".
S
- Self-control, self-defense, self-esteem, self-respect
- These are hyphenated.
- Semicolon
- Used correctly, the semicolon is a very elegant compromise between a full stop (too much) and a comma (not enough). "Some reporters were brilliant; others were less so".
T
- That or which?
- "That" defines, "which" informs:
- "This is the house that Jack built, but this house, which John built, is falling down".
- This and that
- "That was then, but this is now"; "this looks forward, that looks back"; a man showing his son and heir the lands lying in front of them says, "One day, son, all this will be yours." and then he points behind him to the house and says, "But that remains mine".
U
- Uber
- No accent if you are saying something like "uber fast", but use the umlaut if you are quoting German, i.e. Medic responses. The normal transliteration of the 'ü' ('u' with a dieresis representing an umlaut) when used in writing systems without diacritics (such as airport arrival boards, older computer systems, etc.) is 'ue', not just 'u'; however, the English language use of the word "uber" is considered a new word distinct from "ueber". When used in conjunction with another word, it should be written as an individual word and not hyphenated (example: "uber defense" not "uber-defense"). An "ÜberCharge" is the name of the effect from the Medigun in TF2, and as such should be capitalized (see TF2 Wiki Style guide). Also note that the contractions "uber'ed" or "uber'd" should be avoided and "ÜberCharged" used instead.
Z
- Zigzag
- This has no hyphen.
Formatting
While many of these are located in an easily accessible palette, I'll put these in anyway.
- ''text here'' italicizes the word.
- '''text here''' boldens the word.
- '''''text here''''' boldens and italicizes the word.
- [[link here]] makes a link to Page
- [[link here|substituted words]] makes a link to Page, but in different words, such as Edition.
- [[Category:Gameplay]] puts a page in the Gameplay category.
Quotes
To make a quote, use {{Quotation|Speaker|Spoken words|sound=file name here}} Alternatively, cut the sound area out if there is no file available or the text is written, and use {{Quotation|Speaker|Spoken words}}
“ | Gesundheit!
Click to listen
— The Medic
|
” |
“ | When asked about it, the Pyro claims to have found it in the garden and has been using it as a backscratcher, though we must admit we have always wondered how the bent teeth and bloodstains got there. Now we know.
— Back Scratcher publicity blurb
|
” |