Syntaxe wiki

De Design numérique
Révision datée du 21 octobre 2022 à 10:47 par Alexia (discussion | contributions) (Catégories)
Aller à : navigation, rechercher

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 aperçu avant de l’enregistrer 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:

  1. 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
  2. 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]].

  1. Suivez le lien vers cet espace encore inexistant et ajouter votre contenu (indice: il est rouge)
  2. 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.
  • lien bleu = page existante.

exemples:

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

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

Catégories

L'usage de catégories permet de regrouper des pages et de créer des corpus de pages. Cela permet également de les retrouver plus facilement, par exemple via la catégorie "22-23" pour les pages créées lors de l'année scolaire en cours.

Pour ajouter une page ou un fichier dans une catégorie, modifiez simplement la page dans laquelle vous voudrier la voir apparaître et ajoutez le texte suivant : [[Catégorie:Nom]]
Ici j'ajoute la page à la catégorie "Mediawiki" Catégorie:Mediawiki car elle concerne l'outil.
On retrouve les catégorie dans lesquelles sont classées les pages en dessous de chaque page.

Plus d'info sur les catégories et leur hiérarchisation: https://www.mediawiki.org/wiki/Help:Categories/fr

Transclusion

L'inclusion du contenu d'une page dans une autre page par référence est appelée transclusion. Dans un contexte wiki, c'est l'utilisation de la fonctionnalité de template de MediaWiki qui permet d'inclure le même contenu dans plusieurs pages sans avoir à éditer ces pages séparément.

<noinclude></noinclude> - le texte entre les balises n'apparaîtra que sur la page elle-même, pas sur la page qu'il transclut.

<includeonly></includeonly> - le texte entre les balises n'apparaîtra alors que là où la page est transcluse, pas sur la page elle-même.

<onlyinclude></onlyinclude> - seul le texte entre ces balises sera affiché à l'endroit où la page est incluse, mais il sera également affiché sur la page elle-même. Il peut remplacer les autres balises.

{{:Pagename}}- utilisé lors de la transclusion d'une page.

{{User:Username}} - lors de la transclusion d'une page utilisateur.

Plus d'informations : https://www.mediawiki.org/wiki/Transclusion/fr


Mots magiques

Les mots magiques sont des chaînes de texte qui sont souvent utilisées pour spécifier les omissions et/ou les inclusions souhaitées dans le contenu d'une page wiki.

Word Description
__NOTITLE__ cache le titre de la page (alors n'oubliez pas de rajouter un niveau 1 de titre pour votre titre principal (peut aider dans le cas d'éditions print ou si le titre diffère du nom de la page (voir aussi les redirections).
__NOTOC__ cache la table des matières (TOC).

Plus d'informations: https://www.mediawiki.org/wiki/Help:Magic_words/fr

Aide mémoire

''italique'' 
 
 '''bold''' 
 
 '''''bold et italique''''' 
 
 ==titre standard== 
 
 ===niveau suivant de titre=== (...et ainsi de suite) 
 
 [[Lien interne]] 
 
 [[Lien interne|texte alternatif]] 
 
 [http://example.com lien externe et son titre] 
 
 [[Catégorie:Exemple]] (le tag vers la catégorie) 
 
 [[:Catégorie:Exemple]] (le lien vers la catégorie) 
 
 ---- (horizontal line) 
 
 * liste à puce 
 
 # liste numérotée
 
 :indentation 
 
 ::double indentation (...et ainsi de suite) 
 
 [[File:Image-name.jpg|thumb|frame|légende de l'image]] (formater l'affichage d'image en vignette)
 
 {{:le nom de la page transcluse}} 
 
 #REDIRECT [[Page name]] Rediriger vers le nom d'une autre page