Powerbase:How To Edit A Page

From Powerbase
Revision as of 15:14, 19 November 2008 by Lynn Hill (talk | contribs) (merging info from Help:Editing page - tbc tomorrow)
Jump to: navigation, search

Template:SpinProfiles:Help SpinProfiles is a wiki, meaning that anybody who has registered can easily edit any article and have those changes posted immediately.

Before you can edit, you'll need to quickly register with a valid email address, which is done to deter spammers and vandals. Once you've registered, editing a page is as easy as clicking the "edit this page" tab at the top of the window."

This page explains some of the editing features as well as being a reference guide for Wiki markup which provides a guide on how to create sections, link pages, bullet point, write in bold and in Italics, as well as a whole host of other features.

Before you get started please familiarise yourself with the following guidelines:

Everyone who edits a SpinProfiles page is required to read and understand SpinProfiles Libel policy
If you have not already done so. PLEASE READ THIS NOW!

The Zen of Editing

Are there any standard formats, for things like dates for example?

For this and other style questions, see the SpinProfiles:Manual of Style.

What do I do if I find two articles on the same subject?

Well, you could merge them yourself if you are feeling bold. Pick the most suitable page name (which may not necessarily be one of the existing ones!). If you're not sure which name to use, or whether the two articles should really be merged, mention it on their talk page (remember to put a link to the other page to make it easier for others to find), and see what other people think.

What is the ideal/maximum length of an article? When should an article be split into smaller pieces?

Articles seem to have clearly diminished technical performance when they exceed 32K in length. A rule of thumb: >30K must be divided; 20K-30K probably should be divided; 10K-20K consider dividing if the subject conveniently warrants; <10K don't bother. Size is only one factor; a 30K article with no likelihood for increased size is probably fine the way it is. When dividing pages keep in mind that separate stub sub-articles for each area of a topic can be very inconvenient for the reader to be chasing stubs that don't say very much.

Discussing an article - 'Talk' Pages

SpinProfiles strives to present subjects fairly and accurately. Each article has a corresponding "Talk" page where you can discuss its comments and debate editorial decisions if necessary. Any discussion aimed at improving an article is welcome. The 'Talk' page is accessed by clicking on 'discussion' at the top of the article's page.

I've found vandalism, or I've damaged a page by mistake! How can I restore it?

Click on the "Older versions" link. Find the last good version of the page (it helps to use a browser with multiple tabs). Edit this old version (you'll get a warning that you're editing an old version at the top of the edit box). Save this text -- it will become the new current version. More guidelines on vandalism can be found here.

Which languages can I use?

On the English SpinProfiles, English! If you would like to set up a SpinProfiles in another language, be our guest.

American English, I presume, not British English?

British English is preferred.
However, it is good form to keep usage consistent within a given article. A good rule to follow is to use U.S. English in articles on American topics, British English in articles on U.K. topics, and so on. Spelling should follow the originating language - so 'Center' in the US and 'Centre' in the UK
Use of one English variation in article titles can cause a Search in another variant to fail. In this case, it is recommended that you create a new article using the alternative spelling which is a redirect to the main article. Then, in order to prevent this redirect being an orphan, create a link to the redirect from the top of the Talk page of the main article.

How do I spell-check a page?

When editing a larger article, it is in any event much more convenient to paste the text into your favorite text editor or word processor first, edit and spell check there, and then paste back into your browser to preview.

There is no spell check function in the editing box where any spelling you use is considered correct.

Why are some links red? What are the ? links?

They both indicate that a page with that name has not yet been started. Which one you see depends on your Special:Preferences. If you have "Highlight links to empty topics" checked, you'll see red links. Otherwise, you get the little blue question marks.
Either way, you can click on that link and start a page with that name. But be careful -- there may already be articles on similar topics, or an article on the same topic under a different name. It's pretty important to hunt around for similar topics first. See SpinProfiles:Naming Conventions for information on naming pages.

