Difference between revisions of "QBWiki:Editing Tutorial"
Kevin Wang (talk | contribs) |
Kevin Wang (talk | contribs) m (→References) |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
+ | This short tutorial will discuss the formatting involved in editing Wikis, and in editing the QBWiki in particular. | ||
+ | |||
+ | For notes on how to use these tools, please consult the [[QBWiki:Style Guide|Style Guide]]. | ||
+ | __NOTOC__ | ||
+ | {| class="wikitable" | ||
+ | | Jump to: [[QBWiki:Editing Tutorial#Wikitext|Wikitext]]{{dot}} | ||
+ | |} | ||
==Wikitext== | ==Wikitext== | ||
There are many tools at your disposal to give your pages more of an encyclopedic feel. The table below lists several of these tools, and examples of their usage. | There are many tools at your disposal to give your pages more of an encyclopedic feel. The table below lists several of these tools, and examples of their usage. | ||
− | {| | + | Advanced topics not covered in this section can be found [http://meta.wikimedia.org/wiki/Help:Advanced_editing here] and [http://meta.wikimedia.org/wiki/Help:Editing_tips_and_tricks here]. |
+ | |||
+ | {|align="center" class="wikitable" | ||
! Type This | ! Type This | ||
! To Get This | ! To Get This | ||
Line 20: | Line 29: | ||
====sub-subheading====</nowiki></pre> | ====sub-subheading====</nowiki></pre> | ||
− | |||
− | + | Sections which are given a heading will appear in the table of contents. | |
+ | | | ||
+ | ==heading== | ||
− | + | ===subheading=== | |
+ | |||
+ | ====sub-subheading==== | ||
+ | |||
+ | Sections which are given a heading will appear in the table of contents. | ||
|- | |- | ||
| <pre><nowiki>*Bullets are made by placing stars at the beginning of each item. | | <pre><nowiki>*Bullets are made by placing stars at the beginning of each item. | ||
Line 48: | Line 62: | ||
#And the list continues | #And the list continues | ||
|- | |- | ||
− | | A set of two brackets around a word links to an article by that name. | + | | A set of two brackets around a word links to an article by that name. |
+ | |||
+ | <pre><nowiki>[[ACF]] would link to an article on the ACF, for example.</nowiki></pre> | ||
+ | |||
+ | When a link points to the page it is on, it appears bold and cannot be clicked. | ||
+ | |||
+ | <pre><nowiki>[[QBWiki:Editing Tutorial]]</nowiki></pre> | ||
|A double set of brackets around a word links to the article by that name. | |A double set of brackets around a word links to the article by that name. | ||
[[ACF]] links to an article on the ACF, for example. | [[ACF]] links to an article on the ACF, for example. | ||
+ | |||
+ | When a link points to the page it is on, it appears bold and cannot be clicked. | ||
+ | |||
+ | [[QBWiki:Editing Tutorial]] | ||
|- | |- | ||
| Use the article name, followed by a pipe, then the text you want to display, to make an internal link but have your own text show up on the page: <br><pre><nowiki>[[ACF|another format]]</nowiki></pre> would let you write a sentence about NAQT with the phrase "another format" linking to the ACF article. | | Use the article name, followed by a pipe, then the text you want to display, to make an internal link but have your own text show up on the page: <br><pre><nowiki>[[ACF|another format]]</nowiki></pre> would let you write a sentence about NAQT with the phrase "another format" linking to the ACF article. | ||
Line 57: | Line 81: | ||
After many seasons playing only NAQT, the Whoville State program started playing [[ACF|another format]] as well. | After many seasons playing only NAQT, the Whoville State program started playing [[ACF|another format]] as well. | ||
+ | |- | ||
+ | |Pages which do not belong to the default space can be shortened by adding a pipe at the end. | ||
+ | |||
+ | <pre>[[QBWiki:Style Guide|]]</pre> | ||
+ | |Pages which do not belong to the default space can be shortened by adding a pipe at the end. | ||
+ | |||
+ | [[QBWiki:Style Guide|Style Guide]] | ||
|- | |- | ||
| Anything you can do to a normal word, you can do to a link.<br><pre><nowiki>'''[[ACF]]''' makes a bold link.</nowiki></pre> | | Anything you can do to a normal word, you can do to a link.<br><pre><nowiki>'''[[ACF]]''' makes a bold link.</nowiki></pre> | ||
Line 85: | Line 116: | ||
Or leave the title blank (good for citing sources at the end): | Or leave the title blank (good for citing sources at the end): | ||
[http://www.naqt.com] | [http://www.naqt.com] | ||
+ | |- | ||
+ | |<pre><nowiki>References can be embedded using the "ref" tag.<ref>They will appear wherever the "references" tag is embedded.</ref> | ||
+ | |||
+ | ==References== | ||
+ | <references/> | ||
+ | </nowiki></pre> | ||
+ | |References can be embedded using the "ref" tag.<ref>They will appear wherever the "references" tag is embedded.</ref> | ||
+ | |||
+ | ==References== | ||
+ | <references/> | ||
+ | |- | ||
+ | | Users familiar with HTML can construct tables using conventional tags. This allows advanced customization but should only be used by experienced users. | ||
+ | |||
+ | <pre><nowiki><table style="border:1px black solid;"> | ||
+ | <tr><th style="border:1px grey dashed;">Bolded entry</th></tr> | ||
+ | <tr><td style="border:2px red solid;">Unbolded entry</td></tr> | ||
+ | <tbody>Note, however, that there is no support for the "tbody" and "thead" tags that you may be familiar with.</tbody> | ||
+ | </table></nowiki></pre> | ||
+ | |||
+ | Wikitext provides a simpler format for tables that will serve most purposes. | ||
+ | |||
+ | <pre><nowiki>{| class="wikitable" | ||
+ | ! Bolded entry | ||
+ | |- | ||
+ | | Unbolded entry | ||
+ | |}</nowiki></pre> | ||
+ | |||
+ | | Users familiar with HTML can construct tables using conventional tags. | ||
+ | <table style="border:1px black solid;> | ||
+ | <tr><th style="border:1px grey dashed;">Bolded entry</th></tr> | ||
+ | <tr><td style="border:2px red solid;">Unbolded entry</td></tr> | ||
+ | <tbody>Note, however, that there is no support for the "tbody" and "thead" tags that you may be familiar with.</tbody> | ||
+ | </table> | ||
+ | |||
+ | Wikitext provides a simpler format for tables that will serve most purposes. | ||
+ | |||
+ | {| class="wikitable" | ||
+ | ! Bolded entry | ||
+ | |- | ||
+ | | Unbolded entry | ||
|} | |} | ||
+ | |- | ||
+ | |<pre><nowiki>Pages can be annotated with [[:Category:Categories]], which will mark the page as part of that category.</nowiki></pre> | ||
+ | |||
+ | Regardless of where a category is added, it will appear at the bottom of the page. To have it appear as a link instead (as it does in this example), use a colon at the front. | ||
+ | |Pages can be annotated with [[:Category:Categories]], which will mark the page as part of that category. | ||
+ | |||
+ | Regardless of where a category is added, it will appear at the bottom of the page. To have it appear as a link instead (as it does in this example), use a colon at the front. | ||
+ | |- | ||
+ | |<pre><nowiki>{{Templates}} are specified using double curly braces and allow text and formatting to be reused in different places. | ||
+ | |||
+ | By default all templates have "Template:" before their name. Other pages, including articles, can also be used as templates - this is a process called "[https://www.mediawiki.org/wiki/Transclusion transclusion]". The details of this and a list of key templates on the QBWiki will be discussed in the following section.</nowiki></pre> | ||
+ | |{{Templates}} are specified using double curly braces and allow text and formatting to be reused in different places. They can be supplied arguments using | ||
+ | |||
+ | By default all templates have "Template:" before their name. Other pages, including articles, can also be used as templates - this is a process called "[https://www.mediawiki.org/wiki/Transclusion transclusion]". The details of this and a list of key templates on the QBWiki will be discussed in the following section. | ||
+ | |} | ||
+ | |||
+ | ===Templates=== | ||
+ | For an incomplete list of useful templates, see [[Templates]]. | ||
+ | |||
+ | ==QBWiki== | ||
− | |||
[[Category:Wiki maintenance]] | [[Category:Wiki maintenance]] | ||
[[Category:Original QBWiki Page]] | [[Category:Original QBWiki Page]] |
Latest revision as of 21:45, 9 February 2022
This short tutorial will discuss the formatting involved in editing Wikis, and in editing the QBWiki in particular.
For notes on how to use these tools, please consult the Style Guide.
Jump to: Wikitext · |
Wikitext
There are many tools at your disposal to give your pages more of an encyclopedic feel. The table below lists several of these tools, and examples of their usage.
Advanced topics not covered in this section can be found here and here.
Type This | To Get This | ||||
---|---|---|---|---|---|
Two single quotes around a word italicizes it.''hello'' |
hello | ||||
Three single quotes around a word bolds it.'''hello''' |
hello | ||||
Five single quotes around a word bolds and italicizes it.'''''hello''''' |
hello | ||||
Headings and subheadings in an article are made with equal signs.==heading== ===subheading=== ====sub-subheading==== Sections which are given a heading will appear in the table of contents. |
headingsubheadingsub-subheadingSections which are given a heading will appear in the table of contents. | ||||
*Bullets are made by placing stars at the beginning of each item. *If you want a list inside a list **Just use more stars ***Pretty simple, huh? |
| ||||
#Numbered lists work the same way as bullets. #More number (or pound) signs ##Make mini lists ##Inside the first list #And the list continues |
| ||||
A set of two brackets around a word links to an article by that name.
[[ACF]] would link to an article on the ACF, for example. When a link points to the page it is on, it appears bold and cannot be clicked. [[QBWiki:Editing Tutorial]] |
A double set of brackets around a word links to the article by that name.
ACF links to an article on the ACF, for example. When a link points to the page it is on, it appears bold and cannot be clicked. | ||||
Use the article name, followed by a pipe, then the text you want to display, to make an internal link but have your own text show up on the page: [[ACF|another format]]would let you write a sentence about NAQT with the phrase "another format" linking to the ACF article. |
It looks like this:
After many seasons playing only NAQT, the Whoville State program started playing another format as well. | ||||
Pages which do not belong to the default space can be shortened by adding a pipe at the end.
[[QBWiki:Style Guide|]] |
Pages which do not belong to the default space can be shortened by adding a pipe at the end. | ||||
Anything you can do to a normal word, you can do to a link.'''[[ACF]]''' makes a bold link. |
Anything you can do to a normal word, you can do to a link.
ACF makes a bold link. | ||||
[[Links in red]] don't have articles yet. Click on them to edit the article. |
Links in red don't have articles yet. Click on them to edit the article. | ||||
You can make an external link just by typing a URL: http://www.naqt.com You can give it a title: [http://www.naqt.com NAQT] Or leave the title blank (good for citing sources at the end): [http://www.naqt.com] |
You can make an external link just by typing a URL:
You can give it a title: NAQT Or leave the title blank (good for citing sources at the end): [1] | ||||
References can be embedded using the "ref" tag.<ref>They will appear wherever the "references" tag is embedded.</ref> ==References== <references/> |
References can be embedded using the "ref" tag.[1]
References
| ||||
Users familiar with HTML can construct tables using conventional tags. This allows advanced customization but should only be used by experienced users.
<table style="border:1px black solid;"> <tr><th style="border:1px grey dashed;">Bolded entry</th></tr> <tr><td style="border:2px red solid;">Unbolded entry</td></tr> <tbody>Note, however, that there is no support for the "tbody" and "thead" tags that you may be familiar with.</tbody> </table> Wikitext provides a simpler format for tables that will serve most purposes. {| class="wikitable" ! Bolded entry |- | Unbolded entry |} |
Users familiar with HTML can construct tables using conventional tags.
<tbody>Note, however, that there is no support for the "tbody" and "thead" tags that you may be familiar with.</tbody>
Wikitext provides a simpler format for tables that will serve most purposes.
| ||||
Pages can be annotated with [[:Category:Categories]], which will mark the page as part of that category. Regardless of where a category is added, it will appear at the bottom of the page. To have it appear as a link instead (as it does in this example), use a colon at the front. |
Pages can be annotated with Category:Categories, which will mark the page as part of that category.
Regardless of where a category is added, it will appear at the bottom of the page. To have it appear as a link instead (as it does in this example), use a colon at the front. | ||||
{{Templates}} are specified using double curly braces and allow text and formatting to be reused in different places. By default all templates have "Template:" before their name. Other pages, including articles, can also be used as templates - this is a process called "[https://www.mediawiki.org/wiki/Transclusion transclusion]". The details of this and a list of key templates on the QBWiki will be discussed in the following section. |
Template:Templates are specified using double curly braces and allow text and formatting to be reused in different places. They can be supplied arguments using
By default all templates have "Template:" before their name. Other pages, including articles, can also be used as templates - this is a process called "transclusion". The details of this and a list of key templates on the QBWiki will be discussed in the following section. |
Templates
For an incomplete list of useful templates, see Templates.