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

As macros LibreOfficeDev estão agrupadas em ficheiros de módulos, os módulos estão normalmente agrupados em pastas de bibliotecas e as bibliotecas estão agrupadas em contentores de bibliotecas, embora os contentores também possam conter módulos.

Uma biblioteca é utilizada como um agrupamento principal, quer para uma categoria inteira de macros, quer para uma aplicação completa. Os módulos dividem normalmente as funcionalidades, tais como a interação com o utilizador e os cálculos. As macros individuais são sub-rotinas e funções. A figura abaixo mostra um exemplo da estrutura hierárquica das bibliotecas de macros no LibreOfficeDev.

Figura: Hierarquia da biblioteca de macros

Os contentores estão acessíveis em todos os programas LibreOfficeDev através da interface do utilizador. Aceda a Ferramentas > Macros > Organizar Macros > Python para abrir a caixa de diálogo «Macros Python».

Na lista «Macro de...» são apresentados três contentores da biblioteca:

1. As minhas macros: macros pessoais disponíveis para o utilizador LibreOfficeDev

2. Macros de aplicação: macros do sistema distribuídas com o LibreOfficeDev a todos os utilizadores do computador

3. Macros de documento: cada documento pode conter bibliotecas de macros disponíveis nesse documento para todos os utilizadores

Localização para os scripts Python

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

Macros de aplicações

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 LibreOfficeDev, 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 LibreOfficeDev. Qualquer documento aberto pode aceder às macros aqui guardadas. As macros deste local são guardadas no perfil de utilizador do LibreOfficeDev.

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

As macros Python podem ser organizadas em bibliotecas, módulos e macros. Utilize a hierarquia da Biblioteca de Macros como guia ao criar ou instalar novas macros em ficheiros de módulo, novos ficheiros de módulo em pastas de biblioteca ou novas pastas de biblioteca em contentores.