Difference between revisions of "Tutorial"

m
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
Hello, and welcome to the tutorial page. The information here is a combination of instructions on how to effectively use the wiki editor to post your content, as well as some notes and tips on any quirks you may run into. Most of the features of the WikiEditor extension's toolbar are self-explanatory, but what follows are some notes on their use.
+
Hello, and welcome to the tutorial page. The information here is a combination of instructions on how to effectively use the wiki editor to post your content, as well as some notes and tips on any quirks you may run into. All of the following sections correspond to one or more buttons on the editor bars, but syntax for manual formatting has been included for completeness (and so that you don't have to try it ''all'' out on your own :) ).
  
 
__TOC__
 
__TOC__
  
== General Notes ==
+
==General Notes==
  
 
* It is almost always easier to format your content by writing it first, then highlighting sections and clicking the appropriate buttons (e.g. bold, no wiki formatting, etc.)
 
* It is almost always easier to format your content by writing it first, then highlighting sections and clicking the appropriate buttons (e.g. bold, no wiki formatting, etc.)
* Disambiguation for pages is currently a work-in-progress. Please make a note to label setting-specific content with your setting name, e.g. "thecbg.org/wiki/Races_(Fractal_Galaxy)" rather than just "thecbg.org/wiki/Races", so that we can facilitate proper disambiguation pages and so that your pages won't have to be relocated by an administrator.
+
* Disambiguation for pages is currently a work-in-progress. Please make a note to label setting-specific content with your setting name, e.g. "thecbg.org/wiki/Races_(Fractal_Galaxy)" rather than just "thecbg.org/wiki/Races", so that we can facilitate proper disambiguation pages and so that your pages won't have to be relocated by an administrator.<br  />
* The "Random Page" functionality is currently broken.
 
  
 
== Creating a Table of Contents ==
 
== Creating a Table of Contents ==
Line 31: Line 30:
 
== Headings ==
 
== Headings ==
  
* There are five heading options of varying sizes that can help in dividing your content, listed as "Level 2" through "Level 5" in the Heading drop-down, as well as the title heading. The latter is normally reserved only for page titles (e.g. the all-caps "TUTORIAL" at the top of this page), but if you would like to use it multiple times, you can wrap your text like so: <nowiki>= Heading 1=</nowiki> .  
+
There are five heading options of varying sizes that can help in dividing your content, listed as "Level 2" through "Level 5" in the Heading drop-down, as well as the title heading. The latter is normally reserved only for page titles (e.g. the all-caps "TUTORIAL" at the top of this page), but if you would like to use it multiple times, you can wrap your text like so: <nowiki>= Heading 1=</nowiki> .  
* Keep in mind that any headings you add to your page will show up in the page's Table of Contents, if you add one.
+
Keep in mind that any headings you add to your page will show up in the page's Table of Contents, if you add one.
  
 
== Lists ==
 
== Lists ==
Line 46: Line 45:
 
* Bulleted list indentation
 
* Bulleted list indentation
  
== No Wiki Formatting ==
+
== The No Wiki Formatting Button ==
  
 
If you want to avoid formatting for any reason, wrap the text like this:
 
If you want to avoid formatting for any reason, wrap the text like this:
Line 62: Line 61:
 
* <nowiki>'''<big><big>big big</big></big>'''</nowiki> gets you '''<big><big>big big</big></big>'''
 
* <nowiki>'''<big><big>big big</big></big>'''</nowiki> gets you '''<big><big>big big</big></big>'''
  
== Images ==
+
== Images and Other Embedded Files ==
  
 
For now, images can be embedded in the page using the "Embedded file" button, or by using the following syntax:
 
For now, images can be embedded in the page using the "Embedded file" button, or by using the following syntax:
Line 68: Line 67:
 
<nowiki>[[File:<filename.jpg>|<format>|<alignment> (optional)|<description>]]</nowiki>
 
<nowiki>[[File:<filename.jpg>|<format>|<alignment> (optional)|<description>]]</nowiki>
  
For example, the syntax for the logo below is <nowiki>[[File:CBG.png|thumb|left|The CBG Logo]]</nowiki>
+
For example, the syntax for the logo below is <nowiki>[[File:CBG.png|thumb|center|The CBG Logo]]</nowiki>
  
[[File:CBG.png|thumb|left|The CBG Logo]]
+
[[File:CBG.png|thumb|center|The CBG Logo]]
 
+
<br>
For a frameless version:
+
<br>
  
<nowiki>[[File:CBG.png|frameless|left|The CBG Logo]]</nowiki>, e.g.:
+
The available formats are "thumb", "framed", "frameless", and "none".
 +
Note that you may need to use the newline tool to clean up your formatting if you embed images, as otherwise the text you write may be placed adjacent to it.
  
[[File:CBG.png|frameless|left|The CBG Logo]]
 
 
<br>
 
<br>
 
"None" formatting looks like this:
 
 
<nowiki>[[File:CBG.png|none|left|The CBG Logo]]</nowiki>
 
[[File:CBG.png|none|left|The CBG Logo]]
 
  
 
== Links and References ==
 
== Links and References ==
Line 88: Line 82:
 
The link box will make it easy to reference other pages in your setting. When using the "To a Wiki Page" option, you can start typing something (e.g. "Races_(Fractal_Galaxy)" and it should provide you with autocomplete options. Examples:
 
The link box will make it easy to reference other pages in your setting. When using the "To a Wiki Page" option, you can start typing something (e.g. "Races_(Fractal_Galaxy)" and it should provide you with autocomplete options. Examples:
  
 +
<nowiki>[[Races (Fractal Galaxy)]]</nowiki> gets you: <br>
 
[[Races (Fractal Galaxy)]]
 
[[Races (Fractal Galaxy)]]
 +
 +
<nowiki>[http://www.google.com Google]</nowiki> gets you: <br>
 +
[http://www.google.com Google]
 +
 +
== Tables ==
 +
 +
The Table button lets you specify a number of rows and columns to add, which must then be filled out manually. Note that by default, the "Add Header Row" option should be enabled.
 +
 +
No unformatted example is given here, as it shows up poorly in the "nowiki" format.
 +
 +
{| class="wikitable"
 +
|-
 +
! Header one !! Header two !! Header three
 +
|-
 +
| row one, column one || row one, column two || '''row one, column three bolded'''
 +
|-
 +
| row two, column one <sup>superscript</sup> || row two, column two || [[Generic Setting]]
 +
|}
 +
<br>
 +
 +
Sortable tables are also possible:
 +
 +
{| class="wikitable sortable"
 +
|-
 +
! Header one !! Header two !! Header three
 +
|-
 +
| row one, column one || row one, column two || '''row one, column three bolded'''
 +
|-
 +
| row two, column one <sup>superscript</sup> || row two, column two || [[Generic Setting]]
 +
|}

Latest revision as of 15:57, 6 March 2021

Hello, and welcome to the tutorial page. The information here is a combination of instructions on how to effectively use the wiki editor to post your content, as well as some notes and tips on any quirks you may run into. All of the following sections correspond to one or more buttons on the editor bars, but syntax for manual formatting has been included for completeness (and so that you don't have to try it all out on your own :) ).

General Notes

  • It is almost always easier to format your content by writing it first, then highlighting sections and clicking the appropriate buttons (e.g. bold, no wiki formatting, etc.)
  • Disambiguation for pages is currently a work-in-progress. Please make a note to label setting-specific content with your setting name, e.g. "thecbg.org/wiki/Races_(Fractal_Galaxy)" rather than just "thecbg.org/wiki/Races", so that we can facilitate proper disambiguation pages and so that your pages won't have to be relocated by an administrator.

Creating a Table of Contents

Adding a TOC to your page is as simple as adding the following at the top of the wiki document:

__TOC__

This will pick up any headings you add to the page for easier navigation (see below).

Bold and Italic

'''example text''' gets you example text
''example text'' gets you example text

Line Breaks

If you want to force text to be broken across a newline, you can use the <br> formatting (the button to the right of the "No wiki formatting" button). Examples:

This text is bolded and
broken across two lines

Headings

There are five heading options of varying sizes that can help in dividing your content, listed as "Level 2" through "Level 5" in the Heading drop-down, as well as the title heading. The latter is normally reserved only for page titles (e.g. the all-caps "TUTORIAL" at the top of this page), but if you would like to use it multiple times, you can wrap your text like so: = Heading 1= . Keep in mind that any headings you add to your page will show up in the page's Table of Contents, if you add one.

Lists

There are two kinds of lists available: "Bulleted" and "Numbered":

  • Bulleted lists are denoted by "*" characters;
  • Numbered lists are denoted by "#" characters.

Note that numbered lists will indent further than bulleted lists:

  1. Numbered list indentation
  • Bulleted list indentation

The No Wiki Formatting Button

If you want to avoid formatting for any reason, wrap the text like this:

<nowiki> = This heading won't be formatted = </nowiki>

This is how much of the formatting on this tutorial page is exposed.

Big, Small, Superscript, and Subscript

These are pretty self-explanatory. Note that you can nest them if you want to make large text without using Headings:

  • <big>big</big> gets you big
  • <big><big>big big</big></big> gets you big big
  • '''<big><big>big big</big></big>''' gets you big big

Images and Other Embedded Files

For now, images can be embedded in the page using the "Embedded file" button, or by using the following syntax:

[[File:<filename.jpg>|<format>|<alignment> (optional)|<description>]]

For example, the syntax for the logo below is [[File:CBG.png|thumb|center|The CBG Logo]]

The CBG Logo



The available formats are "thumb", "framed", "frameless", and "none". Note that you may need to use the newline tool to clean up your formatting if you embed images, as otherwise the text you write may be placed adjacent to it.


Links and References

The link box will make it easy to reference other pages in your setting. When using the "To a Wiki Page" option, you can start typing something (e.g. "Races_(Fractal_Galaxy)" and it should provide you with autocomplete options. Examples:

[[Races (Fractal Galaxy)]] gets you:
Races (Fractal Galaxy)

[http://www.google.com Google] gets you:
Google

Tables

The Table button lets you specify a number of rows and columns to add, which must then be filled out manually. Note that by default, the "Add Header Row" option should be enabled.

No unformatted example is given here, as it shows up poorly in the "nowiki" format.

Header one Header two Header three
row one, column one row one, column two row one, column three bolded
row two, column one superscript row two, column two Generic Setting


Sortable tables are also possible:

Header one Header two Header three
row one, column one row one, column two row one, column three bolded
row two, column one superscript row two, column two Generic Setting