LSL Editing Primer/fr
LSL Portail Francophone | LSL Portail Anglophone | Fonctions | Évènements | Types | Operateurs | Constantes | Contrôle d'exécution | Bibliothèque | Tutoriels |
Le portail LSL du wiki propose plusieurs « templates » utilisés pour standardiser les rendus et faciliter l’édition.
Les principaux templates
Il existe plusieurs templates généraux, les plus utilisés ont un nom court afin de faciliter leur saisie.
Name | Description | example |
---|---|---|
{{LSLC|catégorie|tri}} | Ajoute une page au groupe “catégorie” et la tri alphabétiquement en fonction de la valeur de « tri ». A utiliser à la place de [[Category:LSL nom|tri]] La zone ‘tri’ est optionnelle. |
{{LSLC/fr|Math}} ajoutera la page à la catégorie Math/fr |
{{LSLGC|catégorie|texte}} | Créé un lien vers la catégorie, le lien apparaît avec le contenu de la zone ‘texte’
A utiliser à la place de [[:Category:LSL nom|texte]] . |
{{LSLGC|Math/3D|Fonction math 3D}} Fonction math 3D {{LSLGC|Math}} Math {{LSLGC/fr|Math}} |
{{HoverText|mot|description}} | Quand vous déplacez votre souris au dessus du ‘mot’, vous faites apparaître une boite avec la description. | {{HoverText|Singe|une espèce de mammifère}} Singe |
{{LSL_Header}} | Ce template est utilisé dans les pages dont les templates n’y font pas déjà appel.
Dans le cadre des pages traduites en français, ce template est devenu {{LSL_Header/fr}} . Ce template inclu des éléments généraux (par exemple les liens fonction/constantes/etc. en haut de page) |
{{LSL Header}} |
{{LSL_Hex|hex|int}} | Ce template fait apparaître une boite d’information lorsque vous passez la souris sur le texte ‘hex’ (correspondant à une valeur hexadécimale) et renvoie la valeur int avec une courte description. Si la valeur int est omise, elle est calculée à partir de ‘hex’
Ce template n’a pas été traduit en français (pour le moment en tout cas) |
{{LSL Hex/fr|0x100|256}} 0x100 {{LSL Hex/fr|0x100}} 0x100 |
{{!}} | | (barre verticale) dans les cas il faut les encapsuler dans les paramètres d’un template. < br/>
Ce template n’a pas été traduit en français. |
{{!}} | |
{{=}} | Utilisé à la place des = dans les cas il faut les encapsuler dans les paramètres d’un template.. | {{=}} = |
Création de tables dans le wiki
Une des grandes faiblesses de la technologie MediaWiki réside dans la difficulté à convertir une table en paramètre compatible avec un template. Il existe plusieurs méthodes de création.
- Ecrivez la table en HTML en utilisant les balises using <table> & </table>, <tr> & </tr>, <th> & </th>, <td> & </td>. Si vous souhaitez employer cette méthode, il est important de bien fermer ses balises (des balises mal fermées peuvent faire réagir étrangement Mediawiki)
- Appliquez la syntaxe MediaWiki pour les tableaux et replacez les '|' qui ne doivent pas être considérés comme des séparateurs par des '{{!}}'
- Encadrez la section avec les balises <div></div> (ne marche pas toujours).
- Vous pouvez être amené à devoir utiliser des espaces ‘ ‘ afin d’obtenir l’affichage recherché avec Mediawiki.
Avant | Aprés | Encapsulé | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{|{{Prettytable/fr}} ! Droits ! Valeurs ! Descriptionss |- | [[PERM_ALL]] | {{LSL Hex/fr|0x7FFFFFFF|2147483647}} | Droit de Déplacer/Modifier/Copier/Transférer |- | [[PERM_COPY]] | {{LSL Hex/fr|0x00008000|32768}} | Droit de Copier |- | [[PERM_MODIFY]] | {{LSL Hex/fr|0x00004000|16384}} | Droit de Modifier |- | [[PERM_MOVE]] | {{LSL Hex/fr|0x00080000|524288}} | Droit de déplacer |- | [[PERM_TRANSFER]] | {{LSL Hex/fr|0x00002000|8192}} | Droit de tansférer |} |
<table {{Prettytable/fr}}><tr> <th> Droits</th> <th> Valeurs</th> <th> Descriptions</th> </tr><tr> <td> [[PERM_ALL]]</td> <td> {{LSL Hex/fr|0x7FFFFFFF|2147483647}}</td> <td> Droit de Déplacer/Modifier/Copier/Transférer </td> </tr><tr> <td> [[PERM_COPY]]</td> <td> {{LSL Hex/fr|0x00008000|32768}}</td> <td> Droit de Copier</td> </tr><tr> <td> [[PERM_MODIFY]]</td> <td> {{LSL Hex/fr|0x00004000|16384}}</td> <td> Droit de Modifier</td> </tr><tr> <td> [[PERM_MOVE]]</td> <td> {{LSL Hex/fr|0x00080000|524288}}</td> <td> Droit de Déplacer</td> </tr><tr> <td> [[PERM_TRANSFER]]</td> <td> {{LSL Hex/fr|0x00002000|8192}}</td> <td> Droit deTransférer</td> </tr></table> |
Tableau dans un tableau:
Tableau comme parametre d’un template:
|
Avant | Aprés | Encapsulé | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{|{{Prettytable/fr}} ! Droits ! Valeurs ! Descriptionss |- | [[PERM_ALL]] | {{LSL Hex/fr|0x7FFFFFFF|2147483647}} | Droit de Déplacer/Modifier/Copier/Transférer |- | [[PERM_COPY]] | {{LSL Hex/fr|0x00008000|32768}} | Droit de Copier |- | [[PERM_MODIFY]] | {{LSL Hex/fr|0x00004000|16384}} | Droit de Modifier |- | [[PERM_MOVE]] | {{LSL Hex/fr|0x00080000|524288}} | Droit de Déplacer |- | [[PERM_TRANSFER]] | {{LSL Hex/fr|0x00002000|8192}} | Droit deTransférer |} |
{{{!}}{{Prettytable/fr}} ! Droits ! Valeurs ! Descriptionss {{!}}- {{!}} [[PERM_ALL]] {{!}} {{LSL Hex/fr|0x7FFFFFFF|2147483647}} {{!}} Droit de Déplacer/Modifier/Copier/Transférer {{!}}- {{!}} [[PERM_COPY]] {{!}} {{LSL Hex/fr|0x00008000|32768}} {{!}} Droit de Copier {{!}}- {{!}} [[PERM_MODIFY]] {{!}} {{LSL Hex/fr|0x00004000|16384}} {{!}} Droit de Modifier {{!}}- {{!}} [[PERM_MOVE]] {{!}} {{LSL Hex/fr|0x00080000|524288}} {{!}} Droit de Déplacer {{!}}- {{!}} [[PERM_TRANSFER]] {{!}} {{LSL Hex/fr|0x00002000|8192}} {{!}} Droit deTransférer {{!}}} |
Tableau dans un tableau:
Tableau comme paramètre d’un template :
|
Avant | Après | Encapsulé | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{|{{Prettytable/fr}} ! Droits ! Valeurs ! Descriptionss |- | [[PERM_ALL]] | {{LSL Hex/fr|0x7FFFFFFF|2147483647}} | Droit de Déplacer/Modifier/Copier/Tansférer |- | [[PERM_COPY]] | {{LSL Hex/fr|0x00008000|32768}} | Droit de Copier |- | [[PERM_MODIFY]] | {{LSL Hex/fr|0x00004000|16384}} | Droit de Modifier |- | [[PERM_MOVE]] | {{LSL Hex/fr|0x00080000|524288}} | Droit de Déplacer |- | [[PERM_TRANSFER]] | {{LSL Hex/fr|0x00002000|8192}} | Droit deTransférer |} |
<div> {|{{Prettytable/fr}} ! Droits ! Valeurs ! Descriptions |- | [[PERM_ALL]] | {{LSL Hex/fr|0x7FFFFFFF|2147483647}} | Droit de Déplacer/Modifier/Copier/Tansférer |- | [[PERM_COPY]] | {{LSL Hex/fr|0x00008000|32768}} | Droit de Copier |- | [[PERM_MODIFY]] | {{LSL Hex/fr|0x00004000|16384}} | Droit de Modifier |- | [[PERM_MOVE]] | {{LSL Hex/fr|0x00080000|524288}} | Droit de Déplacer |- | [[PERM_TRANSFER]] | {{LSL Hex/fr|0x00002000|8192}} | Droit deTransférer |} </div> |
Tableau dans un tableau:
|
Fonctions
A part le template principal, il y a un seul template dédié aux fonctions.
Dans le cadre de la traduction en français, un template LSL function/fr a été créée.
Template:LSL Function/fr
Ce template, basé sur le template Template:LSL Function propose une structure afin de documenter des fonctions en français. Il propose plusieurs sections :
- S’il vous plait, ne supprimer pas de sections du template
- L’ordre des sections n’a pas d’importance.
- Si une section n’est pas configurée, elle sera le plus souvent masquée dans le rendu final (mais toutes les sections ne se masquent pas forcément).
- Une section qui n’est pas utilisée, n’a pas besoin d’être indiquée dans le template de la fonction mais le mieux est cependant de la conserver afin de faciliter le travail des futurs éditeurs.
- S’il vous plait mettez les section en tête du template (cela facilitera les ajouts futurs).
- Si vous pensez qu’une section devrait être ajoutée, ajoutez la à LSL Function Style/fr (elle devrait être alors rapidement ajoutée au template).
Consultez LSL_Function/fr pour obtenir une explication détaillée de sa syntaxe et de ses attributs.
Base | Example: llFrand |
---|---|
{{LSL_Function |func |func_id |func_sleep |sort |func_desc |func_footnote |return_type |return_text |p1_type|p1_name|p1_desc |p2_type|p2_name|p2_desc |p3_type|p3_name|p3_desc |p4_type|p4_name|p4_desc |p5_type|p5_name|p5_desc |p6_type|p6_name|p6_desc |p7_type|p7_name|p7_desc |p8_type|p8_name|p8_desc |p9_type|p9_name|p9_desc |p10_type|p10_name|p10_desc |p11_type|p11_name|p11_desc |p12_type|p12_name|p12_desc |constants |spec |caveats |examples |helpers |also_header |also_functions |also_tests |also_articles |also_events |also_footer |notes |mode |deprecated |permission |negative_index |cat1 |cat2 |cat3 |cat4 |cat5 |cat6 |location }} |
{{LSL_Function |sort=Frand |func=llFrand |func_id=8 |func_sleep=0.0 |func_energy=10.0 |p1_type=float |p1_name=mag |p1_desc=N’importe quell float valide |return_type=float |return_text=correspondant à un nombre pseudo aléatoire dans le périmètre [0.0,mag) or (mag, 0.0]. |spec=Renvoie un nombre pseudo aléatoire dans la périmètre [0.0, mag) ou (mag, 0.0], selon le signe de mag. |caveats=Le générateur aléatoire n’est pas une source d’entropie. |examples=<lsl> default { touch_start(integer total_number) { // Quand l’objet est touché, il dit “Tête” avec une probabilité de50%, // Sinon, il dit “queue” if ( llFrand(1.) < .5) llSay(0, "Tête"); else llSay(0, "queue"); } } </lsl> |helpers |also_header |also_functions |also_tests |also_events |also_articles |also_footer |notes= Le générateur n’est pas une source d’entropie La séquence des nombres aléatoires dépend du process dans son ensemble et n’est pas générée isolément. Cependant le générateur n’est pas compatible avec une application qui nécessiterai des résultats prévisible ou complètement imprévisible. |cat1=Math |cat2 |cat3 |cat4 }} |
Evènement
En dehors des template généraux, il existe uniquement un template dédié aux évènements : LSL_Event Dans le cadre de la traduction en français, un template LSL_Event/fr a été créée. Ce template propose une structure pour écrire une documentation relative aux évènements. Les sections non utilisées sont habituellement masquées. Consultez LSL_Event pour avoir une explication détaillée de son contenu.
Constantes
Il y a un template dédié à la gestion des constantes : LSL_Constant Dans le cadre de la traduction, ce template a été traduit en LSL_Constant/fr Ce template propose une structure pour écrire une documentation relative aux constantes utilisées. Il propose plusieurs sections. Les sections non utilisées sont masquées. Consultez LSL_Constant pour avoir une explication détaillée de son contenu.