Организация и размещение сценариев Python

Макросы LibreOffice сгруппированы в файлы модулей, модули обычно группируются в папках библиотек, а библиотеки объединяются в контейнеры библиотек, хотя контейнеры также могут содержать модули.

Библиотека используется в качестве основного средства группирования как для всей категории макросов, так и для приложения в целом. Функционал в модулях обычно подразделяется, например, на взаимодействие с пользователем и вычисления. Отдельные макросы представляют собой подпроцедуры и функции. На рисунке внизу показан пример иерархической структуры библиотеки макросов в LibreOffice.

Рисунок: Иерархия библиотеки макросов

Доступ к контейнерам возможен во всех программах LibreOffice через пользовательский интерфейс. Перейдите в меню Сервис > Макросы > Управление макросами > Python, чтобы открыть диалоговое окно «Макросы Python».

Три библиотеки контейнеров показаны в списке «Макрос из»:

1. Мои макросы: пользовательские макросы доступны пользователю LibreOffice

2. Макросы приложения: системные макросы, поставляемые вместе с LibreOffice для всех пользователей компьютера

3. Встроенные макросы: каждый документ может содержать библиотеку макросов, доступную в данном документе для всех пользователей

Расположение сценариев Python

См. раздел Получение информации о сеансе для программного определения места расположения сценариев Python.

Макросы приложения

Макросы, находящиеся в этой области хранения (контейнере), были скопированы туда программой установки и доступны каждому пользователю компьютера. К макросам, находящимся в этом контейнере, может обращаться любой открытый документ. Для добавления или редактирования макросов в этом контейнере необходимо обладать правами администратора.

Конкретное место расположения контейнера макросов LibreOffice в файловой системе зависит от операционной системы:

• Для Windows: {Installation}\share\Scripts\python.

• Для Linux и macOS: {Installation}/share/Scripts/python.

Мои макросы

Контейнер доступен только пользователю LibreOffice. К макросам, находящимся в этом контейнере, может обращаться любой открытый документ. Макросы этого контейнера хранятся the в профиле пользователя LibreOffice.

Контейнер «Мои макросы» расположен в пользовательском пространстве и зависит от операционной системы:

• Для Windows
  %APPDATA%\LibreOffice\4\user\Scripts\python.

• Для Linux и macOS
  $HOME/.config/libreoffice/4/user/Scripts/python.

Встроенные макросы

Встроенные макросы находятся в документе и доступны только при его открытии.

Библиотеки, модули и макросы

Макросы Python можно группировать в библиотеки, модули и макросы. При создании или установке новых макросов в файлах модулей, новых файлов модулей в папках библиотек или новых папок библиотек в контейнерах руководствуйтесь иерархией Библиотеки макросов.