What happens when two users edit a page at the same time?

This is called an "edit conflict". You'll get a conflict screen that displays both versions in separate windows, along with a summary highlighting the differences, and instructions on how you should proceed. It's virtually impossible to lose any data.

Is it OK to link to other sites, as long as the material is not copied onto SpinProfiles?

External links are just fine. Arguably, they increase the usability of SpinProfiles. Keep in mind, however, that SpinProfiles is not a web directory; external links should support the content of the article, not replace it. The current convention is to place external links in a separate section at the bottom of the article. However, sometimes they are placed within the article as a footnote.

How do I learn about changes to certain topics without having to go there from time to time?

If you are a logged-in user, on every page you will see a link that says "Watch this article". If you click on it, the article will be added to your personal watchlist. You watchlist will show you the latest changes on your watched articles.

What file formats should I use for pictures/sounds/videos?

For images, use JPEG for photographs, and PNG for drawings, logos and the like. Ogg Vorbis is prefered for sound. As for video, good question; it hasn't come up yet. See SpinProfiles:Image Use Policy for more.

One of the contributors is being unreasonable. Help!

See Etiquette for SpinProfiles policy and advice.

If editing someone else's writing, leave a note

If you are editing or deleting someone else's writing, it's a common courtesy to leave a note on an article's discussion page (found by clicking the "discussion" tab at the top of the article) explaining your reasons why. It would probably then be a good idea to check back a little later to see if other editors have responded. Remember: be cool, be collaborative and talk things out. "Edit wars" are never fun and rarely productive. If a dispute does arise, see SpinProfiles Dispute Resolution page for guidelines on how to resolve it.

Editing a page - Getting started

It's very easy to edit a SpinProfiles page. Simply click on the "Edit this page" link at the top the page you wish to edit. This will bring you to a page with a text box containing the editable text of that SpinProfiles page.

Then type away, and press "Save" when finished! It is normally a good idea to preview your changes before saving it, just to make sure that it is as you intended it to be. The preview and save commands are found at the bottom of the page. Before saving your work, you should write a short 'edit summary' in the small field below the edit-box. This requires a short description of what you have edited. This enables other editors to get an idea of what information you have added or have made changes to. Keep it as clear as you can in the very small amount of space available in this box.

It is often more convenient to copy and paste the text first into your favorite text editor, edit and spell check there, and then paste back into the browser to preview. This way, you can also keep a local backup copy of the pages you authored so that you can make changes offline.

Minor edits

When editing a page, one has the option of flagging the edit as a "minor edit" at the saving stage. When to use this is somewhat a matter of personal preference. The rule of thumb is that an edit of a page that is spelling corrections, formatting, and simple rearranging of text should be flagged as a "minor edit". A major edit is basically something that makes the entry worth relooking at--either through substantial additions or reorganisation--or fixes a major error.

This feature is important, because users can choose to hide minor edits in their view of the Recent Changes page, to keep the volume of edits down to a manageable level.

Major edits

There are several things that a user can do to ensure that major edits are performed smoothly. Before engaging in a major edit, consider discussing proposed changes on the article discussion/talk page. During the edit, if doing so over an extended period of time, the {{inuse}} tag can reduce the likelihood of an edit conflict. Once the edit has been completed, the inclusion of an edit summary will assist in documenting the changes. These steps will all help to ensure that major edits are well received by the Wikipedia community.

Talk pages

There is also a "Discussion" tab to see the pages corresponding 'talk' page. This contains any comments about the page from other SpinProfiles users. If you want to contribute to this discussion, or start a discussion, click on the "+" tab to add a new section, or edit the page in the same way as an article page. When editing talk pages, please sign your change.

Don't "sign" edits you make to the main page/article as the software keeps track of who it is that has made any changes.

After making a new page, it's a good idea to use What links here (with your page displayed) to check the articles that already link to it, and make sure that they are all expecting the same meaning that you have supplied.

