📖

Guide d'utilisation — Cut

Découpez une mallette ODT en fiches indépendantes, étape par étape.

Créé par FCO
📄

Qu'est-ce que Cut ?

Vue d'ensemble du processus en 3 étapes

Cut est un outil local (aucun serveur requis) qui permet de découper une mallette (fichier ODT) en plusieurs fiches (fichiers ODT indépendants), en choisissant visuellement quelles pages vont dans quelle fiche.

Terminologie

TermeDéfinition
MalletteLe fichier ODT source à découper.
FicheUn fichier ODT produit par le découpage, contenant une sélection de pages.
mallette-cut.jsonFichier JSON qui décrit le découpage : liste des fiches et leurs pages.
ℹ️
Une page peut appartenir à plusieurs fiches Par exemple, une page de garde ou un sommaire peut être inclus dans toutes les fiches sans avoir à le dupliquer manuellement.

Vue d'ensemble du flux

┌────────────────────────────────────────────────────┐ │ ÉTAPE 1 — Préparer (une fois par mallette) │ │ LibreOffice → Fichier › Exporter en PDF │ │ → mallette.pdf (dans le même dossier) │ └────────────────────┬───────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────┐ │ ÉTAPE 2 — Définir le découpage (navigateur) │ │ Ouvrir index.html → charger mallette.pdf │ │ Créer des fiches → glisser des pages dedans │ │ Cliquer "Sauvegarder" → télécharge mallette-cut.json │ └────────────────────┬───────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────┐ │ ÉTAPE 3 — Générer les fiches ODT (local) │ │ Ouvrir mallette.odt dans LibreOffice │ │ Lancer la macro Cut - run.py (Outils › Macros) │ │ → Les fiches ODT sont créées dans fiches/ │ └────────────────────────────────────────────────────┘
0

Prérequis

Ce dont vous avez besoin avant de commencer

ÉlémentDétail
✅ LibreOffice Doit être installé. Utilisé pour exporter le PDF et générer les fiches ODT.
✅ Firefox ou Chrome Pour ouvrir index.html. Firefox est recommandé.
✅ Windows Environnement cible (LibreOffice y est disponible).
✅ Votre fichier ODT La mallette source que vous souhaitez découper.
✅
Aucun droit administrateur requis L'outil fonctionne entièrement sans installation supplémentaire. Pas de Python, pas de serveur, pas de plugins.
1

Étape 1 — Exporter la mallette en PDF

À faire une seule fois par mallette (ou après chaque modification du ODT)

L'application affiche les pages de votre mallette en les lisant depuis un PDF. Vous devez donc d'abord exporter votre fichier ODT en PDF depuis LibreOffice.

Procédure

  1. Ouvrez votre fichier mallette.odt dans LibreOffice Writer.
  2. Dans le menu, cliquez sur Fichier › Exporter en PDF…
  3. Dans la boîte de dialogue, cliquez sur Exporter (les options par défaut conviennent).
  4. Enregistrez le fichier PDF dans le même dossier que le fichier ODT, avec le même nom de base.
    Exemple : mallette.odt → mallette.pdf
⚠️
À refaire après chaque modification du ODT Si vous modifiez votre mallette ODT, répétez l'export PDF pour que la visionneuse affiche les pages à jour.

Où placer les fichiers ?

La mallette ODT peut se trouver n'importe où sur votre disque. La macro détermine automatiquement son emplacement à partir du document ouvert dans LibreOffice.

Le seul fichier à placer à côté de la mallette avant la génération est mallette-cut.json :

📁 N'importe où sur votre disque… ├── mallette.odt ← Votre document source ├── mallette.pdf ← L'export PDF (généré à cette étape) ├── mallette-cut.json ← À placer ici avant l'étape 3 └── fiches/ ← Créé automatiquement à l'étape 3 ├── fiche_Introduction.odt └── fiche_Chapitre1.odt
ℹ️
index.html et Cut - run.py sont des outils, pas des fichiers de projet Ils peuvent rester dans un dossier fixe sur votre poste. Vous les utilisez pour toutes vos mallettes, peu importe où elles se trouvent.
2

Étape 2 — Définir le découpage dans le navigateur

Créer les fiches et leur assigner des pages par glisser-déposer

Ouvrir l'application

  1. Double-cliquez sur index.html pour l'ouvrir dans votre navigateur (ou faites un clic droit → Ouvrir avec → Firefox).
  2. Cliquez sur le bouton 📂 Charger un PDF dans la barre d'en-tête, ou glissez directement votre PDF dans la zone centrale.
  3. Sélectionnez votre mallette.pdf. Les pages s'affichent immédiatement.

