Aide:Comment éditer une page

De Lea Linux
Aller à la navigation Aller à la recherche

Introduction

D'abord, la référence en matière de consignes d'édition : la page de wikimedia, et sa traduction francaise. Il existe par ailleurs une liste de mots magiques permettant d'insérer un texte variable et/ou dépendant du contexte.

Les spécificités de Léa

Aperçu rapide

Nous avons installé sur le wiki de Léa l'aperçu rapide développé par Pilaf.

L'aperçu rapide d'une page que vous êtes en train d'éditer s'obtient, après avoir activé javascript dans votre navigateur, en cliquant sur le bouton <key>Aperçu rapide</key>.

<border></border>

C'est beaucoup plus rapide (ça ne passe pas par le serveur de Léa) que l'utilisation du bouton <key>Prévisualisation</key> mais moins précis. En effet certain enrichissement de médiawiki ne sont pas pris en compte et certains bugs existent. Néanmoins on peut obtenir un rendu correct. De plus, autre avantage, l'aperçu rapide peut être caché d'un simple clic.

Par exemple :

<border></border>

N'hésitez pas à l'utiliser de préférence à la prévisualisation standard.

Balise border

Si vous souhaiter mettre un cadre autour d'une image, médiawiki prévoit l'utilisation de l'option frame dans la balise d'image (par exemple : [[Image:nomd'image.png|frame]]) mais cette option a l'énorme défaut de mettre l'image dans un cadre ayant l'option CSS float:left|right. Pour éviter cela, nous avons mis en place une balise <border> à l'intérieur de laquelle les images (et uniquement les images) ont un cadre.

Syntaxe

<border>Fichier:Nomd'image.png</border>

Exemple :

<border></border>

donne : <border></border>

au lieu de : 

<cadre>Note : si vous mettez autre chose que des images dans la balise <border>, les enrichissements habituels auront lieu. </cadre>

Balise cadre

Pour mettre un cadre autour d'un paragraphe, utilisez la balise <cadre>.

Syntaxe

<cadre type=aparte|note|warning|alert>Texte à mettre dans un paragraphe encadré</cadre>

Exemples

  • type=aparte <cadre type=aparte>Texte à mettre dans un paragraphe encadré</cadre>
  • type=note (le type par défaut) <cadre type=note>Texte à mettre dans un paragraphe encadré</cadre>
  • type=warning <cadre type=warning>Texte à mettre dans un paragraphe encadré</cadre>
  • type=alert <cadre type=alert>Texte à mettre dans un paragraphe encadré</cadre>

Note : l'utilisation de la balise <cadre> est strictement équivalente à celle de

.

Balise code

Syntaxe

Dans la mesure du possible, tout code (script, ligne de commande, etc.) devrait être entouré des balises <code>le texte du code en question</code>. <cadre type=alert>La première version de cette balise nécessitait l'option « multi » pour les morceaux de code sur plusieurs lignes : ce n'est plus le cas.</cadre>

Exemples

Syntaxe wiki Résultat
<code>un code sur une ligne</code> un code sur une ligne
<code>un code sur une ligne</code> un code sur une ligne
<code multi>code
 sur
   plusieurs
      lignes (bien entendu tapé sur plusieurs)

</code>

code
 sur
   plusieurs
      lignes (bien entendu tapé sur plusieurs)

Balise key

Syntaxe

Dans la mesure du possible, les touches de fonctions etc. doivent être entourées des balises <key>Touche</key>.

Exemple

Syntaxe wiki Résultat
<key>CTRL+X</key> <key>CTRL+X</key>
<key>CTRL X</key> <key>CTRL X</key>
Vous pouvez constater que le tag sépare les touches séparées par "+"

Auteur

Proposition à discuter : voir page discussion

Les anciens tags <div class='leapar'>auteur</div> sont remplacés par un section = Copyright= qui contient les différents auteurs. Ne sont considérés comme auteurs que les gens qui ont significativement modifié une section (plus que de simples corrections typographique, orthographique ou de mise en page).

Ceci est bien entendu à faire en priorité sur les anciens articles.

Si un article est une modification/traduction d'un article se trouvant ailleurs, indiquer dans cette section = Copyright = l'url du document original ou de référence est un minimum.

Licence

Chaque article du Wiki a une licence :

  • soit elle est précisée par une balise : {{Copy|année|auteur|TAGLICENCE}} en fin de document (voir la page copyright pour la liste des licences acceptées),
  • soit elle n'est pas précisée et elle est alors implicitement sous licence Creative Common, Attribution, Partage à l'identique 2.0. Si la balise {{Copy|année|auteur|CC-BY-SA}} n'est pas présente sur une telle documentation, elle peut être ajoutée par n'importe qui mais en respectant l'auteur original. Aucune autre balise de licence ne peut être mise sur une documentation de Léa par une personne autre que l'auteur original.

L'objectif de ceci est de protéger même les auteurs négligeant. La restriction, c'est que rien n'est publié sur Léa sous le régimes des droits d'auteurs simplement : il y a toujours une licence. C'est contraignant, mais nécessaire pour autoriser à modifier les documents publiés sur Léa tout en garantissant correctement les droits des auteurs.

Exemple

Par exemple sur ce document, il y a la balise : {{Copy|2005|Lea-linux.org|CC-BY-SA}}. Ce qui termine le document par :

Recommandation

  • Pour des raisons d'uniformités, Léa préférerait que toute nouvelle documentation soit publiée sous la licence CC-BY-SA
  • Léa souhaitant défendre une vision libre (dans un sens comparable à celui de logiciel libre), la licence CC-BY-SA-NC n'étant pas une licence libre (empéchant certaines utilisations), nous décourageons fortement l'utilisation de cette licence. Nous nous réservons le droit, dans un avenir proche de refuser toute nouvelle documentation sous cette licence.

Copyright

© 2005 Lea-linux.org

Creative Commons License
Creative Commons Attribution iconCreative Commons Share Alike icon
Ce document est publié sous licence Creative Commons
Attribution, Partage à l'identique 4.0 :
https://creativecommons.org/licenses/by-sa/4.0/