Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Personnalisation

Éditeur de texte enrichi

Dokos propose un éditeur de texte enrichi modernisé pour rédiger et mettre en forme vos contenus directement dans les formulaires. Que vous rédigiez une annonce, une description d'article ou un commentaire, cet éditeur offre une expérience intuitive et des fonctionnalités avancées pour répondre à tous vos besoins.

Éditeur de texte enrichi

Dokos propose un éditeur de texte enrichi modernisé pour rédiger et mettre en forme vos contenus directement dans les formulaires. Que vous rédigiez une annonce, une description d'article ou un commentaire, cet éditeur offre une expérience intuitive et des fonctionnalités avancées pour répondre à tous vos besoins.

Fonctionnalités clés

Interface unifiée

L'éditeur adopte une barre d'outils simplifiée avec des icônes claires et des menus déroulants pour accéder aux fonctionnalités avancées. Les options sont organisées par catégories (texte, insertion, formatage) pour une navigation fluide.

Insertion d'images et de médias

  • Glisser-déposer : Déposez une image directement depuis votre explorateur de fichiers dans l'éditeur.
  • Téléversement : Cliquez sur l'icône Image pour sélectionner un fichier depuis votre ordinateur.
  • URL externe : Insérez une image depuis une URL en collant le lien dans le champ dédié.
  • Galerie : Accédez à la galerie de médias de Dokos pour réutiliser des images déjà téléversées.

Astuce : Les images téléversées sont automatiquement optimisées pour le web, ce qui améliore les performances de chargement.

Styles et formatage avancés

  • Titres : Appliquez des styles de titre (H1, H2, H3) pour structurer votre contenu.
  • Listes : Créez des listes à puces ou numérotées en un clic.
  • Citations : Mettez en évidence des citations avec un style dédié.
  • Code : Insérez des blocs de code avec coloration syntaxique pour les documents techniques.
  • Tableaux : Créez et modifiez des tableaux directement dans l'éditeur.

Prévisualisation en temps réel

Un bouton Prévisualiser permet de basculer entre le mode édition et le mode prévisualisation pour voir le rendu final de votre texte avant de l'enregistrer.

Collaboration et historique

  • Modifications en temps réel : Si plusieurs utilisateurs éditent le même document, les modifications sont visibles en temps réel (nécessite une configuration spécifique).
  • Historique des versions : Consultez l'historique des modifications pour revenir à une version précédente si nécessaire.

Personnalisation de l'éditeur

Pour les utilisateurs

  • Barre d'outils personnalisable : Vous pouvez réorganiser les icônes de la barre d'outils pour accéder plus rapidement aux fonctionnalités que vous utilisez le plus.
  • Raccourcis clavier : Utilisez des raccourcis clavier pour appliquer des styles (ex. : Ctrl+B pour mettre en gras, Ctrl+I pour italique).

Pour les administrateurs et développeurs

Configuration avancée de l'éditeur de texte

L'éditeur de texte enrichi peut être personnalisé pour répondre aux besoins spécifiques de votre organisation. Voici quelques options de configuration disponibles :

1. Activer ou désactiver des fonctionnalités

Dans Personnaliser le formulaire, vous pouvez activer ou désactiver certaines fonctionnalités de l'éditeur pour un champ spécifique :

  • Options de formatage : Gras, italique, souligné, barré, etc.
  • Insertion de médias : Images, vidéos, liens.
  • Styles avancés : Titres, citations, code, tableaux.

2. Définir des styles personnalisés

Vous pouvez ajouter des styles personnalisés pour standardiser la mise en forme des documents dans votre organisation. Par exemple :

// Dans le script client du DocType
frappe.ui.form.on("Mon DocType", {
    refresh(frm) {
        // Ajouter un style personnalisé
        frm.fields_dict["mon_champ_texte"].editor.add_format({
            title: "Alerte",
            icon: "i-mdi-alert",
            tag: "div",
            className: "alert",
            value: "<div class=\"alert\">Texte d'alerte</div>"
        });
    }
});

3. Gérer les placeholders

Le nouvel éditeur gère les placeholders de manière plus intuitive. Si un champ de type "Text Editor" ne contient pas de placeholder, l'éditeur affiche désormais un espace vide au lieu d'un texte générique. Pour définir un placeholder :

  1. Allez dans Personnaliser le formulaire.
  2. Sélectionnez le champ de type "Text Editor".
  3. Saisissez le texte du placeholder dans le champ Placeholder.
  4. Enregistrez les modifications.

Bon à savoir : Si aucun placeholder n'est défini, l'éditeur n'affichera aucun texte par défaut, évitant ainsi les confusions pour les utilisateurs.

4. Intégration avec les formats d'impression

Les contenus rédigés dans l'éditeur de texte enrichi sont automatiquement compatibles avec les formats d'impression de Dokos. Pour optimiser le rendu :

  • Utilisez les styles de titre (H1, H2, H3) pour structurer votre contenu.
  • Évitez les styles personnalisés non standardisés, car ils peuvent ne pas être correctement interprétés dans les formats d'impression.
  • Testez le rendu final dans le mode Prévisualisation avant d'imprimer ou d'exporter.

Bonnes pratiques

  • Sauvegardez régulièrement : Bien que l'éditeur enregistre automatiquement les modifications, il est recommandé de sauvegarder manuellement le document après des modifications importantes.
  • Utilisez les styles : Privilégiez les styles prédéfinis (titres, listes) pour garantir une mise en forme cohérente.
  • Optimisez les images : Avant de téléverser une image, réduisez sa taille pour améliorer les performances de chargement.
  • Collaborez efficacement : Si plusieurs utilisateurs travaillent sur le même document, utilisez l'historique des versions pour suivre les modifications.

Résoudre les problèmes courants

ProblèmeSolution
L'éditeur ne s'affiche pasVérifiez que le champ est bien de type "Text Editor" dans Personnaliser le formulaire.
Les images ne s'affichent pasAssurez-vous que les images sont correctement téléversées et que les permissions sont configurées.
Les styles ne s'appliquent pasVérifiez que les styles utilisés sont compatibles avec le thème Espresso.
Lenteur lors de l'éditionRéduisez la taille des images ou divisez le contenu en plusieurs champs si le document est très long.

Exemples d'utilisation

Rédiger une annonce

Exemple — Maison Verte SARL La responsable marketing de Maison Verte SARL utilise l'éditeur de texte enrichi pour rédiger une annonce promotionnelle :

  1. Elle applique un titre H1 pour le titre de l'annonce.
  2. Elle insère une image de la nouvelle gamme de produits.
  3. Elle utilise une liste à puces pour présenter les avantages des produits.
  4. Elle ajoute un lien vers le site web de l'entreprise.
  5. Elle prévisualise le rendu final avant de publier.

Documenter un processus interne

Exemple — Bureau Moderne Un responsable des ressources humaines de Bureau Moderne utilise l'éditeur pour documenter un processus d'onboarding :

  1. Il structure le document avec des titres H2 pour chaque étape.
  2. Il insère un tableau pour lister les tâches et les responsables.
  3. Il utilise des citations pour mettre en évidence les consignes importantes.
  4. Il ajoute des liens vers les formulaires internes.
  5. Il enregistre le document et le partage avec l'équipe.

Retour à la personnalisation de l'interface