From f8dc93d65b5d06c91cda190467157ebb9837f4f2 Mon Sep 17 00:00:00 2001 From: Mauricio Baeza Date: Fri, 22 Mar 2024 10:23:53 -0600 Subject: [PATCH] Update Home --- Home.md | 320 ++++++++++++++++++++++++++++---------------------------- 1 file changed, 160 insertions(+), 160 deletions(-) diff --git a/Home.md b/Home.md index 43687c6..ca8f7d7 100644 --- a/Home.md +++ b/Home.md @@ -1,160 +1,160 @@ -# ZAZ - -[Leer en español](es.home) - -## Develop macros and extensions for LibreOffice with Python - -`zaz` it's a script Python for rapid develop macros in LibreOffice, with Python of course. - -With `zaz`, you can create: - -* Extensions for final user. -* New components for used from Basic developers. -* AddIn, new functions for Calc. - - -## Requirements - -* Python 3.7+ -* LibreOffice with support for macros Python -* LibreOffice SDK, for new components and AddIn - * For ArchLinux - ``` - sudo pacman -S libreoffice-fresh-sdk - ``` - - -## Installation - -* Clone this repository. -``` -git clone https://git.elmau.net/elmau/zaz.git -``` - -## My first extension - -* Enter folder `source`. -``` -cd zaz/source -``` - -* Make new extension. - -Replace `PATH` for your absolute path. - -``` -python zaz.py --new -t PATH -n my-great-extension -``` - -* For example: -``` -python zaz.py --new -t /home/mau/ -n my-extension -07/11/2020 18:28:39 - INFO - Folders and files copy successfully for new extension. -07/11/2020 18:28:39 - INFO - Change to folder: /home/mau/my-extension -``` - -* Then change to new folder -``` -cd /home/mau/my-extension -``` - -* Create -``` -python zaz.py -c - -07/11/2020 20:43:25 - INFO - Created directories... -07/11/2020 20:43:25 - INFO - Created files... -07/11/2020 20:43:25 - INFO - Don't forget generate DOMAIN.pot for locales -07/11/2020 20:43:25 - INFO - New extension: MyFirstExtension make sucesfully... - Now, you can install and test: zaz.py -i -``` - -* And install it - -``` -python zaz.py -i - -07/11/2020 20:43:38 - INFO - Don't forget generate DOMAIN.pot for locales -07/11/2020 20:43:38 - INFO - Compress OXT extension... -07/11/2020 20:43:38 - INFO - Extension OXT created sucesfully... -Copying: MyFirstExtension_v0.1.0.oxt - -unopkg done. - -07/11/2020 20:43:40 - INFO - Install extension sucesfully... -07/11/2020 20:43:40 - INFO - Start LibreOffice... -07/11/2020 20:44:36 - INFO - Extension make successfully... -``` - - -## File conf.py - -Only modify this options. - -**Configure correctly this options in this file, before you create your new extension.** - - -### Type extension - -`TYPE_EXTENSION` - -It's important select correctly this option. - -* Integer - * 1 = Normal extension - * 2 = New components - * 3 = Calc addin - -Example: -```python -TYPE_EXTENSION = 1 -``` - - -### Name - -Your extension name, not used spaces. - -`NAME` - -* String - -Example: -```python -NAME = 'MyExtension' -``` - - -### Version - -`VERSION` - -* String - * Version for extension, look: [https://semver.org/](https://semver.org/) - -Example: -```python -VERSION = '0.1.0' -``` - - -### ID extension - -Internal name for your extension. - -`ID` - -* String - * Should be unique, used URL inverse - -Example: -```python -ID = 'org.yourname.extensionname' -``` - -## Library easymacro.py - -[Documentation for `easymacro.py`](easymacro) - - -[Leer en español](es.home) +# ZAZ + +[Leer en español](es.home) + +## Develop macros and extensions for LibreOffice with Python + +`zaz` it's a script Python for rapid develop macros in LibreOffice, with Python of course. + +With `zaz`, you can create: + +* Extensions for final user. +* New components for used from Basic developers. +* AddIn, new functions for Calc. + + +## Requirements + +* Python 3.7+ +* LibreOffice with support for macros Python +* LibreOffice SDK, for new components and AddIn + * For ArchLinux + ``` + sudo pacman -S libreoffice-fresh-sdk + ``` + + +## Installation + +* Clone this repository. +``` +git clone https://git.cuates.net/elmau/zaz.git +``` + +## My first extension + +* Enter folder `source`. +``` +cd zaz/source +``` + +* Make new extension. + +Replace `PATH` for your absolute path. + +``` +python zaz.py --new -t PATH -n my-great-extension +``` + +* For example: +``` +python zaz.py --new -t /home/mau/ -n my-extension +07/11/2020 18:28:39 - INFO - Folders and files copy successfully for new extension. +07/11/2020 18:28:39 - INFO - Change to folder: /home/mau/my-extension +``` + +* Then change to new folder +``` +cd /home/mau/my-extension +``` + +* Create +``` +python zaz.py -c + +07/11/2020 20:43:25 - INFO - Created directories... +07/11/2020 20:43:25 - INFO - Created files... +07/11/2020 20:43:25 - INFO - Don't forget generate DOMAIN.pot for locales +07/11/2020 20:43:25 - INFO - New extension: MyFirstExtension make sucesfully... + Now, you can install and test: zaz.py -i +``` + +* And install it + +``` +python zaz.py -i + +07/11/2020 20:43:38 - INFO - Don't forget generate DOMAIN.pot for locales +07/11/2020 20:43:38 - INFO - Compress OXT extension... +07/11/2020 20:43:38 - INFO - Extension OXT created sucesfully... +Copying: MyFirstExtension_v0.1.0.oxt + +unopkg done. + +07/11/2020 20:43:40 - INFO - Install extension sucesfully... +07/11/2020 20:43:40 - INFO - Start LibreOffice... +07/11/2020 20:44:36 - INFO - Extension make successfully... +``` + + +## File conf.py + +Only modify this options. + +**Configure correctly this options in this file, before you create your new extension.** + + +### Type extension + +`TYPE_EXTENSION` + +It's important select correctly this option. + +* Integer + * 1 = Normal extension + * 2 = New components + * 3 = Calc addin + +Example: +```python +TYPE_EXTENSION = 1 +``` + + +### Name + +Your extension name, not used spaces. + +`NAME` + +* String + +Example: +```python +NAME = 'MyExtension' +``` + + +### Version + +`VERSION` + +* String + * Version for extension, look: [https://semver.org/](https://semver.org/) + +Example: +```python +VERSION = '0.1.0' +``` + + +### ID extension + +Internal name for your extension. + +`ID` + +* String + * Should be unique, used URL inverse + +Example: +```python +ID = 'org.yourname.extensionname' +``` + +## Library easymacro.py + +[Documentation for `easymacro.py`](easymacro) + + +[Leer en español](es.home)