Difference between revisions of "Wiki syntax"

From Inkscape Wiki
Jump to: navigation, search
(When Fads Unravel)
m (Reverted edits by Judy0000 (Talk); changed back to last version by Conversion script)
Line 1: Line 1:
When investing, it can be difficult to determine whether the fired-up growth stock you're eyeing is actually just a fad. People who invested in Crocs at the stock's crazy highs have learned the perils of such a situation. The shoe company's fourth-quarter results provide little reason for anybody to believe that Crocs shares can regain their former overpriced glory.
+
You might want to learn simply [[how to start a page]]. If you want the details about how to edit a Wikipedia page, though, you've come to the right place.
  
Crocs did beat analysts' expectations. However, it reported a net loss of $33.2 million, or $0.40 per share, compared to a profit of $38.3 million, or $0.45 per share, during the same period last year. The fourth-quarter net loss included major foreign exchange rate losses; without those, the company still would have reported a net loss of $17.1 million, or $0.20 per share. Revenue plunged 43.9% to $126.1 million.
+
It's very easy to edit a Wiki page. Simply click on the "edit this page right now!" link at the top or bottom of a Wiki page. This will bring you to a page with a text box containing the text of that Wiki page. Then type away, and press "Save" when finished!  (You can also preview your changes before saving if you like.)
  
Crocs also forecast a net loss for the first quarter, guiding in the range of $0.32 to $0.17 per share.
+
What you see in the text box will be mostly plain text, but you will see some special things the Wiki software uses to create links, lists, and other effects. The rest of this page is a demonstration of how to use these features. After the first few sections, you will have to "teach yourself" by pressing the "edit" link (above or below) to see for yourself how various effects were achieved!
  
The company emphasized its improved cash position, accounts receivable, and inventory levels, and these are of course important elements. Cash is king these days, and Crocs' major inventory buildup and mounting accounts receivables hinted at big trouble on the way when the stock first began its downward spiral. However, Crocs' constant emphasis on the poor economy's negative impact may be a bit misleading. Although I have no doubt that the consumer spending slowdown is taking a bite out of Crocs, it's also been clear that the fad element of the company's shoes is rapidly unraveling. That implies that the heady growth of yesteryear is over, even when consumer spending revives.
+
Let's say that you're editing a page about sports, and you mention soccer. Well, there's probably a Wiki page about soccer (and if there isn't, there should be) and you want to make the word a link to that article.  Simple: type double square brackets around it <code>[[like this]]</code> and continue editing.  That's it!  If the page already exists, a link will be made to it. If the page doesn't already exist, a link will be made that allows someone to create it.
  
Faddish stocks like Crocs and Heelys are dangerous for investors, even if Microsoft founder Bill Gates apparently believes that Crocs is a good stock.  
+
There are a few rules about making these links that you might run into.  Foreign characters and punctuation cannot be used in the text of a link, so if you want to make a link to "John's Dog", you'll have to leave out the apostrophe. Also, the Wiki software will link to a page title that is the same as the text of your link, except that the first letter will be uppercased, and spaces may be condensed.  For example, if you type <code>[[card game]]</code>, <br>it will be linked to a page entitled "Card game".
  
Navigating the dire economy won't be easy for discretionary stocks like Crocs. Fellow footwear maker Skechers recently got trampled. On the other hand, these tough times could provide investing opportunities. I've wanted to take a deeper look at Deckers lately; its <a href="http://www.inugg.com/">ugg boots</a> may be a fad, but they've shown remarkable staying power for years now, remaining hot even through last year's holiday shopping season.
+
Older versions of the Wiki software only made one-word links <code>[[LikeThis]]</code>, and didn't require the brackets to make them links.  You can still do that, but it's generally discouraged because it [[LooksFunny]].  It is handy to use singular words like "game" rather than "games", because that makes it easier to create links in other pages.
  
