NoMansSky:Wiki Reference: Difference between revisions

From Step Mods | Change The Game
 
(65 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTITLE__
{{#set:
{{NMSPage|contentTitle=NMS Wiki Reference}}
NMSIndex=Wiki
{{TOC_right}}
}}{{PageTitle|logo=nomanssky|title=NMS Wiki Reference}}
{{NMSPage}}
{{TOC}}
== Introduction ==
== Introduction ==
This is a reference for creating new No Man's Sky wiki pages, as well as some helpful information around text formatting and available templates.
This is a reference specific to No Man's Sky wiki to show examples of how to edit on the Step wiki, as well as, helpful information around text formatting and available templates.


There are a few necessary steps when creating a new page.<br>
First for foremost, there is an invaluable reason that Step has put together to editing the wiki in general, as well as, some specifics. This should be the main informational reference when something comes up that is unfamiliar in regards to working on the wiki. Another excellent source for information is the MediaWiki website, though one must be verse in using search to find anything.
No worries, they're easy! It looks like a lot of steps below, but the information is simply providing a lot of detail to ensure clarity.
* [[Guide:Wiki_Maintenance|Step Wiki User Guide]]
* [https://www.mediawiki.org/wiki/MediaWiki MediaWiki Website]


== Where to Create Pages ==
== Where to Create Pages ==
It's important to create pages with the correct URL structure to help maintain organization of the content.<br>
It's important to create pages with the correct URL structure to help maintain organization of content. To identify NMS pages on the Step wiki, look for the NMS Namespace. All NMS pages must start with the same Namespace, '''NoMansSky''':
To identify NMS pages from wiki pages of other games, all the NMS page must start with the same namespace : <code>wiki.step-project.com/NMS:</code>.
: <code>stepmodifications.org/wiki/NoMansSky:</code>


Most pages can and should be created at the root of the namespace: <code>../wiki/NoMansSky:PageName</code>
: '''Example:''' <code>../wiki/NoMansSky:AMUMSS</code>


Next, users should determine the type of content that is being added. Is it a tutorial? A modding tool? A game file ? Something else?
Pages should only be made a subpage when the content is directly related to the root page: <code>../wiki/NoMansSky:PageName/SubPageName</code>
* [[NMS:Tutorials|Tutorials]] should use this URL structure: <code>wiki.step-project.com/NMS:Tutorials/PageName</code>
: '''Example:''' <code>../wiki/NoMansSky:AMUMSS/Making Combined Mods</code>
* [[NMS:Modding_Tools|Modding Tools]] should use this URL structure: <code>wiki.step-project.com/NMS:Modding_Tools/PageName</code>
 
* [[NMS:Game_Structure|Game Structure]] should use this URL structure: <code>wiki.step-project.com/NMS:Game_Structure/PageName</code>
''{{AlertSmall|type=notice|text=Note that pages can be relocated later, when necessary. However, this adds to maintenance.}}''
* For any other content : <code>wiki.step-project.com/NMS:PageName</code>
Note that pages can remain or be moved (sorted) later, when necessary.


== Creating a New Page ==
== Creating a New Page ==
{{Sidebox|contentAlign=left|right|Side Notes|
{{Sidebox|float=right|title=Side Notes|text=&nbsp;
==== Magic Words ====
==== Magic Words ====
; <nowiki>__NOTITLE__</nowiki> {{CustomTag|color=red|tag=required}}
; <nowiki>__NOTITLE__</nowiki>
: This one is required to maintain the theme. It prevents the page title from being displayed at the top of the page, which is auto-placed by default.
: Don't use this Magic Word. It is already included in the PageTitle template.


; <nowiki>__NOTOC__</nowiki> {{CustomTag|color=#DDD|tag=optional}}
; <nowiki>__NOTOC__</nowiki>
: This Magic Word is optional. Including it will disable the Table of Contents from displaying on the page, which is auto-placed when at least 4 headers are used.
: This Magic Word is optional. Including it will disable the Table of Contents from displaying on the page, which is auto-placed when at least 4 headers are used.
==== Opening / Closing Templates ====
For the time being, the "theme" for NMS is managed and implemented using templates. ''These are required for the theme to work correctly.''


==== Controlling the TOC ====
==== Controlling the TOC ====
There is one control parameter for this template, '''limit''', which controls the headings depth displayed on the TOC.<br>Code: <code><nowiki>{{TOC right|limit=#}}</nowiki></code>}}
There is one control parameter for this template, '''limit''', which controls the headings depth displayed on the TOC.<br>Code: <code><nowiki>{{TOC|limit=#}}</nowiki></code>}}


To create a new page:
To create a new page:
Line 45: Line 45:
Here is the template for a standard page that you can copy/paste in the editor of your new page :
Here is the template for a standard page that you can copy/paste in the editor of your new page :
<pre>
<pre>
__NOTITLE__
<nowiki>{{PageTitle|logo=nomanssky|title=Modding Tools|subtitle=optional|author=optional|forumid=optional}}</nowiki>
<nowiki>{{NMSPage|contentTitle=PageTitle}}</nowiki>
<nowiki>{{NMSPage}}</nowiki>
<nowiki>[[Category:NoMansSky Tutorials]]</nowiki>
<nowiki>{{TOC}}</nowiki>
<nowiki>{{TOC_right}}</nowiki>
<nowiki>[[Catergory:CategoryName]]</nowiki>
<nowiki>== HeaderText ==</nowiki>
<nowiki>== HeaderText ==</nowiki>


Page content here...
Page content here...


<nowiki>{{NMSPageClose}}</nowiki>
</pre>
</pre>


Here are more informations about each line :
Here are more informations about each line :
* Magic Words : <nowiki>__NOTITLE__ & __NOTOC__</nowiki> control specific wiki features. See Side Notes.
* PageTitle Template places the standard page title element. The "optional" parameters do not need to be included, but can be.  
* NMSPAge Opening Template : This places the top half of the theme. The '''contentTitle''' value is the title of the page, placed in the themed header at the top. If no value is provided, PageName Magic Word will be used.
* NMSPage Template places the NMS navbar below the page title.
* Categories : Add appropriated categories so that page will be sorted for users. The '''No Man's Sky''' category should always be added, then followed by the appropriate sub-categories. See the [[NMS:Category_Reference|Category Reference]] for a list a available categories.
* Table of Contents (TOC): if the TOC isn't desired, skip it and ensure the '''<nowiki>__NOTOC__</nowiki>''' Magic Word is included, see Side Notes.
* Table of Contents (TOC) : If the TOC isn't desired, skip this step and ensure the '''<nowiki>__NOTOC__</nowiki>''' Magic Word is included, see Side Notes.
* Categories: add appropriated categories so that page will be sorted for users. See the [[NoMansSky:Category_Reference|Category Reference]] for a list a available categories.
* Content : Your content. It is highly recommended to begin any content with a level two heading: <code><nowiki>== HeaderText ==</nowiki></code>
* Content: add the content below everything else. It's highly recommended to begin any content with a level two heading: <code><nowiki>== HeaderText ==</nowiki></code>
* NMSPageClose Closing template : This places the bottom half of the theme. Without it, the theme would be broken.


==Linking Pages ==
==Linking Pages ==
You can link pages and display them either in the current explorer tab or into a new explorer tab.<br>
Pages can use internal or external links.


To link a page and display it in the current tab, use double brackets, the local url, a vertical dash and the name displayed :<br>
=== Internal Links ===
: '''Example:''' <code><nowiki>[[NMS:Tutorials|Show Tutorials in the current tab]]</nowiki></code><br>
To link to an internal wiki page and display it in the current tab, use the follow syntax:
: '''Result:''' [[NMS:Tutorials|Show Tutorials in the current tab]]
: Note the Magic Word '''<nowiki>{{NAMESPACE}}</nowiki>''' ([https://www.mediawiki.org/wiki/Help:Magic_words see MediaWiki]). This Word fills in the "NoMansSky" portion of the local URL, called the ''Namespace''. Use this rather than the actually typing out "NoMansSky" as it will auto-update the link with any changes to that internal portion of the URL.
:: '''Example:''' <code><nowiki>[[{{NAMESPACE}}:Tutorials|Show Tutorials in the current tab]]</nowiki></code>
::: '''Result:''' [[{{NAMESPACE}}:Tutorials|Show Tutorials in the current tab]]
:: '''Example:''' <code><nowiki>[[{{NAMESPACE}}:Game_Structure/METADATA/GAMESTATE|GAMESTATE Folder]]</nowiki></code>
::: '''Result:''' [[{{NAMESPACE}}:Game_Structure/METADATA/GAMESTATE|GAMESTATE Folder]]


<br>
=== External Links ===
To link a page in a new tab, use single brackets, the full url, a space and the name displayed :<br>
To link a page in a new tab, use single brackets, the full url, a space and the name displayed :<br>
: '''Example:''' <code><nowiki>[https://stepmodifications.org/wiki/NMS:Tutorials Show Tutorials in a new tab]</nowiki></code><br>
:: '''Example:''' <code><nowiki>[https://stepmodifications.org/wiki/NoMansSky:Tutorials Show Tutorials in a new tab]</nowiki></code><br>
: '''Result:''' [https://stepmodifications.org/wiki/NMS:Tutorials Show Tutorials in a new tab]
::: '''Result:''' [https://stepmodifications.org/wiki/NoMansSky:Tutorials Show Tutorials in a new tab]
 
=== Page Anchor Links (links to page sections) ===
To link to a header within a page, simply add <code>#</code> to the end of the page URL followed by the header title (case sensitive!); replacing spaces with <code>_</code>.
:: '''Example:''' <code><nowiki>[[{{NAMESPACE}}:Game_Structure#FONTS|Link to Fonts heading]]</nowiki></code>
::: '''Result:''' [[{{NAMESPACE}}:Game_Structure#FONTS|Link to Fonts heading]]


== Content Formatting ==
== Content Formatting ==
==== General formatting rules ====
==== General formatting rules ====
For the whole rules you can use to format your page, please check [https://www.mediawiki.org/wiki/Help:Formatting This Content Formatting page]
First point of reference is the [[Guide:Wiki_Maintenance|Step Wiki User Guide]] where we explain a great about the use of the Step Wiki, including how to format pages, the use of many of our templates, etc. Second is the [https://www.mediawiki.org/wiki/Help:Formatting general wiki formatting document] is found on the MediaWiki page.
 


==== Avoid auto parsing ====
==== Avoid auto parsing ====
Line 113: Line 119:
             </Property>
             </Property>


==== Link page sections ====
For links, you can link subtitles directly.<br>
All you have to do is adding # to your page url and the exact name of the subtitle (check Uppercases !), replacing spaces with _<br>
IE : To access home page Getting Started section, simply add #Getting_Started to home page url.
<br>


== Useful Templates ==
== Useful Templates ==
Line 149: Line 149:
This can be done with the fc template :
This can be done with the fc template :
: Code: <code><nowiki>{{fc|YourColor|YourText}}</nowiki></code>
: Code: <code><nowiki>{{fc|YourColor|YourText}}</nowiki></code>
: The color variable accepts any [https://www.w3schools.com/cssref/pr_text_color.asp CSS-accepted value] (e.g. #FFF, #FFFFFF, white, RGB(255,255,255)
: The color variables accepts any [[:Template:Fc|keyword]] that is available.


Actually, the 2 main highlight color used on the NMS wiki are :
Actually, the 2 main highlight color used on the NMS wiki are :
* {{fc|#FFF|white #FFF}}
* {{fc|highlight|highlight}}
* {{fc|#F88|reddish #F88}}
* {{fc|red|red}}
<br>
<br>


Line 193: Line 193:


=== Notices ===
=== Notices ===
There are two templates here. Both display notice blocks on page.<br>
The ''Notice'' templates will display some useful information.  
The ''Notice Small'' displays a smaller notice and can be used in lists.<br>
The ''Notice'' template will display a large notice centered on the page.  
 
; Notice Small
: Code: <code><nowiki>{{AlertSmall‏‎|type=notice|text=UserTextHere}}</nowiki></code>
{{AlertSmall‏‎|type=notice|text=This is useful}}


; Small Notice
: Code: <code><nowiki>{{AlertSmall|type=notice|text=This is QUITE useful}}</nowiki></code>
{{AlertSmall|type=notice|text=This is QUITE useful}}
<br>


; Notice
; Notice
Line 207: Line 205:


=== Warnings ===
=== Warnings ===
For very important notices, you can use either of the 2 warning templates
For very important notices, you can use the warning templates
 
; Warning Small
: Code: <code><nowiki>{{AlertSmall‏‎|type=warning|text=UserTextHere}}</nowiki></code>
{{AlertSmall‏‎|type=warning|text=This is important}}


; Small Warning
: Code: <code><nowiki>{{AlertSmall‏‎|type=warning|text=This is QUITE important !}}</nowiki></code>
{{AlertSmall‏‎|type=warning|text=This is QUITE important !}}
<br>


; Warning
; Warning
Line 218: Line 216:
{{alert|type=warning|text=This is VERY important}}
{{alert|type=warning|text=This is VERY important}}


{{NMSPageClose}}
=== Info boxes ===
[[Category:NoMansSky Tutorials]]
 
Info boxes can be created using a simple template like this one :
<pre>
{{InfoboxNMSRef
|float = left
|title = GCSPACESHIPGLOBALS.GLOBAL
|suffix = MBIN
|templateName =
|directory = /
|knowledge = partial
|summary = Handles spaceship settings.
}}
{{clear}}
</pre>
 
{{InfoboxNMSRef
|float = left
|title = GCSPACESHIPGLOBALS.GLOBAL
|suffix = MBIN
|templateName =
|directory = /
|knowledge = partial
|summary = Handles spaceship settings.
}}
{{clear}}

Latest revision as of 18:05, January 10, 2023

Nomanssky flare.png

NMS Wiki Reference

Introduction[edit | edit source]

This is a reference specific to No Man's Sky wiki to show examples of how to edit on the Step wiki, as well as, helpful information around text formatting and available templates.

First for foremost, there is an invaluable reason that Step has put together to editing the wiki in general, as well as, some specifics. This should be the main informational reference when something comes up that is unfamiliar in regards to working on the wiki. Another excellent source for information is the MediaWiki website, though one must be verse in using search to find anything.

Where to Create Pages[edit | edit source]

It's important to create pages with the correct URL structure to help maintain organization of content. To identify NMS pages on the Step wiki, look for the NMS Namespace. All NMS pages must start with the same Namespace, NoMansSky:

stepmodifications.org/wiki/NoMansSky:

Most pages can and should be created at the root of the namespace: ../wiki/NoMansSky:PageName

Example: ../wiki/NoMansSky:AMUMSS

Pages should only be made a subpage when the content is directly related to the root page: ../wiki/NoMansSky:PageName/SubPageName

Example: ../wiki/NoMansSky:AMUMSS/Making Combined Mods
Info-Logo.png
NOTE:
Note that pages can be relocated later, when necessary. However, this adds to maintenance.

Creating a New Page[edit | edit source]

To create a new page:

  1. Copy and paste one of the URL structures from above
  2. Change PageName to the name of page being added (must be unique/can't already exist), and hit Enter/Return on your keyboard.
  3. Users will be presented with a page stating the content doesn't exist and a couple options. Select, the edit this page link.
  4. Users will be taken to the editor for content creation.


Once at the editor, there are a few things that must be included for the NMS theme to work correctly.
Here is the template for a standard page that you can copy/paste in the editor of your new page :

{{PageTitle|logo=nomanssky|title=Modding Tools|subtitle=optional|author=optional|forumid=optional}}
{{NMSPage}}
{{TOC}}
[[Catergory:CategoryName]]
== HeaderText ==

Page content here...

Here are more informations about each line :

  • PageTitle Template places the standard page title element. The "optional" parameters do not need to be included, but can be.
  • NMSPage Template places the NMS navbar below the page title.
  • Table of Contents (TOC): if the TOC isn't desired, skip it and ensure the __NOTOC__ Magic Word is included, see Side Notes.
  • Categories: add appropriated categories so that page will be sorted for users. See the Category Reference for a list a available categories.
  • Content: add the content below everything else. It's highly recommended to begin any content with a level two heading: == HeaderText ==

Linking Pages[edit | edit source]

Pages can use internal or external links.

Internal Links[edit | edit source]

To link to an internal wiki page and display it in the current tab, use the follow syntax:

Note the Magic Word {{NAMESPACE}} (see MediaWiki). This Word fills in the "NoMansSky" portion of the local URL, called the Namespace. Use this rather than the actually typing out "NoMansSky" as it will auto-update the link with any changes to that internal portion of the URL.
Example: [[{{NAMESPACE}}:Tutorials|Show Tutorials in the current tab]]
Result: Show Tutorials in the current tab
Example: [[{{NAMESPACE}}:Game_Structure/METADATA/GAMESTATE|GAMESTATE Folder]]
Result: GAMESTATE Folder

External Links[edit | edit source]

To link a page in a new tab, use single brackets, the full url, a space and the name displayed :

Example: [https://stepmodifications.org/wiki/NoMansSky:Tutorials Show Tutorials in a new tab]
Result: Show Tutorials in a new tab

Page Anchor Links (links to page sections)[edit | edit source]

To link to a header within a page, simply add # to the end of the page URL followed by the header title (case sensitive!); replacing spaces with _.

Example: [[{{NAMESPACE}}:Game_Structure#FONTS|Link to Fonts heading]]
Result: Link to Fonts heading

Content Formatting[edit | edit source]

General formatting rules[edit | edit source]

First point of reference is the Step Wiki User Guide where we explain a great about the use of the Step Wiki, including how to format pages, the use of many of our templates, etc. Second is the general wiki formatting document is found on the MediaWiki page.

Avoid auto parsing[edit | edit source]

Sometimes the wiki will parse text into code that isn't desired to be parsed. This can be overcome a few different ways.

  1. No parsing, standard text : use <nowiki></nowiki> tags.
    nowiki tags will tell the parser to output whatever is between the tags as plain text. This is handy to print out markup on the page.
    Example: <nowiki><div style="color:#EEE;">My text is colored #EEE!</div></nowiki>
    Result: <div style="color:#EEE;">My text is colored #EEE!</div>
  2. No parsing, citation of a single line of text : Use <code>TextHere</code> tags.
    Code tags will envelop text within preformatted text.
    Example: <code>TextHere</code>
    Result: TextHere
  3. No parsing, citation of multiple lines of text, no markups : Use <pre></pre> tags.
    Preformatted tags will block out the text between them on the page, exactly as inputted (including spacing).
    Result:
            <Property value="TkSceneNodeAttributeData.xml">
              <Property name="Name" value="MATERIAL" />
              <Property name="AltID" value="" />
              <Property name="Value" value="MATERIALS/LIGHT.MATERIAL.MBIN" />
            </Property>
  1. No parsing, citation of multiple lines of text, with markups : Just be sure each of your lines start with a space.
    Any line of text starting with a space will be indented as copied and you keep any markup or content formatting ability.
    Result:
           <Property value="TkSceneNodeAttributeData.xml">
             <Property name="Name" value="MATERIAL" />
             <Property name="AltID" value="" />
             <Property name="Value" value="MATERIALS/LIGHT.MATERIAL.MBIN" />
           </Property>


Useful Templates[edit | edit source]

Images[edit | edit source]

Images can be included in a multitude of way as extensively described here.
But users can also easily include them with a template that creates a stylized instance of an image on the page.


GallerySimple Template
Code: {{GallerySimple|id=galleryID|width=250|img=(Image:UploadedImage)|caption=UserText}} {{clear}}
or
Code: {{GallerySimple|id=galleryID|width=250|img=(ImageURL)|caption=UserText}} {{clear}}

This template has several parameters that can be set. See this page to learn what they are and what they accept.

The img parameter accepts URLs (use "direct links"), however, it's recommended to upload the images to the wiki. To do so:
  1. On the top navigation bar, hover over TOOLBOX and select UPLOAD FILE.
  2. Once uploaded, use the image name from the browser's address bar (e.g. wiki.step-project.com/File:Explorer_2017-08-17_15-49-40.png )
Example code for an Uploaded Image:
{{GallerySimple|id=ImageSet1|width=144|img=Image:Explorer_2017-08-17_15-49-40.png|caption=Do this now!}} {{clear}}
Example code for an URL:
{{GallerySimple|id=ImageSet1|width=144|img=https://i.postimg.cc/4yR0dMSR/SWTOR-Guide-Logo.png|caption=Star Wars!<br>wait...wrong wiki...}} {{clear}}

Custom colors[edit | edit source]

When you need to highlight some text, it could be handy to only change its color. This can be done with the fc template :

Code: {{fc|YourColor|YourText}}
The color variables accepts any keyword that is available.

Actually, the 2 main highlight color used on the NMS wiki are :

  • highlight
  • red


Custom Tags[edit | edit source]

This template creates stylized, superscript text. Its use varies.

Code: {{CustomTag|color=ColorHere|tag=UserTextHere}}
The color variable accepts any CSS-accepted value (e.g. #FFF, #FFFFFF, white, RGB(255,255,255)


Exemples

This is some info Info!

Code: {{CustomTag|color=RGB(255,255,255)|tag=Info!}}

How about a warning next time! Warning

Code: {{CustomTag|color=red|tag=Warning}}

Is this thing new or old? New!

Code: {{CustomTag|color=#b1a9f1|tag=New!}}


Lists[edit | edit source]

You can use at least 2 kind of lists :

Dots
If you want a list where each line is preceded with a dot, use a * before your lines :
Code: * first line
Code: * second line
  • first line
  • second line


Numbers
To make each line preceded with an incremented number, use a # before your lines
Code: # first line
Code: # second line
  1. first line
  2. second line

Notices[edit | edit source]

The Notice templates will display some useful information.

Small Notice
Code: {{AlertSmall|type=notice|text=This is QUITE useful}}
Info-Logo.png
NOTE:
This is QUITE useful


Notice
Code: {{alert|type=notice|text=UserTextHere}}
Info-Logo.png

NOTE

This is VERY useful

Warnings[edit | edit source]

For very important notices, you can use the warning templates

Small Warning
Code: {{AlertSmall‏‎|type=warning|text=This is QUITE important !}}
Warning-Logo.png
WARNING:
This is QUITE important !


Warning
Code: {{alert|type=warning|text=UserTextHere}}
Warning-Logo.png

WARNING

This is VERY important

Info boxes[edit | edit source]

Info boxes can be created using a simple template like this one :

 {{InfoboxNMSRef
 |float = left
 |title = GCSPACESHIPGLOBALS.GLOBAL
 |suffix = MBIN
 |templateName = 
 |directory = /
 |knowledge = partial
 |summary = Handles spaceship settings.
 }}
{{clear}}
GCSPACESHIPGLOBALS.GLOBAL
File Suffix: MBIN
Template Name:
Directory: /
Knowledge State: Partially Understood
Summary: Handles spaceship settings.