How to Edit - step by step guide

In the left column of the table below, you can see what effects are possible. In the right column, you can see how those effects were achieved. In other words, to make text look like it looks in the left column, type it in the format you see in the right column.

You may want to keep this page open in a separate browser window for reference. If you want to try out things without danger of doing any harm, you can do so in the Sandbox.

Sections, Paragraphs, Lists and Lines

What it looks like What you type

Start your sections with header lines:

New Section

Subsection

Sub-subsection

If appropriate, place subsections in an appropriate order. If listing countries, place them in alphabetical order


== New Section ==

=== Subsection ===

==== Sub-subsection ====

A single newline has no effect.

But an empty line

starts a new paragraph.

A single newline
has no effect.

But an empty line

starts a new paragraph.
You can break lines
without starting a new paragraph.
You can break lines<br>
without starting a new paragraph.
  • Lists are easy to do:
    • start every line with a star
    • more stars means deeper levels
* Lists are easy to do:
** start every line with a star
** more stars means deeper levels
  1. Numbered lists are also good
    1. Very organized
    2. easy to follow
# Numbered lists are also good
## Very organized
## easy to follow
  • You can even do mixed lists
    1. and nest them
      • like this
* You can even do mixed lists
*# and nest them
*#* like this
Definition list 
list of definitions
item 
the item's definition
; Definition lists : list 
of definitions
; item : the item's definition
Lines can be
indented
several levels
:Lines can be
::indented
:::several levels
A colon will indent a line or paragraph.

A manual newline starts a new paragraph.

:A colon will indent a line or paragraph.
A manual newline starts a new paragraph.
IF a line starts with a space THEN
  it will be formatted exactly 
    as typed;
  in a technical looking font;
  lines won't wrap;
ENDIF
this is useful for:
  * pasting preformatted text;
  * algorithm descriptions;
  * ascii art;

WARNING If you make it wide,
you force the whole page to be wide and
hence less readable.
 IF a line starts with a space THEN
   it will be formatted exactly 
     as typed;
   in a technical looking font;
   lines won't wrap;
 ENDIF
 this is useful for:
   * pasting preformatted text;
   * algorithm descriptions;
   * ascii art;
Centered text.
<center>Centered text.</center>
A horizontal dividing line: above

and below.

A horizontal dividing line: above
----
and below. 

Using columns is an efficient use of space. Just put everything you want in columns below a "<div>" tag

  • One
  • Two
  • Three
  • Four
  • Five
  • Six

And make sure to close your columned-section with a "</div>". You can use this for bulleted or numbered lists or just lines of text, too.

<div style="-moz-column-count:2; column-count:2;">
* One
* Two
* Three
* Four
* Five
* Six
</div>
When adding a comment to a Talk page, you should sign it. You can do this by adding three tildes for your user name. You'll find a command near the top of your talk page that will insert this for you:

- Sheldon Rampton or four for user name plus date/time:

- Sheldon Rampton 08:10 Oct 5, 2002 (UTC)
When adding a comment to a Talk page,
you should sign it. You can do this by adding three
tildes for your user name: 
~~~
or four for user name plus date/time:
~~~~ 

Links and URLs

What it is What you put in What you get

Internal links

A simple internal link.
Link to [[public relations]]. Link to public relations.
An internal link with the same target but a different name. [[Public relations|P.R.]] P.R.
Simple endings to internal links are automatically blended into the link. [[Spin]]ing and [[conservative]]s Fearing and conservatives
when you click "Save page." [[Tom Campbell (California politician)|]]
[[SpinProfiles:Contributing|Contributing]]
[[Portal:Telecom, Media and Intellectual Property Policy (U.S.)|]]
Tom Campbell
Contributing
Telecom, Media and Intellectual Property Policy
Links to pages that don't exist yet show up in red.
  • You can create it by clicking on the link.
  • To create a new page from scratch:
    1. Create a link to it on some other page.
    2. Save that page.
    3. Click on the link you just made. The new page will open for editing.
  • See the instructions and guidelines on how to start a new page and make sure to check the naming conventions.
  • After creating a page, search for its title and make sure that everyone correctly links to it.
