2021-02-04 22:42:11 -06:00
|
|
|
|
|
|
|
|
Introduction
|
|
|
|
|
============
|
|
|
|
|
|
2021-02-04 22:53:14 -06:00
|
|
|
Overview
|
|
|
|
|
--------
|
|
|
|
|
|
2021-02-04 22:49:23 -06:00
|
|
|
ZAZ is a script for rapid develop extensions and macros for `LibreOffice`_, in
|
2021-02-04 22:42:11 -06:00
|
|
|
`Python`_ of course.
|
|
|
|
|
|
2021-02-04 22:49:23 -06:00
|
|
|
With ZAZ, you can create:
|
|
|
|
|
|
|
|
|
|
* Extensions for final user
|
|
|
|
|
* New components for used from Basic
|
|
|
|
|
* AddIn, new functions for Calc
|
|
|
|
|
|
2021-02-04 22:42:11 -06:00
|
|
|
|
2021-02-04 22:53:14 -06:00
|
|
|
Requirements
|
|
|
|
|
------------
|
|
|
|
|
|
2021-02-04 23:08:24 -06:00
|
|
|
* Python 3.7+
|
|
|
|
|
* LibreOffice 7.0+ with support for macros Python
|
2021-02-04 22:53:14 -06:00
|
|
|
* LibreOffice SDK, for new components and Add-In
|
|
|
|
|
|
2021-02-07 21:30:54 -06:00
|
|
|
In:
|
|
|
|
|
|
|
|
|
|
* ArchLinux
|
|
|
|
|
* sudo pacman -S libreoffice-fresh-sdk
|
|
|
|
|
* Ubuntu 20.04+
|
|
|
|
|
* sudo apt install libreoffice-script-provider-python libreoffice-dev
|
|
|
|
|
|
2021-02-04 22:53:14 -06:00
|
|
|
|
2021-02-04 23:08:24 -06:00
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
2021-02-07 21:30:54 -06:00
|
|
|
* Clone this repository (recommended) or download it.
|
2021-02-04 23:08:24 -06:00
|
|
|
|
|
|
|
|
``git clone https://git.cuates.net/elmau/zaz.git``
|
|
|
|
|
|
|
|
|
|
* Move to.
|
|
|
|
|
|
|
|
|
|
``cd zaz/source``
|
|
|
|
|
|
|
|
|
|
* Start new extension.
|
|
|
|
|
|
2021-02-05 22:24:30 -06:00
|
|
|
``./zaz.py -new -t ~/projects -n MyFirstExtension``
|
2021-02-04 23:08:24 -06:00
|
|
|
|
2021-02-04 22:53:14 -06:00
|
|
|
|
2021-02-04 23:19:23 -06:00
|
|
|
My first extension
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
* Move to:
|
|
|
|
|
|
2021-02-05 22:24:30 -06:00
|
|
|
``cd ~/projects/MyFirstExtension``
|
2021-02-04 23:19:23 -06:00
|
|
|
|
|
|
|
|
* Create:
|
|
|
|
|
|
|
|
|
|
``python zaz.py -c``::
|
|
|
|
|
|
|
|
|
|
↪ python zaz.py -c
|
|
|
|
|
04/02/2021 23:07:50 - INFO - Created directories...
|
|
|
|
|
04/02/2021 23:07:50 - INFO - Created files...
|
|
|
|
|
04/02/2021 23:07:50 - INFO - Don't forget generate DOMAIN.pot for locales
|
2021-02-07 21:30:54 -06:00
|
|
|
04/02/2021 23:07:50 - INFO - New extension: MyFirstExtension make successfully...
|
2021-02-04 23:19:23 -06:00
|
|
|
Now, you can install and test: zaz.py -i
|
|
|
|
|
|
|
|
|
|
* Install and test:
|
|
|
|
|
|
|
|
|
|
``python zaz.py -i``::
|
|
|
|
|
|
|
|
|
|
↪ python zaz.py -i
|
|
|
|
|
04/02/2021 23:11:40 - INFO - Don't forget generate DOMAIN.pot for locales
|
|
|
|
|
04/02/2021 23:11:40 - INFO - Compress OXT extension...
|
2021-02-07 21:30:54 -06:00
|
|
|
04/02/2021 23:11:40 - INFO - Extension OXT created successfully...
|
2021-02-04 23:19:23 -06:00
|
|
|
Copying: MyFirstExtension_v0.1.0.oxt
|
|
|
|
|
|
|
|
|
|
unopkg done.
|
|
|
|
|
|
2021-02-07 21:30:54 -06:00
|
|
|
04/02/2021 23:11:41 - INFO - Install extension successfully...
|
2021-02-04 23:19:23 -06:00
|
|
|
04/02/2021 23:11:41 - INFO - Start LibreOffice...
|
|
|
|
|
04/02/2021 23:11:53 - INFO - Extension make successfully...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2021-02-04 22:42:11 -06:00
|
|
|
.. _LibreOffice: https://libreoffice.org
|
|
|
|
|
.. _Python: https://python.org
|
