Style Guide: Difference between revisions

From The Elvis Costello Wiki
Jump to navigationJump to search
(→‎[[Songs|Song]] and Album Titles: comma in Radio, Radio)
 
(19 intermediate revisions by 3 users not shown)
Line 2: Line 2:


==Date Format==
==Date Format==
#YYYY-MM-DD format to be used.
#YYYY-MM-DD format to be used, e.g. 2006-03-27 is the representation for 27 March 2006.


==Song and Album Titles==
==[[Songs|Song]] and Album Titles==
#Song titles should be complete including (parenthesis) and all punctuation. All words capitalized:
# In song titles, all words should be capitalized. Use all punctuation and (parenthesis). For instance:
#* [[(I Don't Want To Go To) Chelsea]]
#* [[(I Don't Want To Go To) Chelsea]]
#* [[(What's So Funny 'Bout) Peace, Love And Understanding]]
#* [[(The Angels Wanna Wear My) Red Shoes]]
#* [[(What's So Funny 'Bout) Peace, Love And Understanding?]]
#* [[...And In Every Home]]
#* [[Dust 2...]]
#* [[...Dust]]
#* [[...This Town...]]
#* [[...This Town...]]
#* [[Hurry Down Doomsday (The Bugs Are Taking Over)]]
#* [[Pads, Paws And Claws]]
#* [[Pony St.]]
#* [[Radio, Radio]] - note that a comma is present
#* [[Speak Darkly, My Angel]] - note that a comma is present
#* [[Tear Off Your Own Head (It's A Doll Revolution)]]
#* [[Tear Off Your Own Head (It's A Doll Revolution)]]
#* [[What's Her Name Today?]]
#* [[When Did I Stop Dreaming?]]
#* [[When I Was Cruel No. 2]]
#* [[When I Was Cruel No. 2]]
#* [[Dust 2...]]
# In album titles, all words should be capitalized. Use all punctuation, including colons and slashes. For instance:
#* [[...Dust]]
#Album titles should be complete including correct punctuation. All words capitalized:
#* [[Get Happy!!]]
#* [[Get Happy!!]]
#* [[Piano Jazz: Costello/McPartland]]
#* [[Piano Jazz: Costello/McPartland]]
Line 19: Line 28:


==Naming Conventions for Images==
==Naming Conventions for Images==
I propose verbose naming conventions rather than short abbreviations, mainly to make the wiki search engine easier to use. These are merely suggestions -- we should have a discussion about it before we go to far. -- [[User:JohnH|JohnH]]<br>
Note: we may be able to use spaces instead of underscores, I believe the Wiki sees them as the same thing.


===Albums===
This section moved to its own page: [[Naming Conventions for Images]]
yyyy_Name_Name_Name_Name_Album_size, for instance:
1977_My_Aim_Is_True_Album_large.jpg
1977_My_Aim_Is_True_Album_small.jpg - anything around 240 pixels
1977_My_Aim_Is_True_Album_thumb.jpg
1996_Costello_&_Nieve_Album_small.jpg
1996_Costello_&_Nieve_D1_Troubadour_Los_Angeles_thumb.jpg
1996_Costello_&_Nieve_D3_Park_West_Chicago_thumb.jpg


===Concert Photos===
==Name of Review Articles and Preview Articles==
yyyy-mm-dd_City_venue_concert_photo#_size_photographer, for instance:
Review:_2007-05-11_Detroit:_GloriousNoise
  1999-12-19_New_York_Town_Hall_concert_01_large_Dave_Weil.jpg
   
  1999-12-19_New_York_Town_Hall_concert_01_small_Dave_Weil.jpg
  where:
1999-12-19_New_York_Town_Hall_concert_01_thumb_Dave_Weil.jpg
      Review or Preview: type of article
1999-12-19_New_York_Town_Hall_concert_02_large_Dave_Weil.jpg
      YYYY-MM-DD: date of concert
1999-12-19_New_York_Town_Hall_concert_02_small_Dave_Weil.jpg
      City: city of concert
1999-12-19_New_York_Town_Hall_concert_02_thumb_Dave_Weil.jpg
      Publication Name: name of purblication in which article appears


===Ticket Stubs ===
==Track Numbering==
1999-12-19_New_York_Town_Hall_ticket_01_large.jpg
I propose we use hard-coded numbers for setlists and tracklisting, so that when one copies a list, they get the numbers too. This is uncoventional I know, but it drives me nuts when I copy a setlist and then have to renumber it. If we do it once, it will save others from having to type in the numbers following a cut and paste.
1999-12-19_New_York_Town_Hall_ticket_01_thumb.jpg
1999-12-19_New_York_Town_Hall_ticket_02_large.jpg
1999-12-19_New_York_Town_Hall_ticket_02_thumb.jpg


