Éditeur

capDoliWiki utilise l'éditeur WYSIWYG Milkdown pour la rédaction des pages wiki. Vous écrivez en Markdown et le résultat est affiché en temps réel dans l'éditeur.

Éditeur WYSIWYG Milkdown avec la barre d'outils et le contenu en cours de rédaction

Barre d'outils

La barre d'outils fixe en haut de l'éditeur propose les actions suivantes :

Bouton Action
G (gras) Met le texte sélectionné en gras
I (italique) Met le texte sélectionné en italique
H1, H2, H3 Applique un niveau de titre
Liste à puces Crée une liste non ordonnée
Liste numérotée Crée une liste ordonnée
Lien Insère un lien hypertexte
Code Insère un bloc de code
Séparateur Insère une ligne horizontale
Plein écran Passe en mode plein écran

Syntaxe Markdown

L'éditeur prend en charge le Markdown standard (CommonMark) et les extensions GitHub Flavored Markdown (GFM) :

Titres

# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3

Mise en forme du texte

**Texte en gras**
*Texte en italique*
~~Texte barré~~
`Code en ligne`

Listes

- Élément de liste à puces
- Deuxième élément

1. Élément de liste numérotée
2. Deuxième élément

Liens et images

[Texte du lien](https://exemple.fr)
![Texte alternatif](/img/capdoliwiki/url-de-l-image.png)

Blocs de code

Entourez votre code de trois backticks en précisant le langage pour activer la coloration syntaxique :

```php
echo "Bonjour le monde";
```

Les langages pris en charge par la coloration syntaxique (Prism.js) incluent : PHP, JavaScript, Python, Java, C, C++, CSS, HTML, SQL, Bash, JSON, YAML, XML, Markdown et TypeScript.

Tableaux

| Colonne 1 | Colonne 2 |
|-----------|-----------|
| Cellule   | Cellule   |

Citations

> Ceci est une citation.

Blocs d'alerte (callouts)

Utilisez la syntaxe :::type pour créer des blocs d'alerte visuels :

:::info
Ceci est un bloc d'information.
:::

:::tip
Ceci est un conseil.
:::

:::warning
Ceci est un avertissement.
:::

:::danger
Ceci est un message de danger.
:::

Diagrammes Mermaid

Intégrez des diagrammes directement dans vos pages :

```mermaid
graph TD
    A[Début] --> B{Condition}
    B -->|Oui| C[Action 1]
    B -->|Non| D[Action 2]
```

Les diagrammes Mermaid sont chargés dynamiquement uniquement lorsqu'une page en contient.

Insertion d'images

Collage depuis le presse-papiers

La méthode la plus rapide pour insérer une image :

  1. Copiez une image dans le presse-papiers (capture d'écran, copie depuis un logiciel, etc.)
  2. Positionnez le curseur à l'endroit souhaité dans l'éditeur
  3. Appuyez sur Ctrl+V

L'image est automatiquement uploadée sur le serveur, redimensionnée si elle dépasse la largeur maximale configurée, et insérée dans le contenu.

Glisser-déposer

Vous pouvez également faire glisser une image depuis votre explorateur de fichiers directement dans l'éditeur.

Mode plein écran

Cliquez sur le bouton Plein écran de la barre d'outils ou utilisez le raccourci Ctrl+Shift+F pour passer en mode plein écran. Ce mode masque l'interface Dolibarr et affiche l'éditeur sur toute la surface de l'écran.

Appuyez sur Échap pour quitter le mode plein écran.

Sauvegarde automatique (brouillon)

L'éditeur enregistre automatiquement le contenu en cours de rédaction dans le stockage local du navigateur (localStorage). L'intervalle de sauvegarde est configurable (30 secondes par défaut).

Si vous fermez accidentellement le navigateur ou si la connexion est interrompue, le brouillon est restauré automatiquement à la prochaine ouverture de la page d'édition.

Attention : Le brouillon est stocké localement dans votre navigateur. Il n'est pas partagé entre différents navigateurs ou postes de travail.

Verrouillage

Lorsque vous ouvrez une page en édition, un verrou est automatiquement posé pour empêcher un autre utilisateur de modifier la même page simultanément. Le verrou est :

  • Prolongé automatiquement tant que l'éditeur reste ouvert (mécanisme de heartbeat)
  • Libéré lorsque vous sauvegardez ou quittez la page d'édition
  • Expiré après la durée de verrouillage configurée si le heartbeat ne fonctionne plus (navigateur fermé brutalement, perte de connexion)

Si vous tentez de modifier une page verrouillée par un autre utilisateur, un message d'avertissement vous indique le nom de la personne ayant verrouillé la page.

Message de verrouillage indiquant qu'un autre utilisateur est en train de modifier la page

Les utilisateurs ayant la permission de suppression/administration peuvent forcer le déverrouillage d'une page.

Raccourcis clavier

En mode édition

Raccourci Action
Ctrl+S Soumettre le formulaire (sauvegarder la page)
Ctrl+Shift+F Basculer en mode plein écran
Échap Quitter le mode plein écran

En mode lecture

Raccourci Action
E Ouvrir l'éditeur sur la page courante
H Accéder à l'historique de la page
Flèches gauche/droite Naviguer entre les pages (page précédente/suivante)