Help:Source Editor

From QSMP Wiki
Jump to navigation Jump to search

Return to QSMP Wiki help page.
This page is for information on how to use the Source Editor. For information on formatting and stylization please visit the Style Guide.

Using the source editor

The source editor is one of the two editors we use on this wiki. It can be more difficult for basic editing as it does not have the same shortcuts and options as a regular word processor. However, it is easier to edit more complicated things such as tables, templates, and other wiki features using the source editor. The source editor does not work on page translations: for those, see Help:Translate.

Navigate to the source editor

Go to any editable page and click "Edit source" in the tabs at the top right. This will take you to the source editing view for that page. If you click "Advanced" in the toolbar this will bring up options to add links, formatting, and the different kinds of headers. Clicking on these will automatically add in the corresponding code. If you want to get a better idea of where the code is click the highlighter icon next to "Advanced." This will show the effects of the wiki code on your writing.

Preview page before saving

It is good practice to preview a page before saving it to the wiki. This will allow you to catch any errors in syntax and formatting. To preview the page click "Show preview" under the editing box. The page will reload with a preview of what the wiki will look like at the top and the editing box below that. Note that this preview is not finalized: navigating away from the page at this point will not save your work. Review your work. If you need to make changes these changes will not reflect in the preview unless you click "Show preview" again. When you are satisfied, save the page.

Save changes

Once you save your changes they can be viewed by anyone and are permanently recorded in that wiki page's version history. They can also be reversed or changed by any other wiki editor, including yourself. When saving a page please summarize your changes in the summary box. This lets others know what you have added or changed. If you are only fixing something minor like a typo, check the box to indicate that it was a minor change. This box is not visible when creating a new page.

Switch between visual and source editors

On most pages you can switch between the visual editor and the source editor while editing using the tabs at the top of the page. This can be useful if you find some things easier to do in one view and some things easier to do in the other. This will add the tag "Visual edit:switched" to the changelog.

Source editor features

Basic text formatting

  • Italics:

''italics''

  • Bold:

'''bold'''

  • Bold italics:

'''''bold italics'''''

  • Bullet points:
    • Indented bullet points:[a]

*Bullet points
**Indented bullet points

  • Big text:

<big>Big text</big>

  • Small text:

<small>Small text</small>

  • ExampleSuperscript text:

Example<sup>Superscript text</sup>

  • ExampleSubscript text:

Example<sub>Subscript text</sub>

Links

Link to wiki page

Use [[Linked page]]

[[Special:MyLanguage/Slimecicle]]

Link to wiki page in text

Use [[Linked page | text]]

[[Special:MyLanguage/Slimecicle | Slimecicle]]

To link to a category page you must insert a colon before the word Category:

[[Category:Eggs]] <- This will add the page to the egg category.

  • [[:Category:Eggs]] <- This will link to the egg category page.

Link outside the wiki

Use external link url

http://www.youtube.com

Link outside the wiki in text

Use [external link url text] (Note there is no |)

[http://www.youtube.com YouTube]

Marking the text

Add a note inline

Use <ref group="lower-alpha">Content of note here</ref> to add a note in the text. Please add notes AFTER punctuation:[b]

<ref group="lower-alpha">This is correct placement.</ref>

Add notes section to page

Add the list under a new section. This section should be directly before the References section. See here for example.

== Notes==
<references group="lower-alpha" />.

Add citations

For information on adding citations please visit Help:Citations.

References

To add the references section to a page insert this code into it:

==References==
{{Scrollbox|content=<references />}}

The references section should go at the bottom of the page, followed only by the Navigation section. For more on page organization see the Style Guide.

Add images

For information on adding images to a page please visit Help:Images.

Categories

A category on wikis is a tool that can be used to easily group pages together. Pages can be added to categories using a category tag [[Category:Category Name]] anywhere on the page. Then, they will show up on that category page. There will also be a bar at the bottom that shows all of the categories that page is in with links to the category pages. To link to a category page without adding a category tag place a colon in front of it like so: [[:Category:Category Name]].
Subcategories are also possible. To make a subcategory create a category page and then add that category page to the main category. Example: the category "Player Bases" is a subcategory of "Places." On the page Category:Player Bases we add [[Category:Places]] to add it to the Place category. Now Player Bases will show up on the Places page as a subcategory.

Templates and Infoboxes

Create template

For information on creating templates please visit Help:Templates.

Add template to page

Use {{Template name}}. The template name is the same as the name of the corresponding template's page, not including "Template:" in it. The template may require or allow parameters. If the parameters are required and not entered the template will give and error. If they are not required they can be omitted. Parameters follow the template name within the curly brackets separated by |. The format is "parameter name=example parameter." Parameters should be named in a way that it is obvious what should be entered there.

{{Citation needed | reason=Example reason}}.

Create infobox

For information on creating infoboxes please visit Help:Infoboxes.

Add infobox to page

Use {{Infobox name | parameter 1=Example | parameter 2=Example}}, with as many parameters as required. Visit the corresponding infobox's page to see what the parameters are. If a parameter is required but you don't have the information use "TBA."


Notes

  1. Bullet points cannot "skip" steps going up: if you start a list with two asterisks it will show two bullets. If you go from one asterisk to three it will show two bullets.
  2. This is correct placement.

References