Macros/Python Guide/Introduction/it

Ritorna all'indice

= Introduzione =

Cos'è PyUNO?
LibreOffice consente agli utenti di scrivere delle macro in diversi linguaggi interpretati, uno di questi è Python. PyUNO è il componente che fornisce agli utenti l'accesso all'interfaccia di programmazione dell'applicazione (d'ora in poi API dall'acronimo inglese Application Programming Interface) di LibreOffice con Python.

Installazione
Su alcuni sistemi operativi, come Ubuntu 18.04 LTS, potrebbe essere necessario installae dei pacchetti di sistema aggiuntivi. Su Ubuntu, il pacchetto si chiama libreoffice-script-provider-python e contiene dei file come scriptproviderforpython.rdb (XML metadata) e pythonscript.py (l'infrastruttura Python).


 * In Ubuntu 18.04 e successive

Verificare se le macro in Python sono supportate
Aprite un nuovo documenti in Writer. Selezionate il menu, apparirà la finestra di dialogo "Seleziona Macro". Nella sezione selezionate, nella sezione  selezionate  e fate clic sul pulsante.

Se visualizzate questo risultato, significa che il vostro sistema è in grado di eseguire le macro in Python.



Dove salvare le macro?
Non esiste uno strumento incorporato per modificare gli script in Python, perciò dovrete usare il vostro editor di testo. Ci sono 3 posti nei quali potete salvare il vostro codice.

Nella cartella del profilo UTENTE, le macro saranno disponibili solo per l'UTENTE

 * GNU/Linux: /home/USER/.config/libreoffice/4/user/Scripts/python
 * Windows: %APPDATA%\LibreOffice\4\user\Scripts\python
 * macOS: ~/Library/Application Support/LibreOffice/4/user/Scripts/python/

Nella cartella di LibreOffice, le macro saranno disponibili per tutti gli utenti
/usr/lib/libreoffice/share/Scripts/python/
 * GNU/Linux

I percorsi sopra menzionati sono quelli predefiniti. In installazioni personalizzate potrebbero essere differenti. Se le cartelle non esistono, dovrete crearle, rispettando le lettere maiuscole e minuscole.

All'interno di un documento

 * Qualsiasi file ODF, in realtà è un file ZIP, che potete estrarre normalmente come estraete questo tipo di file. Nella radice, create una cartella Scripts/python/ e copiate al suo interno qualsiasi file in python, per esempio: mymacros.py
 * Dovreste vedere questo:

myfile |  ...  ├── META-INF │  └── manifest.xml ├── Scripts │  └── python │      └── mymacros.py  ...


 * Modificate il file manifest.xml nella cartella META-INF ed aggiungete delle righe prima del tag  di chiusura


 * Il file finale dovrebbe avere il seguente aspetto:


 * A questo punto comprimete nuovamente in zip il contenuto dell'intera cartella. Attenzione non comprimete la cartella esterna, ma il contenuto della cartella

Ritorna all'indice