Conteúdo

# Organização e localização de scripts Python

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. Application 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

## Localização para os scripts Python

Consulte Obter informação da sessão para ter acesso programático às localidades das macros Python.

### Application Macros

As macros neste local (contentor) foram copiadas pelo programa de instalação e estão disponíveis para todos os utilizadores do computador, e todos os documentos abertos pode aceder às macros guardadas no contentor. necessita de direitos de administrador para guardar ou editar macros aqui.

O local do contentor de macros do LibreOffice, no sistema de ficheiros, depende do sistema operativo utilizado:

- Para Windows: {Instalação}\share\Scripts\python.

- Para Linux e macOS: {Instalação}/share/Scripts/python.

### As minhas macros

Este contentor apenas pode ser acedido pelo utilizador do LibreOffice. Qualquer documento aberto pode aceder às macros aqui guardadas. As macros deste local são guardadas no perfil de utilizador do LibreOffice.

O local do contentor 'Minhas macros', no sistema de ficheiros, depende do sistema operativo utilizado:

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

- Em Linux e macOS,
  $HOME/.config/libreoffice/4/user/Scripts/python.

### Macros de documentos

As macros estão incorporadas no documento e apenas podem ser acedidas se o documento estiver aberto.

## Bibliotecas, módulos e macros

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.

Tópicos relacionados

Obter informação da sessão

Ajuda para os scripts Python no LibreOffice