But in Crocs' case, I continue to firmly advise investors to steer clear. Even though it may look cheap trading in penny stock territory, I don't believe it will ever come near its former growth rates. Buyer, beware.
+
Finally, sometimes the text you would like to make into a link just doesn't make a good page title. In that case, you can specify both inside the brackets separated by a vertical bar like this: <code>[[Page link|text of link]]</code>.  This will appear as "text of link", but will link to a page entitled "Page link".
  
+
Examples of Good links:
 +
:<code>[[my new page]]</code>
 +
:<code>[[My new page]]</code>
 +
:<code>[[JohnSmith]]</code>
 +
:<code>[[Johns Dog]]</code>
 +
:<code>[[Johns Dog|John's Dog]]</code>
 +
Bad links:
 +
:<code>[[my_new_page]]</code> (underscores not necessary)
 +
:<code>[[My_new_page]]</code> (underscores not necessary)
 +
:<code>johnsmith</code> (needs two capital letters or brackets)
 +
:<code>[[John's Dog]]</code> (will not link to the page you want it to link to)
 +
See [[naming conventions]] when choosing names for pages!
  
I love <a href="http://www.inugg.com/">uggs</a> .
+
<h2>Making a new page</h2>
  
Buy <a href="http://www.inugg.com/">buy ugg boots</a> .
+
There are two ways to make a new page:
 +
 
 +
# As mentioned above, while you're editing the text of an old page, you can just put something in brackets.  For example, you would type: <code>[[my page]]</code>.  When you save the page you're editing, if the link you included doesn't exist, you will see a question mark after the text.  Click on that question mark and you will be taken to a newly-created page that you can edit.  Replace "Describe the new page here." with whatever text you want to put on the page!
 +
#Type the URL of the new page in the "address" line of your browser and hit return.  The URL of the new page will be the text of a link, with the first letter uppercased and spaces replaced by underscores (see [[Wiki Canonization]] for more details about this). For example, in the URL above, you would replace
 +
<br><code>http://intranet.pdx.osdl.net/cgi-bin/wiki.pl?How_does_one_edit_a_page</code>
 +
<br>with the new URL
 +
<br><code>http://intranet.pdx.osdl.net/cgi-bin/wiki.pl?Name_of_your_new_page</code>
 +
<br>and then hit return.
 +
 
 +
See also [[how to start a page]].
 +
 
 +
 
 +
<h2>Demonstration area</h2>
 +
 
 +
*What follows is an area for demonstrating the various effects possible using Wiki, such as bold, italics, numbered lists, etc., etc.
 +
*Click "edit" at the top or bottom of this page (i.e., the page you are now reading!) to see how these effects were achieved!!!
 +
*<b>If you don't click "edit" now you won't understand what's going on!!!</b>
 +
 
 +
New paragraphs are made by simply pressing the "enter" or "return" key twice.  If you press it just once,
 +
like this,
 +
a new paragraph ''will not'' be made (as you can see).
 +
 
 +
Here is
 +
<br>the proper way
 +
<br>to make single-spaced lines.
 +
 
 +
:This line is indented.
 +
::This line is indented even farther.
 +
:::Who knows how far it can go?
 +
 
 +
This line is indented by using an initial space,
 +
              but since I didn't use a colon ( : )
 +
  at the beginning of the line, it appears as a monospace font such as "Courier". 
 +
  In other words, if you begin a paragraph with spaces, that
 +
      line will be both indented and in a monospace font.
 +
This is very useful for importing monospace formatted tabular materials, especially source code. Also note that space-indented lines will not wrap!  They will simply increase the width of your window.
 +
 
 +
''This line is in italics.'' (Using double single quote marks!)
 +
<br><i>And so is this one!</i> (Using good old html tags!)
 +
<br><em>And this!</em> (Using still different code!  How versatile!  How confusing!  But any of them will do.)
 +
 
 +
'''This line is bold.''' (Using triple single quote marks!)
 +
<br><b>So is this one!</b> (Using the standard html tag!)
 +
 
 +
Here is a new style link: [[Larry Sanger]] (see [[Free Links]])
 +
<br>Here is an old style link: [[HomePage]]
 +
<br>Consider not capitalizing your page names: [[definition of philosophy]]; see [[naming conventions]]
 +
<br>[[HomePage|the text of this link is different from the name of the page it links to]]
 +
<br>[[HomePage|it really doesn't MatterWhat youType in the...link description.  It's all link&eacute;d!]]
 +
<br>An external link: http://www.nupedia.com/about.shtml
 +
<br>Another external
 +
link: [http://www.nupedia.com/about.shtml Nupedia about page]
 +
 
 +
If you type in the URL of a picture, it will be displayed rather than linked to:<br>http://www.wikipedia.com/wikia.gif
 +
 
 +
You don't have to create weird page titles, like [[Platos]], just to make the plural or possessive form of a name.  [[Plato's]] wouldn't work anyway.  You can write: [[Plato]]'s or (more cleverly) [[Plato|Plato's]].  In the old linking system you'd do it like this: [[JimboWales]]'s homepage (using "").  (Just Say No to the old linking system; after all, you can now link to [[Jimbo Wales]]'s homepage!)  But it ''does'' look like you're stuck with [[Platos Republic]], because [[Plato's Republic]] doesn't work, as you can see, although if you want to type a bit more you can cleverly create [[Platos Republic|Plato's Republic]].
 +
 
 +
