Voir la source de Aide:Outils et astuces pour écrire avec Mediawiki

__TOC__

Voir d'abord les pages d'aide de [http://meta.wikimedia.org/wiki/Help:Help Wikimedia], [http://www.mediawiki.org/wiki/Help:Contents Médiawiki] et [http://fr.wikipedia.org/wiki/Aide:Sommaire Wikipédia]. Comme elles sont complexes, nous en récapitulons ici l'essentiel. Un conseil : quand vous trouvez quelque chose d'intéressant sur une page, notez-en immédiatement l'adresse ; sinon, vous avez toute chance de ne jamais la retrouver, tant l'arborescence des pages est touffue !

Voir une liste des codes HTML reconnus : [https://en.wikipedia.org/wiki/Table_%28HTML%29#Tables HTML element].

== Formatage du texte ==
Nous vous conseillons bien sûr d'utiliser la barre d'outils située juste au-dessus de la fenêtre en mode Modifier, et de compulser les divers manuels d'utilisateur. Mais certains codes ne sont pas faciles à trouver ou à mémoriser. Vous les trouverez ici. Compulsez aussi la page d'aide au [http://www.mediawiki.org/wiki/Help:Formatting formatage] de Mediawiki.

=== Conversion de Word en Mediawiki ===
La meilleure solution semble être de passer par OpenOffice. Pour cela, il faut bien sûr télécharger OpenOffice, puis une extension sun-wiki-publisher.oxt. Le détail est bien décrit sur [http://www.formavia.fr/wiki/index.php/Aide:OpenOffice_et_Mediawiki FormaVia]. Le plus simple est alors d'exporter son fichier en Mediawiki, d'ouvrir ce fichier puis de le copier-coller dans la page cible. On peut ainsi conserver les formatages en italique, gras... 

Il existe aussi des utilitaires qui transforment du Word en HTML. L'HTML est compatible avec Mediawiki, mais le texte est alors encombré de balises inutiles. Consultez l'[http://en.wikipedia.org/wiki/Help:WordToWiki Aide:Word to Wiki] de Wikipédia.

Si vous voulez tester d'autres solutions, jetez un coup d'œil à [http://openwetware.org/wiki/Converting_documents_to_mediawiki_markup Openwetware].

=== Police ===
==== Police à échappement fixe ====

 <nowiki><tt>monospace</tt></nowiki>

donne :

<tt>monospace</tt>

==== Petites capitales ====

<nowiki>{{smallcaps|Texte}}</nowiki> donne :

{{Smallcaps|Texte}}

==== Couleur du texte ====

*Vous pouvez changer la couleur et la taille du texte. 3 est gros, 2 moyen, et 1 petit.

<nowiki><font color=red>texte</font></nowiki> donne :
<font color=red>texte</font>

<nowiki><font color=green>texte</font></nowiki> donne : 
<font color=green>texte</font>

<nowiki><font color=blue>texte</font></nowiki> donne : 
<font color=blue>texte</font>

Au lieu d'entrer les couleurs par leur nom, on peut entrer leur code hexadécimal, ce qui permet d'utiliser toute une palette, comme celle proposée par [http://fr.wikipedia.org/wiki/Aide:Couleurs/table_d%C3%A9taill%C3%A9e Wikipedia]. Une palette plus simple est donnée par [http://meta.wikimedia.org/wiki/Wiki_color_formatting_help Wikimedia].

Par exemple, <nowiki><font color=#901040>texte</font></nowiki> donne
<font color=#901040>texte</font>

Une autre syntaxe est : <nowiki><span style="color:#FFFF00; background:#00C000"> Texte jaune sur fond vert</span></nowiki> qui donne <span style="color:#FFFF00; background:#00C000"> Texte jaune sur fond vert</span>.

==== Taille du texte ====
<nowiki><font color=red size=3>texte</font></nowiki> donne : <font color=red size=3>texte</font>

<nowiki><font color=green size=2>texte</font></nowiki> donne
<font color=green size=2>texte</font>

<nowiki><font color=blue size=1>texte</font></nowiki> donne
<font color=blue size=1>texte</font>

J'ignore pourquoi 1 n'est pas la taille d'un texte ordinaire.

Une autre syntaxe donne size=60%. J'ignore comment cela marche.


''Autre solution''

<nowiki><big>Texte gros</big></nowiki> donne <big>Texte gros</big>

<nowiki><big><big>Texte très gros</big></big></nowiki> donne <big><big>Texte très gros</big></big>

<nowiki><small>Texte petit</small></nowiki> donne <small>Texte petit</small>

<nowiki><small><small>Texte très petit</small></small></nowiki> donne <small><small>Texte très petit</small></small>

==== Retour à la ligne ====
*Si vous voulez forcer un retour de ligne, tapez simplement <nowiki><br></nowiki>. C'est le cas dans les boîtes des modèles.

==== Italique et gras ====
'''''Attention'''''

Si l'on met en italique un mot précédé d'une apostrophe droite, cette apostrophe est interprétée comme faisant partie d'un groupe de trois apostrophes (avec les deux du formatage des italiques), et Mediawiki met en caractères gras tout le texte qui suit jusqu'à ce qu'il trouve un autre groupe de trois apostrophes ; s'il n'en trouve pas, le formatage continue jusqu'à la fin du paragraphe. Pour éviter cela, on peut insérer une espace après la première apostrophe (ce qui ne se voit pas trop), ou mieux, utiliser le guillemet simple fermant, ’. Mais comme Word fait un peu ce qu'il veut, il faut le copier-coller à partir d'un pense-bête qu'on se sera confectionné.

=== Formatage de paragraphe ===
*Par défaut, un paragraphe est aligné à gauche. S'il commence par une espace, il apparaît en police à échappement fixe dans un cadre gris comme ceci :

 texte précédé d'une espace.

==== Texte aligné au centre ====

<nowiki><center>votre texte</center></nowiki>

On peut n'utiliser qu'un seul jeu de balises pour centrer plusieurs paragraphes. Curieusement, cela ne fonctionne pas pour deux paragraphes, auquel cas il faut mettre les jeux de balises à chaque paragraphe.

==== Texte aligné à droite ====

dans la version anglaise:

<nowiki>{{right|votre texte}}</nowiki>

dans la version française:

<nowiki>{{droite|votre texte}}</nowiki>

==== Texte en retrait à gauche ====
Il suffit de commencer la ligne par un ou plusieurs : (deux points).

Ce procédé est le plus simple pour formater un poème :

 <nowiki>
:premier vers
:deuxième vers
:troisième vers
:::Auteur, ''Livre''</nowiki>

donnera

:premier vers
:deuxième vers
:troisième vers
:::Auteur, ''Livre''

==== Texte en retrait à la fois à gauche et à droite ====

S'emploie par exemple pour une citation de longues phrases :

<nowiki><blockquote>''Le radis est cultivé pour ce qu'on appelle la racine, qui est, à proprement parler, la partie inférieure de la tige avec la racine pivotante. On sait à quel point la grosseur, la forme et la couleur de ces organes, qui deviennent charnus, peuvent varier, suivant le terrain et les races cultivées.''<br>
''Il n'y a pas de doute que l'espèce est originaire des régions tempérées de l'ancien monde ; mais, comme elle s'est répandue dans les jardins, depuis les temps historiques les plus reculés, de la Chine et du Japon jusqu'en Europe, et qu'elle se sème fréquemment autour des cultures, il est difficile de préciser son point de départ.'' </blockquote></nowiki>

donne

<blockquote>''Le radis est cultivé pour ce qu'on appelle la racine, qui est, à proprement parler, la partie inférieure de la tige avec la racine pivotante. On sait à quel point la grosseur, la forme et la couleur de ces organes, qui deviennent charnus, peuvent varier, suivant le terrain et les races cultivées.''<br>
''Il n'y a pas de doute que l'espèce est originaire des régions tempérées de l'ancien monde ; mais, comme elle s'est répandue dans les jardins, depuis les temps historiques les plus reculés, de la Chine et du Japon jusqu'en Europe, et qu'elle se sème fréquemment autour des cultures, il est difficile de préciser son point de départ.'' </blockquote>

*Les lignes à l'intérieur d'une citation doivent être séparées par des <nowiki><br></nowiki>.


*Il existe un cas spécial pour les poèmes (non implémenté sur Biowikifarm) :
<blockquote><poem> poème </poem></blockquote>

==== Espace liée ====
<code>&amp;nbsp;</code> (non-breaking space) 


==== Texte qui ne doit pas être interprété par la syntaxe wiki ====

<nowiki><nowiki>votre texte</nowiki></nowiki>


*Pour inclure un texte en mode Modifier, que vous ne voulez pas voir apparaître dans la version Lire :
<nowiki><!-- Note : Ce texte est un commentaire qui n'apparaîtra pas --></nowiki>

(Il apparaît ici parce que je l'ai encadré de balises <nowiki><nowiki></nowiki></nowiki>)

=== Formatage de liste ===
Placer une astérisque au début de chaque élément donne une liste à points.

Placer un dièze au début de chaque élément donne une liste numérotée.

Une deuxième astérisque ou un deuxième dièze crée une indentation de niveau deux, et ainsi de suite.

Si l'on a besoin de sauter un niveau, il suffit d'insérer deux-points.


Une longue liste peut être mise en plusieurs colonnes. Voici un exemple pour trois colonnes :

 <nowiki><div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
*apple
*carpet
*geography
*mountain
*nowhere
*postage
*ragged
*toast
</div></nowiki>

donne :
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
*apple
*carpet
*geography
*mountain
*nowhere
*postage
*ragged
*toast
</div>


Wikipédia a un système qui met les longues listes dans un menu déroulant. voir [http://fr.wikipedia.org/wiki/Shorea Shorea]

=== Ligne horizontale ===

Une ligne horizontale s'insère en tapant quatre tirets. Si vous tapez des tirets supplémentaires, ils sont ignorés.

''Exemple''

 <nowiki>texte au-dessus
----

texte au-dessous</nowiki>

texte au-dessus
----

texte au-dessous

=== Notes et références ===
Dans le texte, à l'emplacement de la note, il faut placer
 <nowiki><ref>texte de la note</ref></nowiki>

Dans la section Notes, on place simplement
 <nowiki><references/></nowiki>

Il faut insérer l'ensemble des deux. On obtient :

<ref>texte de la note</ref>

<references/>

Pour les notes à appel multiple, la syntaxe est
 <nowiki><ref name="name">content</ref></nowiki>
 <nowiki><ref name="name" /></nowiki>


Pour une aide plus détaillée, voir :
*[https://fr.wikipedia.org/wiki/Aide:Note Aide:Note de Wikipédia],
*[https://fr.wikipedia.org/wiki/Aide:Note_%28aide_d%C3%A9taill%C3%A9e%29 Aide:Note (aide détaillée) de Wikipédia],
*[https://en.wikipedia.org/wiki/Help:Footnotes Help:Footnotes de Wikipedia (en)],
*[https://www.mediawiki.org/wiki/Extension:Cite Extension:Cite de Mediawiki] et
*[https://meta.wikimedia.org/wiki/Help:Footnotes Help:Footnotes de Wikimedia].

== Catégories ==
Voir la page [[Aide:Catégories]].

== Modèles ==

*Pour insérer un modèle :

Sans paramètre:

<nowiki>{{NomModèle}}</nowiki>

Avec un seul paramètre :

<nowiki>{{NomModèle|ValeurParamètre}}</nowiki>

Avec plusieurs paramètres :

<nowiki>{{NomModèle
|NomParamètre1=
|NomParamètre2=
}}</nowiki>

Dans ce cas, les paramètres peuvent s'écrire dans un ordre quelconque, mais il est plus clair de les mettre dans le bon ordre et sur des lignes différentes.

=== Pages structurées par un modèle ===

Les modèles complexes sont difficiles à utiliser. Pour faciliter l'écriture, nous avons choisi d'associer un modèle de page à une page exemple (appelée "Nouveau..." ou "Nouvelle..."), qui contient déjà l'appel au modèle avec les noms des paramètres à documenter, et plusieurs autres éléments non contenus dans le modèle. Il suffit alors de copier-coller la page exemple pour créer une nouvelle page.

*Pour créer une page espèce, nous utilisons un robot qui copie le contenu de la page suivante : [[Nouvelle espèce plante à graines]] en ajoutant une série de liens préformatés. 

*Pour créer une page genre, nous faisons de même avec le contenu de la page suivante : [[Nouveau genre plante à graines]].

*Pour créer une page famille, nous faisons de même avec le contenu de la page suivante :  [[Nouvelle famille plante à graines]].

Dans les trois cas, envoyez-nous la liste des noms de taxons à créer (sans noms d'auteurs), de préférence après avoir vérifié qu'ils sont actuellement acceptés.

D'autres pages d'exemples pour d'autres cas seront créées le moment venu.

== Redirections ==
*Voir [https://fr.wikipedia.org/wiki/Aide:Redirection Aide:Redirection] de Wikipédia.

Sur la version française, on peut utiliser l'une des deux syntaxes suivantes : #REDIRECTION[[]] ou #REDIRECT[[]]. Nous préférons cette dernière, qui offre l'avantage d'être copiable facilement dans la version anglaise.

Une page de redirection est utile chaque fois que le mot recherché ne correspond pas au premier mot d'un titre de page. C'est le cas en particulier :
*des noms communs des plantes, quand on peut les renvoyer directement à un nom de genre ou d'espèce ;
*des synonymes des noms scientifiques qui ont changé récemment (depuis moins de vingt ans), et sont donc encore les plus connus ;
*des mots pertinents qui se trouvent loin dans le titre d'une page. Par exemple, [[Arabe]] pour [[Noms des plantes en arabe]].

Attention : il ne peut exister qu'une seule page de redirection pour un mot donné. Quand ce mot peut pointer sur plusieurs autres pages, il vaut mieux le rediriger vers une page qui explique ses différents sens. Par exemple, [[Laurier]], [[Blé]] ou [[Citron]].

== Palette de navigation ==
*Voir [https://fr.wikipedia.org/wiki/Aide:Palette_de_navigation Aide:Palette de navigation] de Wikipédia.

Nous n'en avons pas encore créé (au 17 décembre 2014), mais cela pourrait être utile dans certains cas, par exemple pour montrer la diversité des groupes d'usage et leur structuration.

== Table des matières ==

Une table des matières (en anglais ''table of contents'', TOC) se crée automatiquement dès qu'une page contient au moins quatre sections. Elle se place juste avant le titre de la première section.

Si l'on ne souhaite pas de table des matières, il suffit de taper <nowiki>__NOTOC__</nowiki> n'importe où (de préférence au début).

Si l'on souhaite afficher la table des matières dans tous les cas, taper <nowiki>__FORCETOC__</nowiki>.

Si l'on souhaite que la table des matières apparaisse à un endroit précis (par exemple avant le début du texte introductif), il faut taper <nowiki>__TOC__</nowiki> à l'endroit précis où l'on veut la voir apparaître.
''
''NB. __ représente deux traits de soulignement.

Pour ne faire apparaître que les titres de rang 1 ou 2, il faut utiliser le modèle suivant : <nowiki>{{TOC limite|1}} ou en anglais {{TOC limit|2}}</nowiki>.


On peut aussi créer des tables des matières pour classer de grandes quantités d'éléments par ordre alphabétique.

Pour avoir un simple bandeau avec toutes les lettres de l'alphabet : <nowiki>{{CompactTOC}}</nowiki> en anglais, ou <nowiki>{{Sommaire alphabétique}}</nowiki> en français.

Pour avoir un double bandeau avec toutes les lettres de l'alphabet plus un menu déroulant plus détaillé (permettant de gérer des listes de milliers d'entrées) : <nowiki>{{LargeCategoryTOC}} ou {{TdM longue catégorie}}</nowiki>.

Encore mieux : si vous avez besoin d'une table des matières compacte en grec, en voici la syntaxe (passez en mode Modifier pour la copier) :

{| id="toc" border="0" align="center"
! Sommaire :
| [[#Α|Α]] - [[#Β|Β]] - [[#Γ|Γ]] - [[#Δ|Δ]] - [[#Ε|Ε]] - [[#Ζ|Ζ]] - [[#Η|Η]] - [[#Θ|Θ]] - [[#Ι|Ι]] - [[#Κ|Κ]] - [[#Λ|Λ]] - [[#Μ|Μ]] - [[#Ν|Ν]] - [[#Ξ|Ξ]] - [[#Ο|Ο]] - [[#Π|Π]] - [[#Ρ|Ρ]] - [[#Σ|Σ]] - [[#Τ|Τ]] - [[#Υ|Υ]] - [[#Φ|Φ]] - [[#Χ|Χ]] - [[#Ψ|Ψ]] - [[#Ω|Ω]] __NOTOC__
|}


Ce système permet aussi d'obtenir des sommaires compacts avec n'importe quelle liste trop longue. Par exemple, pour le [[A (Lafage, Côte d'Ivoire)|''Lexique français de Côte d'Ivoire'']], nous avons utilisé :

{| id="toc" border="0" align="center"
! Sommaire :
| [[#abalé|Ab]] - [[#acacia|Ac]] - [[#adjouaba|Ad]] - [[#afambéou|Af]] - [[#agbodjama|Ag]] - [[#ahianana|Ah]] - [[#aïélé|Ai]] - [[#akan|Ak]] - [[#alambi|Al]] - [[#amande|Am]] - [[#anacarde|An]] - [[#aobé|Ao]] - [[#apobéaou|Ap]] - [[#arabica|Ar]] - [[#asân|As]] - [[#atadjon|At]] - [[#aubergine|Au]] - [[#avocat|Av]] - [[#awalé|Aw]] - [[#ayétro|Ay]] - [[#azodau|Az]]
__NOTOC__
|}

== Autres éléments ==
*On utilise habituellement l'apostrophe droite dans un texte. Mais quand cette apostrophe précède un mot en italique, Mediawiki interprète les trois apostrophes comme une balise de début de texte en gras, et met tout en gras jusqu'à ce qu'il trouve trois autres apostrophes, ou à défaut jusqu'à la fin du paragraphe. Pour éviter cela, il faut utiliser un autre caractère pour écrire l'apostrophe, par exemple l'apostrophe oblique : ’.

*Les caractères qui ressemblent à des apostrophes, comme l'arabe translittéré ayin ( ʿ ) et alif ( ʾ ), sont représentés par leur caractère Unicode correct (U+02BF MODIFIER LETTER LEFT HALF RING et U+02BE MODIFIER LETTER RIGHT HALF RING respectivement). Si ce n'est pas faisable, utilisez une apostrophe droite.

*barre verticale : | (shift+alt+L sur Macintosh)

*crochet ouvrant : [ (shift+alt+( sur Macintosh)

*crochet fermant : ] (shift+alt+) sur Macintosh)

Si vous souhaitez signer vos textes (en particulier sur les pages de discussion),
*trois tildes consécutifs ([[Utilisateur:Michel Chauvet|Michel Chauvet]]) insèreront votre nom avec un lien vers votre page d'utilisateur ;
*quatre tildes ([[Utilisateur:Michel Chauvet|Michel Chauvet]] 9 juillet 2012 à 17:25 (CEST)) insèreront ce lien et la date et l'heure d'enregistrement
*cinq tildes (9 juillet 2012 à 17:25 (CEST)) insèreront juste la date et l'heure.

== Astuces ==
Si vous avez de longues listes à formater, il est très fastidieux de le faire manuellement.

Quand on recopie une liste d'un site web, on obtient des mots en divers formats et avec des hyperliens. Les italiques et les gras peuvent s'enlever facilement en une seule opération, et ne seraient de toute façon pas reconnus par Mediawiki. Mais avec Microsoft Word, les hyperliens restent, et doivent être ôtés un par un. Pour les enlever d'un coup, la meilleure solution consiste sous Word à utiliser l'option "collage spécial" et à choisir "texte sans mise en forme".

Si l'on veut obtenir sur le wiki quelque chose comme :
*''[[Zea mays]]''

il faut taper : <nowiki>*''[[Zea mays]]''</nowiki>

On peut le faire automatiquement dans Word. Si les noms d'espèce sont séparés par un retour de paragraphe, il faut sélectionner toute la liste, et demander à Word de remplacer le retour de paragraphe par <nowiki>]]''retour de paragraphe''*[[</nowiki>.

Si Word n'en fait qu'à sa tête et transforme automatiquement les apostrophes normales par des guillemets simples ouvrants et fermants, il vous faudra les changer, par exemple en ouvrant le texte sous un autre traitement de texte (comme TextEdit sur Mac ou OpenOffice).

Pour obtenir quelque chose de plus élaboré, comme

 <nowiki>*[[Aberia-Abutilon (Sturtevant, 1919)|''Aberia-Abutilon'']]</nowiki>
 <nowiki>*[[Acacia (Sturtevant, 1919)|''Acacia'']]</nowiki>

qui donne :

*[[Aberia-Abutilon (Sturtevant, 1919)|''Aberia-Abutilon'']]
*[[Acacia (Sturtevant, 1919)|''Acacia'']]

j'ai trouvé l'astuce suivante :

*préparer une première liste en remplaçant les retours paragraphe par <nowiki>"espace + (Sturtevant, 1919)|'' + retour paragraphe"</nowiki>.
*préparer une deuxième liste en remplaçant les retours paragraphe par "zz + retour paragraphe".
*fusionner les deux listes.
*éliminer tous les retours paragraphe.
*remplacer les zz par <nowiki>"'']] + retour paragraphe + *[["</nowiki>.

Au lieu de fusionner les listes, on peut faire un tableau de chacune, puis coller le deuxième tableau comme deuxième colonne dans le premier tableau. Ensuite, on convertit le tableau en texte, les colonnes étant séparées par des tabulations, et on supprime les tabulations.

Bien sûr, ces astuces ne sont utiles que si vous avez une liste de plus d'un dizaine d'entrées !

On doit pouvoir créer des macros pour ça, mais je ne sais pas comment.

== Troncature de listes ==
Exemple: on veut obtenir une simple liste de noms d'espèces, en éliminant les noms d'auteurs.

La première étape consiste à éliminer les doubles espaces, en demandant à Word de remplacer deux espaces par une seule, et en répétant l'opération jusqu'à ce qu'il y ait 0 remplacement. Il faut aussi vérifier que tous les noms d'espèce sont bien composés de deux mots et deux seuls (tirets dans les épithètes composées, marque d'hybride collée à l'épithète...).

On sélectionne alors la liste et on demande à Word de la transformer en tableau (colonnes séparées par une espace, lignes séparées par un retour paragraphe). Il est alors facile de supprimer toutes les colonnes autres que les deux premières.

== Récupération de textes ==

Certains sites interdisent le copier-coller. On peut contourner ce problème en installant une extension :[https://chrispederick.com/work/web-developer/ Web Developer]. Elle permet de supprimer les styles CSS, et on peut alors tout récupérer.

== Ecriture des hiéroglyphes égyptiens ==
Il existe une extension de Mediawiki [https://www.mediawiki.org/wiki/Extension:WikiHiero WikiHiero].


[[Catégorie:Aide]]

[[en:Help:Tools and tricks to write with Mediawiki]]