---
title: Desiderata remplacement Wiki
tags: EPFL, wiki
description:
---

# Desiderata remplacement Wiki

[TOC]

## À propos

Ce document à pour but de lister les fonctionnalités que nous estimons essentielles, importantes et agréables pour l'outil de remplacement de wiki.epfl.ch.

On ne tient pas compte des limitations des systèmes, le but est plutôt de lister explicitement tout ce qui est possible et les fonctionnalités que nous trouvons utiles dans les différents systèmes de wiki (ou proche des wiki) que nous utilisons.

Ce document se veut aussi être une aide à la décision, car les applications d'un système de wiki sont multiples et le remplacement de wiki.epfl.ch ET de confluence crée un appel d'air favorable pour l'amélioration de nos outils. C'est également l'occasion de prendre du recul et de faire le bilan, capitaliser notre expérience.

## Auteurs

Laurent Indermühle et Nicolas Borboën, deux utilisateurs de [Markdown] pour leurs documentations :)

## Cas d'utilisation

- Notes de réunions
- Documentation techniques :
- Explications
- Guides
- Tutoriels
- Références
- Documentation interne
- Documentation publique (en compétition avec KB ServiceNow et inside Wordpress).
Il faut précisier que la documentation a 3 cibles : la DSI, l'EPFL, le monde et qu'il est souhaitable que l'outil permette un choix de cette granularité aux niveaux des accès.
- Agrégateur de liens d'un service (Description du service dans ServiceNow, Dépôts GIT utilisés, ...)
- Planification de projets
- Priorisation de tâches
- TODO listes
- Présentation

## Fonctionnalités

Ceci est une liste de fonctinnalités en vrac, l'idée serait d'organiser un vote pour pouvoir les classer par importance et évtuellement les regrouper en essentielles, importantes et agréables (nice to have).

- Édition concurente ou résolution de conflits
- Édition WYSIWYG
- Code blocks + Syntax Highlights
- Saisie possible en [Markdown]
- Avec Front Matter (https://odetocode.com/blogs/scott/archive/2020/01/30/markdown-front-matter-for-metadata.aspx)
- Export des pages en [Markdown] ou [CommonMark]
- Export des pages en PDF
- Copy & Paste des images
- Version des pages
- Comparaison des versions (diff)
- Mise à jour des liens lors des déplacements de page
- Offline use
- Extensible, par exemple via des plugins pour :
- Création de tables,
- Possibilité de trier les tables,
- Insértion de table de des matières,
-
- Menu automatique et éditable
- Open Source
- Self-Hosted
- Hosté sur k8s / VM Linux
- Gratuit
- Sans vendor-locking
- Le format utilisé facilite l'exportation des données pour une éventuelle migration dans 7 ans
- Le format utilisé facilite l'importation de données existantes (import from another wiki tools)
- Je suis pour ouvrir la doc sans verroux, mais si gestion des permissions alors compatible avec groupes.epfl.ch obligatoire !!
- Les différents espaces et pages doivent pouvoir être partagés à des groupes d'utilisateurs (e.g. LDAP)
- Partie publique / privée
- Doit permettre le partage de page ou de namespace à d'autre unité de l'EPFL, y compris dans les facultés
- Fourni une API
- Abonnement aux modifications d'une page/namespace par mail
- Flux RSS
- Fait correctement le travail entre français et anglais
- TODO lists
- Date de validiter des pages et revalidation avant archivage automatique
- Espace d'archive
- Génération de diagram (gant, mermaid, PlantUML, MathML, etc.)
- Commentaires
- Recherche dans une page / namespace / partout / par auteur / par groupe / etc.
- Rapide (léger, édition possible depuis un Laptop)
- Dark Mode
- Gestion des liens cassés
- Mentions et notfications emails
- Intégrations ? todoist, jira, ...
- Racourcis claviers
- Version mobile Android, iOS
- Export HTML "white-label" pour intégration des pages dans WordPress
- Mode présentation (slide mode)

## Solutions testés

### Gitlab + Obsidian

Git permet de créer plusieurs branches et donc de gérer plusieurs versions de la doc.
Gitlab gère les droits via des groupes internes, pas d'intégration avec les groupes EPFL -> Deal breaker ?
Obsisian ne gère pas l'édition concurente ou la résolution de conflit (yet)

### Wiki.js

Gère les droits via des groupes internes, pas d'intégration avec les groupes EPFL -> Deal breaker ?

### Bookstack

Currently BookStack does not support multiple instances from one installation
Pas d'édition concurent : https://www.bookstackapp.com/blog/bookstack-release-v21-10/#smarter-concurrent-editing-detection--warnings

### CodiMD (HackMD)

Permet l'édition collaborative, les présentations (reveal.js) le tout en markdown. La version opensource (codiMD) est hostable on-prem. Les documents sont synchronisables avec Git.

[Markdown]: https://daringfireball.net/projects/markdown/
[CommonMark]: https://commonmark.org/