Here is a numbered list:
 +
#Item 1
 +
#Item 2
 +
#Item 8
 +
#Notice, this line isn't numbered because it is not flush left.
 +
:#Neither is this line
 +
 
 +
Here is a bulleted list:
 +
*Here's an item
 +
* Here's another item
 +
**We can do bullets within bullets, as it were
 +
*** Pretty nifty, huh?
 +
 
 +
You can make a horizontal "rule" (line) on a page: ----
 +
Or two, if you wish:
 +
----
 +
----
 +
 
 +
There are three ways to display, rather than parse, wiki code:
 +
#<code>you can use the <code> tag</code>
 +
#<pre>you can use the <pre> tag</pre>
 +
#<nowiki>you can use the <nowiki> tag</nowiki>
 +
The difference between <nowiki><code> and <pre></nowiki> is that the pre tag preserves line breaks, while the code tag does not.  The nowiki tag works like the <code><code></code> tag except that it doesn't use a monospace font.  (We made liberal use of the <code><code></code> tag on this page.)
 +
 
 +
Lines that \
 +
end with backslashes \
 +
will wrap if it is the *last* character on the line.
 +
If there is trailing spaces, the backslash won't cause word wrapping.
 +
 
 +
You can create subpages: [[/Talk]]
 +
<br>Sorry, but you cannot create sub-subpages: [[/Talk/TalkAboutTalk]]
 +
<br>You can link to other subpages: [[Charlize Theron/Filmography]] or even [[charlize Theron/Filmography]].
 +
 
 +
We can do tables the old fashioned HTML way:
 +
<table border=1>
 +
<tr>
 +
<td>Item one</td>
 +
<td>Item two</td>
 +
</tr>
 +
<tr>
 +
<td>Item three</td>
 +
<td>Item four</td>
 +
</tr>
 +
</table>
 +
 
 +
The    preformatted  text    approach  might
 +
be    a              better  way        to
 +
do    columnar      types  of        tables.  ;-)
 +
 
 +
Sometimes you might need to use special characters, like these: ï¿?ï¿?&alpha;
 +
 
 +
You can make <sup>superscripts</sup> and <sub>subscripts</sub> and you can control the font <font size=+1>size</font> and <font color=blue>color</font>!
 +
 
 +
*f(x) = a<sub>0</sub> + a<sub>1</sub>x<sub>1</sub> + a<sub>2</sub>x<sub>2</sub><sup>2</sup> + a<sub>3</sub>x<sub>3</sub><sup>3</sup> + ...
 +
 
 +
