MediaWiki Guide - Revision history

Raw Salad: /* Creating a Page */ spacing

2025-05-13T18:40:28Z

Creating a Page: spacing

← Older revision		Revision as of 18:40, 13 May 2025
Line 8:		Line 8:
	This will take you to a temporary page that says "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page." Click on "create this page" to start editing.		This will take you to a temporary page that says "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page." Click on "create this page" to start editing.

	Note that there are some limitations to valid page names. Trailing spaces, for example, will automatically be trimmed. See the [https://www.mediawiki.org/wiki/Manual:PAGENAMEE_encoding linked resource] for further information.~~<br>~~		Note that there are some limitations to valid page names. Trailing spaces, for example, will automatically be trimmed. See the [https://www.mediawiki.org/wiki/Manual:PAGENAMEE_encoding linked resource] for further information.

	To combat spam bots, the wiki requires that new accounts wait at least a day before they can create pages.		To combat spam bots, the wiki requires that new accounts wait at least a day before they can create pages.

Raw Salad: Note on delayed page creation for new accounts.

2025-05-13T18:40:03Z

Note on delayed page creation for new accounts.

← Older revision		Revision as of 18:40, 13 May 2025
Line 8:		Line 8:
	This will take you to a temporary page that says "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page." Click on "create this page" to start editing.		This will take you to a temporary page that says "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or create this page." Click on "create this page" to start editing.

	Note that there are some limitations to valid page names. Trailing spaces, for example, will automatically be trimmed. See the [https://www.mediawiki.org/wiki/Manual:PAGENAMEE_encoding linked resource] for further information.		Note that there are some limitations to valid page names. Trailing spaces, for example, will automatically be trimmed. See the [https://www.mediawiki.org/wiki/Manual:PAGENAMEE_encoding linked resource] for further information.<br>
			To combat spam bots, the wiki requires that new accounts wait at least a day before they can create pages.

	===Editing a Page===		===Editing a Page===

Raw Salad at 20:45, 5 March 2025

2025-03-05T20:45:30Z

← Older revision		Revision as of 20:45, 5 March 2025
Line 1:		Line 1:
	=Basics=		=Basics=
	Click on the pencil icon situated on the top right of the page. A dropdown menu will appear containing ~~two~~ options available for a given page.		Click on the pencil icon situated on the top right of the page. A dropdown menu will appear containing the options available for a given page.

	===Creating a Page===		===Creating a Page===

Raw Salad: Updated basics. Fixed some typos. Expanded on some topics like html sanitization.

2025-03-05T20:42:10Z

Updated basics. Fixed some typos. Expanded on some topics like html sanitization.

Show changes

Hiimray: /* Transclusion */ Added bit about template parameters

2024-08-08T01:28:37Z

Transclusion: Added bit about template parameters

← Older revision		Revision as of 01:28, 8 August 2024
Line 46:		Line 46:
	[https://www.mediawiki.org/wiki/Transclusion#Transclusion_Markup_&_Syntax <span style="color:white; background-color:#1f1f1f;"><span style="color:#a463d6">{{</span><span style="color:#fbfbc8">:</span><span style="color:#2d7ad6">Swords</span><span style="color:#a463d6">}}</span></span>] transcludes the Swords page.		[https://www.mediawiki.org/wiki/Transclusion#Transclusion_Markup_&_Syntax <span style="color:white; background-color:#1f1f1f;"><span style="color:#a463d6">{{</span><span style="color:#fbfbc8">:</span><span style="color:#2d7ad6">Swords</span><span style="color:#a463d6">}}</span></span>] transcludes the Swords page.
	*This is the same page you get when searching for "Swords" in the basic search bar. Here, the ":" prefix denotes the Main namespace, which "regular pages" are part of by default.		*This is the same page you get when searching for "Swords" in the basic search bar. Here, the ":" prefix denotes the Main namespace, which "regular pages" are part of by default.
			[https://www.mediawiki.org/wiki/Help:Templates#Parameters <span style="color:white; background-color:#1f1f1f;"><span style="color:#a463d6">{{{</span><span style="color:#2d7ad6">1</span><span style="color:#fbfbc8">\|</span><span style="color:#a463d6">}}}</span></span>] inserts the value of the 1st unnamed parameter, or less commonly, the parameter named "1".
			*The "\|" here specifies a default value in case the referenced parameter was not given one, in this example that default value is "". If a default value would be used but was not specified, "<span style="color:#a463d6">{{{</span><span style="color:#2d7ad6">1</span><span style="color:#a463d6">}}}</span>" will be used instead.

	===[https://www.mediawiki.org/wiki/Help:Magic_words Magic Words]===		===[https://www.mediawiki.org/wiki/Help:Magic_words Magic Words]===

Hiimray: /* Built-In Features */ Added some basic transclusion stuff

2024-08-03T06:52:38Z

Built-In Features: Added some basic transclusion stuff

← Older revision		Revision as of 06:52, 3 August 2024
Line 40:		Line 40:
	<span style="color:white; background-color:#1f1f1f;"><span style="color:#808080"><</span><span style="color:#2d7ad6">div</span><span style="color:#808080">></span>...<span style="color:#808080"><</span>/<span style="color:#2d7ad6">div</span><span style="color:#808080">></span></span>		<span style="color:white; background-color:#1f1f1f;"><span style="color:#808080"><</span><span style="color:#2d7ad6">div</span><span style="color:#808080">></span>...<span style="color:#808080"><</span>/<span style="color:#2d7ad6">div</span><span style="color:#808080">></span></span>
	*This tag is used to apply CSS to a "block", text or otherwise. Think "page element" CSS.		*This tag is used to apply CSS to a "block", text or otherwise. Think "page element" CSS.

			===[https://www.mediawiki.org/wiki/Transclusion Transclusion]===
			[https://www.mediawiki.org/wiki/Help:Templates <span style="color:white; background-color:#1f1f1f;"><span style="color:#a463d6">{{</span><span style="color:#2d7ad6">Element</span><span style="color:#fbfbc8">\|</span><span style="color:#2d7ad6">Spirit</span><span style="color:#a463d6">}}</span></span>] calls the Element template with "Spirit" as a parameter.
			*The basic search bar can be used to search for templates by prefixing the template name with the fixed namespace, "Template" (e.g. type "template:Element" into the search bar).
			[https://www.mediawiki.org/wiki/Transclusion#Transclusion_Markup_&_Syntax <span style="color:white; background-color:#1f1f1f;"><span style="color:#a463d6">{{</span><span style="color:#fbfbc8">:</span><span style="color:#2d7ad6">Swords</span><span style="color:#a463d6">}}</span></span>] transcludes the Swords page.
			*This is the same page you get when searching for "Swords" in the basic search bar. Here, the ":" prefix denotes the Main namespace, which "regular pages" are part of by default.

	===[https://www.mediawiki.org/wiki/Help:Magic_words Magic Words]===		===[https://www.mediawiki.org/wiki/Help:Magic_words Magic Words]===

Raw Salad: Adding TODO notes.

2024-04-14T16:49:29Z

Adding TODO notes.

← Older revision		Revision as of 16:49, 14 April 2024
Line 10:		Line 10:
	*"Show preview" allows you to edit code and see the effects of your edits before committing the changes with "Save changes".		*"Show preview" allows you to edit code and see the effects of your edits before committing the changes with "Save changes".
	*If you enter an empty page, i.e. an existing page without content, try using Source Edit.<br>More likely than not, there is code that is hidden within <span style="color:green"><includeonly></span> html tags.		*If you enter an empty page, i.e. an existing page without content, try using Source Edit.<br>More likely than not, there is code that is hidden within <span style="color:green"><includeonly></span> html tags.
			<br>
			TODO: Add info that the general user may be interestd in. Stuff like basic markup.
	<br>		<br>
	Join the [https://discord.com/invite/wqRBSytTmP/ Wiki Discord] if you wish to discuss changes, ideas, or questions.		Join the [https://discord.com/invite/wqRBSytTmP/ Wiki Discord] if you wish to discuss changes, ideas, or questions.
Line 19:		Line 21:
	The sections below will touch upon most but not all of the commonly used elements on the Wiki.<br>		The sections below will touch upon most but not all of the commonly used elements on the Wiki.<br>
	For more comprehensive information and guides it is best to follow the included hyperlinks.		For more comprehensive information and guides it is best to follow the included hyperlinks.

			TODO: Add section on basic template/transclusion usage. I.e. stuff like parameters. Maybe comment on intuition for using certain things?

	TODO: Add section on MediaWiki whitespace handling. Differences between basic MediaWiki and ParserFunction whitespace handling.		TODO: Add section on MediaWiki whitespace handling. Differences between basic MediaWiki and ParserFunction whitespace handling.

Raw Salad: Undo revision 21487

2024-03-21T17:09:48Z

Undo revision 21487

← Older revision		Revision as of 17:09, 21 March 2024
Line 1:		Line 1:
	~~__TOC__~~
	=Basics=		=Basics=
	There are two ways to edit a page:<br><br>		There are two ways to edit a page:<br><br>

Raw Salad: Adding ToC

2024-03-21T17:04:11Z

Adding ToC

← Older revision		Revision as of 17:04, 21 March 2024
Line 1:		Line 1:
			__TOC__
	=Basics=		=Basics=
	There are two ways to edit a page:<br><br>		There are two ways to edit a page:<br><br>

Raw Salad: Basic guide to MediaWiki. WIP

2024-03-21T16:27:01Z

Basic guide to MediaWiki. WIP

New page

=Basics=
There are two ways to edit a page: 
Edit aka, "Visual Edit".
*If you want to make a simple change -to fix a typo, let's say- then edit is the better and faster option.
*This mode makes creating and editing tables quicker than in source edit. Pasting a copy selection from Excel/G-Sheets to the wiki is as simple as pasting regular text.
**Note: editing colors and other niche properties will require using Source Edit.
*Visual Edit isn't accessible on Template pages.
Source Edit
*Takes you to a codebox that highlights wikitext syntax.
*"Show preview" allows you to edit code and see the effects of your edits before committing the changes with "Save changes".
*If you enter an empty page, i.e. an existing page without content, try using Source Edit. More likely than not, there is code that is hidden within <includeonly> html tags.
 
Join the [https://discord.com/invite/wqRBSytTmP/ Wiki Discord] if you wish to discuss changes, ideas, or questions.

=MediaWiki=
The Dark and Darker wiki runs on MediaWiki software. 
This gives the wiki access to a few basic features like magic words, basic text markup, and HTML markup. 
Mediawiki also allows the inclusion of several extensions that emulate more traditional programming language elements. 
The sections below will touch upon most but not all of the commonly used elements on the Wiki. 
For more comprehensive information and guides it is best to follow the included hyperlinks.

TODO: Add section on MediaWiki whitespace handling. Differences between basic MediaWiki and ParserFunction whitespace handling.

==Built-In Features==

===[https://www.mediawiki.org/wiki/Help:Formatting#Text_formatting_markup Text Markup]===
Great for basic text formatting.

Generally not used in Template code, where text formatting requires more complex functionality like CSS and Parser Funtions.

===[https://www.mediawiki.org/wiki/Help:Formatting#HTML_tags HTML Markup]===

*HTML comments are commonly used to emulate the whitespace structures of more traditional languages like Python, Java, and C.
<span>...</span>
*This tag is used to apply CSS to a specific section of text. Think "inline" CSS.
<div>...</div>
*This tag is used to apply CSS to a "block", text or otherwise. Think "page element" CSS.

===[https://www.mediawiki.org/wiki/Help:Magic_words Magic Words]===
[https://www.mediawiki.org/wiki/Help:Magic_words#Page_names {{PAGENAME}}] returns the name of the page.
*Commonly used in Auto-templates to call templates with the name of the page.
[https://www.mediawiki.org/wiki/Help:Magic_words#Formatting {{lc: "string"}}] returns "string" in lowercase.
*Primarily used as data validation to default strings to lowercase.

==Extensions==

===[https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions]===
[https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions##switch {{#switch: "value" | case1 = result1 | case2 = result2 | ... | #default = resultN }}] returns the result corresponding to the first case that matches value, or default if none match.
*The wiki's primary way of storing data. Used to create data templates.
[https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions##if {{#if: not "null" | value_if_true | value_if_false }}] returns values depending on whether the if clause has a non empty string or not.
*OR logic: include multiple variables in the if clause to check if any of them are not "null".
**{{#if: (not "null")(not "null")(not "null") | value_if_true | value_if_false }}
***If any of the variables are not "null", return value_if_true, otherwise return value_if_false.
*AND logic: use multiple, nested if statements to check if all of the variables are not "null".
**{{#if: not "null" | {{#if: not "null" | value_if_true | value_if_false }} | value_if_false }}
***If Clause1 and Clause2 are not "null", return value_if_true, otherwise return value_if_false.
**The AND logic is less resource efficient than the OR logic, but it is often necessary.
**#if is commonly used with "#switch" to do data validation. E.g. if a value is not "null", continue doing further work on the data .
*Common formats:
**Inline:
***{{#if: condition | value_if_true | value_if_false }}
**Block:
***<div style="white-space:pre; background-color:#1f1f1f; width:fit-content;">{{#if: condition| value_if_true| value_if_false }}</div>
***Note that the pipe characters begin the lines rather than end the lines. When the "then clause" or the "else clause" have multiple lines, the code is easier to follow as you can identify where each clause begins at aglance. This in addition to indentation scope makes it easy to parse the code visually.
***The block format is used to emulate the whitespace structures of more traditional languages like Python, Java, and C. Unless the condition is very simple, the block format is preferred as it is easier to read and edit.
[https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions##ifeq {{#ifeq: value1 | value2 | value_if_equal | value_if_not_equal }}] returns value_if_equal if value1 is equal to value2, and value_if_not_equal otherwise.

===[https://www.mediawiki.org/wiki/Extension:ParserFunctions/String_functions ParserFunctions/Strings]===
[https://www.mediawiki.org/wiki/Extension:ParserFunctions/String_functions##pos {{#pos: string | substring }}] returns the position of the first occurrence of substring in string, or "null" if substring is not found.
*Used to like an "or" statement. If the substring is found, the return value is not "null".
[https://www.mediawiki.org/wiki/Extension:ParserFunctions/String_functions##replace {{#replace: string | substring | replacement }}] returns string with all occurrences of substring replaced by replacement.
*Typically used to replace commas with other separators.
[https://www.mediawiki.org/wiki/Extension:ParserFunctions/String_functions##explode {{#explode: string | delimiter | index | limit }}] returns the index-th element of the list obtained by splitting string at each occurrence of delimiter.
*"limit" is optional. If you only need the first few elements, "limit" is used to save resources.
*If index is negative, the explode redturns in reverse index order.
*Explode is commonly used to split a string along some character(s), making it efficient to retrieve sections of a list-type string.
**Can be used to strip portions of a string.

===[https://www.mediawiki.org/wiki/Extension:Variables Variables]===
[https://www.mediawiki.org/wiki/Extension:Variables##vardefineecho {{#vardefineecho: variable_name | value }}] returns value and defines variable_name as value.
*This is useful when handling data that is used more than once. Calls to data templates eat up resources, so it is best practice to store the data in a variable and call the variable instead of the data template. This is true even if the template data is only called twice.
*Typically used within the "flow" of code, i.e. within a #if or #switch statement.
[https://www.mediawiki.org/wiki/Extension:Variables##vardefine {{#vardefine: variable_name | value }}] returns nothing and defines variable_name as value.
*Slightly less efficient than vardefineecho, but useful when you need to use a var in various scopes.
[https://www.mediawiki.org/wiki/Extension:Variables##var {{#var: variable_name }}] returns the value of variable_name.
*Commonly used within a few lines of the vardefineecho.
*Unlike in traditional programming languages the return value is not "typed". It is a string.
*A common bug is to write the variable name but forget to include the curly braces and var tag. So instead of referencing a variable's value you simply have a static string. This sometimes goes unnoticed when using #var: with #if:.

===[https://www.mediawiki.org/wiki/Extension:Arrays Arrays]===
[https://www.mediawiki.org/wiki/Extension:Arrays#arraydefine {{#arraydefine: variable_name | value1, value2, ... }}] returns nothing and defines variable_name as an array.
*Commonly used to transform a comma separated list into an array.
*Occasionally used to transform comma separated lists into slash (or other) separated lists.
[https://www.mediawiki.org/wiki/Extension:Arrays#arraysize {{#arraysize: variable_name }}] returns the number of elements in variable_name.
*Commonly used to set how many iterations of a loop to execute.
[https://www.mediawiki.org/wiki/Extension:Arrays#arrayindex {{#arrayindex: variable_name | index }}] returns the index-th element of variable_name.
*Almost always used with #loop to do work on individual elements in an list/array.

===[https://www.mediawiki.org/wiki/Extension:Loops Loops]===
[https://www.mediawiki.org/wiki/Extension:Loops##loop {{#loop: start | end | step | code }}] returns the result of code executed for each value in the range start to end, incrementing by step.

===[https://www.mediawiki.org/wiki/Extension:TabberNeue#Simple_tabbers Tabber]===
This extension allows content to be created under tabs.

The entire Wiki Editing page is organized using this extension.