Difference between revisions of "AoPS Wiki:Tutorial"

m (Math Questions)
(rewrote syntax section)
Line 10: Line 10:
  
 
=== Wiki Syntax ===
 
=== Wiki Syntax ===
First, while in edit mode, there is a control panel in the upper left of the text box.  Hover your cursor over the buttons to get an idea as to what they do.  Remember that you can test syntax on your own user page.  You can also hunt for examples by going into edit mode while in any article.
+
First, while in edit mode, there is a control panel in the upper left of the text box.  Hover your cursor over the buttons to get an idea as to what they do.  Remember that you can test syntax on your own user page.  You can also hunt for examples by going into edit mode while in any article. Here are a few common ways to format content in your article:
 +
* To create '''bullets''' link for this list, use the asterisk (*) at the beginning of each line.
 +
* Use the colon (:) to '''indent'''.
 +
* To ''italicize'' text, place two apostrophes both before and after the <nowiki>'''text'''</nowiki>.
 +
* To '''bold''' text, place three apostrophes both before and after the <nowiki>'''text'''</nowiki>.
 +
 
 
==== Internal Links ====
 
==== Internal Links ====
Internal links are the heart of what makes a wiki.  Place two square brackets on each side of a word or phrase to link the text to the article of the same name.  If you highlight text while writing/editing, the third button from the left on the control panel will do this for you.
+
Internal links are at the heart of what makes a wiki.  Place two square brackets on each side of a word or phrase to link the text to the article of the same name.  In order to create the link [[mathematics]], you would type <nowiki>[[mathematics]]</nowiki>.
 +
 
 
==== External Links ====
 
==== External Links ====
When linking to information outside of the AoPSWiki, use external links.  Begin with one open square bracket, type or paste the URL, add a space, then type the text that should appear naming the external link:
+
When linking to information outside of the AoPSWiki, use external links.  Begin with one open square bracket, type or paste the URL, add a space, then type the text that should appear naming the external link.  For instance, to create a link to the [[Art of Problem Solving]] homepage ([http://www.artofproblemsolving.com Art of Problem Solving]), you should type <nowiki>[http://www.artofproblemsolving.com Art of Problem Solving]</nowiki>.
:[URL name]
+
 
End with a closed square braceWhen the URL is the AoPS homepage and the name is '''Art of Problem Solving''', the link looks like this: [http://www.artofproblemsolving.com Art of Problem Solving]
 
The fourth button from the left in the control panel will add the square braces to highlighted text.
 
  
 
== Finding articles to edit ==
 
== Finding articles to edit ==

Revision as of 17:11, 19 June 2006

This AoPSWiki tutorial will help guide you through the process of learning to contribute to the AoPSWiki.


Getting Started

Learning About AoPSWiki

All users are encouraged to read up on what a wiki is and look around AoPSWiki. Click the Random Page button on the navigation panel at right a few times to get a feel for the structure of content in the AoPSWiki. Try clicking through a few of the colored links on some of the pages. Some will take you to other parts of the AoPSWiki and some will take you out of the AoPSWiki to other websites.

Editing an Article

Click on the Edit button above an article while you are logged into the AoPSWiki. If the article is new, you can just start writing. If the article already exists, you will see the article text, MediaWiki syntax included. Write around or over the text to change the content of the article.

Wiki Syntax

First, while in edit mode, there is a control panel in the upper left of the text box. Hover your cursor over the buttons to get an idea as to what they do. Remember that you can test syntax on your own user page. You can also hunt for examples by going into edit mode while in any article. Here are a few common ways to format content in your article:

  • To create bullets link for this list, use the asterisk (*) at the beginning of each line.
  • Use the colon (:) to indent.
  • To italicize text, place two apostrophes both before and after the '''text'''.
  • To bold text, place three apostrophes both before and after the '''text'''.

Internal Links

Internal links are at the heart of what makes a wiki. Place two square brackets on each side of a word or phrase to link the text to the article of the same name. In order to create the link mathematics, you would type [[mathematics]].

External Links

When linking to information outside of the AoPSWiki, use external links. Begin with one open square bracket, type or paste the URL, add a space, then type the text that should appear naming the external link. For instance, to create a link to the Art of Problem Solving homepage (Art of Problem Solving), you should type [http://www.artofproblemsolving.com Art of Problem Solving].


Finding articles to edit

Red Links

If, while reading through an article, you notice a red internal link, that represents an article that has not yet been written. Click on the red link to start writing that article. Remember, however, that the article on this subject may have already been written under a slightly different name, so it is always a good idea to make a little search first. If you find the relevant article under a different name, all you need to do is to create a simple REDIRECT page. You may also want to use this option if you feel that the right name for the topic should be somewhat different from the text in the red link. Also, don't forget to check the red link text for spelling and other errors before creating an article with the name from a red link.

Recently Changed Articles

At least while AoPSWiki is relatively young, recently changed articles are usually fairly new articles. You can find recently changed articles by clicking on the Special:Recentchanges (Recent Changes) link on the navigation tab at right. Go methodically through the articles, either contributing or adding broken links. Also see the AoPSWiki:Community_Portal (Community Portal).


Practice Good Netiquette


Where to Ask Questions

AoPSWiki Forum

The AoPSWiki Forum is a place to ask questions about AoPSWiki and its functionality when you cannot find the explanation in the AoPSWiki itself. Please read through the announcement and sticky threads to see if your questions are answered there. The forum also includes a search feature that might help you locate the answers to your questions.

Article Discussion

Click the Discussion tab at the top of an article to ask questions about an article or discuss its content.

Math Questions

The AoPS Forums are the appropriate places to ask questions about mathematics, concepts, specific math problems, and problem solving (not the article discussion area).