*<font size=+2 color=red>f(x) = a<sub>0</sub> + a<sub>1</sub>x<sub>1</sub> + a<sub>2</sub>x<sub>2</sub><sup>2</sup> + a<sub>3</sub>x<sub>3</sub><sup>3</sup> + ...</font>
 +
 
 +
If you want to redirect traffic going to one page to another page (with a better title, for example), then use the command <code>#REDIRECT [[pagename]]</code> at the top of the page.  To look at the history of the old page, click on the "<code>(redirected from [[OldPageName]])</code>" link at the top of the new page.
 +
 
 +
----
 +
This page is borrowed & adapted from [http://www.wikipedia.com/ Wikipedia.com], and is reusable under the terms of the [http://www.gnu.org/copyleft/fdl.html GNU Free Documentation License (FDL)].

Revision as of 21:31, 5 March 2009

You might want to learn simply how to start a page. If you want the details about how to edit a Wikipedia page, though, you've come to the right place.

It's very easy to edit a Wiki page. Simply click on the "edit this page right now!" link at the top or bottom of a Wiki page. This will bring you to a page with a text box containing the text of that Wiki page. Then type away, and press "Save" when finished! (You can also preview your changes before saving if you like.)

What you see in the text box will be mostly plain text, but you will see some special things the Wiki software uses to create links, lists, and other effects. The rest of this page is a demonstration of how to use these features. After the first few sections, you will have to "teach yourself" by pressing the "edit" link (above or below) to see for yourself how various effects were achieved!

Let's say that you're editing a page about sports, and you mention soccer. Well, there's probably a Wiki page about soccer (and if there isn't, there should be) and you want to make the word a link to that article. Simple: type double square brackets around it like this and continue editing. That's it! If the page already exists, a link will be made to it. If the page doesn't already exist, a link will be made that allows someone to create it.

There are a few rules about making these links that you might run into. Foreign characters and punctuation cannot be used in the text of a link, so if you want to make a link to "John's Dog", you'll have to leave out the apostrophe. Also, the Wiki software will link to a page title that is the same as the text of your link, except that the first letter will be uppercased, and spaces may be condensed. For example, if you type card game,
it will be linked to a page entitled "Card game".

Older versions of the Wiki software only made one-word links LikeThis, and didn't require the brackets to make them links. You can still do that, but it's generally discouraged because it LooksFunny. It is handy to use singular words like "game" rather than "games", because that makes it easier to create links in other pages.

Finally, sometimes the text you would like to make into a link just doesn't make a good page title. In that case, you can specify both inside the brackets separated by a vertical bar like this: text of link. This will appear as "text of link", but will link to a page entitled "Page link".

Examples of Good links:

my new page
My new page
JohnSmith
Johns Dog
John's Dog

Bad links:

my_new_page (underscores not necessary)
My_new_page (underscores not necessary)
johnsmith (needs two capital letters or brackets)
John's Dog (will not link to the page you want it to link to)

See naming conventions when choosing names for pages!

Making a new page

There are two ways to make a new page:

  1. As mentioned above, while you're editing the text of an old page, you can just put something in brackets. For example, you would type: my page. When you save the page you're editing, if the link you included doesn't exist, you will see a question mark after the text. Click on that question mark and you will be taken to a newly-created page that you can edit. Replace "Describe the new page here." with whatever text you want to put on the page!
  2. Type the URL of the new page in the "address" line of your browser and hit return. The URL of the new page will be the text of a link, with the first letter uppercased and spaces replaced by underscores (see Wiki Canonization for more details about this). For example, in the URL above, you would replace


http://intranet.pdx.osdl.net/cgi-bin/wiki.pl?How_does_one_edit_a_page
with the new URL
http://intranet.pdx.osdl.net/cgi-bin/wiki.pl?Name_of_your_new_page
and then hit return.

See also how to start a page.


