Difference between revisions of "AoPS Wiki:Tutorial"
(→Editing the AoPS Wiki) |
m (fix) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{shortcut|[[A:T]]}} | {{shortcut|[[A:T]]}} | ||
| − | This '''AoPS Wiki tutorial''' will help guide you through the process of learning to contribute to the [[AoPS Wiki]]. Also see the categories [[:Category:AoPSWiki| | + | This '''AoPS Wiki tutorial''' will help guide you through the process of learning to contribute to the [[AoPS Wiki]]. Also see the categories [[:Category:AoPSWiki|AoPS Wiki]] and [[:Category:Tutorials|Tutorials]] for more information on certain topics. |
In addition to the information below, there is a good [//en.wikipedia.org/wiki/Help:Editing Wikipedia editing page] which contains most of the information below and will be incorporated into this tutorial over time. | In addition to the information below, there is a good [//en.wikipedia.org/wiki/Help:Editing Wikipedia editing page] which contains most of the information below and will be incorporated into this tutorial over time. | ||
| − | + | == Editing the AoPS Wiki == | |
| − | + | The AoPS Wiki is meant to be edited by you, the users! We encourage you to modify and enhance the AoPS Wiki. To edit an article, however, you must first be familiar with the AoPS Wiki's operational procedures. | |
| − | + | == Learning About AoPS Wiki == | |
| − | + | All users are encouraged to read up on what a wiki is and look around AoPS Wiki. Click the [[Special:Random|Random Page]] button on the navigation panel at right a few times to get a feel for the structure of content in the AoPS Wiki. Try clicking through a few of the colored links on some of the pages. Some will take you to other parts of the AoPS Wiki and some will take you out of the AoPS Wiki to other websites. Have fun with it! | |
| − | All users are encouraged to read up on what a wiki is and look around AoPS Wiki. Click the [[Special:Random | Random Page]] button on the navigation panel at right a few times to get a feel for the structure of content in the AoPS Wiki. Try clicking through a few of the colored links on some of the pages. Some will take you to other parts of the AoPS Wiki and some will take you out of the AoPS Wiki to other websites. | ||
| − | Read about [[AoPS_Wiki:What_makes_AoPSWiki_different|what makes the | + | Read about [[AoPS_Wiki:What_makes_AoPSWiki_different|what makes the AoPS Wiki different]]. |
== Creating an Article == | == Creating an Article == | ||
| − | If you search a topic or click on a link to an article that was not yet written, you yourself can begin creating that article. It is preferred to make bold the name of the article when it first appears in the article, particularly for terms that are given definitions. | + | |
| + | If you search a topic or click on a link to an article that was not yet written, you yourself can begin creating that article. It is preferred to make bold the name of the article when it first appears in the article, particularly for terms that are given definitions. Bolding is explained in the Wiki Syntax section below. Read [{{SERVER}}/community/c65h98050 Tips for Article Creation] to better understand the AoPS Wiki philosophy of article content. | ||
If you can't think of a good topic to write about, look through the list of [[:Category:stubs|stubs]] for articles which already exist but have very little content. | If you can't think of a good topic to write about, look through the list of [[:Category:stubs|stubs]] for articles which already exist but have very little content. | ||
=== Editing an Article === | === Editing an Article === | ||
| + | |||
Click on the '''(Edit)''' button above an article while you are logged into the AoPS Wiki. 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. | Click on the '''(Edit)''' button above an article while you are logged into the AoPS Wiki. 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. | ||
| Line 26: | Line 27: | ||
=== 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. | + | |
| + | 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 look for examples by going into edit mode while in any article. Next, you can practice using wiki syntax in the [[sandbox]]. 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. | * To create '''bullets''' link for this list, use the asterisk (*) at the beginning of each line. | ||
* Use the colon (:) to '''indent'''. | * Use the colon (:) to '''indent'''. | ||
| Line 33: | Line 35: | ||
==== Internal Links ==== | ==== 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 <nowiki>[[mathematics]]</nowiki>. Also, for the cases when it is necessary to make the link-forming part of the phrase different from the actual title of the article it refers to, you may use the piped link format like in <nowiki>[[real number|reals]]</nowiki>, which will create a link to the article titled '''Real Number''' but show and highlight the word '''reals''' instead. If you wish to refer to a specific section of an article, say that Natural Logarithm section of the Logarithm article, you use <nowiki>[[Logarithm#Natural Logarithm|natural logarithm]]</nowiki>, which comes out like this: [[Logarithm#Natural Logarithm|natural logarithm]]. | 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>. Also, for the cases when it is necessary to make the link-forming part of the phrase different from the actual title of the article it refers to, you may use the piped link format like in <nowiki>[[real number|reals]]</nowiki>, which will create a link to the article titled '''Real Number''' but show and highlight the word '''reals''' instead. If you wish to refer to a specific section of an article, say that Natural Logarithm section of the Logarithm article, you use <nowiki>[[Logarithm#Natural Logarithm|natural logarithm]]</nowiki>, which comes out like this: [[Logarithm#Natural Logarithm|natural logarithm]]. | ||
==== External Links ==== | ==== External Links ==== | ||
| − | |||
| − | |||
| − | When linking to | + | When linking to information outside of the AoPS Wiki, use external links. Begin with one open square bracket, type or paste the URL replacing http:// or https:// with //, add a space, then type the text that should appear naming the external link. For instance, to create a link to the [[MAA]] homepage ([http://www.maa.org Mathematical Association of America]), you should type this: |
| − | + | :<nowiki>[//www.maa.org Mathematical Association of America]</nowiki>. | |
| − | + | If you plan to add external links to books, please read [[AoPS Wiki:Linking books]]. | |
| − | |||
| − | + | ==== Redirects ==== | |
| − | + | If an article has several less standard names or acronyms, you can create a page (or pages) to direct users who find each one to the article name you chose. For instance, there is an article under [[ARML]] with the following text: | |
| − | If an article has several less standard names or acronyms, you can create a page (or pages) to direct users who find each one to the article name you chose. For instance, there is an article under [[ARML]] with the following text: | + | :<nowiki>#REDIRECT[[American Regions Mathematics League]]</nowiki>. |
| − | <nowiki>#REDIRECT[[American Regions Mathematics League]]</nowiki>. | + | If you click on the [[ARML]] link, you will go directly to the [[American Regions Mathematics League]] page. Very convenient! |
| − | If you click on the [[ARML]] link, you will go directly to the [[American Regions Mathematics League]] page. | + | |
| + | ==== HTML Phrases ==== | ||
| − | |||
AoPS Wiki supports a limited, but highly useful amount of HTML. Try it out and see. | AoPS Wiki supports a limited, but highly useful amount of HTML. Try it out and see. | ||
| Line 85: | Line 85: | ||
* <p> | * <p> | ||
* <pre> | * <pre> | ||
| − | * [ | + | * [//www.w3.org/TR/1999/WD-ruby-19990322/ <rb>] |
| − | * [ | + | * [//www.w3.org/TR/1999/WD-ruby-19990322/ <rp>] |
| − | * [ | + | * [//www.w3.org/TR/1999/WD-ruby-19990322/ <rt>] |
| − | * [ | + | * [//www.w3.org/TR/1999/WD-ruby-19990322/ <ruby>] |
* <s> | * <s> | ||
* <small> | * <small> | ||
| Line 107: | Line 107: | ||
|} | |} | ||
| − | === Templates | + | Note that many of these tags have different ways to do it using Wiki syntax. For example, headers have HTML tags as well as = signs. |
| + | |||
| + | === Templates and Categories === | ||
| + | |||
See the article [[template]]s and [[Help:Category|categories]] for a definitive guide on creating and using templates & categories, as well as a list of templates and categories currently in existence. | See the article [[template]]s and [[Help:Category|categories]] for a definitive guide on creating and using templates & categories, as well as a list of templates and categories currently in existence. | ||
== Finding Articles To Edit == | == Finding Articles To Edit == | ||
| + | |||
=== Red Links === | === 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. | 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 | + | === Recently Changes === |
| − | At least while AoPS Wiki is relatively young, recently changed articles are usually fairly new articles. | + | |
| + | At least while AoPS Wiki 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 [[AoPS Wiki:Community_Portal|Community Portal]]. | ||
=== Wanted Pages === | === Wanted Pages === | ||
| − | |||
| − | ===Stubs=== | + | The AoPS Wiki automatically creates a list of [[Special:Wantedpages|wanted pages]]. These are pages to which there exist several links, but no actual page exists. This is a good place to look for articles which would contribute the most to the AoPS Wiki's goodness. |
| + | |||
| + | === Stubs === | ||
Some short articles have text at the bottom that says | Some short articles have text at the bottom that says | ||
| + | :''This article is a stub. Help us by [{{SERVER}}/wiki/index.php?title=AoPS_Wiki:Tutorial&action=edit expanding it].'' | ||
| + | It is extremely recommended to expand stubs. | ||
| − | + | == Practice Good Netiquette == | |
| − | |||
| − | |||
| − | |||
* Absolutely no [[spam]] is permitted in the AoPS Wiki. | * Absolutely no [[spam]] is permitted in the AoPS Wiki. | ||
* Practice good [[netiquette]]. | * Practice good [[netiquette]]. | ||
| − | * Be aware of [[AoPS Wiki:What AoPSWiki is not|what the | + | * Be aware of [[AoPS Wiki:What AoPSWiki is not|what the AoPS Wiki is not]]. |
== Where to Ask Questions == | == Where to Ask Questions == | ||
| − | |||
| − | |||
| − | === | + | === AoPS Forums === |
| − | |||
| − | + | The [{{SERVER}}/community AoPS Forums] are the appropriate place to ask questions about AoPS, [[mathematics]], concepts, specific math problems, and [[problem solving]]. | |
| − | The [ | ||
| − | |||
| − | + | The [{{SERVER}}/community/c10 Site Support forum] is a place to ask questions about AoPS Wiki and its functionality when you cannot find the explanation in the AoPS Wiki 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 the article or discuss its content. | ||
| + | [[Category:AoPS Wiki|Tutorial]] | ||
[[Category:AoPSWiki|Tutorial]] | [[Category:AoPSWiki|Tutorial]] | ||
Latest revision as of 17:30, 21 February 2025
| Shortcut: |
This AoPS Wiki tutorial will help guide you through the process of learning to contribute to the AoPS Wiki. Also see the categories AoPS Wiki and Tutorials for more information on certain topics.
In addition to the information below, there is a good Wikipedia editing page which contains most of the information below and will be incorporated into this tutorial over time.
Contents
Editing the AoPS Wiki
The AoPS Wiki is meant to be edited by you, the users! We encourage you to modify and enhance the AoPS Wiki. To edit an article, however, you must first be familiar with the AoPS Wiki's operational procedures.
Learning About AoPS Wiki
All users are encouraged to read up on what a wiki is and look around AoPS Wiki. 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 AoPS Wiki. Try clicking through a few of the colored links on some of the pages. Some will take you to other parts of the AoPS Wiki and some will take you out of the AoPS Wiki to other websites. Have fun with it!
Read about what makes the AoPS Wiki different.
Creating an Article
If you search a topic or click on a link to an article that was not yet written, you yourself can begin creating that article. It is preferred to make bold the name of the article when it first appears in the article, particularly for terms that are given definitions. Bolding is explained in the Wiki Syntax section below. Read Tips for Article Creation to better understand the AoPS Wiki philosophy of article content.
If you can't think of a good topic to write about, look through the list of stubs for articles which already exist but have very little content.
Editing an Article
Click on the (Edit) button above an article while you are logged into the AoPS Wiki. 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.
If you would like to experiment with the Wiki format, please use the Sandbox to play around with new features.
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 look for examples by going into edit mode while in any article. Next, you can practice using wiki syntax in the sandbox. 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]]. Also, for the cases when it is necessary to make the link-forming part of the phrase different from the actual title of the article it refers to, you may use the piped link format like in [[real number|reals]], which will create a link to the article titled Real Number but show and highlight the word reals instead. If you wish to refer to a specific section of an article, say that Natural Logarithm section of the Logarithm article, you use [[Logarithm#Natural Logarithm|natural logarithm]], which comes out like this: natural logarithm.
External Links
When linking to information outside of the AoPS Wiki, use external links. Begin with one open square bracket, type or paste the URL replacing http:// or https:// with //, add a space, then type the text that should appear naming the external link. For instance, to create a link to the MAA homepage (Mathematical Association of America), you should type this:
- [//www.maa.org Mathematical Association of America].
If you plan to add external links to books, please read AoPS Wiki:Linking books.
Redirects
If an article has several less standard names or acronyms, you can create a page (or pages) to direct users who find each one to the article name you chose. For instance, there is an article under ARML with the following text:
- #REDIRECT[[American Regions Mathematics League]].
If you click on the ARML link, you will go directly to the American Regions Mathematics League page. Very convenient!
HTML Phrases
AoPS Wiki supports a limited, but highly useful amount of HTML. Try it out and see.
|
|
|
Note that many of these tags have different ways to do it using Wiki syntax. For example, headers have HTML tags as well as = signs.
Templates and Categories
See the article templates and categories for a definitive guide on creating and using templates & categories, as well as a list of templates and categories currently in existence.
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 Changes
At least while AoPS Wiki is relatively young, recently changed articles are usually fairly new articles. You can find recently changed articles by clicking on the Recent Changes link on the navigation tab at right. Go methodically through the articles, either contributing or adding broken links. Also see the Community Portal.
Wanted Pages
The AoPS Wiki automatically creates a list of wanted pages. These are pages to which there exist several links, but no actual page exists. This is a good place to look for articles which would contribute the most to the AoPS Wiki's goodness.
Stubs
Some short articles have text at the bottom that says
- This article is a stub. Help us by expanding it.
It is extremely recommended to expand stubs.
Practice Good Netiquette
- Absolutely no spam is permitted in the AoPS Wiki.
- Practice good netiquette.
- Be aware of what the AoPS Wiki is not.
Where to Ask Questions
AoPS Forums
The AoPS Forums are the appropriate place to ask questions about AoPS, mathematics, concepts, specific math problems, and problem solving.
The Site Support forum is a place to ask questions about AoPS Wiki and its functionality when you cannot find the explanation in the AoPS Wiki 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 the article or discuss its content.
