View source for Help:Syntax and formatting

{{note|wip}}

This page should help you get familiar with the syntax and formatting used to create and update pages of the Renaissance Kingdoms Wiki.<br/><br/>

= Namespaces =

A namespace is a specific reserved word that serves as the common prefix for a group of Wiki pages. Several namespaces are used to structure the Renaissance Kingdoms Wiki:<br/><br/>

:{| class="wikitable" width="80%" style="margin: auto"
! Namespace !! Prefix !! Visibility !! When to use
|-
|'''Articles (or main)<br/>namespace'''
|style="text-align:center;"|/
|rowspan="5" style="text-align:center;"|Public
| 
* an article introducing a specific game-related item or mechanism
|-
|'''Discussions<br/>namespace'''
|style="text-align:center;"|Talk:
| 
* a discussion on game-related topics among Wiki users
|-
|'''Users<br/>namespace'''
|style="text-align:center;"|User:
| 
* a profile introducing a registered user of the Wiki
|-
|'''Help<br/>namespace'''
|style="text-align:center;"|Help:
| 
* a guide providing users with help on a specific subject
|-
|'''Templates<br/>namespace'''
|style="text-align:center;"|Template:
| 
* a template used to simplify the creation of pages with a similar structure
|-
|'''Drafts<br/>namespace'''
|style="text-align:center;"|Drafts:
|style="text-align:center;"|wiki editors
| 
* a draft is typically created before it is moved to the main namespace
|-
|}<br/>

= Create a page =

There are several approaches to creating a Wiki page:<br/><br/>
* '''<span style="color:#EF9B0F">Approach 1:</span>''' using links while creating or editing another page
** create a link for a future article page that will be created and save the page: <nowiki>[[</nowiki>My new page<nowiki>]]</nowiki>
** if you (or anyone else) create a link to an article that doesn't exist yet, the link will be colored red (e.g. <span style="color:#ee685b">My new page</span>)
** clicking a red link will take you to the edit page for the new article<br/><br/>

* '''<span style="color:#EF9B0F">Approach 2:</span>''' from the search box
** enter the title of the new page to the search box and search for it (e.g. My new page)
** if the search results do not display a page with the desired title, you'll typically see an option or link to create a new page with that title
** clicking a red link (e.g. '''<span style="color:#ee685b">My new page</span>''') will take you to the edit page for the new article<br/><br/>

* '''<span style="color:#EF9B0F">Approach 3:</span>''' using the URL
** the URL to an article typically looks something like this: <nowiki>https://wiki.renaissancekingdoms.com/en/ARTICLE</nowiki>
** if you replace ARTICLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet
** clicking on one of the links <span style="color:#f6b443">create this page</span> or <span style="color:#f6b443">Create</span> will take you to the edit page for the new article<br/><br/>

Once a page is created, it is possible to: 
* '''"Show preview"''' which generates a preview of how your edits will appear on the page without actually saving them. This allows you to review the formatting, layout, and content to ensure it looks the way you intend it to. It's a useful feature to catch and correct any errors or formatting issues before committing your changes. 
* '''"Save page"''' which commits your changes and updates the Wiki page with the edits you've made. Once you save the page, the changes become visible to other users, and the previous version of the page is replaced by your updated version.<br/><br/>

'''Remarks:'''
* To generate a page in a namespace other than the main namespace, you should add a prefix to a selected page name, such as "Help:", "Drafts:", "Talk:", "Template:", or "User:".
* Regarding the user pages, it is highly advisable to only create your own profile page. <br/><br/>

= Create a redirect to a page =
There are several approaches to creating a Wiki page:<br/><br/>
* '''<span style="color:#EF9B0F">Approach 1:</span>'''
** click on the "Special characters" and select the redirection icon: [[File:RedirectionIcon.png|25px]],
** type the name of the destination page.<br/><br/>

* '''<span style="color:#EF9B0F">Approach 2:</span>'''
** use the code: <nowiki>#REDIRECTION [[Destination page]]</nowiki>.<br/><br/>

= Edit a page =
To edit a Wiki page, simply click on the "<span style="color:#f6b443">Edit</span>" link, and you'll be taken to the editing interface:
* at the top of the page, to see the full content of the page in the editing interface 
* at the top of the section, to see the content of the section in the editing interface.<br/><br/>

