Du Libre de l'Art et du Rock & Roll !
Un Wiki en Markdown simple à mettre en place
Un Wiki en Markdown simple à mettre en place

Un Wiki en Markdown simple à mettre en place

MDwiki le wiki ultra light

Je vous en ai déjà parlé ici j’aime beaucoup le Markdown et il y à quelque temps, j’ai découvert MDwiki, c’est super léger, simple et efficace !

MDwiki est un CMS/Wiki entièrement construit en HTML5/Javascript ou aucune installation de logiciel spécial ou traitement côté serveur n’est requise.

Comme j’aime les trucs light et sans prise de tête, je l’ai adopté pour créer mon wiki perso, disponible ici

Les besoins :

  • Un espace Web (ou un serveur Web pouvant servir des fichiers statiques)
  • Un navigateur Web moderne
  • Le fichier mdwiki.html

Fonctionnement

Déposez simplement le fichier mdwiki.html disponible sur la page de téléchargement ainsi que vos fichiers .md sur un espace Web. Vous pouvez mettre n’importe quelle URL (relative au fichier mdwiki.html) à MDwiki après le hashbang #! :

http://www.monsite.com/wiki/mdwiki.html#!monfichier.md

Il est conseillé de créer un fichier index.md qui sert de point de départ pour votre wiki lorsqu’aucun paramètre n’est donné, dans ce cas MDwiki récupérera et affichera automatiquement le fichier index.md.

Si vous renommez également le fichier mdwiki.html en index.html, aucun paramètre n’est requis et vous pouvez accéder à votre wiki à l’adresse :

http://www.monsite.com/wiki/

Ajouter un menu de navigation

Créez un fichier navigation.md dans le même répertoire que le mdwiki.html et mettez-y les liens qui composent votre menu :

# Le nom de votre Wiki

[Page 1](page1.md)
[Page 2](page2.md)
[Page 3](page3.md)

La première ligne est un en-tête Markdown, qui sera utilisé comme nom du site Web dans la barre de navigation. Des liens Markdown standard doivent être utilisés pour les entrées de la barre de navigation.

Pour des menus plus complexes, il est également possible d’imbriquer des éléments de sous-menu sous forme de liste et d’utiliser des lignes horizontales qui seront rendues comme des séparateurs :

# Nom du Wiki

[Titre menu 1]()

  * # Sous Menu Titre 1
  * [Sous Menu page 1](page1.md)
  * [Sous Menu page 2](page2.md)
  - - - -
  * # Sous Menu Titre 2
  * [Sous Menu page 3](page3.md)
  - - - -
  * # Sous Menu Titre 3
  * [Sous Menu page 4](page4.md)

[Titre menu 2](page5.md)
- - - -
[Titre menu 3](page6.md)

Si une liste à puces de liens est fournie comme dans l’exemple ci-dessus, la liste deviendra une liste déroulante dans la barre de navigation affichant un sous-menu.
Pour que cela fonctionne, le lien de niveau supérieur doit avoir une cible vide (voir l’élément [Menu 1]() dans l’exemple ci-dessus). Les en-têtes déroulants sont également possibles en ajoutant un # devant.

Ajouter un sélecteur de thème

Il existe un gadget spécial ThemeChooser qui ajoutera une entrée de sous-menu à la barre de navigation avec tous les thèmes disponibles.

Activez-le en ajoutant :

[gimmick:themechooser](Changer le thème)

au fichier navigation.md (ou dans chaque page individuellement).

Sélectionner d’un thème par défaut

Vous pouvez également définir un thème spécifique qui sera utilisé comme thème par défaut.

[gimmick:theme](amelia)

Cela définira le thème par défaut de votre Wiki sur amelia, mais vous aurez tout de même accès à la liste des thèmes dans la barre de navigation pour modifier le thème à votre guise.

Pour appliquer le thème globalement pour tous les fichiers, placez l’entrée dans navigation.md. Vous pouvez également basculer le mode « inverse », qui changera les couleurs de certains thèmes (voir http://www.bootswatch.com/ pour plus de détails)

[gimmick:theme (inverse: true)](flatly)

Documentation complète

La documentation complète (en anglais) est disponible ici et la page de téléchargement de la dernière version de MDwiki ici


💡 Astuce : Gérer votre Wiki avec NextCloud

Si NextCloud est installé sur votre serveur, vous pouvez l’utiliser pour gérer les pages de votre Wiki.

C’est super pratique grâce à l’extension Plain text editor qui vous permettra de modifier en direct vos pages sans passer par un client FTP, d’en créer de nouvelles et de rédiger facilement du Markdown.

Dans les paramètres de NextCloud : Paramètres → Administration → Stockages externes:

  • Nom du dossier : Nom du dossier que vous voulez voir dans NextCloud.
  • Stockage externe : Pour le type de stockage, choisissez Local
  • Authentification : Aucune.
  • Configuration : Entrez le chemin où se trouve votre wiki (ex : https://mondomaine.com/wiki)
  • ⚠️ Attention: Si le chiffrement est activé dans NextCloud, ne pas cocher la case Activer le chiffrement sur ce dossier.

J’espère que cet article vous aura inspiré pour mettre en place facilement votre propre Wiki 😉

Keep on Rocking 🤘‍

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée.