Manuel d'utilisation
User Manual
Guide complet pour créer vos documents avec SuperPrint
Complete guide to creating documents with SuperPrint
SuperPrint est un éditeur de mise en page professionnel 100% navigateur. Aucune installation requise. Créez des flyers, affiches, brochures et documents multi-pages, puis exportez en PDF haute résolution prêt pour l'impression.
SuperPrint is a professional layout editor that runs entirely in your browser. No installation needed. Create flyers, posters, brochures and multi-page documents, then export as high-resolution print-ready PDFs.
Créer un nouveau projet
Create a New Project
Cliquez sur le bouton + dans la barre d'outils supérieure (toolbar) pour ouvrir la fenêtre « Nouveau projet ». Choisissez :
Click the + button in the top toolbar to open the "New Project" dialog. Choose:
- Format — A4, A5, Letter ou dimensions personnalisées
- Format — A4, A5, Letter or custom dimensions
- Nombre de pages — Vous pouvez en ajouter/supprimer à tout moment
- Number of pages — You can add/remove pages anytime
- Marges & fond perdu — Définissez les zones de sécurité pour l'impression
- Margins & bleed — Define safe zones for print
Raccourci : les boutons A4, A5, Letter dans la barre latérale gauche changent directement le format.
Tip: The A4, A5, Letter buttons in the left sidebar change the format directly.
Sommaire rapide
Quick contents
- Installation locale (Vite) ou en ligne
- Local install (Vite) or online
- Préférences & interface
- Preferences & interface
- Pages, texte, typographie
- Pages, text, typography
- Images, formes, outil plume
- Images, shapes, pen tool
- Calques, grilles, repères
- Layers, grids, guides
- Pages maîtresses, planches
- Master pages, spreads
- Sauvegarder, importer, exporter
- Save, import, export
- PDF CMYK prêt pour l'impression
- Print-ready CMYK PDF
- Raccourcis clavier, paramètres
- Keyboard shortcuts, settings
- Annuler/rétablir, zoom, GPU
- Undo/redo, zoom, GPU
- Studio SP213 — maquettes par IA
- SP213 Studio — AI layouts
- Assistant IA intégré
- Built-in AI assistant
Installation locale (Vite)
Local install (Vite)
Deux façons d'utiliser SuperPrint
Two ways to use SuperPrint
En ligne (aucune installation) — ouvrez simplement superprint.cc dans votre navigateur. Tout fonctionne directement, sans rien installer.
Online (no install) — just open superprint.cc in your browser. Everything works directly, nothing to install.
En local (100% hors-ligne) — toute l'application PAO + le studio SP213 sont servis par un serveur Vite local. Le modèle IA (WebLLM) est téléchargé une fois puis mis en cache — plus aucune donnée ne quitte votre machine.
Locally (100% offline) — the entire DTP app + the SP213 studio are served by a local Vite server. The AI model (WebLLM) is downloaded once then cached — no data ever leaves your machine.
Prérequis
Prerequisites
- Node.js ≥ 18 (inclut npm) — nodejs.org
- Un navigateur récent avec WebGPU (Chrome/Edge) pour le modèle local
- A recent browser with WebGPU (Chrome/Edge) for the local model
Installation (Windows)
Install (Windows)
Copiez-collez cette ligne dans PowerShell :
Copy-paste this line in PowerShell:
cd $HOME; irm https://superprint.cc/install.ps1 | iex
Cette commande télécharge sp213-local.zip, le décompresse dans $HOME/sp213-local, installe les dépendances puis lance le serveur.
This command downloads sp213-local.zip, unpacks it to $HOME/sp213-local, installs dependencies and starts the server.
Installation (macOS / Linux)
Install (macOS / Linux)
Copiez-collez cette ligne dans le Terminal :
Copy-paste this line in the Terminal:
curl -fsSL https://superprint.cc/install.sh | bash
Démarrage (déjà installé)
Launch (already installed)
Depuis le dossier sp213-local :
From the sp213-local folder:
npm.cmd install; npm.cmd run dev
Puis ouvrez http://localhost:5173 dans votre navigateur. La pré-home locale propose une ligne à copier simplifiée (npm run dev) et des boutons pour lancer l'app, le studio ou la documentation.
Then open http://localhost:5173 in your browser. The local pre-home offers a simplified copy line (npm run dev) and buttons to launch the app, the studio or the documentation.
Scripts npm
npm scripts
| Commande | Rôle | Role |
npm run dev | Lance Vite + bannière (scripts/start.mjs) | Starts Vite + banner (scripts/start.mjs) |
npm run dev:plain | Lance Vite sans bannière | Starts Vite without banner |
npm run setup | Assistant d'installation (téléchargement + décompression + npm install) | Install wizard (download + unzip + npm install) |
npm run build | Build de production (dist/) | Production build (dist/) |
npm run preview | Prévisualise le build de production | Preview the production build |
Structure du projet local
Local project structure
sp213-local/
├── index.html ← pré-home (lancer / ouvrir l'app, le studio, la doc)
├── src/main.js ← logique du studio SP213
├── public/ ← assets servis à la racine par Vite
│ ├── favicon.png
│ └── superprint/ ← copie COMPLÈTE de l'app + du studio web
├── scripts/
│ ├── start.mjs ← launcher dev (bannière SUPERPRINT)
│ └── setup.mjs ← assistant d'installation
├── package.json ← @mlc-ai/web-llm + vite
└── vite.config.js
⚙ Ouvrir les Préférences dès le départ
⚙ Open Preferences from the start
Before anything else, click the ⚙ icon at the very top of the left sidebar. The Preferences panel is the central control hub of SuperPrint and contains every option that shapes your editing experience: theme (light/dark), interface language (FR / EN / JA), automatic hyphenation, pasteboard, invisible characters, CMYK color picker, Pantone spot colors, soft proof simulation, save mode (browser, .sp, JSON, Web3), GPU acceleration, and the keyboard shortcut reference.
Avant toute chose, cliquez sur l'icône ⚙ tout en haut de la barre latérale gauche. Le panneau Préférences est le hub central de SuperPrint et regroupe toutes les options qui façonnent votre expérience d'édition : thème (clair/sombre), langue de l'interface (FR / EN / JA), césure automatique, table de montage (pasteboard), caractères invisibles, sélecteur CMYK, tons directs Pantone, simulation d'épreuve, mode de sauvegarde (navigateur, .sp, JSON, Web3), accélération GPU, et la référence des raccourcis clavier.
All preferences are saved automatically in localStorage and restored on every launch. You can change them at any time without losing your work.
Toutes les préférences sont enregistrées automatiquement dans localStorage et restaurées à chaque lancement. Vous pouvez les modifier à tout moment sans perdre votre travail.
A complete reference of every preference is available further down in the
Settings section. Power users should also visit the
⚡ GPU Acceleration section.
Une référence complète de chaque préférence est disponible plus bas dans la section
Paramètres. Les utilisateurs avancés consulteront également la section
⚡ Accélération GPU.
Interface
Interface
L'écran de SuperPrint est divisé en 4 zones principales :
The SuperPrint screen is divided into 4 main areas:
① Barre latérale gauche
① Left Sidebar
Outils (texte, images, formes, plume, chaînage), mode d'affichage (simple / double page), format de page, marges, et panneau des calques.
Tools (text, images, shapes, pen, chaining), display mode (single / spread), page format, margins, and layers panel.
② Barre latérale ouverte (panneau actif)
② Open Sidebar (active panel)
Quand un outil est ouvert dans la barre latérale gauche, son panneau affiche : navigation pages (◀ ▶), ajout/suppression de page, grouper/dégrouper, annuler/rétablir, et les boutons Save, Import, Export et IA.
When a tool is opened in the left sidebar, its panel shows: page navigation (◀ ▶), add/delete page, group/ungroup, undo/redo, plus the Save, Import, Export and AI buttons.
③ Zone de travail (Canvas)
③ Work Area (Canvas)
La zone centrale avec les pages du document. Faites défiler pour naviguer entre les pages. Le fond gris est le « pasteboard » (zone de dépassement).
The center area with your document pages. Scroll to navigate between pages. The grey background is the "pasteboard" (overflow area).
④ Barre latérale droite
④ Right Sidebar
Propriétés de l'objet sélectionné : position, taille, rotation, couleurs, opacité, typographie.
Properties of the selected object: position, size, rotation, colors, opacity, typography.
Réduire / Agrandir la sidebar
Collapse / Expand the Sidebar
Cliquez sur le logo SUPER PRINT en haut de la barre latérale pour la réduire en mode icônes. Cliquez sur la flèche → pour l'agrandir.
Click the SUPER PRINT logo at the top of the sidebar to collapse it to icon mode. Click the → arrow to expand it.
Pages
Pages
Ajouter une page
Add a Page
Cliquez sur Page + dans la toolbar, ou utilisez le raccourci clavier. La nouvelle page est ajoutée après la page courante.
Click Page + in the toolbar, or use the keyboard shortcut. The new page is added after the current page.
Supprimer une page
Delete a Page
Cliquez sur le bouton − à côté de « Page + ». La page courante est supprimée (minimum 1 page conservée).
Click the − button next to "Page +". The current page is deleted (minimum 1 page always kept).
Naviguer entre les pages
Navigate Between Pages
Utilisez les boutons ◀ ▶ dans la toolbar, ou faites simplement défiler verticalement dans la zone de travail pour passer d'une page à l'autre. L'indicateur P 1/5 affiche votre position.
Use the ◀ ▶ buttons in the toolbar, or simply scroll vertically in the work area to move between pages. The P 1/5 indicator shows your position.
Changer le format
Change Page Format
Dans la barre latérale gauche, section Format : cliquez sur A4, A5, Letter ou Perso. Pour des dimensions personnalisées, modifiez L (largeur) et H (hauteur) en mm.
In the left sidebar, Format section: click A4, A5, Letter or Custom. For custom dimensions, edit W (width) and H (height) in mm.
Texte & Typographie
Text & Typography
Ajouter un bloc de texte
Add a Text Block
Cliquez sur l'outil Texte (icône T) dans la sidebar, puis cliquez-glissez sur le canvas pour dessiner un cadre. Double-cliquez sur le cadre pour entrer en mode édition.
Click the Text tool (T icon) in the sidebar, then click-drag on the canvas to draw a frame. Double-click the frame to enter editing mode.
Mise en forme du texte
Formatting Text
Sélectionnez un bloc texte puis utilisez les contrôles dans la barre latérale droite :
Select a text block then use the controls in the right sidebar:
- Police — Sélecteur de police (Open Sans, Montserrat, Roboto, Lato, Poppins, Playfair Display, Bebas Neue, IBM Plex Mono, Fira Code, Space Mono, Noto Sans JP…)
- Font — Font selector (Open Sans, Montserrat, Roboto, Lato, Poppins, Playfair Display, Bebas Neue, IBM Plex Mono, Fira Code, Space Mono, Noto Sans JP…)
- Taille — En points (pt)
- Size — In points (pt)
- Style — Gras, italique, souligné, barré
- Style — Bold, italic, underline, strikethrough
- Alignement — Gauche, centré, droite, justifié
- Alignment — Left, center, right, justified
- Interligne — Espacement entre les lignes
- Line height — Spacing between lines
- Espacement — Espacement entre les lettres (tracking)
- Letter spacing — Space between characters (tracking)
- Couleur — Couleur du texte et de l'arrière-plan
- Color — Text color and background fill
La césure automatique est disponible en 5 langues (FR, EN, DE, ES, IT). Elle s'active dans les paramètres.
Automatic hyphenation is available in 5 languages (FR, EN, DE, ES, IT). Enable it in settings.
Chaînage de texte
Text Chaining
Principe
Concept
Le chaînage de texte (mise en page professionnelle) permet de relier plusieurs blocs de texte : quand le texte déborde d'un bloc, il continue automatiquement dans le bloc suivant. Cela fonctionne aussi entre différentes pages.
Professional text chaining links multiple text blocks: when text overflows one block, it automatically continues in the next. This works across different pages too.
Chaîner des blocs
Chain Blocks
Sélectionnez deux ou plusieurs blocs texte, puis cliquez sur l'outil Chaîner (icône chaîne) ou utilisez Ctrl+L. Les blocs sont liés dans l'ordre de sélection. Une flèche bleue relie visuellement les blocs chaînés.
Select two or more text blocks, then click the Chain tool (link icon) or use Ctrl+L. Blocks are linked in selection order. A blue arrow visually connects chained blocks.
Déchaîner
Unchain
Sélectionnez un bloc chaîné et cliquez sur Déchaîner ou utilisez Ctrl+Shift+L.
Select a chained block and click Unchain or use Ctrl+Shift+L.
Images
Images
Importer une image
Import an Image
Cliquez sur l'outil Image dans la sidebar (sous-menu import), puis sélectionnez un fichier. Formats supportés : JPG, PNG, WebP, GIF. Vous pouvez aussi glisser-déposer une image directement sur le canvas, ou coller depuis le presse-papiers (Ctrl+V).
Click the Image tool in the sidebar (import sub-menu), then select a file. Supported formats: JPG, PNG, WebP, GIF. You can also drag-and-drop an image directly onto the canvas, or paste from clipboard (Ctrl+V).
Redimensionner & positionner
Resize & Position
Sélectionnez l'image, puis utilisez les poignées pour redimensionner. Maintenez Shift pour conserver les proportions. Utilisez les champs X, Y, W, H dans la barre latérale droite pour un positionnement précis.
Select the image, then use the handles to resize. Hold Shift to maintain proportions. Use the X, Y, W, H fields in the right sidebar for precise positioning.
SVG vectoriel
Vector SVG
Importez des fichiers SVG via l'outil SVG dans le sous-menu import. Les SVG sont importés comme objets vectoriels éditables (couleur, contour, déformation).
Import SVG files through the SVG tool in the import sub-menu. SVGs are imported as editable vector objects (color, stroke, deformation).
Formes & Dessin
Shapes & Drawing
Ajouter des formes
Add Shapes
Ouvrez le sous-menu Formes dans la sidebar. Options disponibles :
Open the Shapes sub-menu in the sidebar. Available options:
- Rectangle — Forme rectangulaire avec coins optionnellement arrondis
- Rectangle — Rectangular shape with optional rounded corners
- Cercle — Ellipse parfaite
- Circle — Perfect ellipse
- Étoile — Étoile polygonale
- Star — Polygon star
- Forme libre — Tracé à main levée
- Freeform — Freehand drawing
Chaque forme peut être colorée (remplissage + contour), redimensionnée et tournée.
Each shape can be colored (fill + stroke), resized and rotated.
Outil Plume (Bézier)
Pen Tool (Bézier)
Créer des tracés vectoriels
Create Vector Paths
Cliquez sur l'outil Plume (icône stylo) dans la sidebar. Cliquez pour poser des points d'ancrage. Cliquez-glissez pour créer des courbes de Bézier. Fermez le tracé en cliquant sur le premier point.
Click the Pen tool (pen icon) in the sidebar. Click to place anchor points. Click-drag to create Bézier curves. Close the path by clicking the first point.
- Échap pour terminer un tracé ouvert
- Escape to end an open path
- Ctrl+Z pour annuler le dernier point
- Ctrl+Z to undo the last point
Paper.js permet les opérations booléennes (union, soustraction, intersection) entre les tracés — comme le Pathfinder d'Illustrator.
Paper.js enables boolean operations (union, subtraction, intersection) between paths — like Illustrator's Pathfinder.
Calques
Layers
Panneau des calques
Layers Panel
Le panneau calques (section « Calques » dans la sidebar) liste tous les objets de la page courante. Chaque objet est un calque qui peut être :
The layers panel ("Layers" section in the sidebar) lists all objects on the current page. Each object is a layer that can be:
- Réordonné — Boutons ↑ / ↓ pour monter/descendre
- Reordered — ↑ / ↓ buttons to move up/down
- Supprimé — Bouton ✕
- Deleted — ✕ button
- Déplacé vers une autre page — « ◀ Page » / « Page ▶ »
- Moved to another page — "◀ Page" / "Page ▶"
« Clear All » supprime tous les objets de la page (sauf la structure).
"Clear All" removes all objects from the page (except structure).
Grilles & Repères
Grids & Guides
Grille de colonnes
Column Grid
Ouvrez le sous-menu Règles & Grilles → Grille. Configurez :
Open the Rulers & Grids sub-menu → Grid. Configure:
- Colonnes — Nombre de colonnes (1-12)
- Columns — Number of columns (1-12)
- Gouttière — Espace entre colonnes en mm
- Gutter — Space between columns in mm
- Lignes — Nombre de rangées
- Rows — Number of rows
- Ligne de base — Grille typographique (pas et décalage en mm)
- Baseline grid — Typographic grid (step and offset in mm)
Activez le magnétisme pour accrocher les objets à la grille.
Enable snapping to snap objects to the grid.
Repères manuels
Manual Guides
Dans la section « Repères manuels » de la sidebar, ajoutez des repères verticaux ou horizontaux. Glissez-les pour les repositionner. Activez le magnétisme des repères pour un alignement précis.
In the "Manual Guides" section of the sidebar, add vertical or horizontal guides. Drag them to reposition. Enable guide snapping for precise alignment.
Pages maîtresses
Master Pages
Principe
Concept
Les pages maîtresses sont des modèles réutilisables. Les objets placés sur une page maîtresse (en-têtes, pieds de page, arrière-plans) apparaissent automatiquement sur toutes les pages qui l'utilisent.
Master pages are reusable templates. Objects placed on a master page (headers, footers, backgrounds) automatically appear on all pages that use it.
Créer & Appliquer
Create & Apply
Utilisez le panneau « Chemin de fer » (page thumbnails) pour gérer les pages maîtresses. Cliquez droit sur une page pour assigner une page maîtresse.
Use the "Page Thumbnails" panel to manage master pages. Right-click on a page to assign a master page.
Mode planche (Spread)
Spread Mode
Activer le mode planche
Enable Spread Mode
Dans la sidebar, section « Mode d'affichage », cliquez sur Double page. Les pages sont affichées côte à côte comme un livre ouvert. La première page (couverture) reste en page simple.
In the sidebar, "Display Mode" section, click Spread. Pages are displayed side by side like an open book. The first page (cover) stays as a single page.
Le mode planche est idéal pour les brochures et magazines.
Spread mode is ideal for brochures and magazines.
Sauvegarder
Save
Sauvegarde automatique
Auto-Save
SuperPrint sauvegarde automatiquement votre travail dans IndexedDB (stockage local du navigateur). Votre projet est restauré automatiquement lorsque vous rouvrez l'application.
SuperPrint automatically saves your work in IndexedDB (browser local storage). Your project is automatically restored when you reopen the app.
Sauvegarde manuelle (.sp)
Manual Save (.sp)
Cliquez sur SAVE dans la toolbar pour créer un fichier .sp — un fichier JSON contenant le projet complet, images et polices embarquées. Ce fichier peut être rechargé plus tard via Import.
Click SAVE in the toolbar to create an .sp file — a JSON file containing the complete project, with images and fonts embedded. This file can be reloaded later via Import.
Historique de sauvegardes
Save History
SuperPrint conserve jusqu'à 20 snapshots de votre projet. Accessible depuis le panneau Historique pour revenir à une version antérieure.
SuperPrint keeps up to 20 snapshots of your project. Access the History panel to roll back to a previous version.
Importer
Import
Formats supportés
Supported Formats
Cliquez sur IMPORT dans la toolbar. Formats acceptés :
Click IMPORT in the toolbar. Accepted formats:
| Format | Description | Description |
| PDF | Import page par page (rastérisé via PDF.js) | Page-by-page import (rasterized via PDF.js) |
| DOCX | Conversion du contenu texte via Mammoth.js | Text content conversion via Mammoth.js |
| IDML | Format d'échange PAO (texte + structure) | DTP interchange format (text + structure) |
| ODT | Format LibreOffice Writer | LibreOffice Writer format |
| .sla | Texte + formes basiques (BETA) | Basic text + shapes (BETA) |
| SVG | Graphiques vectoriels | Vector graphics |
| Images | PNG, JPG, WebP (fichier ou presse-papiers) | PNG, JPG, WebP (file or clipboard) |
| .sp | Projet SuperPrint (JSON) | SuperPrint project (JSON) |
| TXT / RTF | Texte brut ou enrichi | Plain or rich text |
| JSON | Données Fabric.js brutes | Raw Fabric.js data |
Exporter / PDF
Export / PDF
Export PDF
PDF Export
Cliquez sur Export dans la toolbar. Options :
Click Export in the toolbar. Options:
- Résolution — 72 DPI (écran), 150 DPI (brouillon), 300 DPI (impression)
- Resolution — 72 DPI (screen), 150 DPI (draft), 300 DPI (print)
- Fond perdu — Zone de sécurité pour la coupe (3mm typique)
- Bleed — Safety zone for trimming (typical 3mm)
- Repères d'impression — Traits de coupe, croix de repérage
- Trim marks — Cut marks, registration marks
- PDF imposé — Imposition en cahier pour impression recto-verso
- Imposed PDF — Booklet imposition for duplex printing
Export CMJN + tons directs (Pantone)
CMYK + spot colors (Pantone) export
Dès qu'un ton direct du nuancier Pantone est appliqué à un objet du document, la boîte d'export bascule automatiquement en mode « CMJN + Pantone », comme dans InDesign :
As soon as a Pantone spot color from the swatch library is applied to an object, the export dialog switches automatically to “CMYK + Pantone” mode, as in InDesign:
- Résolution verrouillée à 300 DPI — les autres qualités (72 / 200 / 600 DPI) sont retirées
- Resolution locked to 300 DPI — the other qualities (72 / 200 / 600 DPI) are removed
- Mode couleur CMJN imposé — RVB et Noir & Blanc ne sont plus proposés
- CMYK color mode enforced — RGB and Black & White are no longer offered
- Une couche chromatique par Pantone — 1 Pantone = CMJN (4 canaux) + 1 canal ; 2 Pantones = CMJN + 2 canaux. Chaque canal est un espace Separation nommé d'après le Pantone (ex.
PANTONE 214 C), donc séparable par le RIP / l'imprimeur.
- One color channel per Pantone — 1 Pantone = CMYK (4 channels) + 1 channel; 2 Pantones = CMYK + 2 channels. Each channel is a Separation color space named after the Pantone (e.g.
PANTONE 214 C), so the RIP / printer can separate it.
- Fonds perdus toujours inclus et typographie vectorielle forcée (indispensable : un texte rasterisé ne peut pas être peint lettre à lettre dans la couche d'encre)
- Bleed always included and vector typography forced (required: rasterized text cannot be painted letter by letter into the ink channel)
- Repères colorimétriques étendus — patchs quadri + un patch par encre directe
- Extended color bars — process patches + one patch per spot ink
- Sans aucun Pantone dans le document, la boîte d'export classique reste strictement inchangée (RVB / CMJN / N&B, toutes qualités).
- With no Pantone in the document, the classic export dialog stays strictly unchanged (RGB / CMYK / B&W, all qualities).
Autres exports
Other Exports
- Print-to-Web (D4Export) — Génère un mini-site HTML dans un ZIP pour diffusion numérique
- Print-to-Web (D4Export) — Generates an HTML mini-site in a ZIP for digital distribution
- .sp — Projet complet en JSON (images et polices embarquées)
- .sp — Complete project as JSON (images and fonts embedded)
Simulation CMYK
CMYK Simulation
Soft Proofing
Soft Proofing
Outil Simulation CMYK dans la sidebar (icône cercles CMYK). Prévisualisez comment votre document apparaîtra à l'impression :
Use the CMYK Simulation tool in the sidebar (CMYK circles icon). Preview how your document will look when printed:
- RGB — Affichage écran normal
- RGB — Normal screen display
- CMYK Couché — Simulation papier couché brillant
- CMYK Coated — Glossy coated paper simulation
- CMYK Mat — Simulation papier non couché
- CMYK Uncoated — Matte uncoated paper simulation
Vous pouvez aussi simuler différents types de papier : blanc pur, ivoire, recyclé, journal.
You can also simulate different paper types: pure white, ivory, recycled, newsprint.
Annuler / Rétablir
Undo / Redo
Historique des actions
Action History
Utilisez Ctrl+Z pour annuler et Ctrl+Y (ou Ctrl+Shift+Z) pour rétablir. Les boutons ↶ et ↷ dans la toolbar ont la même fonction.
Use Ctrl+Z to undo and Ctrl+Y (or Ctrl+Shift+Z) to redo. The ↶ and ↷ buttons in the toolbar have the same function.
L'historique est persisté dans IndexedDB : même après rechargement de la page, votre pile d'annulations est conservée.
The history is persisted in IndexedDB: even after reloading the page, your undo stack is preserved.
Zoom
Contrôles de zoom
Zoom Controls
- Ctrl+Molette — Zoom avant/arrière libre
- Ctrl+Scroll — Free zoom in/out
- Ctrl+0 — Réinitialiser le zoom à 100 %
- Ctrl+0 — Reset zoom to 100%
- Ctrl+= / Ctrl+- — Zoom incrémental
- Ctrl+= / Ctrl+- — Incremental zoom
Le rendu est optimisé pour rester net à tous les niveaux de zoom grâce à l'ajustement dynamique du DPR (Device Pixel Ratio).
Rendering is optimized to stay sharp at all zoom levels thanks to dynamic DPR (Device Pixel Ratio) adjustment.
Raccourcis clavier
Keyboard Shortcuts
| Action | Action | Raccourci | Shortcut |
| Annuler | Undo | Ctrl+Z |
| Rétablir | Redo | Ctrl+Y |
| Copier | Copy | Ctrl+C |
| Coller | Paste | Ctrl+V |
| Couper | Cut | Ctrl+X |
| Tout sélectionner | Select all | Ctrl+A |
| Tabulation : insère une tabulation dans le bloc en édition (les taquets sont activés au besoin, pas par défaut 10 mm) | Tab: inserts a tab in the block being edited (tab stops enabled if needed — default step 10 mm) | Tab |
| Tab intégré : navigation vers le champ / contrôle suivant (natif). | Built-in Tab: move to the next field / control (native). | Option + Tab Maj + Tab |
| Dupliquer (glisser) | Duplicate (drag) | Alt+Glisser |
| Supprimer | Delete | Suppr / Backspace |
| Grouper | Group | Ctrl+Shift+G |
| Dégrouper | Ungroup | Ctrl+Shift+U |
| Chaîner texte | Chain text | Ctrl+L |
| Déchaîner texte | Unchain text | Ctrl+Shift+L |
| Sauvegarder | Save | Ctrl+S |
| Zoom + | Zoom in | Ctrl+= |
| Zoom − | Zoom out | Ctrl+- |
| Zoom 100% | Zoom 100% | Ctrl+0 |
| Gras | Bold | Ctrl+B |
| Italique | Italic | Ctrl+I |
| Souligné | Underline | Ctrl+U |
| Ajouter un texte | Add text | ⌥+T |
| Ajouter une image | Add image | ⌥+I |
| Ajouter un rectangle | Add rectangle | ⌥+R |
| Ajouter un cercle | Add circle | ⌥+C |
| Outil plume | Pen tool | ⌥+P |
Paramètres
Settings
Accéder aux paramètres
Access Settings
Cliquez sur l'icône ⚙ en haut de la barre latérale. Options disponibles :
Click the ⚙ icon at the top of the sidebar. Available options:
- Thème — Clair / Sombre
- Theme — Light / Dark
- Langue — Français, English, 日本語
- Language — Français, English, 日本語
- Césure — Activer/désactiver la césure automatique
- Hyphenation — Enable/disable automatic hyphenation
- Raccourcis clavier — Liste complète des raccourcis
- Keyboard shortcuts — Complete shortcut list
- Table de montage (Pasteboard) — Zone de travail étendue autour des pages
- Pasteboard — Extended work area around pages
- Caractères invisibles — Afficher/masquer les espaces, insécables et retours de ligne
- Invisible characters — Show/hide spaces, non-breaking spaces and line breaks
- Couleurs CMYK — Activer le sélecteur CMYK, tons directs Pantone et simulation d'épreuve
- CMYK Colors — Enable CMYK picker, Pantone spot colors and proof simulation
- Ctrl+S — Choisir le mode de sauvegarde : Navigateur (IndexedDB), .sp, JSON local, Web3 IPFS
- Ctrl+S — Choose save mode: Browser (IndexedDB), .sp, local JSON, Web3 IPFS
- ⚡ Accélération GPU — Activer l'accélération matérielle (voir section dédiée ci-dessous)
- ⚡ GPU Acceleration — Enable hardware acceleration (see dedicated section below)
⚡ Accélération GPU
⚡ GPU Acceleration
Principe
How it works
SuperPrint peut déléguer le rendu des pages à la carte graphique (GPU) de l'ordinateur pour accélérer sensiblement l'affichage — en particulier sur des documents multi-pages avec de nombreuses images et formes complexes.
SuperPrint can delegate page rendering to the computer's GPU to significantly accelerate display — especially on multi-page documents with many images and complex shapes.
Détection automatique de la carte graphique
Automatic graphics card detection
À l'ouverture du panneau Réglages ⚙ (ou lors de l'écran de bienvenue au premier lancement), SuperPrint interroge WebGL via l'extension WEBGL_debug_renderer_info et affiche le nom exact du GPU détecté — par exemple NVIDIA GeForce RTX 4090, Apple M3 GPU ou Intel Iris Xe Graphics. Si le GPU n'est pas accessible (WebGL désactivé ou non disponible), un message ✗ s'affiche et l'option reste sans effet.
When opening the Settings panel ⚙ (or during the first-launch welcome wizard), SuperPrint queries WebGL via the WEBGL_debug_renderer_info extension and displays the exact detected GPU name — e.g. NVIDIA GeForce RTX 4090, Apple M3 GPU or Intel Iris Xe Graphics. If the GPU is not accessible (WebGL disabled or unavailable) a ✗ message appears and the option has no effect.
La détection n'est effectuée qu'au moment de l'ouverture du panneau Réglages ou de l'écran de bienvenue, pas en continu.
Detection only happens when the Settings panel or welcome wizard is opened, not continuously.
Activer / désactiver
Enable / disable
Dans Réglages ⚙ → section Accélération GPU : cochez la case pour activer, décochez pour désactiver. Le réglage est appliqué immédiatement (sans rechargement de page) et persisté dans localStorage sous la clé sp_gpu_enabled. Il est restauré automatiquement à chaque lancement.
In Settings ⚙ → GPU Acceleration section: check the box to enable, uncheck to disable. The setting is applied immediately (no page reload) and persisted in localStorage under key sp_gpu_enabled. It is automatically restored on every launch.
Ce que l'accélération GPU fait concrètement
What GPU acceleration actually does
- Promotion en couche composite GPU — les conteneurs canvas Fabric.js (
.canvas-container, .lower-canvas, .upper-canvas, #canvasScrollArea, .canvas-wrapper) reçoivent will-change: transform + transform: translateZ(0) + backface-visibility: hidden : le navigateur les délègue au compositeur de la carte graphique, libérant le fil principal CPU.
- GPU compositor layer promotion — Fabric.js canvas containers (
.canvas-container, .lower-canvas, .upper-canvas, #canvasScrollArea, .canvas-wrapper) receive will-change: transform + transform: translateZ(0) + backface-visibility: hidden: the browser delegates them to the GPU compositor, freeing the main CPU thread.
- Cache objet Fabric.js —
objectCaching = true activé sur formes (Rect, Circle, Ellipse), images (Image), chemins (Path) et groupes (Group) : chaque objet est bitmapé en mémoire et n'est repaint sur le GPU que s'il est modifié. Le texte (Text, Textbox) conserve toujours objectCaching = false pour un rendu typographique net à tous les niveaux de zoom.
- Fabric.js object cache —
objectCaching = true enabled on shapes (Rect, Circle, Ellipse), images (Image), paths (Path) and groups (Group): each object is bitmapped in memory and only repainted to the GPU when modified. Text (Text, Textbox) always keeps objectCaching = false for sharp typographic rendering at all zoom levels.
- Re-rendu immédiat —
requestRenderAll() est appelé sur tous les canvas actifs lors du basculement.
- Immediate re-render —
requestRenderAll() is called on all active canvases when toggling.
Les gains sont les plus visibles sur les documents comportant beaucoup d'images, de formes complexes ou lors du scroll entre les pages.
Gains are most visible on documents with many images, complex shapes, or when scrolling between pages.
Écran de bienvenue — onboarding (premier lancement)
Welcome wizard — onboarding (first launch)
Au tout premier lancement de SuperPrint (et uniquement ce premier lancement), un wizard en 4 étapes apparaît après le splash d'intro :
On the very first launch of SuperPrint (and only the first launch), a 4-step wizard appears after the intro splash:
- Étape 1 — Message de bienvenue et présentation de l'application
- Step 1 — Welcome message and application overview
- Étape 2 — Présentation des 5 modes de sauvegarde (auto IndexedDB 12 s, Ctrl+S, .sp, JSON, PDF)
- Step 2 — 5 save modes overview (auto IndexedDB every 12 s, Ctrl+S, .sp, JSON, PDF)
- Étape 3 — Détection GPU en direct + case d'activation. La case prend effet immédiatement, sans attendre « Commencer »
- Step 3 — Live GPU detection + activation checkbox. The toggle takes effect immediately, without waiting for "Start"
- Étape 4 — Récapitulatif des raccourcis essentiels
- Step 4 — Essential shortcuts summary
Le wizard ne s'affiche plus une fois terminé ou passé (localStorage clé sp_onboarding_done = 1).
The wizard no longer appears once completed or skipped (localStorage key sp_onboarding_done = 1).
Pour revoir l'onboarding en développement : tapez localStorage.removeItem('sp_onboarding_done') dans la console, puis rechargez la page.
To re-show the onboarding during development: type localStorage.removeItem('sp_onboarding_done') in the console, then reload the page.
C'est quoi ?
What is it?
Le dev tool est la console de script de SuperPrint : on y écrit du JavaScript qui pilote le document ouvert — ajouter des objets, poser une grille, numéroter les pages, inspecter un montage. C'est aussi la référence de l'API publique, avec les signatures et les options de chaque fonction.
The dev tool is SuperPrint's script console: you write JavaScript that drives the open document — add objects, lay out a grid, number pages, inspect a layout. It is also the reference for the public API, with each function's signature and options.
Rien à installer, rien à compiler : le script s'exécute dans la page, sur le document en cours.
Nothing to install, nothing to compile: the script runs in the page, against the current document.
Ouvrir le panneau
Opening the panel
- Bouton « dev tool » — tout en bas de la barre latérale de droite.
- “dev tool” button — at the very bottom of the right sidebar.
- Touche F12 — ouvre le panneau depuis n'importe où dans l'application.
- F12 key — opens the panel from anywhere in the application.
- Échap — ferme le panneau.
- Escape — closes the panel.
Trois onglets
Three tabs
| Onglet | Tab | Ce qu'on y trouve | What it holds |
| Exemples | Six scripts prêts à l'emploi, avec un champ de filtre. Chacun s'exécute directement ou s'ouvre dans l'éditeur pour être adapté. | Six ready-made scripts, with a filter field. Each one runs directly or opens in the editor to be adapted. |
| Éditeur | Editor | Votre script, la console de sortie et l'aide-mémoire du bac à sable. Ctrl + Entrée exécute ; le script est mémorisé d'une session à l'autre. | Your script, the output console and the sandbox cheat-sheet. Ctrl + Enter runs it; the script is remembered between sessions. |
| Référence | Reference | Toutes les fonctions de l'API, groupées (Document, Objets, IA, Bac à sable) et filtrables. | Every API function, grouped (Document, Objects, AI, Sandbox) and filterable. |
Le bac à sable : ce qui est disponible dans un script
The sandbox: what a script can use
| Nom | Name | À quoi ça sert | What it does |
SuperPrint | L'API publique : addText, addRect, addCircle, addEllipse, addImage, getPages, setPage, exportPDF, saveProject, loadProject, aiGenerate. | The public API: addText, addRect, addCircle, addEllipse, addImage, getPages, setPage, exportPDF, saveProject, loadProject, aiGenerate. |
canvas | Le canvas Fabric.js de la page active : getObjects(), add(), remove(), requestRenderAll()… | The Fabric.js canvas of the active page: getObjects(), add(), remove(), requestRenderAll()… |
log() | Écrit une ligne horodatée dans la console du panneau. console.log est également capturé. | Writes a timestamped line to the panel console. console.log is captured too. |
mm() / px() | Conversion millimètres ↔ pixels. Le document travaille à 72 dpi : pixels = millimètres × 72 ÷ 25,4. | Millimetre ↔ pixel conversion. The document works at 72 dpi: pixels = millimetres × 72 ÷ 25.4. |
save() | Force une entrée d'historique nommée (l'annulation redevient possible en un geste). | Forces a named history entry (so undo stays one keystroke away). |
getActiveCanvas()
spToast()
fabric | Les fonctions globales de l'application, la notification discrète et la bibliothèque, pour fabriquer ce que l'API ne couvre pas. | The application's global helpers, the small notification, and the library itself, for anything the API does not cover. |
Le script est enveloppé dans une fonction async : await est disponible, et la valeur retournée par un return s'affiche dans la console, suivie de la durée d'exécution.
The script is wrapped in an async function: await is available, and a return value is printed in the console, followed by the execution time.
Les six exemples fournis
The six built-in examples
| Exemple | Example | Ce qu'il fait | What it does | Effet | Effect |
| Inventaire du document | Document inventory | Liste les objets de la page active : type, position et taille en millimètres, fond et trait. | Lists the objects of the active page: type, position and size in millimetres, fill and stroke. | Lecture seule | Read-only |
| Grille de 12 colonnes | 12-column grid | Pose une grille typographique (marges, gouttières) calculée sur la taille réelle de la page. | Lays out a typographic grid (margins, gutters) computed from the real page size. | Modifie la page | Changes the page |
| Nuancier imprimé | Printed swatch strip | Six pastilles alignées en bas de page, chacune suivie de son code hexadécimal. | Six swatches aligned at the bottom of the page, each one followed by its hex code. | Modifie la page | Changes the page |
| Bloc éditorial | Editorial block | Surtitre, titre sur deux lignes, filet de séparation et chapô : un gabarit de début de page. | Kicker, two-line headline, rule and standfirst: a page-opening template. | Modifie la page | Changes the page |
| Pied de page sur toutes les pages | Footer on every page | Parcourt le document, pose un bandeau noir et la mention « Page n / total », puis revient en page 1. | Walks the document, adds a black band and “Page n / total”, then returns to page 1. | Modifie la page | Changes the page |
| Contrôle des débords | Overflow check | Signale les objets qui sortent de la page finie, avec la mesure du dépassement (tolérance 0,5 mm). | Reports objects running off the trimmed page, with the overflow measurement (0.5 mm tolerance). | Lecture seule | Read-only |
Les repères de marge, de fond perdu et de fond de page ne sont jamais comptés par les exemples : ni dans l'inventaire, ni dans le contrôle des débords.
Margin, bleed and page-background guides are never counted by the examples: neither in the inventory nor in the overflow check.
Exemple de script commenté
An annotated script
Un filet de 0,6 mm sous un titre, avec la largeur utile calculée sur la page — la façon la plus courte de voir comment tout s'enchaîne :
A 0.6 mm rule under a headline, with the usable width computed from the page — the shortest way to see how everything connects:
// Tout est en millimètres, la page fait 210 × 297 (A4).
const c = getActiveCanvas();
const marge = 20;
const largeur = px(c.width) - 2 * marge; // px() renvoie des mm
SuperPrint.addText(marge, marge, 'TITRE', { fontSize: 28, fontWeight: 'bold', width: largeur });
SuperPrint.addRect(marge, marge + 14, largeur, 0.6, { fill: '#111111', strokeWidth: 0 });
log('Filet posé sur ' + Math.round(largeur) + ' mm de large');
Précautions
Caveats
- Un script agit sur le document : faites-le tourner sur un document de test la première fois, et gardez Ctrl + Z à portée de main.
- A script acts on the document: run it on a test document the first time, and keep Ctrl + Z within reach.
- Un script extérieur a les mêmes droits que l'application : n'exécutez que des scripts dont vous connaissez la provenance.
- An outside script has the same rights as the application: only run scripts whose origin you trust.
- Les erreurs s'affichent en rouge dans la console du panneau — le message suffit neuf fois sur dix pour corriger la ligne fautive.
- Errors appear in red in the panel console — nine times out of ten the message is enough to fix the offending line.
- Le script et le dernier onglet ouvert sont conservés (clés
sp_devtool_code et sp_devtool_tab) ; la console, elle, repart vide à chaque ouverture de l'application.
- The script and the last open tab are kept (keys
sp_devtool_code and sp_devtool_tab); the console itself starts empty on each application launch.
Studio SP213 — maquettes par IA
SP213 Studio — AI-generated layouts
C'est quoi ?
What is it?
Le studio SP213 est l'assistant de mise en page par IA de SuperPrint : vous décrivez la maquette en langage naturel (par texte ou par voix), et il génère un document complet — affiche, flyer, brochure, catalogue, magazine, rapport… — que vous pouvez ensuite ouvrir et retravailler dans l'éditeur SuperPrint.
SP213 Studio is SuperPrint's AI layout assistant: describe the layout in natural language (by text or by voice), and it generates a complete document — poster, flyer, brochure, catalog, magazine, report… — that you can then open and refine in the SuperPrint editor.
Moteurs d'exécution
Execution engines
- DeepSeek (moteur par défaut) — DeepSeek V4 Flash (recommandé, rapide/économique), V4 Pro (puissant), V4 Flash Vision (images), V3.2 chat / R1 en repli. Excellent en raisonnement et JSON structuré. Clé
sk-… sur platform.deepseek.com.
- DeepSeek (default engine) — DeepSeek V4 Flash (recommended, fast/cheap), V4 Pro (powerful), V4 Flash Vision (images), V3.2 chat / R1 fallback. Excellent at reasoning and structured JSON. Key
sk-… at platform.deepseek.com.
- OpenRouter (100% gratuit) — modèles
:free vérifiés (Nemotron 3 Super 120B ⭐, Qwen3.8 27B, Nemotron 3 Ultra 550B). Clé sk-or-… sur openrouter.ai.
- OpenRouter (100% free) — verified
:free models (Nemotron 3 Super 120B ⭐, Qwen3.8 27B, Nemotron 3 Ultra 550B). Key sk-or-… on openrouter.ai.
- Groq (cloud, rapide) — inférence ultra-rapide (Qwen 3.8 27B recommandé, Qwen 3.6 27B, GPT-OSS 120B/20B, Groq Compound). Plafond 8 192 tokens en sortie. Clé
gsk_… sur console.groq.com.
- Groq (cloud, fast) — ultra-fast inference (Qwen 3.8 27B recommended, Qwen 3.6 27B, GPT-OSS 120B/20B, Groq Compound). 8 192 output token cap. Key
gsk_… on console.groq.com.
- SP213 WLLM (local) — modèle WebLLM exécuté dans votre navigateur via WebGPU : Qwen2.5 1.5B (recommandé, environ 1,63 Go de VRAM estimée), SmolLM2 1.7B, Llama 3.2 1B, Qwen2.5 0.5B et SmolLM2 360M. La VRAM estimée n'est pas la taille du téléchargement et la disponibilité dépend du matériel. Le prompt est traité localement; le téléchargement initial du modèle nécessite Internet.
- SP213 WLLM (local) — WebLLM model running in your browser via WebGPU: Qwen2.5 1.5B (recommended, about 1.63 GB estimated VRAM), SmolLM2 1.7B, Llama 3.2 1B, Qwen2.5 0.5B and SmolLM2 360M. Estimated VRAM is not download size and availability depends on hardware. Prompts are processed locally; the initial model download requires internet access.
💡 Les moteurs DeepSeek, OpenRouter et Groq sont alignés entre le studio SP213 et l'app SuperPrint (mêmes modèles, mêmes clés partagées via localStorage). Une clé saisie dans un outil est réutilisée dans l'autre.
💡 DeepSeek, OpenRouter and Groq engines are aligned between the SP213 studio and the SuperPrint app (same models, shared keys via localStorage). A key entered in one tool is reused in the other.
Boîte de prompt
Prompt box
- Pièce jointe (trombone) — joignez des images (jpg, png, webp…), du texte (.txt, .md…) ou des documents Word (.docx). SP213 les analyse et les intègre dans la maquette.
- Attachment (paperclip) — attach images (jpg, png, webp…), text (.txt, .md…) or Word documents (.docx). SP213 analyzes them and integrates them into the layout.
- Prompt vocal (micro) — dictez votre description à voix haute (Web Speech API, Chrome/Edge). La transcription s'insère dans la zone de saisie.
- Voice prompt (microphone) — dictate your description out loud (Web Speech API, Chrome/Edge). The transcription is inserted into the input box.
- Inviter (envoyer) — génère ou met à jour la maquette. Vous pouvez ensuite demander des ajustements dans la même conversation.
- Send — generates or updates the layout. You can then request adjustments in the same conversation.
Conversations multiples
Multiple conversations
Les conversations sont organisées en onglets (bouton + pour créer, double-clic pour renommer, ✕ pour supprimer). Chaque conversation a sa propre maquette et son historique, sauvegardés automatiquement dans le navigateur.
Conversations are organized in tabs (+ button to create, double-click to rename, ✕ to delete). Each conversation has its own layout and history, auto-saved in the browser.
Ouvrir dans SuperPrint
Open in SuperPrint
Le bouton Ouvrir dans SuperPrint (en bas de l'aperçu) transfère la maquette vers l'éditeur complet : elle est écrite dans localStorage puis SuperPrint s'ouvre avec ?from=sp213 et la charge automatiquement. Vous pouvez aussi Exporter .sp et l'importer plus tard via Importer → Charger JSON / .sp.
The Open in SuperPrint button (bottom of the preview) transfers the layout to the full editor: it is written to localStorage then SuperPrint opens with ?from=sp213 and loads it automatically. You can also Export .sp and import it later via Import → Load JSON / .sp.
Retravailler une zone ciblée (sélection)
Refine a targeted area (selection)
Une fois une maquette générée, vous pouvez demander à l'IA de retravailler uniquement certains éléments plutôt que de tout régénérer :
Once a layout is generated, you can ask the AI to refine only specific elements instead of regenerating everything:
- Dans l'aperçu (colonne de gauche), cliquez sur un élément (titre, image, bloc de texte…) ou glissez pour en sélectionner plusieurs (encadré vert).
- In the preview (left column), click an element (title, image, text block…) or drag to select several (green frame).
- Un bandeau vert apparaît : « N élément(s) sélectionné(s) — le prochain prompt ne retravaillera que ceux-ci ».
- A green banner appears: "N element(s) selected — the next prompt will only refine these."
- Tapez ensuite votre demande (ex. « agrandis le titre », « passe ce bloc en bleu ») : l'IA modifie uniquement les éléments sélectionnés et conserve tout le reste du document strictement identique.
- Then type your request (e.g. "enlarge the title", "make this block blue"): the AI modifies only the selected elements and keeps the rest of the document strictly unchanged.
- Pour désélectionner : cliquez sur Effacer dans le bandeau, ou cliquez sur un fond vide de la page. Si rien n'est sélectionné, le prochain prompt régénère une maquette complète (comportement par défaut).
- To deselect: click Clear in the banner, or click on an empty area of the page. If nothing is selected, the next prompt regenerates a full layout (default behavior).
Assistant IA
AI Assistant
Utiliser l'IA
Using AI
Cliquez sur le bouton IA dans la toolbar pour ouvrir l'assistant IA. Il peut vous aider à générer du contenu texte, suggérer des mises en page, et plus encore. Les requêtes passent par le proxy serveur (ai-proxy.php) pour sécuriser les clés API.
Click the AI button in the toolbar to open the AI assistant. It can help generate text content, suggest layouts, and more. Requests go through the server proxy (ai-proxy.php) to secure API keys.
Plug-ins — en écrire un
Plug-ins — writing one
Ce qu'est un plug-in
What a plug-in is
Un plug-in est un seul fichier texte, nommé mon-plugin.plugin.js. Il n'a ni dossier, ni manifeste séparé, ni dépendance à installer : le fichier est le plug-in. Il déclare ce qu'il sait faire, et l'application construit elle-même sa trappe (le panneau de réglages) et son bouton.
A plug-in is a single text file named my-plugin.plugin.js. No folder, no separate manifest, no dependency to install: the file is the plug-in. It declares what it can do, and the application builds its panel (French “trappe”) and its button on its own.
Trois plug-ins sont livrés avec l'application et servent de référence lisible : Global Refactor (app/plugins/global-refactor.plugin.js), Motif (app/plugins/motif-vectoriel.plugin.js) et Contrôle avant impression (app/plugins/print-studio.plugin.js). Ce sont de vrais plug-ins, pas des exemples : leur code est la documentation la plus à jour.
Three plug-ins ship with the application and are readable references: Global Refactor (app/plugins/global-refactor.plugin.js), Vector Pattern (app/plugins/motif-vectoriel.plugin.js) and Preflight studio (app/plugins/print-studio.plugin.js). They are real plug-ins, not samples: their code is the most up-to-date documentation.
⚠️ Le plug-in « Polices Google » a été retiré : il interrogeait fonts.googleapis.com à chaque aperçu, ce qui transmettait l'adresse IP du visiteur à Google sans base légale (voir la politique de confidentialité). Les polices de l'interface et des documents restent disponibles : elles sont auto-hébergées dans CSS/fonts.css.
⚠️ The “Google Fonts” plug-in has been removed: it queried fonts.googleapis.com for every preview, which sent the visitor's IP address to Google with no lawful basis (see the privacy policy). The interface and document fonts remain available: they are self-hosted in CSS/fonts.css.
⚠️ Un plug-in livré peut arriver éteint : c'est le cas du Contrôle avant impression, qui déclare actifParDefaut: false. Il apparaît dans la bibliothèque, s'y allume d'un clic, et c'est alors seulement qu'il prend sa place dans la barre du haut.
⚠️ A bundled plug-in may ship switched off: the Preflight studio does, by declaring actifParDefaut: false. It shows in the library, turns on with one click, and only then takes its place in the top bar.
1 · Installer et désinstaller
1 · Install and uninstall
- Ouvrez la bibliothèque : bouton Plug-ins en bas de la barre latérale gauche.
- Open the library: Plug-ins button at the bottom of the left sidebar.
- Glissez le fichier
.plugin.js n'importe où dans la fenêtre — sur le plan de travail comme sur la bibliothèque. Le dépôt d'un plug-in est reconnu où qu'il tombe.
- Drag the
.plugin.js file anywhere in the window — on the workspace or on the library. A plug-in drop is recognised wherever it lands.
- Le plug-in est installé, activé, et conservé dans le navigateur (il survit à un rechargement). Un interrupteur permet de le désactiver sans le désinstaller.
- The plug-in is installed, enabled and kept in the browser (it survives a reload). A switch disables it without uninstalling.
Un plug-in désactivé n'est jamais exécuté, mais son code reste enregistré : le réactiver ne demande aucun nouveau fichier.
A disabled plug-in is never executed, but its code stays stored: re-enabling it needs no new file.
2 · Le squelette d'un plug-in
2 · The skeleton of a plug-in
Le fichier appelle une seule fonction, SPPluginAPI, avec un objet :
The file calls a single function, SPPluginAPI, with one object:
SPPluginAPI({
id: 'mon-plugin', // 2 à 64 caractères : lettres, chiffres, . _ -
name: { fr: 'Mon plug-in', en: 'My plug-in', ja: 'マイプラグイン' },
version: '1.0.0',
author: 'Votre nom',
description: {
fr: 'Ce que fait le plug-in, en une phrase.',
en: 'What the plug-in does, in one sentence.'
},
icon: '◆', // glyphe de secours
options: [
{ key: 'mot', label: { fr: 'Mot', en: 'Word' }, type: 'text', defaut: 'SuperPrint' },
{ key: 'taille', label: { fr: 'Corps', en: 'Size' }, type: 'number', min: 6, max: 200, defaut: 48, unite: 'pt' }
],
run: function (valeurs, api) {
const t = new api.fabric.Textbox(valeurs.mot, {
left: 80, top: 80, width: api.mm(120),
fontSize: valeurs.taille, fill: '#000000'
});
api.add(t, { libelle: 'Plug-in : texte' }); // annulable par Ctrl+Z
}
});
Tous les libellés (name, description, label, aide) acceptent soit une chaîne, soit un objet { fr, en, ja } : un plug-in monolingue n'a rien à traduire, un plug-in soigné suit la langue de l'interface.
Every label (name, description, label, aide) accepts either a string or a { fr, en, ja } object: a single-language plug-in has nothing to translate, a careful one follows the interface language.
3 · Les champs de la trappe (options)
3 · Panel fields (options)
| type | Ce qu'il affiche | What it shows |
text | Champ de texte libre | Free text field |
number | Nombre ; respecte min, max, pas et unite | Number; honours min, max, pas and unite |
range | Tirette ; le plug-in est relancé à chaque mouvement, avec api.apercu === true | Slider; the plug-in is re-run on each move with api.apercu === true |
color | Sélecteur de couleur | Colour picker |
checkbox | Case à cocher (booléen) | Checkbox (boolean) |
select | Liste déroulante ; les choix sont dans choix | Drop-down; the choices live in choix |
image | Sélecteur de fichier ; la valeur reçue est une dataURL | File picker; the value received is a dataURL |
images | Plusieurs images à la fois (mixeur) | Several images at once (mixer) |
apercu | Grande toile que le plug-in dessine lui-même (voir api.toileApercu()) | Large canvas the plug-in draws itself (see api.toileApercu()) |
Chaque champ accepte aussi aide (une phrase d'explication sous le champ) et, pour apercu, ratio (rapport hauteur/largeur de la toile, 1.414 pour un A4 portrait).
Each field also accepts aide (a hint under the field) and, for apercu, ratio (canvas height/width ratio, 1.414 for A4 portrait).
4 · L'API donnée à run(valeurs, api)
4 · The API given to run(valeurs, api)
| Membre | Member | À quoi il sert | What it is for |
api.fabric | Le moteur graphique : on construit les objets avec lui | The graphics engine: objects are built with it |
api.mm(v) / api.px(v) | Conversion millimètres ↔ points (l'unité interne est le point : 1 mm = 72/25,4) | Millimetres ↔ points (internal unit is the point: 1 mm = 72/25.4) |
api.add(obj, opts) | Ajoute un objet et écrit une entrée d'historique : le plug-in reste annulable par Ctrl+Z | Adds an object and writes a history entry: the plug-in stays undoable with Ctrl+Z |
api.addMany(liste) | Ajoute une série d'objets en une seule entrée | Adds a series of objects as one entry |
api.selection() | Les objets sélectionnés (tableau, vide si rien) | The selected objects (array, empty if none) |
api.document | Dimensions en points et en mm, page courante, nombre de pages, fond perdu, marges | Sizes in points and mm, current page, page count, bleed, margins |
api.canvases() | Tous les plans de travail — pour retirer un dessin partout où il a été posé | All workspaces — to remove a drawing everywhere it was placed |
api.remove(obj) | Retire un objet (aperçus successifs) | Removes an object (successive previews) |
api.sync() | Synchronise le document sans écrire d'historique | Syncs the document without writing history |
api.commit(libellé) | Écrit l'entrée d'historique (ignoré en aperçu) | Writes the history entry (ignored during preview) |
api.apercu | true quand la trappe est en aperçu direct : à vous de ne rien coûteux | true while live-previewing: up to you to skip expensive work |
api.toileApercu() | Toile de prévisualisation : { canvas, ctx, largeur, hauteur }, ou null | Preview canvas: { canvas, ctx, width, height }, or null |
api.t(v) / api.L(fr,en,ja) | Traduire un message dans la langue de l'interface | Translate a message into the interface language |
api.alert(msg) / api.prompt(q) | Les boîtes de l'application — jamais window.alert, la DA reste cohérente | The application's dialogs — never window.alert, so the UI stays consistent |
api.imageDataUrl() | Ouvre un sélecteur de fichier et rend une dataURL | Opens a file picker and returns a dataURL |
api.store.get/set | Petit stockage persistant, propre au plug-in | Small persistent store, private to the plug-in |
api.log(msg) | Trace dans la console, préfixée du nom du plug-in | Logs to the console, prefixed with the plug-in name |
Annuler fonctionne. Un objet posé par api.add écrit une entrée d'historique : l'utilisateur retrouve son document d'avant avec Ctrl+Z, comme après n'importe quelle action.
Undo works. An object placed with api.add writes a history entry: the user gets their previous document back with Ctrl+Z, as after any action.
5 · Aperçu en direct : ce qu'il faut respecter
5 · Live preview: the rules
- Un champ
range relance run à chaque mouvement. Dans ce cas api.apercu vaut true : n'écrivez ni historique ni message.
- A
range field re-runs run on every move. Then api.apercu is true: write no history and no message.
- Retirez le dessin précédent (
api.remove, ou api.canvases() pour un nettoyage global) avant de poser le nouveau, sinon les aperçus s'empilent.
- Remove the previous drawing (
api.remove, or api.canvases() for a global clean-up) before placing the new one, otherwise previews pile up.
- La validation écrit l'historique une seule fois : c'est l'application qui s'en charge, pas le plug-in.
- Validation writes the history entry once: the application does it, not the plug-in.
6 · Ce qu'un plug-in ne peut pas faire
6 · What a plug-in cannot do
- Il ne voit aucune variable interne de l'application : son code est évalué dans une fonction isolée et ne reçoit que
SPPluginAPI. Tout ce dont il a besoin passe par l'api.
- It sees none of the application's internal variables: its code is evaluated in an isolated function and only receives
SPPluginAPI. Everything it needs goes through the api.
- Il ne peut pas réclamer une « trappe » du produit : ce privilège est réservé aux plug-ins intégrés (
integre: true), sinon un fichier installé pourrait exécuter du code produit d'un seul clic.
- It cannot claim one of the product's own panels: that privilege is reserved for built-in plug-ins (
integre: true), otherwise an installed file could run product code in one click.
- Il ne peut pas installer un autre plug-in, ni écrire hors de son propre stockage.
- It cannot install another plug-in, nor write outside its own store.
7 · Vérifier et déboguer
7 · Check and debug
- Ouvrez la console du navigateur (F12) :
api.log() y écrit, préfixé du nom du plug-in, et les erreurs de chargement y apparaissent en clair.
- Open the browser console (F12):
api.log() writes there, prefixed with the plug-in name, and loading errors appear in plain text.
- Un identifiant invalide, un nom manquant ou un
run absent sont refusés à l'installation, avec le motif exact — le plug-in fautif n'entre pas dans la bibliothèque.
- An invalid identifier, a missing name or a missing
run is refused at install time with the exact reason — the faulty plug-in never enters the library.
- Un plug-in qui échoue au chargement ne casse pas la bibliothèque : il est signalé, les autres restent utilisables.
- A plug-in that fails to load does not break the library: it is reported, the others stay usable.
SuperPrint — simon@2points13.fr
Manuel mis à jour le 18 octobre 2026 — v1.7.687
Manual updated October 18, 2026 — v1.7.687