Syntaxe wiki
Guide pratique
les Utilisateur·rices
Pour pouvoir créer des pages et les modifier sur une plateforme wiki, il faut avoir un compte.
Pour cela un·e des étudiant·es ou une·e professeur·e doit vous inviter via cette page.
Dans le code, cette page se nomme "Spécial:Créer un compte", car elle fait partie des pages spéciales auxquelles les utilisateurs peuvent accéder et qui permettent une série d'actions sur le site comme par exemple visualiser l'ensemble des pages, des fichiers, des catégories, voir les modifications récentes, ajouter une image ou un fichier...
Dans tous les wikis il y a différents groupes d'Utilisateurs (j'utilise la majuscule car elle a son importance, voir plus loin) qui possèdes différents "privilèges".
- les Utilisateurs anonymes: peuvent uniquement lire les pages
- les Utilisateurs enregistrés: peuvent lire, modifier et créer des pages
- les administrateurs: peuvent en plus effacer des pages, modérer et placer les Utilisateurs dans différents groupes etc.
Modifier une page
Dans un wiki il y un mode lecture et un mode écriture que vous pouvez activer via l'onglet "modification" en haut à droite de chaque page
Dans le mode écriture vous pouvez créer de nouvelles pages ou modifier des existantes.
Lorsque vous modifiez une page vous pouvez contrôler son apperçu avant de l'enregister via le bouton Prévisualiser qui se trouve en bas de la page de modification tout en gardant votre fenêtre d'écriture active en dessous.
Une fois que vous avez terminé, vous sauvez les changements via le bouton Enregistrer.
Créer une page
La structure d'un Wiki s'organise essentiellement en pages. C'est une structure horizontale qui ne fait pas de distinction hiérarchique ou formelle entre les différentes pages. Tout est page, également votre page compte Utilisateur, une Catégorie... C'est la force de ce réseau de pages et des liens que l'on tisse entre elles qui créer l'intérêt et la richesse des contenus.
Pour créer une page: Il y a plusieurs moyens pour créer une page:
- Chercher dans le champ de recherche si elle existe, et le cas échéant dans l'absence de résultat accepter la proposition "Créer la page" en cliquant sur le nom de page qui est affiché en rouge
- Créer un lien vers une page inexistante à partir de d'une autre page. De cette façon la page sera déjà liée à quelqu'un (si vous la créer dans votre compte Utilisateur) ou à un contenu existant si cela est pertinent. Lier une page à une autre est en quelque sorte la meilleure façon de la retrouver par la suite, surtout quand le wiki commence à se constituer d'une centaine — voir plus — de pages.
La syntaxe pour créer une page (ou un lien) est d'entourer de double crocher le [[nom de votre page]].
- Suivez le lien vers cet espace encore inexsitant et ajouter votre contenu (indice: il est rouge)
- Enregistrez la page lorsque vous avez finalisé sa création. NB: vous pouvez laisser temporairement la page vide et la compléter par la suite mais le lien ne sera plus rouge (bleu) ce qui peut être compliqué par la suite pour les retrouver. Le rouge indique la création potentielle d'une page. Un état "entre" deux. Le "peut-être" de l'édition. Ainsi on peut à partir d'un wiki créer un réseau de pages, une structure sémantique bien avant d'y avoir intégré un contenu. Cela peut être un exercice intéressant à faire à partir de votre page Utilisateur:
Pour résumer:
- lien rouge = page inexistante.
- lein bleu = page existante.
DESIGN NUMERIQUE - une page existante
Serveurs féministes - une page en devenir... (ou inexistante ;-))
Structurer l'information
Si vous regardez dans le mode "modification" l'introduction de cette page vous y verrez déjà une série d'éléments syntaxiques dont voici un petit récapitulatif.
Créer différents niveaux de titres en utilisant le signe "=" comme ceci:
Premier niveau
=Votre 1er titre=
NB: le premier niveau est celui du nom de la page, on ne le répète en général pas!
Second niveau
==Votre 2e titre==
Troisième niveau
===Votre 3e titre===
Vous pouvez placer votre texte en dessous de chacun de ces niveaux qui constituent une table des matières dans le haut de la page.
Mise en forme
La syntaxe wiki est très simple et est résumée par une série de styles et de fonctionnalités dans la barre de supérieure de la fenêtre d'écriture.
Vous pouvez aussi l'intégrer vous même lorsque vous écrivez, elle est très simple à retenir, voir en détail ici
Vous pouvez par ailleurs insérer des balises html et les styler, comme par exemple ceci:
- Changer le style de paragraphe:
<p style="text-align:center; font-size:30px;"> VOTRE PARAGRAPHE
- Changer la couleur des textes ou leur fond:
<span style="color:#58D68D; background:#0E6655;"> VOTRE TEXTE </span>
Upload d'images ou de fichier
Pour uploader des fichiers (images, pdf...) sur le wiki il y a plusieurs façons:
Créer une page fichier à partir de la page dans laquelle vous souhaiteriez l'insérer
- Fichier:Nouvelle image.jpg
- Enregistrer la page
- Cliquer sur le lien rouge
- Suivre les instructions de téléchargement
Les formats autorisés sur ce wiki sont: png, gif, jpg, jpeg, webp, pdf
Uploader directement un fichier via la page de téléchargement des images: Spécial:Téléverser (se trouve dans la barre de navigation principale gauche sous l'intitulé "Importer un fichier"
Pour ajouter une légende directement à votre fichier, ajouter une barre verticale (pipe) comme ceci:
[[File:newimage.png|Caption under the image]]
Pour formater la mise en page des images dans la page: https://www.mediawiki.org/wiki/Help:Images/fr
Transclusion
The inclusion of the content of a document into another document by reference is generally called transclusion. In a wiki context, it is the use of the template functionality of MediaWiki to include the same content in multiple documents without having to edit those documents separately.
<noinclude></noinclude> — text between tags will only appear on the page itself, not on the page it's transcluded
<includeonly></includeonly> — text between tags will only appear then where the page is transcluded, not on the page itself
<onlyinclude></onlyinclude> — only the text between these tags will be shown where the page is transcluded, but it also shows on the page itself. It can override the other tags.
{{:Pagename}}— used when transcluding a page from the main namespace
{{User:Username}} — when transcluding a user page
More info: https://www.mediawiki.org/wiki/Transclusion
Magic words
Magic words are strings of text that are often used to specify desired omissions and/or inclusions in the content of a wiki page.
| Word | Description |
|---|---|
| __NOTITLE__ | Hides the title of the page. |
| __NOTOC__ | Hides the table of contents (TOC). |
More info: https://www.mediawiki.org/wiki/Help:Magic_words
Cheatsheet
''italics''
'''bold'''
'''''bold and italics'''''
==standard header==
===next-level header=== (...and so on)
[[Internal link]]
[[Internal link|alternate text]]
[http://example.com text of external link]
[[Category:Example]] (category tag)
[[:Category:Example]] (link to category)
---- (horizontal line)
* bulleted item
# numbered item
:indentation
::double indentation (...and so on)
[[File:Image-name.jpg|thumb|frame|Caption text]]
{{:Transcluded page name}}
#REDIRECT [[Page name]]
__NOTITLE__
