zaz/doc/source/main/intro.rst

80 lines
1.7 KiB
ReStructuredText
Raw Normal View History

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-04 23:08:24 -06:00
Installation
------------
* Clone this repository (recomended) or download it.
``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
04/02/2021 23:07:50 - INFO - New extension: MyFirstExtension make sucesfully...
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...
04/02/2021 23:11:40 - INFO - Extension OXT created sucesfully...
Copying: MyFirstExtension_v0.1.0.oxt
unopkg done.
04/02/2021 23:11:41 - INFO - Install extension sucesfully...
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