Difference between revisions of "QBWiki:Editing Tutorial"

From QBWiki
Jump to navigation Jump to search
 
(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.
  
{| border="1" cellspacing="0" cellpadding="5" align="center"
+
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>
| <div style="font-size:150%;border-bottom:1px solid #000000;">heading</div>
 
  
<div style="font-size:132%;font-weight:bold;">subheading</div>
+
Sections which are given a heading will appear in the table of contents.
 +
|
 +
==heading==
  
<div style="font-size:116%;font-weight:bold;">sub-subheading</div>
+
===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.<br><pre><nowiki>[[ACF]] would link to an article on the ACF, for example.</nowiki></pre>
+
| 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==
  
More examples and other editing features can be found [http://meta.wikimedia.org/wiki/Help:Advanced_editing here] and [http://meta.wikimedia.org/wiki/Help:Editing_tips_and_tricks here].
 
  
 
[[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.

heading

subheading

sub-subheading

Sections 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?
  • 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
  1. Numbered lists work the same way as bullets.
  2. More number (or pound) signs
    1. Make mini lists
    2. Inside the first list
  3. 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.

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:
[[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.

Style Guide

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:

http://www.naqt.com

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

  1. They will appear wherever the "references" tag is embedded.
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>

Bolded entry
Unbolded entry

Wikitext provides a simpler format for tables that will serve most purposes.

Bolded entry
Unbolded entry
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.

QBWiki