As explained before, the '''"Show preview"''' link will generate a preview of how your edits will appear on the page without actually saving them, while the '''"Save page"''' link will commit your changes and update the Wiki page with the edits you've made.<br/><br/>

'''Remarks:'''
* Only the game [[Celsius Online|administrators]] can edit the [[Main Page]].<br/><br/>

= Syntax and formatting basics =
== Text color ==
To change the color of text, you can use the <nowiki><span></nowiki> HTML tag along with the style attribute to specify the text color:
* <nowiki><span style="color:#Code of the color"> Colored text </span></nowiki>

Color can be specified by its hexadecimal code or RGB values for more precise control.<br/><br/>

Colored text is typically used when presenting the item descriptions. The hexadecimal codes in use are:
* '''<span style="color:#CA6AD0>purple #CA6AD0</span>''': 3D furnishing to be placed inside or outside of the house
* '''<span style="color:#50B9EA> turquoise #50B9EA</span>''': information on how the item can be obtained (e.g. artisan making the item, peasant producing the item, or an event during which the item can be obtained)
* '''<span style="color:#C2AD3A">yellow #C2Ad3A</span>''': durability of the item
* '''<span style="color:#808025">golden yellow doré #808025</span>''': prosperity of the item
* '''<span style="color:#4C0B09">dark brown #4C0B09</span>''': copy limit of the item bringing prosperity
* '''<span style="color:#DE7435">orange #DE7435</span>''': information to specify whether the clothing item is suitable for women, men, or both
* '''<span style="color:#D3312C">red #D3312C</span>''': weapon type
* '''<span style="color:#469A43">green #469A43</span>''': impact of the item on the characteristics, virtue, actions of a character, a county, a kingdom
* '''<span style="color:#265911">dark green #265911</span>''': luxury food
* '''white''': rest of the description, typically describing the item in a humorous way<br/><br/>

'''<span style="color:#EF9B0F">Exemple:</span>'''<br/>
<nowiki>'''<span style="color:#EF9B0F">Colored text</span>'''</nowiki><br/><br/>
'''<span style="color:#EF9B0F">Colored text</span>'''<br/><br/>

== Text alignment ==
The text can be aligned in different ways:
* centered: <nowiki><div style="text-align: center;"> Text </div></nowiki>
* right-aligned: <nowiki><div style="text-align: right"> Text </div></nowiki>
* left-aligned: <nowiki><div style="text-align: left"> Text </div></nowiki><br/><br/>

'''<span style="color:#EF9B0F">Example:</span>'''<br/>
<pre>
<nowiki>The text can be:<br/></nowiki><br/>
<nowiki><div style="text-align: center;">centered</div></nowiki><br/>
<nowiki><div style="text-align: right">right-aligned</div></nowiki><br/>
<nowiki><div style="text-align: left">left-aligned</div></nowiki><br/><br/>
</pre>

The text can be:<br/>
<div style="text-align: center">centered</div>
<div style="text-align: right">right-aligned</div>
<div style="text-align: left">left-aligned</div><br/><br/>

== Examples and remarks (formatting) ==

<pre>
<nowiki>'''Remarks:'''</nowiki><br/>
<nowiki>* Lorem Ipsum Text<br/><br/></nowiki><br/><br/>
</pre>

'''Remarks:'''
* Lorem Ipsum Text<br/><br/>

<pre>
<nowiki>'''<span style="color:#EF9B0F">Example:</span>'''<br/></nowiki><br/>
<nowiki>Lorem Ipsum Text<br/><br/></nowiki>
</pre>

'''<span style="color:#EF9B0F">Exemple:</span>'''<br/>
Lorem Ipsum Text<br/><br/>

== Files ==
To upload a file:
* click an "<span style="color:#f6b443">Upload file</span>" link in the Tools menu
** choose a file
** add a file summary to help other editors when using it
** upload a file<br/><br/>

To view or search for previously uploaded files, consult a [[Special:ListFiles|file list]] page which shows all uploaded files.<br/><br/>

