Python Scripts Organization

Inhoud
Index 🔎︎

# Python Scripts Organization and Location

LibreOffice macros are grouped in module files, modules are usually grouped in library folders, and libraries are grouped in library containers although containers can contain modules too.

A library is used as a major grouping for either an entire category of macros, or for an entire application. Modules usually split functionality, such as user interaction and calculations. Individual macros are subroutines and functions. The Figure below shows an example of the hierarchical structure of macro libraries in LibreOffice.

Figure: Macro Library hierarchy

The containers are accessible in all LibreOffice programs through the user interface. Go to Tools > Macros > Organize Macros > Python, to open the Python Macros dialog.

Three library containers are shown in the Macro From list:

1. My Macros: personal macros available for the LibreOffice user

2. LibreOffice Macros: system macros distributed with LibreOffice for every computer user

3. Document macros: every document can contain macro libraries available in that document for all users

## Python Script-locaties

Refer to Getting Session Information in order to get programmatic access to Python script locations.

### LibreOffice Macros

Bestaande macro's op deze locatie (container) werden gekopieerd door het installatieprogramma en zijn beschikbaar voor elke computergebruiker, en elk open document heeft toegang tot macro's die in de container zijn opgeslagen. U hebt beheerdersrechten nodig om macro's hier op te slaan of te bewerken.

De LibreOffice macro-containerlocatie in het bestandssysteem is afhankelijk van het besturingssysteem:

- Voor Windows: {Installatie}\share\Scripts\python.

- Voor Linux en macOS: {Installatie}/share/Scripts/python.

### Mijn macro's

Deze container is alleen toegankelijk voor de gebruiker van LibreOffice. Elk open document heeft toegang tot macro's die in de container zijn opgeslagen. Macro's op deze locatie worden opgeslagen in het gebruikersprofiel van LibreOffice.

De containerlocatie Mijn macro's in het bestandssysteem is afhankelijk van het besturingssysteem:

- Voor Windows,
  %APPDATA%\LibreOffice\4\user\Scripts\python.

- Voor Linux en macOS,
  $HOME/.config/libreoffice/4/user/Scripts/python.

### Document-macro's

Documentmacro's zijn ingesloten in het document en zijn alleen toegankelijk als het document open is.

## Bibliotheken, modules en macro's

Python macros can be organized in libraries, modules and macros. Use the Macro Library hierarchy as a guide when creating or installing new macros in module files, new module files in library folders or new library folders in containers.

Verwante onderwerpen

Getting Session Information

Hulp bij LibreOffice Python-scripts