Macros/Python Guide/fr/Initialconcepts

⇐ Ma première macro Introduction au développement de macros Python ⇒
 * Table des matières|

Principes de base

Comment essayer des scripts de macros et comment intégrer des macros à un fichier LibreOffice ?

= Python et le mode interactif avec LibreOffice =

Avant toute création d'une macro python, vous pouvez tester vos macros avec un shell python interactif.

Voyons comment faire avec notre macro bonjour.py :

Vous devez d'abord lancer LibreOffice en mode serveur pour pouvoir communiquer avec votre shell python.

Sous Linux : libreoffice --accept="socket,host=localhost,port=2002;urp;StarOffice.ServiceManager" & Sous macOS : /Applications/LibreOffice.app/Contents/MacOS/soffice --accept="socket,host=localhost,port=2002;urp;StarOffice.ServiceManager" & Sous Windows : "C:\\Program Files (x86)\LibreOffice 5\program\soffice.exe" --accept="socket,host=localhost,port=2002;urp;"

Après lancez l'interpréteur python dans une console terminal bash, pour Linux et macOS, ou DOS avec cmd.exe pour Windows.

Sous Linux : python3

Sous macOS : /Applications/LibreOffice.app/Contents/MacOS/python

Sous Windows : "C:\\Program Files (x86)\LibreOffice 5\program\python.exe"

Puis saisissez ces lignes dans l'interpréteur Python :

Voici deux schémas d'explication du fonctionnement du mode interactif et macro :

= Emplacement des fichiers macro =

Vous avez trois possibilités d'emplacements pour vos fichiers de macro.

Ajout à la bibliothèque de LibreOffice
Copier votre macro dans :

Linux : /usr/lib/libreoffice/share/Scripts/python/

macOS : /Applications/LibreOffice.app/Contents/Resources/Scripts/python/

Windows : C:\Program Files (x86)\LibreOffice 5\share\Scripts\python\

Ajout à la bibliothèque de l'utilisateur
Copier votre macro dans :

Linux : ~/.config/libreoffice/4/user/Scripts/python/

macOS :

Windows : C:\Users\«User»\AppData\Roaming\LibreOffice\4\user\Scripts\python\

Ajouter dans un document LibreOffice
Les fichiers LibreOffice sont des documents compressés de structure de répertoires. Si vous décompressé un fichier ODT par exemple : unzip test.odt Vous obtenez l'arborrescence : .                                                                                                                                                                                                                  ├── Configurations2 │   ├── accelerator │   ├── floater │   ├── images │   │   └── Bitmaps │   ├── menubar │   ├── popupmenu │   ├── progressbar │   ├── statusbar │   ├── toolbar │   └── toolpanel ├── content.xml ├── manifest.rdf ├── META-INF │   └── manifest.xml ├── meta.xml ├── mimetype ├── settings.xml ├── styles.xml └── Thumbnails └── thumbnail.png

Il suffit de créér les répertoires : Scripts/python

et de copier votre script bonjour.py pour avoir cette arborescence . ├── Configurations2 │   ├── accelerator │   ├── floater │   ├── images │   │   └── Bitmaps │   ├── menubar │   ├── popupmenu │   ├── progressbar │   ├── statusbar │   ├── toolbar │   └── toolpanel ├── content.xml ├── manifest.rdf ├── META-INF │   └── manifest.xml ├── meta.xml ├── mimetype ├── Scripts │   └── python │      └── bonjour.py ├── settings.xml ├── styles.xml ├── test.odt └── Thumbnails └── thumbnail.png

Après il faut modifier le fichier META-INF/manifest.xml et ajouter :

soit le fichier complet :

Puis vous devez recompresser les fichiers : zip -r test.odt *



Script python d'intégration de macros dans un document LibreOffice
⇐ Ma première macro Introduction au développement en Python ⇒