« Aide:Comment éditer une page » : différence entre les versions
(44 versions intermédiaires par 7 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
= Introduction = | = Introduction = | ||
D'abord, la référence en matière de consignes d'édition : la [http://meta.wikimedia.org/wiki/MediaWiki_User's_Guide:_Editing_overview | D'abord, la référence en matière de consignes d'édition : la [http://meta.wikimedia.org/wiki/MediaWiki_User's_Guide:_Editing_overview page de wikimedia], et sa [http://meta.wikimedia.org/wiki/Aide:Édition traduction francaise]. Il existe par ailleurs une liste de [http://meta.wikimedia.org/wiki/Aide:Mots_magiques mots magiques] permettant d'insérer un texte variable et/ou dépendant du contexte. | ||
= Les spécificités de Léa = | = Les spécificités de Léa = | ||
une | == 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'' == | |||
=== Syntaxe === | |||
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 === | |||
{| border='1' | |||
! Syntaxe wiki !! Résultat | |||
|- | |||
|<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 multi>un code sur une ligne</code> | |||
|- | |||
|<nowiki><code multi></nowiki>code | |||
sur | |||
plusieurs | |||
lignes (bien entendu tapé sur plusieurs) | |||
<nowiki></code></nowiki> | |||
|<code>code | |||
sur | sur | ||
plusieurs | plusieurs | ||
lignes (bien entendu tapé sur plusieurs) | lignes (bien entendu tapé sur plusieurs) | ||
</code> | </code> | ||
* | |} | ||
* | |||
== Balise ''key'' == | |||
=== Syntaxe === | |||
Dans la mesure du possible, les touches de fonctions etc. doivent être entourées des balises <nowiki><key>Touche</key></nowiki>. | |||
=== Exemple === | |||
{| border='1' | |||
! Syntaxe wiki !! Résultat | |||
|- | |||
|<nowiki><key></nowiki>CTRL+X<nowiki></key></nowiki> | |||
|<key>CTRL+X</key> | |||
|- | |||
|<nowiki><key></nowiki>CTRL X<nowiki></key></nowiki> | |||
|<key>CTRL X</key> | |||
|} | |||
<div class="aparte">Vous pouvez constater que le tag sépare les touches séparées par "+"</div> | |||
== Auteur == | |||
=== Proposition à discuter : voir page discussion === | |||
Les anciens tags <nowiki><div class='leapar'>auteur</div></nowiki> 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 : <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>{{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 === | |||
* 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.''' | |||
{{Copy|2005|Lea-linux.org|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>.
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 :
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 :
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
|
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> |
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
Ce document est publié sous licence Creative Commons Attribution, Partage à l'identique 4.0 : https://creativecommons.org/licenses/by-sa/4.0/ |