Interface en 2 colonnes

📄 Cut — mallette.pdf
📄
◀ Page 2 / 10 ▶
1●
22
3●
4
Fiches ＋
▶ Introduction  3 pg
p.1 p.2 p.3
▶ Chapitre 1  2 pg
p.2 p.4
  • Colonne gauche : visionneuse de la page courante + bandeau de vignettes.
  • Colonne droite : liste des fiches que vous créez.

Créer et nommer une fiche

  1. Cliquez sur le bouton ＋ dans l'en-tête de la colonne Fiches (colonne droite).
  2. Une fiche apparaît avec un nom par défaut. Cliquez sur le nom pour le modifier.
  3. Répétez pour chaque fiche que vous souhaitez créer.

Assigner des pages à une fiche

Vous pouvez glisser une seule page ou une sélection multiple vers une fiche.

Sélection simple

  1. Cliquez sur une vignette pour la sélectionner (fond bleu, contour bleu).
  2. Faites glisser la vignette vers la zone de dépôt de la fiche (colonne droite).
  3. La page s'ajoute à la fiche et apparaît sous forme de pastille (p.3).

Sélection multiple

ActionEffet
Clic Sélectionne uniquement cette page (désélectionne les autres).
Ctrl + Clic Ajoute ou retire cette page de la sélection.
Shift + Clic Sélectionne toute la plage entre la dernière page cliquée et celle-ci.
Échap Désélectionne tout.

Une fois vos pages sélectionnées, glissez n'importe laquelle d'entre elles vers une fiche : toutes les pages sélectionnées sont ajoutées ensemble, dans l'ordre.

💡
Pages partagées entre fiches Une même page (ou sélection) peut être glissée dans plusieurs fiches différentes. C'est intentionnel : une page de garde ou un sommaire peut figurer dans toutes les fiches.

Comprendre les badges sur les vignettes

BadgeSignification
(aucun badge) La page n'est assignée à aucune fiche.
● La page est assignée à 1 fiche.
2 3 La page est assignée à plusieurs fiches (le chiffre indique combien).

Survolez une vignette avec le curseur pour voir le tooltip listant les fiches qui contiennent cette page.

Réordonner et retirer des pages

  • Dans la liste des pages d'une fiche, glissez-déposez les pastilles pour changer leur ordre.
  • Cliquez sur le × d'une pastille pour retirer la page de cette fiche seulement (les autres fiches qui contiennent cette page ne sont pas affectées).

Reprendre un travail en cours

Si vous aviez déjà sauvegardé un mallette-cut.json, cliquez sur 📥 Charger mallette-cut.json dans la barre du bas. Les fiches et leurs pages seront restaurées.

Sauvegarder le plan de découpage

  1. Lorsque toutes vos fiches sont définies, cliquez sur 💾 Sauvegarder mallette-cut.json.
  2. Un fichier mallette-cut.json est téléchargé dans votre dossier Téléchargements.
  3. Déplacez ce fichier dans le même dossier que votre mallette.odt.
ℹ️
Format du mallette-cut.json Le fichier liste chaque fiche avec son nom et les numéros de pages (1 = première page). Vous pouvez l'ouvrir dans un éditeur de texte pour vérifier ou corriger manuellement.
3

Étape 3 — Générer les fiches ODT

Lancer le script pour produire les fichiers ODT finaux

Préparer les fichiers

La mallette ODT peut se trouver n'importe où sur votre disque. Placez uniquement mallette-cut.json dans le même dossier que votre mallette.odt avant de lancer la macro.

