Formulix Documentation← Retour au site
Formulix / 0.1.0

CKEditor 5

Plugin avec widgets et transactions du modèle de l’éditeur.

Installation

Exécutez npm run build:integrations et copiez dist/integrations/ckeditor5/ dans l’application. Pour distribuer les sources et licences, utilisez npm run package:integrations. Chargez formulix-ui.min.js avant de créer l’éditeur et importez index.js en ESM.

Utilisez l’installation ckeditor5 de l’application ; n’ajoutez pas une seconde copie. Version testée et déclarée en peer dependency : CKEditor 49.

Configuration

Fusionnez ces valeurs avec les plugins existants de ClassicEditor.

import Formulix from './formulix/index.js';
const config = {
  plugins: [  Formulix ],
  toolbar: ['formulixFormula', 'formulixConta', 'formulixGrafico', 'formulixQuimica'],
  formulix: {
    servidor: 'https://api.formulix.example',
    chave: 'YOUR_PUBLIC_KEY',
    idioma: 'fr'
  }
};

Sans callback upload, le plugin utilise FileRepository et l’adaptateur de téléversement déjà configuré. Pour votre propre stockage, ajoutez upload: async blob => uploadPng(blob) dans formulix. Implémentez uploadPng pour envoyer le PNG et renvoyer son URL ; le serveur doit authentifier l’envoi et valider le format PNG et la taille.

API et clé publique

Renseignez l’URL HTTPS de l’API fournie par l’exploitant et la clé publique de votre compte. Enregistrez le domaine de l’éditeur dans le tableau de bord ; ses sous-domaines sont inclus. https://api.formulix.example et YOUR_PUBLIC_KEY sont des placeholders : ni un service disponible ni une vraie clé.

Le contenu des aperçus et insertions est envoyé à l’API. Utilisez uniquement la clé publique liée au domaine ; ne placez jamais d’identifiants d’administration, SMTP ou Mercado Pago dans le navigateur. Consultez l’authentification, les erreurs et les limites et le brouillon de confidentialité.

Utilisation et conservation

Utilisez les quatre boutons et double-cliquez sur un élément pour le modifier. Enregistrez editor.getData(). Préservez les conteneurs data-formulix, MathML, tableaux et attributs data-* dans le filtre HTML du serveur. Les modifications et l’historique utilisent les transactions du modèle.

Limites connues

Testé avec CKEditor 49 : quatre types, enregistrement/rechargement, modification, annulation, filtrage et lecture seule. Vérifiez séparément la licence de l’éditeur hôte ; l’adaptateur est GPL-3.0-or-later.

Le traitement du presse-papiers OMML/RTF de Word reste propre à TinyMCE. La parité des adaptateurs alpha, plusieurs langues simultanées, Firefox/WebKit et les appareils mobiles restent à valider.