From EncyclopAtys
m (→And to finish) |
m (→Galleries) |
||
(58 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
− | {{Trad|EN=Writing Guide|FR=Guide de rédaction}} | + | {{Trad |
− | This '''writing guide''' is a | + | |DE=Anleitung zum Schreiben |DEs=4 |
+ | |EN=Writing Guide |ENs=4 | ||
+ | |ES=Guía de Redacción | ||
+ | |FR=Guide de rédaction |FRs=0 | ||
+ | |RU= Руководство по редактированию |RUs=5 }} | ||
+ | This '''writing guide''' is a “mini-guide for dummies” with a rolistic hue, i.e. built for an encyclopedia written for and '''by''' the “[#User or homin|toons]]” (more than by their “"anima"” hiding behind their Karavan interface module <ref>A “Karavan interface module” is named computer IRL</ref> by strumming on a shell of [[arma]]). This guide focuses more on the '''art''' of pages' composition than the '''how to''' make articles. However it quickly provides the reader with the basic essentials for him to take control of these fabulous [http://en.wikipedia.org/wiki/MediaWiki MediaWiki]. | ||
+ | |||
+ | * [[Wiki tools bar]] present the tool bars on wikis (small attempt to improve communication - as it's better to use the same vocabulary when asking for help). | ||
+ | * An other Guide, pore technical is on [[Wiki Technical Guide]]. There's [[:fr:Guide de rédaction/Wiki IG|some notes on wiki, seen IG]] (but only in French), and since then the IG browser is better. | ||
[[File:RClogo211905.png|center|#pj-ryzom_wiki is the RC channel to talk about wikis |link=https://chat.ryzom.com/channel/pj-ryzom_wiki]] | [[File:RClogo211905.png|center|#pj-ryzom_wiki is the RC channel to talk about wikis |link=https://chat.ryzom.com/channel/pj-ryzom_wiki]] | ||
==to start== | ==to start== | ||
Line 22: | Line 30: | ||
And if the page I wanted already exists? Ah! that's another adventure. Later! Now the question is: | And if the page I wanted already exists? Ah! that's another adventure. Later! Now the question is: | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
==Breaking the blank page== | ==Breaking the blank page== | ||
Line 48: | Line 59: | ||
</poem> | </poem> | ||
</div> | </div> | ||
− | This will be | + | This will be displayed as |
<div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> | <div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> | ||
This is an example of | This is an example of | ||
Line 128: | Line 139: | ||
</nowiki></poem> | </nowiki></poem> | ||
</div> | </div> | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
===Add an image=== | ===Add an image=== | ||
Line 137: | Line 151: | ||
=====Where to find the pictures?===== | =====Where to find the pictures?===== | ||
− | The images are stored in | + | The images are stored in the COMMON wiki (common to all wikis: French, German etc) : |
− | + | * list with recent on top of page http://atys.wiki.ryzom.com/w/index.php?limit=500&ilsearch=&user=&title=Special%3AListFiles Nice if you uploaded your images (then add your name in the '''Username''' filed) | |
− | * http://atys.wiki.ryzom.com/w/index.php?limit=500&ilsearch=&user=&title=Special%3AListFiles | + | * or using an array, with most common categories [[:atys:Main_Page]] (manual array) |
− | + | * an other test can be used [[:atys:User:Craftjenn/Main page]] - it's a dynamic one, with help | |
− | |||
===== How to put a personal picture ===== | ===== How to put a personal picture ===== | ||
Line 148: | Line 161: | ||
To import the image, you have to choose from the menu '' Tools '' the command '' Import a file" and follow the instructions. | To import the image, you have to choose from the menu '' Tools '' the command '' Import a file" and follow the instructions. | ||
− | Click on "Browse" to choose the image that is on your machine, it can be useful to indicate keywords in Summary; validate at the bottom in click "Unload file" (wait for the sending of the image on the servers of Atys). | + | Click on "Browse" to choose the image that is on your machine, it can be useful to indicate keywords and category in Summary; validate at the bottom in click "Unload file" (wait for the sending of the image on the servers of Atys). |
The image has been sent (we no longer see the instructions for help with insertion). However, it must now be inserted into the wiki code (copy the exact name of the file, eg "File: Barreswiki.png" go to the next step). | The image has been sent (we no longer see the instructions for help with insertion). However, it must now be inserted into the wiki code (copy the exact name of the file, eg "File: Barreswiki.png" go to the next step). | ||
− | The images are hosted in the Common (URL address that how in atys: https://atys.wiki.ryzom.com/wiki/Home). More on Tips for [[ | + | The images are hosted in the Common (URL address that how in atys: https://atys.wiki.ryzom.com/wiki/Home). More on Tips for [[SOS/catImage|categorizing an Image]]. |
====Inserting an image, wiki code==== | ====Inserting an image, wiki code==== | ||
Line 163: | Line 176: | ||
[[file:Dummy.png|64px|alt=A strange sphere, ex 64|The emblem of the ASA, ex 64]] | [[file:Dummy.png|64px|alt=A strange sphere, ex 64|The emblem of the ASA, ex 64]] | ||
where the '''Name of the picture''' is preceded by the prefix «file:». The other parameters are optional. | where the '''Name of the picture''' is preceded by the prefix «file:». The other parameters are optional. | ||
− | |||
− | |||
====Galleries==== | ====Galleries==== | ||
Line 176: | Line 187: | ||
Wiki-bar-insimg.png|misnamed, because does not allow to send an image, but just add it to the page | Wiki-bar-insimg.png|misnamed, because does not allow to send an image, but just add it to the page | ||
</gallery> | </gallery> | ||
+ | |||
+ | More on [[Writing Guide/Image gallery]]. | ||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
+ | |||
+ | ====Images and links==== | ||
+ | * Link on image: pour [[File:Atysmap.jpg|50px|link=Atys/Dynamic map]] (image reduced to 50px), the code is <nowiki>[[File:Atysmap.jpg|50px|link=Atys/Dynamic map]]</nowiki> where Atys/Dynamic map is link's target. | ||
+ | *If the image is hosted on the common wiki, in order to make [[:atys:File:Atysmap.jpg|See in big]], the code is <nowiki>[[:atys:File:Atysmap.jpg|See in big]]</nowiki>.<br /> | ||
+ | *To add a link towards an image category on the common, ex: [[:atys:Category:Wiki|The Common's Wiki category]] groups together wiki help images, use the code <nowiki> [[:atys:Category:Wiki|The Common's Wiki category]] </nowiki> | ||
+ | * To add links according to the zones of an image (see [[Atys/Dynamic map|this example]]), map generation on the web: | ||
+ | ** http://maschek.hu/imagemap/imgmap/ | ||
+ | ** https://www.image-map.net/ | ||
+ | ** http://www.image-maps.com/ | ||
+ | |||
+ | Source : https://www.mediawiki.org/wiki/Help:Images#Link_behavior | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
===Links=== | ===Links=== | ||
Line 186: | Line 215: | ||
* external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use [https://ballisticmystix.net the website ballistic mistix] . | * external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use [https://ballisticmystix.net the website ballistic mistix] . | ||
* And the reference which is a link to a note <ref>example of note </ref> at the bottom of the page, as can be seen on this line. | * And the reference which is a link to a note <ref>example of note </ref> at the bottom of the page, as can be seen on this line. | ||
+ | * Links to other wikis (interwiki links): add the language before, such for common [[:atys:Category:User work|User work images]], or to the French version of this guide: [[:fr:Guide de rédaction]]. | ||
</div> | </div> | ||
Here is the wiki code: | Here is the wiki code: | ||
Line 196: | Line 226: | ||
* external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use [https://ballisticmystix.net the website ballistic mystix] . | * external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use [https://ballisticmystix.net the website ballistic mystix] . | ||
* And the reference which is a link to a note <ref>example of note</ref> at the bottom of the page, as can be seen on this line. | * And the reference which is a link to a note <ref>example of note</ref> at the bottom of the page, as can be seen on this line. | ||
+ | * Links to other wikis (interwiki links): add the language before, such for common [[:atys:Category:User work|User work images]], or to the French version of this guide: [[:fr:Guide de rédaction]]. | ||
</nowiki></poem> | </nowiki></poem> | ||
</div> | </div> | ||
Line 203: | Line 234: | ||
Reference error : some <ref> exists, but no <references/> found. | Reference error : some <ref> exists, but no <references/> found. | ||
</nowiki></div> | </nowiki></div> | ||
+ | |||
+ | A trick is to create a template to have a navigation bar in the page ([[:fr:Manuel de l'utilisateur/ListeTPFranglais|an example here]], with [[:fr:Manuel de l'utilisateur/ListeTPFranglais/BarreNav|this template]]). For the anchor at the top of the page, use the code <nowiki><div id="Top"></div></nowiki> | ||
+ | |||
+ | To link to a wiki page on an other wiki, see [[Help:Interwiki]]. | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
=== Other tips === | === Other tips === | ||
+ | About History (just after the Edit tab), a basic functionality of wikis: https://en.wikipedia.org/wiki/Help:Page_history | ||
+ | ==== citation, poems...==== | ||
+ | * "quote tags" <nowiki><q> blblbl </q></nowiki>. The enclosed text will appear with an italic serif font withi appropriate quote (language dependant) characters. An example: <q> blblbl </q> | ||
+ | |||
+ | * "poem tags" is a wiki extension. <nowiki><poem> Looooooooooooooooooooooooooooooong text or not so long </poem></nowiki> will display: <poem> Looooooooooooooooooooooooooooooong text or not so long </poem> | ||
+ | : The Poem extension allows easy formatting of poems and similar material within Wikitext. Once the extension is enabled, you can put any block of text within <nowiki><poem></poem></nowiki> tags, which has the following effects: | ||
+ | :* All newlines are preserved by converting them into <nowiki><br /></nowiki> tags | ||
+ | :* The block of text is enclosed in <nowiki><p>...</p></nowiki> tags (as well as a div of class "poem") | ||
+ | :* Colons at the beginning of a line are converted into 1 em indentation | ||
+ | :* Spaces at the beginning of a line are preserved and no longer invoke the <nowiki><pre></nowiki> tag (a must to have paragraph indentation) | ||
+ | :* The extension preserves wikilinks, bolding, etc. if they are present in the poem. | ||
+ | |||
+ | * "center tags" anything between these tags will be centered to the page <nowiki><center> blblbl </center></nowiki>. | ||
+ | ** Note that floating images or tables reduce page size, thus the <nowiki>{{clear}}</nowiki> template is often useful to force text to appear under an image. | ||
+ | ** Note also that you may need to add a couple of cente tags if a new line breaks it. It isn't necessary if you use only <br/> to separate different lines. | ||
+ | |||
+ | * emdash space (ALTGR then -, or U+2212 U+0020) is useful, often combined with quote tags to separate the sentences of in dialogs. Ex: blakjhd - | ||
+ | |||
+ | |||
+ | '''Examples:''' [[The_Kitin_Song]], [[Tears_of_Serenity]], [[A_Flyner_Escape]] | ||
+ | |||
+ | ==== Useful links (Special pages) ==== | ||
+ | * 🇬🇧 [https://en.wiki.ryzom.com/wiki/Special:RecentChanges changes] 🇩🇪 [https://de.wiki.ryzom.com/wiki/Spezial:Letzte_%C3%84nderungen DE changes] 🇫🇷 [https://fr.wiki.ryzom.com/wiki/Sp%C3%A9cial:Modifications_r%C3%A9centes FR changes] and [https://atys.wiki.ryzom.com/wiki/Special:RecentChanges common's changes] | ||
+ | |||
+ | ===== Pages too long can be an issue IG ===== | ||
+ | '''Note''': long/heavy page is an issue, if user read wiki from the game, as the game browser is limited in memory (for ex, [[User Manual]] :( Therefore, for some pages, it would be better to check IG if they are fully displayed. | ||
+ | |||
+ | |||
+ | * 🇬🇧 https://en.wiki.ryzom.com/wiki/Special:LongPages 🇫🇷 https://fr.wiki.ryzom.com/wiki/Sp%C3%A9cial%3APages_longues | ||
+ | : for EN it's, in Feb 2020: | ||
+ | ::(hist) User Manual [87,963 bytes] | ||
+ | ::(hist) Paul C. R. Monk – Bloomtree [75,959 bytes] | ||
+ | :: Story of a Young Fyros [61,565 bytes] | ||
+ | ::(hist) Categorization [60,455 bytes] -> not an issue as it's NOT for helping homins but for wiki contributors | ||
+ | ::(hist) Chapter II - Vigils in the Marauder Camp [58,750 bytes] | ||
+ | |||
+ | IG, the Lore don't comes from here (but from an other tool, and through a service who cut some html/css code). The game's internal browser has a very limited memory (css issues too). User Manual v3 can't be read IG because it's too long and too big. The User Manual, faq and help should be quite light. The wikis are quite bad on a cell phone too... | ||
+ | |||
+ | '''A solution''': use titles, and below the title, create a sub page. | ||
+ | * More on [[Help:Transclusion]] (about partial transclusion tags noinclude, includeonly and onlyincude, and template for the wiki In Game too). | ||
+ | |||
==== Sorted array ==== | ==== Sorted array ==== | ||
− | An ex: [[fr:Emotes]] | + | An ex: [[:fr:Emotes]] |
<nowiki>{|cellspacing="0" cellpadding="5" border="1" style="text-align:left;" class="sortable" | <nowiki>{|cellspacing="0" cellpadding="5" border="1" style="text-align:left;" class="sortable" | ||
Line 216: | Line 295: | ||
|}</nowiki> | |}</nowiki> | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
===And to finish=== | ===And to finish=== | ||
Line 257: | Line 339: | ||
====Courtesy==== | ====Courtesy==== | ||
An encyclopedia aims above all to synthesize all fields of knowledge (Atys). To achieve this, the articles are inspired from various sources. Beyond the encyclopedic aspect and the weaving of the Web, which recommends citing the sources, there is also the elegance of the recognition of the work of an author. | An encyclopedia aims above all to synthesize all fields of knowledge (Atys). To achieve this, the articles are inspired from various sources. Beyond the encyclopedic aspect and the weaving of the Web, which recommends citing the sources, there is also the elegance of the recognition of the work of an author. | ||
− | ====Preview==== | + | ====Preview and save ==== |
Previewing is also a form of courtesy. It not only makes it possible to verify that everything is correct before validating, but also to avoid that the modification histories fill up unnecessarily. Of course, Jena will not throw you into the hands of Kamis, or they will plunge you into the Goo if after validating your backup you find that you have missed some errors. | Previewing is also a form of courtesy. It not only makes it possible to verify that everything is correct before validating, but also to avoid that the modification histories fill up unnecessarily. Of course, Jena will not throw you into the hands of Kamis, or they will plunge you into the Goo if after validating your backup you find that you have missed some errors. | ||
+ | |||
+ | '''Note''': if you get the message (which appears often, because wikis don't like people changing the same page too often - '''it's not related''' to the capacity of your PCs or the quality of your connection to the web), '''save the page again - and you're done'''! | ||
+ | |||
+ | <p style="color:red;">Sorry! We could not process your edit due to a loss of session data. | ||
+ | |||
+ | You might have been logged out. Please verify that you're still logged in and try again. If it still does not work, try logging out and logging back in, and check that your browser allows cookies from this site. | ||
+ | </p> | ||
+ | |||
====Importance==== | ====Importance==== | ||
If this is the case, you then have to check the ''Minor modification'' button. This allows you to correct an article, make intermediate changes, etc. Because of this, you can hide minor changes when you make a search for changes. Think of the administrators! | If this is the case, you then have to check the ''Minor modification'' button. This allows you to correct an article, make intermediate changes, etc. Because of this, you can hide minor changes when you make a search for changes. Think of the administrators! | ||
Line 268: | Line 358: | ||
To add a link on this wiki to your RC adress, the wiki code is <nowiki>[https://chat.ryzom.com/direct/YourName YourName on RC]</nowiki> or using an image [[File:RClogo211905.png|60px|Private message on RC|link=https://chat.ryzom.com/direct/Craftjenn]] <nowiki>[[File:RClogo211905.png|Private message on RC|link=https://chat.ryzom.com/direct/YourName]]</nowiki> | To add a link on this wiki to your RC adress, the wiki code is <nowiki>[https://chat.ryzom.com/direct/YourName YourName on RC]</nowiki> or using an image [[File:RClogo211905.png|60px|Private message on RC|link=https://chat.ryzom.com/direct/Craftjenn]] <nowiki>[[File:RClogo211905.png|Private message on RC|link=https://chat.ryzom.com/direct/YourName]]</nowiki> | ||
− | as here [[File:RClogo211905.png|Contact Craftjenn on RC|link=https://chat.ryzom.com/direct/Craftjenn]] | + | as here [[File:RClogo211905.png|Contact Craftjenn on RC|link=https://chat.ryzom.com/direct/Heernis]] |
+ | |||
+ | |||
+ | '''Very useful for wiki translators:''' | ||
+ | # explanation of the inter-wiki signing issue, for example... Let's say my profile is on the English wiki (User:MyName). | ||
+ | #* If, on a page of the French wiki (or other language, such DE, ES, RU), I use my signature (with the code 16:10, 3 March 2020 (CET))... | ||
+ | #* it will put a link on the discussion page of the profile User:MyName, which is on the English wiki | ||
+ | #* Then there are two cases: | ||
+ | #** either I don't have a profile created on the French wiki, and the talk link will be red (the page doesn't exist) | ||
+ | #** either I created a profile on the French wiki (talk link in blue) - but I wouldn't be notified on the English wiki, if I usually don't go much on the French wiki. So, I'll have to think about '''checking the 2''' (or more) talk pages '''regularly''' :( | ||
+ | # There are several '''solutions''': [[User:Zorroargh|Zo]]'s one and [[User:Craftjenn|Craftjenn]]'s one. The simplest is to use [[Chat/RC FAQ|RC]] and that's what is presented here. | ||
+ | #* On the top right of the screen: Preferences, (1st tab where we arrive), part Signature : | ||
+ | #* "New signature": CraftJenn, Ranger of the Circle of the Wood of Almati ( <nowiki>[https://chat.ryzom.com/direct/Craftjenn on RC]</nowiki> ) | ||
+ | #* check "Treat the signature as wikittext (no automatic link)". | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
==The art of writing an article== | ==The art of writing an article== | ||
Line 280: | Line 386: | ||
You know the minimum to get by. Of course you will have to search stuffs. This will look like the work of Surveys of Mission Raw Materials which will be more and more valuable. There is one last point you will not find elsewhere: | You know the minimum to get by. Of course you will have to search stuffs. This will look like the work of Surveys of Mission Raw Materials which will be more and more valuable. There is one last point you will not find elsewhere: | ||
"How to elegantly introduce OOC in roleplay (RP) articles?" | "How to elegantly introduce OOC in roleplay (RP) articles?" | ||
+ | |||
+ | ==== Dates and time ==== | ||
+ | Please use the Atysian dates. More on [[Time]] and there's a tool to convert dates on https://ryzom.kervala.net/time.php?shard=atys | ||
====⇒ in notes==== | ====⇒ in notes==== | ||
In the roleplay text, the Atysian date '''Holeth, Winderly 24, 1st AC 2603''' <ref>OOC: 2019-04-15</ref> | In the roleplay text, the Atysian date '''Holeth, Winderly 24, 1st AC 2603''' <ref>OOC: 2019-04-15</ref> | ||
− | ==== | + | The code is <br /> |
− | + | <nowiki>'''Holeth, Winderly 24, 1st AC 2603''' <ref>OOC: 2019-04-15</ref></nowiki> | |
+ | and will be displayed down page as | ||
+ | <div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> | ||
+ | [[#⇒ dans les notes|↑]] OOC: 2019-04-15 | ||
+ | </div> | ||
====⇒ in the text==== | ====⇒ in the text==== | ||
Line 291: | Line 404: | ||
{{OOC|short comment|Some quite long text}} | {{OOC|short comment|Some quite long text}} | ||
</pre> | </pre> | ||
− | will give the colored section: | + | will '''NOT''' give the colored section: '''it seems this Template don't exists''' |
− | + | ||
− | + | ||
+ | |||
+ | |||
+ | ====⇒ in a tabbed page==== | ||
+ | As in [[APageRPandOOC]] | ||
+ | |||
====Categorise your OOC pages==== | ====Categorise your OOC pages==== | ||
− | This category doesn't exists in the English wiki. | + | This category doesn't exists in the English wiki. Thanks to use for spoilers [[:Category:Mysteries]] |
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
==Portals== | ==Portals== | ||
Line 332: | Line 453: | ||
To work on Featured article/Tryker, I copy somewhere in my personal page "<code><nowiki>{{Featured article/Tryker}}</nowiki></code>" then I change the braces in hooks and, as braces are for templates in mediaWiki, prefix with template, it should gives "<code><nowiki>[[Template:Featured article/Tryker]]</nowiki></code>" - this is the link I will use to change the Tryker page (and then the Tryker portal). | To work on Featured article/Tryker, I copy somewhere in my personal page "<code><nowiki>{{Featured article/Tryker}}</nowiki></code>" then I change the braces in hooks and, as braces are for templates in mediaWiki, prefix with template, it should gives "<code><nowiki>[[Template:Featured article/Tryker]]</nowiki></code>" - this is the link I will use to change the Tryker page (and then the Tryker portal). | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
==And after...== | ==And after...== | ||
Line 341: | Line 465: | ||
For translation codes, and translating on wiki, see [[WikiTrad-EN]]. | For translation codes, and translating on wiki, see [[WikiTrad-EN]]. | ||
+ | |||
+ | ===Templates === | ||
+ | Template is for repetitive stuff. For example, a navigation bar on several pages: create <nowiki>Template:My_Nav</nowiki> (with the links) and use with <nowiki>{{My_nav}}</nowiki> on pages (each time you change <nowiki>Template:My_Nav</nowiki>, all page who have code <nowiki>{{My_nav}}</nowiki> will use the last updated <nowiki>Template:My_Nav</nowiki>). | ||
+ | |||
+ | See for ex [[:Category:Navigation_templates]] | ||
+ | |||
+ | If you create your own Templates, thanks to add the category <nowiki>[[Category:User Templates]]</nowiki>. To get an idea of some examples: [[:Category:User Templates]] | ||
+ | |||
+ | |||
+ | <small>[[#top|Top]]</small> | ||
==Links== | ==Links== | ||
[[File:RClogo211905.png|center|#pj-ryzom_wiki is the RC channel to talk about wikis |link=https://chat.ryzom.com/channel/pj-ryzom_wiki]] | [[File:RClogo211905.png|center|#pj-ryzom_wiki is the RC channel to talk about wikis |link=https://chat.ryzom.com/channel/pj-ryzom_wiki]] | ||
− | https://www.mediawiki.org/wiki/Help: | + | * official help https://www.mediawiki.org/wiki/Help:Contents |
+ | {{:Help/Some official help links}} | ||
+ | |||
+ | <!-- testing portal link [[Category:Wikipatys]] --> | ||
+ | |||
− | [[Category: | + | {{clear}}{{Last version link}} |
+ | <noinclude>{{Portal|Wikipatys}} | ||
+ | [[Category:WikipAtys]] [[Category:EncyclopAtys]] [[Category:Help]]</noinclude> |
Latest revision as of 09:50, 18 October 2023
This writing guide is a “mini-guide for dummies” with a rolistic hue, i.e. built for an encyclopedia written for and by the “[#User or homin|toons]]” (more than by their “"anima"” hiding behind their Karavan interface module [1] by strumming on a shell of arma). This guide focuses more on the art of pages' composition than the how to make articles. However it quickly provides the reader with the basic essentials for him to take control of these fabulous MediaWiki.
- Wiki tools bar present the tool bars on wikis (small attempt to improve communication - as it's better to use the same vocabulary when asking for help).
- An other Guide, pore technical is on Wiki Technical Guide. There's some notes on wiki, seen IG (but only in French), and since then the IG browser is better.
Contents
to start
I would like to write something. What a good idea! But it may have already been written, so the wisest thing is to find out if someone has come before you. And there, oh! nice! either the wiki tells you that the article exists or it shows you:
Search result
...
There were no results matching the query.
Create the page « Trucobolite » on this wiki !
If you hover over the text written in dark red (not here, because I have intentionally not added any link) you will see the name of the page highlight and display "Trucobolite (page does not exist)". All you have to do is click to open a blank page and start the adventure.
It's so simple? Um, almost. Just before you start, follow these tips for choosing a title:
- Avoid as much as possible articles, plural... be close to a dictionary entry. It is better to write an article about Corsairs than about The Corsairs even though in the end it's like the corsairs as a tribe we want to talk about.
- If you feel that the article should be written, but perhaps with a similar spelling, you can use the Google search engine by typing the statement:
trucobolite site:http://en.wiki.ryzom.com
And if the page I wanted already exists? Ah! that's another adventure. Later! Now the question is:
Breaking the blank page
To write in a wiki, the easiest way is to write, write, write ...
And so you start ...
After hundreds of characters entered briskly on your keyboard you will take a look at your work, and as everyone advised you you choose the Preview button instead of Save. And, oh, surprise! your text is an inelegant pile of endless words.
As long as you're not used to MediaWiki, you may get some surprising results in the first place. But with very few rules, it is possible to quickly write a good and beautiful text.
Indeed, MediaWiki was designed at a time when wyziwyg was not commonplace. And yet, it wanted to be easily accessible to non-computer scientists, those who work without a mouse, visually impaired ... It was therefore necessary to work as efficiently as possible (that is to say, tiring as little as possible, specialty both Tryker and computer scientists among others) and so, it was necessary to play on simple gestures like repeating the same key to achieve a certain result. But first of all, let's try to see clearly.
Basic formatting
Paragraph
In MediaWiki, a "carriage return" is not a "return to line" let alone a paragraph break. In the spirit, this wiki is very close to HTML. And in the latter, the return to the line has no meaning other than that of making the lines more readable in the source. So, to make a new paragraph, you need two "carriage return" (or a blank line). Here is an example to illustrate these "carriage returns":
This is an example of
a text written on
3 lines.
And this a a new paragraph.
In case a line begins with a
it gives a very special effect, very useful, but perhaps unexpected in the context.
This will be displayed as
This is an example of a text written on 3 lines.
And this a a new paragraph.
In case a line begins with a space
it gives a very special effect, very useful, but perhaps unexpected in the context.
Titles
Your text is already more readable, but it probably lacks to be organized. For that, you will want to add titles. Here too the technique is simple, just frame the text with "=" as shown in the following examples, taken from this passage:
==Breaking the blank page==
===Basic formatting===
====Titles====
And, will you tell me, there is no =Title level 1=
? No, this one is reserved for the MediaWiki who uses it to make the title of the page.
Comment and wiki tags
A comment is some text, inserted in the wiki code of a page, that we can only see if we modify the wiki page = it remains invisible to the display (or in other words: only those who have the right to edit this page can see it).
<!-- This is an example of an invisible comment -->
The wiki interprets the wiki code that you enter in a page; it is done to automatically perform a number of tasks depending on the context. For example:
- before recording a page, it interprets the code (hence the preview, which gives an idea of the silent work done by the wiki, just before saving these codes.) We understand this aspect, with the comments and the nowiki tag)
- before displaying it (the reading mode via the Page view: it hides the comments, processes the nowiki tag, ... the write mode via the Edit view: it shows the comments...), ...
This help page very often uses the nowiki tag to show wiki code.
What is a tag?
It is a series of characters, used for the structuring of a document and which will be invisible by the final reader. In general (the line break is one of the well-known exceptions) there is an opening tag and a closing tag - HTML follows this logic, and the code wiki has much in common with it.
Typically: '''<a_tag>''' bla bla '''</a_tag>'''
With the nowiki tag, as soon as the wiki recognizes the first tag, instead of working as usual, it changes mode until the closing tag. In the wiki toolbar, open the advanced bar to see its icon (just after the numbered lists)
bring out
Well, no, we do not emphasize, we do not highlight! :)
When something is important, you tend to raise your voice or change the tone. One could say that it is the same in writing: it puts in bold character. Needless to say, it's not worth while to raise your voice all the time ... it's tiring.
A convention (but not an obligation) is to always write, before the first title, a summary in which the name of the article appears as soon as possible. This habit is intended to confirm to the reader that it is on the right page, which is very useful when some pages are redirected.
And italics? Basically, we could say that these are quotes and expressions that are out of the current contextual language (honorific title, foreign word, wording ...) and that we could have put in quotation marks. For example, for us atysiens, it could be an OCC expression in the text.
So here is how to produce both types:
'''In bold''' and ''in italics'' and with '''''both'''''.
This will display
In bold and italics and both.
When I told you that you were typing thirty-six times on the same key!
Lists
Well, for sure, now that you know how to write in the wiki, you will want to give recipes, raw materials to extract ... And then, you want it to be done in a quest, in a certain order .. It's easy in MediWiki. To get this:
- a list item consisting of an ordered sequence
- itself composed of a list
- A
- B
- etc.
- itself composed of a list
- etc. ...
you need to write that:
*a list item consisting of an ordered sequence
*#itself composed of a list
*#*A
*#*B
*#etc.
*etc. ...
Add an image
For now, we were just text, and yet nothing like an image to clarify a description (describe the fauna and flora without image!) Or just to enhance the reading.
Which image?
Before placing an image on a page of EncyclopAtys, it must have been downloaded beforehand. We strongly advise, before going further, to re-read the EncyclopAtys:General warnings and http://atys.wiki.ryzom.com/wiki/Terms_of_Use
Where to find the pictures?
The images are stored in the COMMON wiki (common to all wikis: French, German etc) :
- list with recent on top of page http://atys.wiki.ryzom.com/w/index.php?limit=500&ilsearch=&user=&title=Special%3AListFiles Nice if you uploaded your images (then add your name in the Username filed)
- or using an array, with most common categories atys:Main_Page (manual array)
- an other test can be used atys:User:Craftjenn/Main page - it's a dynamic one, with help
How to put a personal picture
I found or made an image that I want to insert in an EncyclopAtys article. (Warning: the image must be under a free license like the GFDL. )
To import the image, you have to choose from the menu Tools the command Import a file" and follow the instructions.
Click on "Browse" to choose the image that is on your machine, it can be useful to indicate keywords and category in Summary; validate at the bottom in click "Unload file" (wait for the sending of the image on the servers of Atys).
The image has been sent (we no longer see the instructions for help with insertion). However, it must now be inserted into the wiki code (copy the exact name of the file, eg "File: Barreswiki.png" go to the next step).
The images are hosted in the Common (URL address that how in atys: https://atys.wiki.ryzom.com/wiki/Home). More on Tips for categorizing an Image.
Inserting an image, wiki code
To insert an image, just write: [[file:Name of the picture | thumb | where | size | alt=Textual Alternative | Legend]]. For example, to display the 2 images of this paragraph, write:
[[file:Dummy.png|thumb|right|alt=A strange sphere, ex thumb right|The emblem of the ASA, ex thumb right]]
[[file:Dummy.png|64px|alt=A strange sphere, ex 64|The emblem of the ASA, ex 64]]
where the Name of the picture is preceded by the prefix «file:». The other parameters are optional.
Galleries
If we have several images, we can use the "file gallery" (on the toolbar in edit mode of the wiki, the icon just to the right of "Insert").
This makes it easier to read/edit the wiki code because it adds gallery tags; thus, each image will be on a line (in the wiki code), with a simple syntax: filename.jpg the "vertical bar" (AltGr + 6) and a description:
More on Writing Guide/Image gallery.
Images and links
- Link on image: pour (image reduced to 50px), the code is [[File:Atysmap.jpg|50px|link=Atys/Dynamic map]] where Atys/Dynamic map is link's target.
- If the image is hosted on the common wiki, in order to make See in big, the code is [[:atys:File:Atysmap.jpg|See in big]].
- To add a link towards an image category on the common, ex: The Common's Wiki category groups together wiki help images, use the code [[:atys:Category:Wiki|The Common's Wiki category]]
- To add links according to the zones of an image (see this example), map generation on the web:
Source : https://www.mediawiki.org/wiki/Help:Images#Link_behavior
Links
There are several kinds of possible links in a MediaWiki document. Here is the list:
- internal link as User Manual
Note that the letters attached to this type of link unite to form a single word: flyners. We can of course rename to adapt to the context: planiant plant ...
- link to a title User Manual#Web Applications or on title (same page) Gallery's title on this page
- external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use the website ballistic mistix .
- And the reference which is a link to a note [2] at the bottom of the page, as can be seen on this line.
- Links to other wikis (interwiki links): add the language before, such for common User work images, or to the French version of this guide: fr:Guide de rédaction.
Here is the wiki code:
* internal link as [[User Manual]]
Note that the letters attached to this type of link unite to form a single word: [[flyner]]s.
We can of course rename to adapt to the context: [[flyner|planiant plant]] ...
* link to a title [[User Manual#Web Applications]] or on title (same page) [[#Galleries|Gallery's title on this page]]
* external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use [https://ballisticmystix.net the website ballistic mystix] .
* And the reference which is a link to a note <ref>example of note</ref> at the bottom of the page, as can be seen on this line.
* Links to other wikis (interwiki links): add the language before, such for common [[:atys:Category:User work|User work images]], or to the French version of this guide: [[:fr:Guide de rédaction]].
And if you see the following message at the bottom of your page, do not worry, we'll see that right away...
A trick is to create a template to have a navigation bar in the page (an example here, with this template). For the anchor at the top of the page, use the code <div id="Top"></div>
To link to a wiki page on an other wiki, see Help:Interwiki.
Other tips
About History (just after the Edit tab), a basic functionality of wikis: https://en.wikipedia.org/wiki/Help:Page_history
citation, poems...
- "quote tags" <q> blblbl </q>. The enclosed text will appear with an italic serif font withi appropriate quote (language dependant) characters. An example:
blblbl
- "poem tags" is a wiki extension. <poem> Looooooooooooooooooooooooooooooong text or not so long </poem> will display:
Looooooooooooooooooooooooooooooong text or not so long
- The Poem extension allows easy formatting of poems and similar material within Wikitext. Once the extension is enabled, you can put any block of text within <poem></poem> tags, which has the following effects:
- All newlines are preserved by converting them into <br /> tags
- The block of text is enclosed in <p>...</p> tags (as well as a div of class "poem")
- Colons at the beginning of a line are converted into 1 em indentation
- Spaces at the beginning of a line are preserved and no longer invoke the <pre> tag (a must to have paragraph indentation)
- The extension preserves wikilinks, bolding, etc. if they are present in the poem.
- "center tags" anything between these tags will be centered to the page <center> blblbl </center>.
- Note that floating images or tables reduce page size, thus the {{clear}} template is often useful to force text to appear under an image.
- Note also that you may need to add a couple of cente tags if a new line breaks it. It isn't necessary if you use only
to separate different lines.
- emdash space (ALTGR then -, or U+2212 U+0020) is useful, often combined with quote tags to separate the sentences of in dialogs. Ex: blakjhd -
Examples: The_Kitin_Song, Tears_of_Serenity, A_Flyner_EscapeUseful links (Special pages)
- 🇬🇧 changes 🇩🇪 DE changes 🇫🇷 FR changes and common's changes
Pages too long can be an issue IG
Note: long/heavy page is an issue, if user read wiki from the game, as the game browser is limited in memory (for ex, User Manual :( Therefore, for some pages, it would be better to check IG if they are fully displayed.
- 🇬🇧 https://en.wiki.ryzom.com/wiki/Special:LongPages 🇫🇷 https://fr.wiki.ryzom.com/wiki/Sp%C3%A9cial%3APages_longues
- for EN it's, in Feb 2020:
- (hist) User Manual [87,963 bytes]
- (hist) Paul C. R. Monk – Bloomtree [75,959 bytes]
- Story of a Young Fyros [61,565 bytes]
- (hist) Categorization [60,455 bytes] -> not an issue as it's NOT for helping homins but for wiki contributors
- (hist) Chapter II - Vigils in the Marauder Camp [58,750 bytes]
IG, the Lore don't comes from here (but from an other tool, and through a service who cut some html/css code). The game's internal browser has a very limited memory (css issues too). User Manual v3 can't be read IG because it's too long and too big. The User Manual, faq and help should be quite light. The wikis are quite bad on a cell phone too...
A solution: use titles, and below the title, create a sub page.
- More on Help:Transclusion (about partial transclusion tags noinclude, includeonly and onlyincude, and template for the wiki In Game too).
Sorted array
An ex: fr:Emotes
{|cellspacing="0" cellpadding="5" border="1" style="text-align:left;" class="sortable" |-bgcolor="#eee" style="color:black;" !Titre col 1 !Titre col 2 !Titre col 3 |- |}
And to finish
You want to save your page. Wait a sec! Sure it's finish? Don't forget the final touch.
Notes
At the end of an article you will often find the following information, including the famous <references/> which indicates where to display the notes you created with the <ref>...</ref> seen above.
==References==
===See as well===
*[Somewhere on the web...]
*[[Or in this encyclopedia...]]
===Remarks===
*Specialists in : [[PC]], [[NPC]]
*... : ...
===Sources===
*{{Source
|Langue=[[:Category:Ja|]]
|Auteur=[[user:Rajaaar|]] and [[user:Zorroargh|Zo'ro Argh]]
|Perso=PC
|Guilde=[[Guilde:Hoodo|]]
|Site=Registre Des Guildes (Ryzom Community Forum-Aniro)
|Date=JY 2557
|Page=Hoodo, les chercheurs de Symbiose
|URL=http://atys.ryzom.com/start/app_forum.php?page=topic/view/8293
}}
*{{Source
|Auteur=Derry O'Darren
|Perso=chroniqueur tryker
|Site=Les chroniques d'Atys
|Date=vers 2486 (JY)
|Page=Chronique relatant un épisode de la vie de Rosen Ba'Darins
|URL=http://atys.ryzom.com/projects/pubfr/wiki/C_EvasionEnFlyner
}}
===Notes===
<references/>
Courtesy
An encyclopedia aims above all to synthesize all fields of knowledge (Atys). To achieve this, the articles are inspired from various sources. Beyond the encyclopedic aspect and the weaving of the Web, which recommends citing the sources, there is also the elegance of the recognition of the work of an author.
Preview and save
Previewing is also a form of courtesy. It not only makes it possible to verify that everything is correct before validating, but also to avoid that the modification histories fill up unnecessarily. Of course, Jena will not throw you into the hands of Kamis, or they will plunge you into the Goo if after validating your backup you find that you have missed some errors.
Note: if you get the message (which appears often, because wikis don't like people changing the same page too often - it's not related to the capacity of your PCs or the quality of your connection to the web), save the page again - and you're done!
Sorry! We could not process your edit due to a loss of session data. You might have been logged out. Please verify that you're still logged in and try again. If it still does not work, try logging out and logging back in, and check that your browser allows cookies from this site.
Importance
If this is the case, you then have to check the Minor modification button. This allows you to correct an article, make intermediate changes, etc. Because of this, you can hide minor changes when you make a search for changes. Think of the administrators!
Signature
Lastly, this is not where you will have to do it, but since this is the last word in this paragraph and it's very important when writing to someone or in the article-related discussion page, type always as an end point: ~~~~.
This serves as a dated signature, which is additionally a link to your personal page.
To add a link on this wiki to your RC adress, the wiki code is [https://chat.ryzom.com/direct/YourName YourName on RC] or using an image [[File:RClogo211905.png|Private message on RC|link=https://chat.ryzom.com/direct/YourName]]
Very useful for wiki translators:- explanation of the inter-wiki signing issue, for example... Let's say my profile is on the English wiki (User:MyName).
- If, on a page of the French wiki (or other language, such DE, ES, RU), I use my signature (with the code 16:10, 3 March 2020 (CET))...
- it will put a link on the discussion page of the profile User:MyName, which is on the English wiki
- Then there are two cases:
- either I don't have a profile created on the French wiki, and the talk link will be red (the page doesn't exist)
- either I created a profile on the French wiki (talk link in blue) - but I wouldn't be notified on the English wiki, if I usually don't go much on the French wiki. So, I'll have to think about checking the 2 (or more) talk pages regularly :(
- There are several solutions: Zo's one and Craftjenn's one. The simplest is to use RC and that's what is presented here.
- On the top right of the screen: Preferences, (1st tab where we arrive), part Signature :
- "New signature": CraftJenn, Ranger of the Circle of the Wood of Almati ( [https://chat.ryzom.com/direct/Craftjenn on RC] )
- check "Treat the signature as wikittext (no automatic link)".
The art of writing an article
A wiki is a collaborative work with many hands and everyone knows that there are as many ideas as homins. Also, it is advisable to write as much as possible according to the "Principle of least surprise", that is to say that the reader finds the same schemas from one page to the other despite the fact that it was written by different homins.
MediaWiki offers several tools and default behavior. For example, as soon as you have 4 titles, a summary is automatically generated above the second title of the page (the title of the page itself, level 1, being the first).
Schemas and templates : about navigation toolbars, templates... To update and translate from French.
OOC: Out of character
You know the minimum to get by. Of course you will have to search stuffs. This will look like the work of Surveys of Mission Raw Materials which will be more and more valuable. There is one last point you will not find elsewhere: "How to elegantly introduce OOC in roleplay (RP) articles?"
Dates and time
Please use the Atysian dates. More on Time and there's a tool to convert dates on https://ryzom.kervala.net/time.php?shard=atys
⇒ in notes
In the roleplay text, the Atysian date Holeth, Winderly 24, 1st AC 2603 [3]
The code is
'''Holeth, Winderly 24, 1st AC 2603''' <ref>OOC: 2019-04-15</ref> and will be displayed down page as↑ OOC: 2019-04-15
⇒ in the text
For a longer explanatory note, you can create an OOC paragraph at the end of the article that looks like this paragraph.
{{OOC|short comment|Some quite long text}}
will NOT give the colored section: it seems this Template don't exists
⇒ in a tabbed page
As in APageRPandOOC
Categorise your OOC pages
This category doesn't exists in the English wiki. Thanks to use for spoilers Category:Mysteries
Portals
Portals contain topics and often tabs. In general, the portal and the sub-pages and headings are locked at prime access to avoid accidental (even malicious) changes. The source of the portal then often has two parts, quite small since everything is outside the portal. Thus, if we take the matis portal, we see at the top, the tabs code and at the bottom the code of the rubrics.
Of course, we could have changed the order of the tabs. When correcting (or creating) tabs, care must be taken to copy the complete tab structure in each of them to remain visually consistent. And to correct the different pages designated by the tabs, it will go directly to the page indicated by the URL. The simplest is to click on the title indicated on the tab.
topics
More for reasons of elegance than of protection (for that it is enough to change the rights of writing), the headings are not editable from the edit link which accompanies each title.
This is a title whose content is editable by clicking on the associated link... [edit]
If you don't want to see the "
[edit]
" link, just add in the page "__NOEDITSECTION__
".Often, for the same reasons, we do not want to see tables of matter to embed themselves in the page: add "
__NOTOC__
".But if you want to change the content of these pages, how can you do so since there is no link?
Here's my tip:
The pages that appear in the structures of a portal are of this type:
<!-- ==============LIGHT ON ================ --> !{{ContentBox |title= {{3DText|group=tryker|3D=inset|text=General presentation}}<!-- default=Spotlight on}}--> |palette=tryker |image= Tryker emblem.png<!-- default=Zor emblem.png--> |content= {{:Tryker}} <!--{{:Featured article/Tryker}}
To work on Featured article/Tryker, I copy somewhere in my personal page "
{{Featured article/Tryker}}
" then I change the braces in hooks and, as braces are for templates in mediaWiki, prefix with template, it should gives "[[Template:Featured article/Tryker]]
" - this is the link I will use to change the Tryker page (and then the Tryker portal).And after...
Above all, what to do then if you come across the case or a page exists with another title. For example, you wanted to write Corsair but The Corsairs already exists. Well, this has been planned in the MediaWiki: you can redirect a page to an other one: write in the page Corsaire (that you wanted to create)
#REDIRECT [[The Corsairs]]
You are now ready not only to write, but also to modify the existing one. And that's not always easy either. You can usually add the flourishes that have been taught above especially at least one category (the good), links, references ... They are often forgotten by the editors of passage. Making small corrections is always welcome but sometimes if the content seems to you wrong it is better to start discussing when possible with the author or in the article's discussion page. Otherwise, it may happen that the writing of the article is transformed in PvP.
For translation codes, and translating on wiki, see WikiTrad-EN.
Templates
Template is for repetitive stuff. For example, a navigation bar on several pages: create Template:My_Nav (with the links) and use with {{My_nav}} on pages (each time you change Template:My_Nav, all page who have code {{My_nav}} will use the last updated Template:My_Nav).
See for ex Category:Navigation_templates
If you create your own Templates, thanks to add the category [[Category:User Templates]]. To get an idea of some examples: Category:User Templates
Links
- official help https://www.mediawiki.org/wiki/Help:Contents
A selection of official links
For users
- Mediawiki help:
- Wikipedia:
- Advanced:
- Mediawiki wiki :
- Mediawiki wiki : Extension:ImageMap
- Wikipedia : Help:Wikitext
- Monobook editing shortcuts Wikipedia : Wikipedia:Keyboard shortcuts
- Inter-languages and interwiki links: (see Special:Interwiki for local variations)
rename and move
advanced stuff
- Mediawiki wiki : Help:Namespaces
- Mediawiki wiki : Help:Templates , Metawiki : Help:Template and Wikipedia : Help:Template
- Wikibooks : MediaWiki Administrator's Handbook
- https://techblog.wikimedia.org/
- Mediawiki wiki : Manual:Administrators
- Mediawiki wiki : Manual:External editors External Editors on MediaWiki for an advanced editing technique
Other useful links:- https://regex101.com/
- Mediawiki wiki : Manual:Pywikibot and User:Amosys/Pywiki (for tests)
Last version 2023-10-18•ᐒ - The Poem extension allows easy formatting of poems and similar material within Wikitext. Once the extension is enabled, you can put any block of text within <poem></poem> tags, which has the following effects: