Difference between revisions of "Contributing"

From P2SR Wiki

m (remove pointless spaces)
m (no discrims)
 
(2 intermediate revisions by the same user not shown)
Line 64: Line 64:
 
These are the templates used for maps in singleplayer and coop. Map pages can be added for mods in the future with enough community interest.
 
These are the templates used for maps in singleplayer and coop. Map pages can be added for mods in the future with enough community interest.
  
The <code>#p2sr:</code> templates use [[Krzyhau]]'s plugin to fetch WR data from iVerb, or a Least Portals spreadsheet. Other games are not currently supported.
+
The <code>#p2sr:</code> templates use [[Krzyhau]]'s plugin to fetch WR data from [https://board.portal2.sr the leaderboards], or a Least Portals spreadsheet. Other games are not currently supported.
 
===Singleplayer===
 
===Singleplayer===
 
<pre>
 
<pre>
 
{{P2_Infobox|Map Name|Map_sp_.jpg|
 
{{P2_Infobox|Map Name|Map_sp_.jpg|
*''File name'' sp_
+
*''Previous Map'' [[Previous Map]]
 +
*''File Name'' sp_
 
*''Appearance'' [[Chapter Name]]
 
*''Appearance'' [[Chapter Name]]
 
*''Native to Challenge Mode'' Yes | Not by default
 
*''Native to Challenge Mode'' Yes | Not by default
 
*''World Record'' {{#p2sr:wr|sp:map name}}
 
*''World Record'' {{#p2sr:wr|sp:map name}}
 
*''Least Portals'' {{#p2sr:lp|sp:map name}}
 
*''Least Portals'' {{#p2sr:lp|sp:map name}}
 +
*''Next Map'' [[Next Map]]
 
}}
 
}}
 
=Overview=
 
=Overview=
Line 92: Line 94:
 
===Coop===
 
===Coop===
 
<pre>
 
<pre>
{{P2_Infobox|Map Name|Map_mp_coop.jpg|
+
{{P2_Infobox|Map Name|Map_mp_coop_.jpg|
*''File name'' mp_coop_
+
*''Previous Map'' [[Previous Map. How to handle the hub?]]
 +
*''File Name'' mp_coop_
 
*''Appearance'' [[Course Name]]
 
*''Appearance'' [[Course Name]]
 
*''World Record'' {{#p2sr:wr|coop:map name}}
 
*''World Record'' {{#p2sr:wr|coop:map name}}
 
*''Least Portals'' {{#p2sr:lp|coop:map name}}
 
*''Least Portals'' {{#p2sr:lp|coop:map name}}
 +
*''Next Map'' [[Next Map. How to handle the hub?]]
 
}}
 
}}
 
=Overview=
 
=Overview=
Line 115: Line 119:
 
</pre>
 
</pre>
 
=Additional Info=
 
=Additional Info=
In case of any doubt or question, contact <code>bigdaniel#9055</code>, <code>Krzyhau#8514</code> or <code>AMJ#3045</code> on Discord.
+
In case of any doubt or question, contact <code>bigdaniel</code>, <code>krzyhau</code> or <code>amj</code> on Discord.

Latest revision as of 17:53, 26 June 2023

Contributing

Overview

Since this project is meant to be community-driven, everyone is allowed and encouraged to create and edit articles. It is, however, required to create an account, so your changes can be easily tracked and verified. This page lists useful information for all community members looking to contribute to the P2SR Wiki.

General Information

Creating/Editing page

Every page that is not protected can be edited by everyone with a user account. All you have to do is to click the Edit page link in your TOOLS menu. Certain preferences can be modified here.

In order to create new page, type the name of the page in the search bar, then on the search results page click the page creation link.

Please note that all your contributions may be edited, altered, or removed by other contributors or moderators. Nevertheless, it is encouraged to create new content, as long as you're knowledgeable about the topic you write about and can provide accurate information.

Formatting

This wiki uses MediaWiki markup. For more information, visit the MediaWiki help page about formatting.

Marking changes for others

If you're not knowledgeable enough to write a section, mark it in red for someone else to update. This is done like so:

<pre style="color:red">Text</pre>

Example:

Include seamshot coordinates. How precise is it exactly?

Code/Data Formatting

Cvars, coordinates, commands etc. should be code blocked to look like this. This is not done natively through MediaWiki specific syntax, but rather the HTML code tag. See the following example.

<code>your text here</code>

Links

Same as above. Go here for more information.

Media

While MediaWiki provides multiple ways to include media, we are limiting ourselves to several methods in order to keep consistency between pages, as well as to avoid unnecessary mess.

Uploading media

To upload files to the wiki, click on the TOOLS dropdown, and select Upload File.

In an effort to reduce loading times for the pages, .jpg images are generally preferred over .png images, as most images do not need to be too high in detail. While it is possible, it is discouraged to upload videos to the wiki. Use video sharing services like YouTube instead.

Images

In order to include images on a page, use one of those methods:

{{P2_Image|image.jpg|Description}}
                OR
[[File:image.jpg|thumb|Description]]

Videos

Side Video (Preferred)

{{P2_Video|url=https://www.youtube.com/watch?v=aaaaaaaaaaa|time=0|desc=Video Description}}

Inline Video (Specific use-cases)

{{#ev:youtube|youtu.be/aaaaaaaaaaa}}

Gallery

<gallery>
File:image1.jpg|thumb|Description
File:image2.jpg|thumb|Description
</gallery>

Page Formatting

Headers

By default, pages do not contain their title to allow customization in this regard. For that, we use a couple of wiki templates created specifically for that purpose.

Image + Info Bar Header (typical for a map page)

{{P2_Infobox|Page Title|Image.jpg|
*''Entry Upper'' Entry Lower
}}

Title Header (typical for a glitch writeup)

{{P2_Title|Page Title}}

Map Page Template

These are the templates used for maps in singleplayer and coop. Map pages can be added for mods in the future with enough community interest.

The #p2sr: templates use Krzyhau's plugin to fetch WR data from the leaderboards, or a Least Portals spreadsheet. Other games are not currently supported.

Singleplayer

{{P2_Infobox|Map Name|Map_sp_.jpg|
*''Previous Map'' [[Previous Map]]
*''File Name'' sp_
*''Appearance'' [[Chapter Name]]
*''Native to Challenge Mode'' Yes | Not by default
*''World Record'' {{#p2sr:wr|sp:map name}}
*''Least Portals'' {{#p2sr:lp|sp:map name}}
*''Next Map'' [[Next Map]]
}}
=Overview=

=General Route=

=Challenge Mode Specific=

=Full Game Specific=

==Full Game Dialogue==

=History=

[[Category:Maps]]
[[Category:Singleplayer Maps]]
[[Category:Chapter Name]]

Coop

{{P2_Infobox|Map Name|Map_mp_coop_.jpg|
*''Previous Map'' [[Previous Map. How to handle the hub?]]
*''File Name'' mp_coop_
*''Appearance'' [[Course Name]]
*''World Record'' {{#p2sr:wr|coop:map name}}
*''Least Portals'' {{#p2sr:lp|coop:map name}}
*''Next Map'' [[Next Map. How to handle the hub?]]
}}
=Overview=

=General Route=

=Challenge Mode Specific=

=Full Game Specific=

==Full Game Dialogue==

=History=

[[Category:Maps]]
[[Category:Cooperative Maps]]
[[Category:Course Name]]

Additional Info

In case of any doubt or question, contact bigdaniel, krzyhau or amj on Discord.