===Concert Posters and flyers===
'''I'd like to see us code it like this:'''
  1999-12-19_New_York_Town_Hall_poster_01_large.jpg
  01. Still<nowiki><br></nowiki>
  1999-12-19_New_York_Town_Hall_poster_01_small.jpg
  02. Upon A Veil Of Midnight Blue<nowiki><br></nowiki>
  1999-12-19_New_York_Town_Hall_poster_01_thumb.jpg
  03. Veronica<nowiki><br></nowiki>
  1999-12-19_New_York_Town_Hall_flyer_01_large.jpg
  04. Speak Darkly My Angel<nowiki><br></nowiki>
  1999-12-19_New_York_Town_Hall_flyer_01_small.jpg
  05. Almost Blue<nowiki><br></nowiki>
1999-12-19_New_York_Town_Hall_flyer_01_thumb.jpg
'''to get this:'''<br>
01. Still<br>
===Photos in the Bibliography===
02. Upon A Veil Of Midnight Blue<br>
1980-05_US_Rolling_Stone_magazine_cover_large.jpg
03. Veronica<br>
1980-05_US_Rolling_Stone_magazine_cover_small.jpg
04. Speak Darkly My Angel<br>
  1980-05_US_Rolling_Stone_magazine_cover_thumb.jpg
05. Almost Blue<br>
  1980-05_US_Rolling_Stone_magazine_01_large.jpg (for interior artwork)
 
  1980-05_US_Rolling_Stone_magazine_01_small.jpg
'''The above method is preferred instead of the conventional way:'''
  1980-05_US_Rolling_Stone_magazine_01_thumb.jpg
  # Still
  1983-09_AUS_Rolling_Stone_magazine_cover_large.jpg
  # Upon A Veil Of Midnight Blue
1983-09_AUS_Rolling_Stone_magazine_cover_small.jpg
  # Veronica
1983-09_AUS_Rolling_Stone_magazine_cover_thumb.jpg
  # Speak Darkly My Angel
1983-09_AUS_Rolling_Stone_magazine_01_large.jpg (for interior artwork)
  # Almost Blue
1983-09_AUS_Rolling_Stone_magazine_01_small.jpg
'''to get this:'''
1983-09_AUS_Rolling_Stone_magazine_01_thumb.jpg
# Still
# Upon A Veil Of Midnight Blue
# Veronica
# Speak Darkly My Angel
# Almost Blue
(which, when you select with a mouse, does not grab the numbers)
 
 
==Page Templates==
*Use [[Page Templates]] for consistency.
*List [http://www.elviscostello.info/wiki/index.php?title=Special:Allpages&namespace=10 All Wiki templates] in ElvisCostello wiki

Latest revision as of 09:46, 26 May 2008

Until we have a style guide, here's a link to Wikipedia's Style Guide.

Date Format

  1. YYYY-MM-DD format to be used, e.g. 2006-03-27 is the representation for 27 March 2006.

Song and Album Titles

  1. In song titles, all words should be capitalized. Use all punctuation and (parenthesis). For instance:
  2. In album titles, all words should be capitalized. Use all punctuation, including colons and slashes. For instance:

Naming Conventions for Images

This section moved to its own page: Naming Conventions for Images

Name of Review Articles and Preview Articles

Review:_2007-05-11_Detroit:_GloriousNoise

where:
      Review or Preview: type of article
      YYYY-MM-DD: date of concert
      City: city of concert
      Publication Name: name of purblication in which article appears

Track Numbering

I propose we use hard-coded numbers for setlists and tracklisting, so that when one copies a list, they get the numbers too. This is uncoventional I know, but it drives me nuts when I copy a setlist and then have to renumber it. If we do it once, it will save others from having to type in the numbers following a cut and paste.

I'd like to see us code it like this:

01. Still<br>
02. Upon A Veil Of Midnight Blue<br>
03. Veronica<br>
04. Speak Darkly My Angel<br>
05. Almost Blue<br>

to get this:
01. Still
02. Upon A Veil Of Midnight Blue
03. Veronica
04. Speak Darkly My Angel
05. Almost Blue

The above method is preferred instead of the conventional way:

# Still
# Upon A Veil Of Midnight Blue
# Veronica
# Speak Darkly My Angel
# Almost Blue

to get this:

  1. Still
  2. Upon A Veil Of Midnight Blue
  3. Veronica
  4. Speak Darkly My Angel
  5. Almost Blue

(which, when you select with a mouse, does not grab the numbers)


Page Templates