« Aide:Comment éditer une page » : différence entre les versions

De Lea Linux
Aller à la navigation Aller à la recherche
m (→‎Syntaxe : ortho, style, typo)
 
(28 versions intermédiaires par 5 utilisateurs non affichées)
Ligne 3 : Ligne 3 :


= Les spécificités de Léa =
= Les spécificités de Léa =
== Modération a priori ==
Le wiki de Léa est modéré a priori. Cela signifie que tout le monde peut modifier une page mais que les modification ne sont visibles qu'après avoir été validées par un modérateur.
C'est pénible, mais nous n'avons pas assez de relecteurs pour nous permettre de supprimer cette phase de modération.
Donc, en cours de rédaction d'article si vous voulez voir comment seront prises en compte vos modification, vous devez utiliser la prévisualisation.
== Aperçu rapide ==
Nous avons installé sur le wiki de Léa l'[http://en.wikipedia.org/wiki/User:Pilaf/Live_Preview aperçu rapide] développé par [http://en.wikipedia.org/wiki/User:Pilaf 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>[[Image:aide-edition-apercu.png]]</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>[[Image:aide-edition-apercu-2.png]]</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 <code>frame</code> dans la balise d'image (par exemple : <nowiki>[[Image:nomd'image.png|frame]]</nowiki>) mais cette option a l'énorme défaut de mettre l'image dans un cadre ayant l'option CSS <code>float:left|right</code>. Pour éviter cela, nous avons mis en place une balise <code><border></code> à l'intérieur de laquelle les images (et uniquement les images) ont un cadre.
=== Syntaxe ===
<code>
<border>[[Image:nomd'image.png]]</border>
</code>
=== Exemple : ===
<code>
<border>[[Image:Flag-fr.png]]</border>
</code>
donne :  <border>[[Image:Flag-fr.png]]</border>
au lieu de : [[Image:Flag-fr.png]]
<cadre>'''Note :'''  si vous mettez autre chose que des images dans la balise <nowiki><border></nowiki>, les enrichissements habituels auront lieu.
</cadre>
== Balise ''cadre'' ==
Pour mettre un cadre autour d'un paragraphe, utilisez la balise <code><cadre></code>.
=== Syntaxe ===
<code>
<cadre type=aparte|note|warning|alert>Texte à mettre dans un paragraphe encadré</cadre>
</code>
=== Exemples ===
* <code>type=aparte</code> <cadre type=aparte>Texte à mettre dans un paragraphe encadré</cadre>
* <code>type=note</code> (le type par défaut) <cadre type=note>Texte à mettre dans un paragraphe encadré</cadre>
* <code>type=warning</code> <cadre type=warning>Texte à mettre dans un paragraphe encadré</cadre>
* <code>type=alert</code> <cadre type=alert>Texte à mettre dans un paragraphe encadré</cadre>
'''Note :''' l'utilisation de la balise <code><cadre></code> est strictement équivalente à celle de <code><div class="aparte|note|warning"></code>.


== Balise ''code'' ==
== Balise ''code'' ==
Ligne 9 : Ligne 65 :


Dans la mesure du possible, tout code (script, ligne de commande, etc.) devrait être entouré des balises <nowiki><code>le texte du code en question</code></nowiki>.
Dans la mesure du possible, tout code (script, ligne de commande, etc.) devrait être entouré des balises <nowiki><code>le texte du code en question</code></nowiki>.
<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 ===
=== Exemples ===
Ligne 17 : Ligne 74 :
|<nowiki><code>un code sur une ligne</code></nowiki> || <code>un code sur une ligne</code>
|<nowiki><code>un code sur une ligne</code></nowiki> || <code>un code sur une ligne</code>
|-
|-
|<nowiki><code></nowiki>code
|<nowiki><code>un code sur une ligne</code></nowiki> || <code multi>un code sur une ligne</code>
|-
|<nowiki><code multi></nowiki>code
   sur
   sur
     plusieurs
     plusieurs
Ligne 46 : Ligne 105 :
|<key>CTRL X</key>
|<key>CTRL X</key>
|}
|}
<div class="aparte">Vous pouvez constater que le tag sépare les touches séparées par "+"</div>


== Auteur ==
== Auteur ==
Ligne 60 : Ligne 120 :


Chaque article du Wiki '''a''' une licence :
Chaque article du Wiki '''a''' une licence :
* soit elle est précisée par une balise : <nowiki>{{TAGLICENCE}}</nowiki> ''en fin'' de document (voir la page [[Lea_Linux:Copyright|copyright]] pour la liste des licences acceptées),
* soit elle est précisée par une balise : <nowiki>{{Copy|année|auteur|TAGLICENCE}}</nowiki> ''en fin'' de document (voir la page [[Lea_Linux:Copyright|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 <nowiki>{{CC-BY-SA}}</nowiki> n'est pas présent sur une telle documentation, il peut être ajouté par n'importe qui. Aucune autre balise de licence ne peut être mise sur une documentation de Léa par une personne autre que l'auteur original. Sinon, il faut créer un autre document.
* 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 <nowiki>{{Copy|année|auteur|CC-BY-SA}}</nowiki> 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 : <nowiki>{{Copy|2005|Lea-linux.org|CC-BY-SA}}</nowiki>. Ce qui termine le document par :
 
=== Recommandation ===


= Copyright =
* 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
{{Copy|2005|Lea-linux.org|CC-BY-SA}}
{{CC-BY-SA}}

Dernière version du 18 septembre 2008 à 21:13

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

Modération a priori

Le wiki de Léa est modéré a priori. Cela signifie que tout le monde peut modifier une page mais que les modification ne sont visibles qu'après avoir été validées par un modérateur.

C'est pénible, mais nous n'avons pas assez de relecteurs pour nous permettre de supprimer cette phase de modération.

Donc, en cours de rédaction d'article si vous voulez voir comment seront prises en compte vos modification, vous devez utiliser la prévisualisation.

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/