Tub Book: Style Guide

From Plastic Tub

Revision as of 18:11, 24 Feb 2008 Payne (Talk | contribs) ← Go to previous diff		Current revision Payne (Talk | contribs) Links - doh! of course you cannot just worship *1* dong ...
Line 4:		Line 4:
	'''Internal Links:'''		'''Internal Links:'''
	* Internal links that properly name the entry -- leave as is		* Internal links that properly name the entry -- leave as is
-	* Misdirects (e.g., [[Wacky Tobaccy|Stinking Weed]] actually takes you to Stinking Weed) -- leave as is, but add a "see" reference to the [[Tub Book: Index|index]] (i.e., [[Wacky Tobaccy]] '''see''' [[Stinking Weed]])	+	* Misdirects (e.g., [[Stinking Weed|Wacky Tobaccy]] actually takes you to Stinking Weed) -- leave as is, but add a "see" reference to the [[Tub Book: Index|index]] (e.g., [[Wacky Tobaccy]] '''see''' [[Stinking Weed]])
-	* Dead links (they take you know where) -- delete 'em	+	* Dead links (they take you know where) -- fix 'em (preferably) or delete 'em (when imagination or patience lacks) (e.g., change [[giant]] to [[The Worship of Dongs|giant]] -- now live, pointing to "The Worship of Dongs")
	'''External Links:'''		'''External Links:'''
-	* Put the page name in quotes and the add the address after in parenthesis. For example:	+	Add the address after in parenthesis. For example:
-	** Adid likes to [http//www.jumprope.com jump rope] in Madrid.	+	* Adid likes to [http://www.jumprope.com jump rope] in Madrid.
-	: Should be changed to:	+	: ''Should be changed to:''
-	** Adid likes to jump rope (http//www.jumprope.com) in Madrid.	+	* Adid likes to jump rope (http://www.jumprope.com) in Madrid.
	==Glossary-specific==		==Glossary-specific==
		+	* glossary terms should be lower case unless they are proper nouns (e.g., [[ablation]] vs. [[Tampa]])
	* each definition should end in a period (or exclamation point or question mark).		* each definition should end in a period (or exclamation point or question mark).
	* watch the 2.a. ... 2.b. layout -- be sure that you have a period after the number & after the letter		* watch the 2.a. ... 2.b. layout -- be sure that you have a period after the number & after the letter

---

Current revision

The main thing is to be consistent -- so if you see inconsistent patterns punctuation, let us all know!

Links

Internal Links:

• Internal links that properly name the entry -- leave as is
• Misdirects (e.g., Wacky Tobaccy actually takes you to Stinking Weed) -- leave as is, but add a "see" reference to the index (e.g., Wacky Tobaccy see Stinking Weed)
• Dead links (they take you know where) -- fix 'em (preferably) or delete 'em (when imagination or patience lacks) (e.g., change giant to giant -- now live, pointing to "The Worship of Dongs")

External Links: Add the address after in parenthesis. For example:

• Adid likes to jump rope (http://www.jumprope.com) in Madrid.

Should be changed to:

• Adid likes to jump rope (http://www.jumprope.com) in Madrid.

Glossary-specific

• glossary terms should be lower case unless they are proper nouns (e.g., ablation vs. Tampa)
• each definition should end in a period (or exclamation point or question mark).
• watch the 2.a. ... 2.b. layout -- be sure that you have a period after the number & after the letter

General Copy Edits

• Use double dashes (--) instead of em-dashes because em-dashes don't work so well in this wiki
• if we're going Yank style, periods, question marks, and exclamation marks go inside quotes. (Personally, I prefer British style, which puts the end punctuation outside of the quote unless the end punctuation is part of the quote -- but I think we have mostly been following the Yank style, so let's keep the end punctuation inside quotes unless someone else wants to argue otherwise.)
• one space after periods and colons (speak up if you'd prefer 2 spaces)
• dates -- like this: 3 March, 2007 (speaks up if you'd prefer March 3, 2007)
• Ellipses (i.e., ...) -- surround them by spaces (e.g., "and then ... she went to the sky")