Help:Editing
Aide en Français
Principes généraux d'édition
- Chaque modification sauvegardée est conservée dans l'historique de la page correspondante. (Pour voir ce qu'est l'historique d'une page, cliquez sur l'onglet "history" de la présente page, vous verrez son historique.) Cela vous permet de récupérer l'état passé de la page en cas d'erreur d'un éditeur.
- Si deux personnes modifient une page en même temps, cela ne pose pas de problème: le wiki vous le signale au moment de la sauvegarde.
- Utilisez la fonction "Show preview" pour prévisualiser vos modifications. C'est mieux que de faire une multitude d'enregistrement successifs (qui encombrent l'historique). Mais n'oubliez pas de sauvegarder à la fin!
- Prenez l'habitude de remplir le champ "Summary" quand vous faites une modification importante: cela permet au webmestre de surveiller plus facilement l'historique des modifications pour savoir ce qui se passe.
- Si vous faites une modification mineure, par exemple si vous corrigez une coquille ou ajoutez un point, cochez la case "This is a minor edit": de cette façon, la modification n'apparaît pas dans l'historique de ceux qui surveille la page, ce qui en rend la lecture plus facile.
- De préférence, donnez des noms simples mais explicites à vos pages, par exemple GroupeLecture_2008_ExistentialismeParachutisme plutôt que Existentialisme_et_Parachutisme ou ParEx2008.
- Vous pouvez faire des essais de syntaxe wiki dans le Bac à Sable.
- Vous pouvez signer vos contributions en écrivant quatre tildes: ~~~~, ou plus simplement en utilisant le bouton "signature" du cadre d'édition.
Faire des essais, copier les pages déjà faites
Une façon d'apprendre la syntaxe est de regarder comment sont faites des pages déjà existantes, voire de copier/coller leur contenu. Par exemple, vous pouvez cliquer sur l'onglet "edit" de la présente page pour voir comment elle est codée en syntaxe wiki.
Faites vos essais de syntaxe wiki dans le Bac à sable.
A propos de la syntaxe wiki
Qu'est-ce que la syntaxe wiki?
Pour mettre en forme le contenu, le wiki utilise une syntaxe particulière: la "syntaxe wiki".
Un exemple: une astérisque au début d'une ligne est affichée comme une puce (bullet). Dans la page d'édition, vous écrivez:
* Première chose à savoir
Après sauvegarde cela apparaîtra dans la page comme:
- Première chose à savoir
Avantages de la syntaxe wiki
La syntaxe wiki permet d'introduire du gras, de l'italique, des titres, des liens hypertexte, des images, etc. tout en restant lisible par rapport à du HTML standard. Par exemple, en HTML standard l'exemple précédent serait encodé comme suit:
<ul>
<li>Première chose à savoir</li>
</ul>
L'avantage de la syntaxe wiki par rapport à l'HTML est encore plus clair pour les liens. Par exemple, pour créer un lien vers le bac à sable j'écris:
* [[Sandbox|Bac à sable]]
Ce qui donne:
Alors qu'en HTML standard il faudrait écrire:
<ul>
<li><a href="index.php/Sandbox">Bac à sable</a></li>
</ul>
Est-ce que je dois apprendre la syntaxe wiki?
Non, ce n'est pas nécessaire. L'éditeur vous propose une barre d'outils pour les fonctions les plus courantes (gras, italique, lien interne, lien externe, titre, signature). Ils vous suffiront à éditer des pages simples.
Leur fonctionnement est simple. Pour le gras, l'italique et les titre, sélectionner le texte concerné, et cliquez sur le bouton. Pour les liens, cliquer sur le bouton (lien externe ou lien interne), et remplacer "link title" par le nom de la page, et (dans le cas des liens externes) http://www.exemple.com par l'adresse à laquelle vous voulez renvoyer.
Notez aussi qu'il faut laisser une ligne vide pour commencer un nouveau paragraphe.
Et surtout ne commencez jamais une ligne par un espace! Elle apparaîtra comme du code informatique, comme la ligne ci-dessous:
Ligne commençant par un espace qui est affichée comme du code.
Est-ce que j'ai intérêt à apprendre la syntaxe wiki?
Oui, c'est facile et utile.
La syntaxe wiki est très facile à apprendre, il suffit de retenir quelques codes: voir ci-dessous.
Elle accélèrera votre édition des pages. Elle vous donne aussi accès à des fonctionnalités de mise en forme avancée, comme mettre [entre crochets] sans que cela créée un lien, ou avoir un lien interne dont le titre diffère du titre de la page (par exemple page d'aide plutôt que Help:Contents).
Vous pourrez la réutiliser pour éditer Wikipédia, ou pour faire votre page web à l'aide d'un wiki (comme Roberto Casati par exemple), ou un blog. La plupart des blogs et des moteurs wiki utilisent une syntaxe wiki proche de celle utilisée ici (celle de MediaWiki et Wikipédia).
Je vous conseille de l'apprendre au fur et à mesure, en regardant d'abord comment marchent les boutons et en revenant régulièrement à cette page.
Bases de la syntaxe wiki
Faire des titres
On commence habituellement les titres à partir du niveau 2. Le niveau 1 est réservé au titre de la page.
Pour faire un titre de niveau 2, entourez le titre de deux signes "=":
== Titre de niveau 2 ==
Pour les niveaux inférieurs, on ajoute des signes "=":
=== Titre de niveau 3 === ==== Titre de niveau 4 ====
Il est bon d'utiliser les formats de titres, parce que le wiki les utilise pour générer automatiquement un sommaire pour la page.
Gras, italique
Deux apostrophes pour l'italique, trois pour le gras:
Voici ''l'italique''
s'affiche:
Voici l'italique.
Et voici '''le gras'''
s'affiche:
Et voici le gras.
Liens externes
Les liens externes sont des liens hypertexte qui renvoient à des pages hors du wiki, y compris les pages du département.
La façon la plus simple est de mettre simplement l'adresse précédée de http://:
http://www.unige.ch/
s'affiche:
Pour leur donner un titre différent de l'adresse, il faut utiliser les crochets simples: [ ]. Il faut mettre un crochet ouvrant, puis l'adresse (http:// inclus), puis un espace, puis le titre qu'on veut donner au lien, et mettre un crochet fermant. Par exemple:
[http://www.unige.ch/ Site de l'Université de Genève]
s'affiche:
Site de l'Université de Genève
Liens internes
Les liens internes sont les liens hypertexte qui renvoient à d'autres pages du wiki. Ils sont marqués par des doubles crochets: [[ ]]. Par exemple:
[[Main Page]]
s'affiche:
et renvoie à la page d'accueil.
Pour faire un lien dont le titre diffère du nom de la page auquel il renvoie, on utilise la barre verticale. L'adresse vient avant le titre. Ainsi:
[[Sandbox|Bac à sable]]
s'affiche:
et renvoie à la page intitulée Sandbox.
Mettre du texte entre crochets sans qu'il soit transformé en lien
Il faut utiliser les balises <nowiki>, qui désactivent la syntaxe wiki sur une portion de texte. Par exemple:
Ce <nowiki>[mot]</nowiki> est entre crochets.
S'affiche:
Ce [mot] est entre crochets.
N'oubliez pas de "fermer" la balise, comme on ferme une parenthèse: c'est à dire qu'à chaque balise "ouvrante" <nowiki> doit correspondre une balise "fermante" </nowiki>
Souligné, exposant et indice, texte barré, etc.
Pour ces fonctions avancés il suffit d'utiliser les codes HTML correspondants. Voir le détail sur Wikipédia. Quelques exemples:
Pour du texte barré, on utilise la balise <del>:
<del>Ceci était une erreur</del>
s'affiche:
Ceci était une erreur
Pour le texte souligé, la balise <u>:
je <u>souligne</u> ce que j'écris.
s'affiche:
je souligne ce que j'écris.
On utilise pareillement <sup> et <sub> pour les exposants et indices.
Voir d'autres possibilités encore sur Wikipédia. En général, évitez de changer la couleur, la taille ou la fonte de caractères à la main.
Comment classer une page dans une catégorie?
Ajouter à la fin de la page:
[[Category:Reading_group]] [[Category:2010]]
Utiliser des underscores (_) plutôt que des espaces.
Comment ajouter des fichiers à une page?
Vous pouvez ajouter des fichiers à une page. Plus précisément, vous pouvez télécharger un fichier (image, texte, pdf, présentation powerpoint) et créer des liens vers celui-ci sur n'importe quelle page. Voici comment faire.
Créez un lien vers le fichier à ajouter
Créez d'abord un lien vers le fichier qui sera ajouté. Par exemple, supposons que je veuille ajouter un fichier qui se nommera Programme_ParachutismeExistentialisme_2008.pdf. (Choisissez un nom bien spécifique, voir la remarque à ce sujet ci-dessous.) Je dois faire précéder son nom par "Media:" pour indiquer au wiki qu'il s'agit d'un fichier et non d'une page normale, soit:
[[Media:Programme_ParachutismeExistentialisme_2008.pdf]]
(C'est un lien interne au wiki, donc double crochets). Le résultat est:
Media:Programme_ParachutismeExistentialisme_2008.pdf
Ou mieux, si je veux plutôt faire apparaître autre chose que le nom du fichier:
Vous pouvez télécharger le [[Media:Programme_ParachutismeExistentialisme_2008.pdf|programme du colloque]].
qui donne:
Vous pouvez télécharger le programme du colloque.
Sauvegardez la page.
Téléchargez le fichier
Une fois la page sauvegardée, le lien créé apparaît d'abord en rouge. Cliquez dessus: le wiki vous propose de télécharger un fichier. (Vous pouvez essayer les liens rouges ci-dessus pour voir à quoi le formulaire ressemble, mais prière de ne pas télécharger de fichier!)
Avec "Parcourir" vous pouvez choisir le fichier désiré sur votre ordinateur (source filename).
Le "nom de destination" (destination filename) est déjà rempli. C'est le nom que le fichier aura sur le wiki, il doit correspondre à celui que vous avez mis dans le lien (par exemple, Programme_ParachutismeExistentialisme_2008.pdf).
Dans Summary, mettez une indication sur ce qu'est le fichier. Cela nous aidera à nettoyer le wiki d'ici quelques années!
Cliquez "upload", et le fichier sera téléchargé.
(Si le message d'erreur "... is not a recommended image file format." apparaît, voir ci-dessous la section à ce sujet.)
Au besoin, créez d'autres liens vers le fichier
Vous pouvez ensuite revenir à la page que vous éditiez: le lien apparaît en bleu, et si vous cliquez dessus vous arrivez sur le fichier téléchargé.
Vous pouvez créer d'autres liens vers le fichier sur cette page ou d'autres pages, toujours de la forme Media: suivi du nom du fichier. Exemples:
[[Media:Programme_ParachutismeExistentialisme_2008.pdf]] [[Media:Programme_ParachutismeExistentialisme_2008.pdf|programme du colloque]].
qui donnent:
Media:Programme_ParachutismeExistentialisme_2008.pdf programme du colloque
Choisissez bien le nom du fichier!
Tous les fichiers du wiki sont mis dans un répertoire commun, que vous pouvez voir ici. Il faut donc éviter de leur donner des noms trop généraux, qui conduiraient à tout mélanger, du type "abstract.doc" ou "article.pdf".
Notez que vous pouvez choisir le fichier au moment du téléchargement, inutile de renommer votre fichier sur votre ordinateur.
Message d'erreur: "XXX is not a recommended image file format."
Le wiki est configuré pour n'accepter qu'un nombre limité de types de fichiers. Les principaux types utiles sont couverts (.doc<code>, <code>.pdf<code>, etc.) Si votre fichier est <code>.html<code> <code>.htm<code> ou <code>.php<code>, c'est normal: pour des raisons de sécurité, le wiki ne peut pas les accepter. Vous devez les transformer en fichier Word ou autre, ou les copier/coller dans le wiki lui-même.
Si votre fichier est d'un autre type, il est probable qu'il ait été oublié: contactez le [User:WebmestrePhilo|webmestre] pour qu'il ajuste la configuration. (Prière de joindre le fichier concerné.)
Comment ajouter des images à une page?
Pour ajouter des images, suivez exactement la même procédure que pour ajouter un fichier en général. Il existe en outre quelques fonctionnalités spécifiques aux images:
Fonctions spéciales pour les images (taille, miniatures etc)
Voir la page sur les images du manuel MediaWiki.
Comment faire des tableaux?
On peut faire des tableaux en wiki. Voir la page sur les tableaux du manuel de MediaWiki.
External links for further info - Liens externes pour plus d'informations
- MediaWiki manual, main page for editors (english).
- manuel MediaWiki manual, page principale pour les éditeurs (français).
- Advanced editing sur le manuel de MediaWiki.
- Aide détaillée sur la syntaxe wiki dans le manuel de MediaWiki.
- Tableau récapitualif sur la mise en forme du manuel de MediaWiki (français).
- Reference table on formatting on the MediaWiki manual (english).
