Newsies Team: Style Guide: Difference between revisions

From 118Wiki
Jump to navigation Jump to search
m (Adding media info.)
m (Comments on spacing after periods, and using categories.)
Line 15: Line 15:


If this isn't an option for you, copy and paste your text into Microsoft Word (or similar program) and run a spell-check. It will provide full grammar suggestions, as well.  
If this isn't an option for you, copy and paste your text into Microsoft Word (or similar program) and run a spell-check. It will provide full grammar suggestions, as well.  
===ONE space, not two===
The Chicago Manual of Style, [http://www.adamsdrafting.com/2006/10/30/one-space-or-two/ among others] agree: only '''one space after a period''', not two.


==Post length==
==Post length==
Line 36: Line 39:


==Every post must have a category==
==Every post must have a category==
Just like it says. Choose the category that's most appropriate -- you may want to read them all first, to make sure you're selecting the appropriate one.  
Just like it says. Choose the ONE category that's most appropriate (no more than one) -- you may want to read them all first, to make sure you're selecting the appropriate one.  


===Tags===
===Tags===

Revision as of 09:04, 27 November 2010

Newsies Team

Newslogo.jpg



Team Co-Facilitators


Edit this nav

To ensure that all of our posts appear uniform, and of high quality, this style guide will show you the best practices of posting on the site.

Fonts and formats

If you copy and paste text into a post, WordPress will keep whatever font the original source text had. You need to be careful with this, because sometimes you might be copying from a text that looks much different than the font we have on our site.

To avoid this issue, you can use a "text editor pit stop." First, copy text from the source. Next, open Windows "Notepad" (it's important that you use this specific program) and paste the text there. You'll notice that the text appears entirely plain in Notepad. Now, select the text and copy it again. Subsequently, you can paste it into the WordPress post box. This effectively "washes" the text of any extra formats so that all of our posts appear uniform.

Alternatively, on the post editor tool-bar, you can click the last square icon (it says "Show/Hide Kitchen Sink" if you hover over it) to open other editing buttons. Then, click on the eraser button after you've selected text to remove any formatting.

Grammar and spelling

Bottom line: we won't post anything on our site that has very bad spelling or grammar, so please make every effort to clean it before posting on the site. The better the quality of our writing, the more people will respect us.

If you don't already, you should use a modern browser like Firefox, Chrome, or Safari, all of which provide a built-in spell-check feature, which will underline any misspelled words automatically in a text editing box on your browser.

If this isn't an option for you, copy and paste your text into Microsoft Word (or similar program) and run a spell-check. It will provide full grammar suggestions, as well.

ONE space, not two

The Chicago Manual of Style, among others agree: only one space after a period, not two.

Post length

If you take a look community news index, you'll notice that most of the posts are about a paragraph in length. This doesn't mean that everything we post on the news has to only be a paragraph, but that we don't want posts on the index to be excessively long, because they push other content down the page.

If you're writing a post that's more than a paragraph or so in length, you'll want to break it up. Here's a video explaining how to use the "more" tag to split up your posts into two parts:

HOWEVER: that video mentions the "excerpt" box. Please disregard that info - our website theme does not support excerpts.

Make your intro enticing!

Don't just slap a "more" tag into your post after the first paragraph. Remember, we're writing for an audience here, and we want to entice our readers to actually continue reading the rest of the post, right? So, make sure when you're create that part of the post that will go on the main index (before the "more" tag) that it actually provides a "hook" or something to get the reader interested!

Prefer linking over duplicating content

We don't want to duplicate content that's already on our website. So, for example, if you wanted to do a profile on a species that's on the ILI, you wouldn't just copy/paste the content from the wiki onto WordPress. Instead, create a news item and link to the profile. Give people a compelling reason to read more by providing an interesting introduction to the species, and anything in particular that readers might want to learn more about. Then, provide a link to that page.

Don't credit yourself

If you've set up your account the right way, your name will appear at the bottom of the post when it's published. There's no need to include a Byline, as WordPress effectively takes care of this for you.

However, in your profile (accessed by clicking on your user name at the top of the page in WordPress) you can add a link to your forum or wiki profile to give people more information about yourself, if you'd like.

Every post must have a category

Just like it says. Choose the ONE category that's most appropriate (no more than one) -- you may want to read them all first, to make sure you're selecting the appropriate one.

Tags

Only add tags if they're appropriate; they're not required.

See also

Using sub-headings

If you've opened the extra editor options (ALT+SHIFT+Z in the post editor), you'll see the a drop-down box on the tool-bar which allows you to use sub-headings like "Heading 1" through "Heading 4". If you need to use sub-headings in your text, default to Heading 4. If you need two levels of sub-headings, use Heading 3 and Heading 4.

Also, don't put a sub-heading at the very top of your article. You'll notice that WordPress automatically uses the Title of the post as the subject line at the top of each article. If you use a new sub-heading directly below without any intro text, it will appear strange.

Whenever you're using sub-headings, be sure there's text under it before you use your next sub-heading. Never have two sub-headings together.

i.e.-

  • Sub-heading 1
    • Intro to this section.
  • Sub-heading 2
    • Text

Using media

You're welcome to use media such as pictures and video in your posts.

If you're putting a graphic into a post, be respectful of the author's copyright. You can credit them using the "Caption" box, and link directly to the image in the "link URL" box.