📁 Dossier de votre mallette (où qu'il soit) ├── mallette.odt ← Ouvrez ce fichier dans LibreOffice └── mallette-cut.json ← Copiez-le ici depuis vos Téléchargements

La macro Cut - run.py doit être installée une fois dans LibreOffice (voir le chapitre suivant). Elle créera automatiquement un sous-dossier fiches\ à côté de votre mallette.

Lancer la génération

  1. Ouvrez votre mallette.odt dans LibreOffice Writer.
  2. Allez dans Outils › Macros › Organiser les macros › Python…
  3. Dans la boîte de dialogue, développez Mes macros › Cut - run.
  4. Sélectionnez la fonction main et cliquez sur Exécuter.
  5. À la fin, les fiches ODT sont créées dans un sous-dossier fiches\.

Résultat attendu

Un sous-dossier fiches\ est créé automatiquement à côté de votre mallette :

📁 Dossier de votre mallette (où qu'il soit) ├── mallette.odt ├── mallette-cut.json └── fiches\ ← Créé automatiquement ├── fiche_Introduction.odt ← pages 1, 2, 3 ├── fiche_Chapitre_1.odt ← pages 2, 4, 5 └── fiche_Exercices.odt ← pages 2, 8, 9

Si LibreOffice n'est pas détecté automatiquement

Le script cherche LibreOffice dans les emplacements standards. S'il ne le trouve pas, il vous demandera de saisir le chemin complet de soffice.exe.

⚠️
La macro doit être enregistrée dans LibreOffice Si le script indique que la macro n'a pas pu être lancée directement, il faudra installer manuellement le script Python dans LibreOffice. Consultez le chapitre suivant.
🔴
Ne pas fermer LibreOffice pendant la génération Attendez que la macro se termine avant d'intervenir dans LibreOffice. Interrompre l'exécution peut laisser des fichiers ODT incomplets dans fiches\.
🐍

Installation du script Python sous LibreOffice

Enregistrer Cut - run.py comme macro utilisateur dans LibreOffice

Cut - run.py est une macro Python qui s'exécute à l'intérieur de LibreOffice. Pour qu'elle soit disponible, elle doit être copiée dans le dossier des macros utilisateur de LibreOffice.

ℹ️
Pourquoi ne pas utiliser Python directement ? Le script utilise l'API UNO de LibreOffice pour manipuler les documents ODT. Il ne peut s'exécuter qu'au sein du moteur LibreOffice, pas comme un script Python autonome.

Étape A — Copier le script dans le dossier des macros

  1. Ouvrez l'Explorateur de fichiers et naviguez vers le dossier des macros utilisateur de LibreOffice. Ce dossier se trouve généralement ici : 
    C:\Users\VotreNom\AppData\Roaming\LibreOffice\4\user\Scripts\python\
    Note : AppData est un dossier caché. Dans l'Explorateur, cochez Affichage › Éléments masqués pour le voir.
  2. Si le sous-dossier python\ n'existe pas, créez-le.
  3. Copiez le fichier Cut - run.py dans ce dossier python\.
💡
Raccourci : ouvrir le dossier depuis LibreOffice Dans LibreOffice : Outils › Macros › Éditer les macros… → Dans l'IDE Basic, allez dans Fichier › Ouvrir pour localiser le dossier, ou utilisez la commande ci-dessous dans l'Explorateur Windows.

Étape B — Vérifier que la macro est bien reconnue

  1. Ouvrez LibreOffice Writer (n'importe quel document).
  2. Allez dans Outils › Macros › Organiser les macros › Python…
  3. Dans la boîte de dialogue, développez Mes macros.
  4. Vous devriez voir Cut - run dans la liste, avec la fonction main disponible.

Étape C — Exécuter la macro

  1. Ouvrez votre mallette.odt dans LibreOffice Writer.
  2. Assurez-vous que mallette-cut.json est dans le même dossier que mallette.odt.
  3. Allez dans Outils › Macros › Organiser les macros › Python…
  4. Sélectionnez Mes macros › Cut - run › main.
  5. Cliquez sur Exécuter.
  6. La macro lit mallette-cut.json, découpe la mallette et génère les fiches ODT dans le sous-dossier fiches\.
⚠️
La mallette doit être enregistrée sur le disque La macro détermine le chemin de mallette-cut.json à partir de l'emplacement de la mallette. Si le fichier ODT n'a jamais été enregistré (document nouveau sans chemin), la macro ne pourra pas fonctionner.

Emplacement des macros selon la version de LibreOffice

ContexteChemin du dossier python\
Installation standard (utilisateur) %APPDATA%\LibreOffice\4\user\Scripts\python\
Installation sans droits admin
(dossier utilisateur local)		 %LOCALAPPDATA%\LibreOffice\4\user\Scripts\python\
Installation portable Voir la documentation de votre version portable.

Dépannage

ProblèmeSolution
La macro n'apparaît pas dans la liste Vérifiez que Cut - run.py est bien dans le dossier Scripts\python\ et que LibreOffice a été redémarré après la copie.
Erreur "mallette-cut.json introuvable" Assurez-vous que mallette-cut.json est dans le même dossier que la mallette ODT ouverte.
Erreur "La mallette doit être enregistrée" Enregistrez d'abord le fichier ODT sur le disque (Ctrl+S) avant de lancer la macro.
Les fiches sont vides ou mal formées Vérifiez le contenu de mallette-cut.json (numéros de pages valides, noms non vides).
LibreOffice plante ou se fige Fermez tous les documents LibreOffice ouverts, puis relancez la macro sur la mallette seule.