== Lists ==
In Wiki, you can create lists to organize and present information in a structured and easy-to-read format. There are typically three main types of lists used in Wiki:
* unordered (or bulleted) list
** used to present items in no particular order
** each item in the list is preceded by a bullet point or some other marker (e.g. <nowiki>*</nowiki>)
* ordered (or numbered) list
** used to present items in a specific sequence or order
** each item in the list is preceded by a number or a hash symbol ( <nowiki>#</nowiki> )
* definition (or description) list
** used to present a list of terms and their corresponding definitions or descriptions
** each item consists of two main parts: the term and the definition<br/><br/>

'''<span style="color:#EF9B0F">Example :</span>'''<br/>
<pre>
<nowiki>* It is easy to create lists:</nowiki><br/>
<nowiki>** to create a bulleted list item</nowiki><br/>
<nowiki>* use an asterisk followed by a space</nowiki><br/>
<nowiki>** more asterisk symbols</nowiki><br/>
<nowiki>*** create a nested list</nowiki><br/><br/>
</pre>

* It is easy to create lists::
** to create a bulleted list item
* use an asterisk followed by a space
** more asterisk symbols
*** create a nested list<br/><br/>

<pre>
<nowiki># Ordered lists are</nowiki><br/>
<nowiki>## very well organized, and</nowiki><br/>
<nowiki>## easy to follow</nowiki><br/><br/>
</pre>

# Ordered lists are
## very well organized, and
## easy to follow<br/><br/>

<pre>
<nowiki>; Nested definition list</nowiki><br/>
<nowiki>; element 1 : definition</nowiki><br/>
<nowiki>:; sub-element 1 and its term</nowiki><br/>
<nowiki>:: definition</nowiki><br/>
<nowiki>:; sub-elemnt 2 : definition</nowiki><br/>
<nowiki>; element 2</nowiki><br/>
<nowiki>: returning to the main list</nowiki><br/><br/>
</pre>

; Nested definition list
; element 1 : definition
:; sub-element 1 and its term
:: definition
:; sub-element 2 : definition
; element 2
: returning to the main list<br/><br/>

== Line breaks ==
To start text in a new line, you should use the <nowiki><br/></nowiki> tag to insert a line break wherever you need one.<br/><br/>

'''Remarks:'''
* Doubling the <nowiki><br/></nowiki> code increases the number of line breaks.<br/><br/>

== Tables ==
Creating tables typically involves using several markup formattings:
* '''<nowiki>{|</nowiki>''': start of the table
** a mandatory tag
* '''<nowiki>|-</nowiki>''': table row
* '''<nowiki>!</nowiki>''': table header
** an optional tag
** single exclamation mark (<nowiki> ! </nowiki>) if at the start of a new line
** double exclamation mark (<nowiki> !! </nowiki>) if on the same line
* '''<nowiki>|</nowiki>''': data cell
** an optional tag
** single vertical bar (<nowiki> | </nowiki>) if at the start of a new line
** double vertical bar (<nowiki> || </nowiki>) if on the same line
* '''<nowiki>|}</nowiki>''': end of the table
** a mandatory tag<br/><br/>

'''<span style="color:#EF9B0F">Example:</span>'''<br/>
<pre>
<nowiki>:{| class="wikitable"</nowiki><br/>
<nowiki>! Header 1 !! Header 2 !! Header 3</nowiki><br/>
<nowiki>|-</nowiki>
<nowiki>| Column 1, Row 1 || Column 2, Row 1 || Column 3, Row 1</nowiki><br/>
<nowiki>|-</nowiki>
<nowiki>| Column 1, Row 2</nowiki><br/>
<nowiki>| Column 2, Row 2</nowiki><br/>
<nowiki>| Column 3, Row 2</nowiki><br/>
<nowiki>|-</nowiki>
<nowiki>|}<br/></nowiki><br/><br/>
</pre>

:{| class="wikitable"
! Header 1!! Header 2 !! Header 3
|-
| Column 1, Row 1
| Column 2, Row 1
| Column 3, Row 1
|-
| Column 1, Row 2 || Column 2, Row 2 || Column 3, Row 2
|-
|}<br/>

== Section titles ==
To create section titles within a page, you should use headings. Headings are created by using a series of equal signs (=) before and after the text of the section title. The number of equal signs indicates the level of the heading (higher numbers indicate lower-level headings).<br/><br/>

'''<span style="color:#EF9B0F">Example:</span>'''<br/>
<pre>
<nowiki>= Section title =</nowiki><br/>
<nowiki>== Subsection title ==</nowiki><br/>
<nowiki>=== Sub-subsection tile ===</nowiki><br/>
<nowiki>===== Sub-sub-subsection tile =====</nowiki><br/><br/>
</pre>

----
[[FR:Aide:Syntaxe pour débuter]]
----