[[National sarcasm society]] is a page that doesn't exist yet. National sarcasm society is a page that doesn't exist yet.
You can redirect one article title to another by inserting this single line into the blank page you want to redirect from (the link goes where you want it to redirect to). This is useful for making sure that when other editors link to an article without checking the exact spelling, their link will still work. #REDIRECT [[Thomas D. Delay]] (See an example here)

External links

A simple external link is made by putting a url (including the http://) within a single bracket. To name the link, put one space after the url and then type whatever you want (spaces and other characters are generally fine) and close it with a bracket. [http://www.prwatch.org PR Watch] PR Watch
An even simpler external link can be made by simply pasting the url into the editing window. However the use of brackets as above is the prefered method for use on SpinProfiles. http://www.prwatch.org http://www.prwatch.org

Images

What it looks like What you put in
A picture: Experts small.gif


  • Only images that have been uploaded to SpinProfiles can be used. To upload images, use the upload page. You can find the uploaded image on the image list.
A picture: [[Image:Experts_small.gif]]

or, with alternate text (preferred)

[[Image:Experts_small.gif|Trust Us, We're Experts book cover]] 

which will be

  • displayed in text only browsers, like Lynx
  • displayed in any browser, when display of images is disabled by the user
  • spoken in text to speech browsers, e.g. for blind people

Clicking on an uploaded image displays a description page, which you can also link directly to: Image:Experts_small.gif



[[:Image:Experts_small.gif]]

To include links to non-image uploads such as sounds, or to images shown as links instead of drawn on the page, use a "media" link.


Movie

Link to image



[[media:Foolbush.mov|Movie]]

[[media:Experts_small.gif|Link to image]]

To link to a section on the same page, use a "#" sign and then paste in the title of the section you want to link to. WARNING: If someone changes the name of a section heading, the link will break, so use this sparingly.

 [[#Articles and resources]] 

Character formatting

What it looks like What you type

Emphasize, strongly, very strongly.

  • These are double and triple apostrophes, not double quotes.
''Emphasize'', '''strongly''', 
'''''very strongly'''''.

You can also write italic and bold if the desired effect is a specific font style rather than emphasis, as in mathematical formulas:

F = ma
  • However, the difference between these two methods is not very important, and most people choose to ignore it.
You can also write <i>italic</i> and <b>bold</b>
if the desired effect is a specific font style
rather than emphasis, as in mathematical formulas:

:<b>F</b> = <i>m</i><b>a</b>
A typewriter font for technical terms.
A typewriter font for <tt>technical terms</tt>.
You can strike out deleted material

and underline new material.

  • Useful for editing.
You can <strike>strike out deleted material</strike>
and <u>underline new material</u>.

Umlauts and accents: (See wikipedia:Special characters)
À Á Â Ã Ä Å
Æ Ç È É Ê Ë
Ì Í Î Ï Ñ Ò
Ó Ô Õ Ö Ø Ù
Ú Û Ü ß à á
â ã ä å æ ç
è é ê ë ì í
î ï ñ ò ó ô
õ ö ø ù ú û

ü ÿ


&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring; 
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml; 
&Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve; 
&Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave; 
&Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute; 
&acirc; &atilde; &auml; &aring; &aelig; &ccedil; 
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc; 
&otilde; &ouml; &oslash; &ugrave; &uacute; &ucirc; 
&uuml; &yuml;

Punctuation:
¿ ¡ « » § ¶
† ‡ • —


&iquest; &iexcl; &laquo; &raquo; &sect; &para;
&dagger; &Dagger; &bull; &mdash;

Commercial symbols:
™ © ® ¢ € ¥

£ ¤

&trade; &copy; &reg; &cent; &euro; &yen; 
&pound; &curren;
Subscript: x2

Superscript: x2 or x²

  • The latter method of superscript can't be used in the most general context, but is preferred when possible (as with units of measurement) because most browsers have an easier time formatting lines with it.

ε0 = 8.85 × 10−12

C² / J m.
Subscript: x<sub>2</sub>
Superscript: x<sup>2</sup> or x&sup2;







&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.
Greek characters:

α β γ δ ε ζ
η θ ι κ λ μ ν
ξ ο π ρ σ ς
τ υ φ χ ψ ω
Γ Δ Θ Λ Ξ Π
Σ Φ Ψ Ω


&alpha; &beta; &gamma; &delta; &epsilon; &zeta; 
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu; 
&xi; &omicron; &pi; &rho;  &sigma; &sigmaf;
&tau; &upsilon; &phi; &chi; &psi; &omega;
&Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi; 
&Sigma; &Phi; &Psi; &Omega;

Math characters:
∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥ →
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
(See also [SpinProfiles:Special Characters|Special characters]])

&int; &sum; &prod; &radic; &minus; &plusmn; &infin;
&asymp; &prop; &equiv; &ne; &le; &ge; &rarr;
&times; &middot; &divide; &part; &prime; &Prime;
&nabla; &permil; &deg; &there4; &alefsym; &oslash;
&isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;
&not; &and; &or; &exist; &forall; &rArr; &hArr;
x2   ≥   0 true.
  • To space things out, use non-breaking spaces - &nbsp;.
  • &nbsp; also prevents line breaks in the middle of text, this is useful in formulas.
<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.

Tables

An example table
First header Second header Third header
upper left upper middle right side
lower left lower middle
bottom row
<table border="1">
<caption>An example table</caption>
<tr>
<th>First header</th>
<th>Second header</th>
<th>Third header</th>
</tr>
<tr>
<td>upper left</td>
<td>upper middle</td>
<td rowspan=2>right side</td>
</tr>
<tr>
<td>lower left</td>
<td>lower middle</td>
</tr>
<tr>
<td colspan="3" align="center">bottom row</td>
</tr>
</table>

If your table doesn't look right, make sure that all <tr> and <td> tags are closed with corresponding </tr> and </td> tags. Do not indent lines, and do not include empty lines within a table. Otherwise, you will get spurious space above the table or even a browser crash.

Here's a more advanced example, showing some more options available for making up tables. You can play with these settings in your own table to see what effect they have. Keep in mind that though colors are possible, it's best to use them sparingly. Check the above tables to see what can be done to the text inside the cells.

An example table
First header Second header
upper left   right side
lower left lower middle
A table in a table
Experts small.gif Experts small.gif
Two book covers
<table border="1" cellpadding="5" cellspacing="0" align="center">
<caption>'''An example table'''</caption>
<tr>
<th style="background:#efefef;">First header</th>
<th colspan="2" style="background:#ffdead;">Second header</th>
</tr>
<tr>
<td>upper left</td>
<td> </td>
<td rowspan=2 style="border-bottom:3px solid grey;" valign="top">right side</td>
</tr>
<tr>
<td style="border-bottom:3px solid grey;">lower left</td>
<td style="border-bottom:3px solid grey;">lower middle</td>
</tr>
<tr>
<td colspan="3" align="center">
<table border="0">
<caption>''A table in a table''</caption>
<tr>
<td align="center" width="150px">[[Image:Experts_small.gif]]</td>
<td align="center" width="150px">[[Image:Experts_small.gif]]</td>
</tr>
<tr>
<td align="center" colspan="2" style="border-top:1px solid red; border-right:1px solid red;
border-bottom:2px solid red; border-left:1px solid red;">Two book covers</td>
</tr>
</table>
</td>
</tr>
</table>