LSL Editing Primer/fr

From Second Life Wiki
Jump to navigation Jump to search

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.

Attention dans le cadre de la traduction en français, un template spécifique a été créé. Il vous suffit de faire appel au template LSLC/fr (au lieu du LSLC) pour ajouter la page à la catégorie traduite en français (avec un suffixe en /fr par convention de traduction). < br/>< br/>Ce template ne doit être utilisé que pour les pages en français.

{{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]] .
Si la zone ‘texte’ est omise, alors le lien apparaît simplement avec le nom de la catégorie.

Attention dans le cadre de la traduction en français, un template spécifique a été créé. Il vous suffit de faire appel au template LSLGC/fr (au lieu du LSLGC) pour créer une lien vers la catégorie traduite en français (avec un suffixe en /fr par convention de traduction). Ce template n’est à utiliser bien évidemment que pour les pages en français.

{{LSLGC|Math/3D|Fonction math 3D}}
Fonction math 3D
{{LSLGC|Math}}
Math

{{LSLGC/fr|Math}}
Math
{{LSLGC/fr|Math|Math en fr}}
Math en fr

{{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.

  1. 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)
  2. Appliquez la syntaxe MediaWiki pour les tableaux et replacez les '|' qui ne doivent pas être considérés comme des séparateurs par des '{{!}}'
  3. 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.
HTML Method
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:

Droits Valeurs Descriptions
PERM_ALL 0x7FFFFFFF Droit de Déplacer/Modifier/Copier/Tansférer
PERM_COPY 0x00008000 Droit de Copier
PERM_MODIFY 0x00004000 Droit de Modifier
PERM_MOVE 0x00080000 Droit de Déplacer
PERM_TRANSFER 0x00002000 Droit deTransférer

Tableau comme parametre d’un template:

Permissions Value Description
PERM_ALL 0x7FFFFFFF Droit de Déplacer/Modifier/Copier/Tansférer
PERM_COPY 0x00008000 Droit de Copier
PERM_MODIFY 0x00004000 Droit de Modifier
PERM_MOVE 0x00080000 Droit de Déplacer
PERM_TRANSFER 0x00002000 Droit deTransférer
Pipe Replacement Method
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:

Droits Valeurs Descriptionss
PERM_ALL 0x7FFFFFFF Droit de Déplacer/Modifier/Copier/Tansférer
PERM_COPY 0x00008000 Droit de Copier
PERM_MODIFY 0x00004000 Droit de Modifier
PERM_MOVE 0x00080000 Droit de Déplacer
PERM_TRANSFER 0x00002000 Droit deTransférer

Tableau comme paramètre d’un template :

Droits Valeurs Descriptionss
PERM_ALL 0x7FFFFFFF Droit de Déplacer/Modifier/Copier/Tansférer
PERM_COPY 0x00008000 Droit de Copier
PERM_MODIFY 0x00004000 Droit de Modifier
PERM_MOVE 0x00080000 Droit de Déplacer
PERM_TRANSFER 0x00002000 Droit deTransférer
Div Tag Method (doesn't always work)
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:

Droits Valeurs Descriptions
PERM_ALL 0x7FFFFFFF Droit de Déplacer/Modifier/Copier/Tansférer
PERM_COPY 0x00008000 Droit de Copier
PERM_MODIFY 0x00004000 Droit de Modifier
PERM_MOVE 0x00080000 Droit de Déplacer
PERM_TRANSFER 0x00002000 Droit deTransférer

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.