When you connect to this website, you send your IP address and sometimes some cookies. You may also give us personal identifying information, such as your name and contact information. All this data is used to securely provide you with the services that you request. We encourage you to review our privacy policy to make sure that you understand how your data is managed, and to contact us if you have any questions. View Privacy Policy

Difference between revisions of "Style guide"

From NASPAWiki

You are viewing a condensed mobile version of this NASPA webpage.
Switch to full version.

(Punctuation and Typography: explained "entity" as used here (as opposed to legal entities such as organizations))
(updated the instructions for empasis and quotes)
Line 20: Line 20:
  
 
* Use multiple levels of headings appropriately.
 
* Use multiple levels of headings appropriately.
* Use boldface (entered by surrounding the text by triple primes like '''this''') to emphasize the first appearance of the article title in the first paragraph of an article, when applicable.  Where possible, write the first paragraph so that it does include the article title.
+
* Use '''boldface''' (entered by surrounding the text by <code>'</code><code>'</code><code>'</code>) only to emphasize the first appearance of the article title in the first paragraph of an article.  Where possible, write the first paragraph so that it does include the article title.
* For <em>general emphasis</em>, use <code> &lt;em&gt;</code>, not <code> &lt;i&gt;</code> or <code> &lt;b&gt;</code>.
+
* Use ''italics'' (entered by surrounding the text by <code>'</code><code>'</code>) for general emphasis, foreign/nonstandard words and the titles of books and other publications.
* Use <code> &lt;i&gt;</code> for roman text in book titles when not linked: <i>Long List</i>.
+
* However, do not emphasize links.  For example, use [[Long List]] and ''Long List'', not ''[[Long List]]''.
* Single quotes: use <code> &amp;lsquo; </code> and <code> &amp;rsquo; </code> (like &lsquo;this&rsquo;), not the plain ' symbol.   
+
* Single quotes: use <code> &amp;lsquo; </code> and <code> &amp;rsquo; </code> (like &lsquo;this&rsquo;), not the plain <code>' </code>symbol.   
* Double quotes: use <code> &amp;ldquo; </code> and <code> &amp;rdquo; </code> (like &ldquo;this&rdquo;), not the plain " symbol.
+
* Double quotes: use <code> &amp;ldquo; </code> and <code> &amp;rdquo; </code> (like &ldquo;this&rdquo;), not the plain <code>" </code> symbol.
 
* Use double quotes for the first level of quotation, single quotes for the second (nested) level.
 
* Use double quotes for the first level of quotation, single quotes for the second (nested) level.
* Use <code> &amp;rsquo; </code> and not ' for an apostrophe.
+
* Use <code> &amp;rsquo; </code> and not <code>'</code> for an apostrophe.  In typesetting, the apostrophe is identical to the right single quote, and there is no distinct HTML entity for the apostrophe.
 
* Use <code> &amp;ndash; </code> (&ndash;) and not - for numerical and date ranges or elsewhere where endashes are called for.
 
* Use <code> &amp;ndash; </code> (&ndash;) and not - for numerical and date ranges or elsewhere where endashes are called for.
 
* Use <code> &amp;mdash; </code> (&mdash;) and not -- where emdashes are called for.
 
* Use <code> &amp;mdash; </code> (&mdash;) and not -- where emdashes are called for.
 
* Use <code> &amp;minus; </code> (&minus;) and not - to denote subtraction.
 
* Use <code> &amp;minus; </code> (&minus;) and not - to denote subtraction.
 
* Use <code> &amp;times; </code> (&times;) and not x to denote multiplication.
 
* Use <code> &amp;times; </code> (&times;) and not x to denote multiplication.
* Notwithstanding the above, do not use HTML entity names (such as &amp;rsquo;) in article titles, as some browsers do not render them correctly as browser window titles. So, for example, use a typewriter apostrophe ' in [[World English-language Scrabble Players' Association]].
+
* Notwithstanding the above, do not use HTML entity names (such as &amp;rsquo;) in article titles, as some browsers do not render them correctly as browser window titles. So, for example, use a typewriter apostrophe <code>' </code>in [[World English-language Scrabble Players' Association]].
 
* Do not use serial commas.
 
* Do not use serial commas.
  

Revision as of 21:20, 8 March 2009

Please obey the following rules in this style guide when editing content at this web site. For issues not discussed below, consult the Wikipedia Manual of Style.

Spelling

Words should be spelled as shown in the current edition of TWL. Where variant spellings are given, use the more common and note the choice you made below. When given a choice between American and British spellings, use the American.

  • COCHAIR, not CO-CHAIR
  • EMAIL, not E-MAIL
  • LIGHT, not LITE
  • “the NSA” but no article before NASPA or NASPAWiki

Punctuation and Typography

  • Use multiple levels of headings appropriately.
  • Use boldface (entered by surrounding the text by ''') only to emphasize the first appearance of the article title in the first paragraph of an article. Where possible, write the first paragraph so that it does include the article title.
  • Use italics (entered by surrounding the text by '') for general emphasis, foreign/nonstandard words and the titles of books and other publications.
  • However, do not emphasize links. For example, use Long List and Long List, not Long List.
  • Single quotes: use &lsquo; and &rsquo; (like ‘this’), not the plain ' symbol.
  • Double quotes: use &ldquo; and &rdquo; (like “this”), not the plain " symbol.
  • Use double quotes for the first level of quotation, single quotes for the second (nested) level.
  • Use &rsquo; and not ' for an apostrophe. In typesetting, the apostrophe is identical to the right single quote, and there is no distinct HTML entity for the apostrophe.
  • Use &ndash; (–) and not - for numerical and date ranges or elsewhere where endashes are called for.
  • Use &mdash; (—) and not -- where emdashes are called for.
  • Use &minus; (−) and not - to denote subtraction.
  • Use &times; (×) and not x to denote multiplication.
  • Notwithstanding the above, do not use HTML entity names (such as &rsquo;) in article titles, as some browsers do not render them correctly as browser window titles. So, for example, use a typewriter apostrophe ' in World English-language Scrabble Players' Association.
  • Do not use serial commas.

Linking and Article Titles

  • Link (only) the first occurrence of each phrase in a section to the appropriate internal wiki page.
  • Where possible, avoid direct external links in unrelated pages by providing an intermediate internal page explaining or summarizing the external page. For example, link NSA rather than NSA.
  • Contact information for committee members should be placed only in their individual pages, so that if it changes, only one page needs to be edited.
  • Create redirect pages rather than using alternate labels for inflections or base forms of internal page names (e.g., the “committee” page redirects to “commitees” to save inexperienced editors having to write [[committees|committee]].
  • Article titles should be unabbreviated nouns or noun phrases. Create redirect pages from acronyms to fully spelled out names.

Logos

The NASPA logo is available in the following formats:

Wiki (135×112 pixel GIF)
logowiki.gif
200×100 pixel GIF as used in the NASPA home page
Logo.gif
high-resolution PDF
File:Logo.pdf

Trademark

  • Always write SCRABBLE, never Scrabble.
  • Always use SCRABBLE as an adjective, not as a noun.
  • Add the ® symbol to the first or more prominent use of the trademark on each page; do not add it to subsequent uses.