Demonstration area

  • What follows is an area for demonstrating the various effects possible using Wiki, such as bold, italics, numbered lists, etc., etc.
  • Click "edit" at the top or bottom of this page (i.e., the page you are now reading!) to see how these effects were achieved!!!
  • If you don't click "edit" now you won't understand what's going on!!!

New paragraphs are made by simply pressing the "enter" or "return" key twice. If you press it just once, like this, a new paragraph will not be made (as you can see).

Here is
the proper way
to make single-spaced lines.

This line is indented.
This line is indented even farther.
Who knows how far it can go?
This line is indented by using an initial space,
              but since I didn't use a colon ( : ) 
  at the beginning of the line, it appears as a monospace font such as "Courier".  
 In other words, if you begin a paragraph with spaces, that 
     line will be both indented and in a monospace font.
This is very useful for importing monospace formatted tabular materials, especially source code. Also note that space-indented lines will not wrap!  They will simply increase the width of your window.

This line is in italics. (Using double single quote marks!)
And so is this one! (Using good old html tags!)
And this! (Using still different code! How versatile! How confusing! But any of them will do.)

This line is bold. (Using triple single quote marks!)
So is this one! (Using the standard html tag!)

Here is a new style link: Larry Sanger (see Free Links)
Here is an old style link: HomePage
Consider not capitalizing your page names: definition of philosophy; see naming conventions
the text of this link is different from the name of the page it links to
it really doesn't MatterWhat youType in the...link description. It's all linkéd!
An external link: http://www.nupedia.com/about.shtml
Another external link: Nupedia about page

If you type in the URL of a picture, it will be displayed rather than linked to:
http://www.wikipedia.com/wikia.gif

You don't have to create weird page titles, like Platos, just to make the plural or possessive form of a name. Plato's wouldn't work anyway. You can write: Plato's or (more cleverly) Plato's. In the old linking system you'd do it like this: JimboWales's homepage (using ""). (Just Say No to the old linking system; after all, you can now link to Jimbo Wales's homepage!) But it does look like you're stuck with Platos Republic, because Plato's Republic doesn't work, as you can see, although if you want to type a bit more you can cleverly create Plato's Republic.

Here is a numbered list:

  1. Item 1
  2. Item 2
  3. Item 8
#Notice, this line isn't numbered because it is not flush left.
  1. Neither is this line

Here is a bulleted list:

  • Here's an item
  • Here's another item
    • We can do bullets within bullets, as it were
      • Pretty nifty, huh?

You can make a horizontal "rule" (line) on a page: ---- Or two, if you wish:



There are three ways to display, rather than parse, wiki code:

  1. you can use the <code> tag
  2. you can use the <pre> tag
  3. you can use the <nowiki> tag

The difference between <code> and <pre> is that the pre tag preserves line breaks, while the code tag does not. The nowiki tag works like the <code> tag except that it doesn't use a monospace font. (We made liberal use of the <code> tag on this page.)

Lines that \ end with backslashes \ will wrap if it is the *last* character on the line. If there is trailing spaces, the backslash won't cause word wrapping.

You can create subpages: /Talk
Sorry, but you cannot create sub-subpages: /Talk/TalkAboutTalk
You can link to other subpages: Charlize Theron/Filmography or even charlize Theron/Filmography.

We can do tables the old fashioned HTML way:

Item one Item two
Item three Item four
The    preformatted   text    approach   might 
be     a              better  way        to
do     columnar       types   of         tables.  ;-)

Sometimes you might need to use special characters, like these: ï¿?ï¿?α

You can make superscripts and subscripts and you can control the font size and color!

  • f(x) = a0 + a1x1 + a2x22 + a3x33 + ...
  • f(x) = a0 + a1x1 + a2x22 + a3x33 + ...

If you want to redirect traffic going to one page to another page (with a better title, for example), then use the command #REDIRECT pagename at the top of the page. To look at the history of the old page, click on the "(redirected from OldPageName)" link at the top of the new page.


This page is borrowed & adapted from Wikipedia.com, and is reusable under the terms of the GNU Free Documentation License (FDL).