From 2ad3122984661f9758f41a4b2cbd2b02b6fb97d5 Mon Sep 17 00:00:00 2001 From: Mauricio Baeza Date: Wed, 17 Aug 2022 22:02:54 -0500 Subject: [PATCH] Refactory and documented LibreOffice Menus --- doc/content/es/application/menus/_index.md | 171 +++ .../es/application/shortcuts/_index.md | 114 ++ doc/public/404.html | 16 +- doc/public/categories/index.html | 52 +- doc/public/es/404.html | 16 +- doc/public/es/application/index.html | 154 +- doc/public/es/application/menus/index.html | 1287 +++++++++++++++++ doc/public/es/application/menus/index.xml | 10 + .../es/application/shortcuts/index.html | 1198 +++++++++++++++ doc/public/es/application/shortcuts/index.xml | 10 + doc/public/es/calc/index.html | 150 +- doc/public/es/categories/index.html | 150 +- doc/public/es/dialog/index.html | 150 +- doc/public/es/documents/index.html | 152 +- doc/public/es/index.html | 150 +- doc/public/es/index.json | 14 + doc/public/es/installation/index.html | 150 +- doc/public/es/sitemap.xml | 4 + doc/public/es/tags/index.html | 150 +- doc/public/es/tools/dates_and_time/index.html | 150 +- doc/public/es/tools/email/index.html | 150 +- doc/public/es/tools/index.html | 150 +- doc/public/es/tools/macros/index.html | 150 +- doc/public/es/tools/messages/index.html | 150 +- doc/public/es/tools/paths/index.html | 150 +- doc/public/es/tools/threads/index.html | 150 +- doc/public/es/tools/timer/index.html | 150 +- doc/public/es/tools/url/index.html | 150 +- doc/public/es/tools/utils/index.html | 150 +- doc/public/es/tools_debug/index.html | 150 +- doc/public/fr/404.html | 16 +- doc/public/fr/categories/index.html | 52 +- doc/public/fr/index.html | 52 +- doc/public/fr/tags/index.html | 52 +- doc/public/index.html | 52 +- doc/public/installation/index.html | 52 +- doc/public/pt/404.html | 16 +- doc/public/pt/categories/index.html | 52 +- doc/public/pt/index.html | 52 +- doc/public/pt/installation/index.html | 52 +- doc/public/pt/tags/index.html | 52 +- doc/public/tags/index.html | 52 +- doc/public/tools_debug/index.html | 52 +- source/easymacro/__init__.py | 2 + source/easymacro/easymain.py | 1 + .../{zazplus => easyplus}/__init__.py | 0 .../{zazplus => easyplus}/easyplus.py | 0 .../easymacro/{zazplus => easyplus}/mureq.py | 0 source/easymacro/easytools.py | 561 ++++++- 49 files changed, 6070 insertions(+), 846 deletions(-) create mode 100644 doc/content/es/application/menus/_index.md create mode 100644 doc/content/es/application/shortcuts/_index.md create mode 100644 doc/public/es/application/menus/index.html create mode 100644 doc/public/es/application/menus/index.xml create mode 100644 doc/public/es/application/shortcuts/index.html create mode 100644 doc/public/es/application/shortcuts/index.xml rename source/easymacro/{zazplus => easyplus}/__init__.py (100%) rename source/easymacro/{zazplus => easyplus}/easyplus.py (100%) rename source/easymacro/{zazplus => easyplus}/mureq.py (100%) diff --git a/doc/content/es/application/menus/_index.md b/doc/content/es/application/menus/_index.md new file mode 100644 index 0000000..b41322a --- /dev/null +++ b/doc/content/es/application/menus/_index.md @@ -0,0 +1,171 @@ ++++ +title = "Menús" +weight = 2 ++++ + +### insert + +Insertar nuevo menú en Calc. + +En la propiedad `CommandURL` es posible establecer tanto un comando UNO de LibreOffice, como un diccionario con los datos de una macro. + +El nombre del menú es importante para cuando se quiera eliminar. + +```python +nombre_menu = 'zaz.my.menu' +menu = { + 'Label': 'My menu', + 'CommandURL': nombre_menu, + 'Submenu': [ + { + 'Label': 'Open Macros Dialog...', + 'CommandURL': 'MacroDialog', + }, + { + 'Label': '-', + }, + { + 'Label': 'My macro', + 'CommandURL': {'library': 'test', 'name': 'hola'}, + }, + { + 'Label': 'Execute macro...', + 'CommandURL': 'RunMacro', + 'ShortCut': 'Shift+Ctrl+Alt+E', + }, + ] +} + +menus_calc = app.menus['calc'] +menus_calc.insert(menu) +``` + + +### remove + +Eliminar un menú existente. + +```python +nombre_menu = 'zaz.my.menu' +menus_calc = app.menus['calc'] +menus_calc.remove(nombre_menu) +``` + +#### Insertar nuevo menú en uno existente. + +Dentro del menú Herramientas (`tools`), después de la opción `Macros...` + +```python +menu = app.menus['calc']['tools'] + +menu_nombre = 'zaz.my.menu' +menu_nuevo = { + 'Label': 'My menu', + 'CommandURL': menu_nombre, + 'Submenu': [ + { + 'Label': 'Open Macros Dialog...', + 'CommandURL': 'MacroDialog', + }, + { + 'Label': '-', + }, + { + 'Label': 'My macro', + 'CommandURL': {'library': 'test', 'name': 'hello'}, + }, + { + 'Label': 'Execute macro...', + 'CommandURL': 'RunMacro', + 'ShortCut': 'Shift+Ctrl+Alt+E', + }, + ] +} + +if menu_nombre in menu: + menu.remove(menu_nombre) +else: + menu.insert(menu_nuevo, '.uno:MacrosMenu') +``` + +### debug + +Para saber los nombres de cualquier menú. + +```python +menu = app.menus['calc']['tools'] +menu.debug() +``` + +``` +(0) .uno:SpellDialog +(1) .uno:SpellOnline +(2) .uno:ThesaurusDialog +(3) .uno:LanguageMenu + ├─ (0) .uno:SetLanguageAllTextMenu + ├─ (1) ---------- + ├─ (2) .uno:Hyphenate + ├─ (3) .uno:ChineseConversion + ├─ (4) .uno:HangulHanjaConversion + ├─ (5) ---------- + ├─ (6) .uno:MoreDictionaries +(4) ---------- +(5) .uno:AutoCorrectDlg +(6) .uno:AutoComplete +(7) .uno:ImageMapDialog +(8) ---------- +(9) .uno:RedactDoc +(10) .uno:AutoRedactDoc +(11) ---------- +(12) .uno:GoalSeekDialog +(13) .uno:SolverDialog +(14) .uno:AuditMenu + ├─ (0) .uno:ShowPrecedents + ├─ (1) .uno:ShowDependents + ├─ (2) ---------- + ├─ (3) .uno:ClearArrows + ├─ (4) .uno:ClearArrowPrecedents + ├─ (5) .uno:ClearArrowDependents + ├─ (6) ---------- + ├─ (7) .uno:ShowErrors + ├─ (8) .uno:RefreshArrows + ├─ (9) ---------- + ├─ (10) .uno:AuditingFillMode + ├─ (11) .uno:AutoRefreshArrows + ├─ (12) .uno:ShowInvalid +(15) .uno:ScenarioManager +(16) ---------- +(17) .uno:ToolsFormsMenu + ├─ (0) .uno:SwitchControlDesignMode + ├─ (1) .uno:UseWizards + ├─ (2) ---------- + ├─ (3) .uno:ControlProperties + ├─ (4) .uno:FormProperties + ├─ (5) ---------- + ├─ (6) .uno:ShowFmExplorer + ├─ (7) .uno:TabDialog + ├─ (8) .uno:AddField + ├─ (9) ---------- + ├─ (10) .uno:OpenReadOnly + ├─ (11) .uno:AutoControlFocus +(18) ---------- +(19) .uno:ShareDocument +(20) .uno:Protect +(21) .uno:ToolProtectionDocument +(22) ---------- +(23) .uno:MacrosMenu + ├─ (0) .uno:MacroRecorder + ├─ (1) .uno:RunMacro + ├─ (2) .uno:BasicIDEAppear + ├─ (3) .uno:ScriptOrganizer + ├─ (4) ---------- + ├─ (5) .uno:MacroSignature + ├─ (6) .uno:MacroOrganizer?TabId:short=1 + ├─ (7) ---------- + ├─ (8) .uno:OpenXMLFilterSettings +(24) .uno:DevelopmentToolsDockingWindow +(25) ---------- +(26) service:com.sun.star.deployment.ui.PackageManagerDialog +(27) .uno:ConfigureDialog +(28) .uno:OptionsTreeDialog +``` diff --git a/doc/content/es/application/shortcuts/_index.md b/doc/content/es/application/shortcuts/_index.md new file mode 100644 index 0000000..3d37ad0 --- /dev/null +++ b/doc/content/es/application/shortcuts/_index.md @@ -0,0 +1,114 @@ ++++ +title = "Accesos directos" +weight = 1 ++++ + +#### Globales + +Iterar en todos los accesos directos. Accesos directos disponibles para todas las aplicaciones. + +```python +for acceso_directo, comando in app.shortcuts: + app.debug(acceso_directo, comando) +``` + +Devolver una lista de tuplas con toda la información. + +```python +datos = app.shortcuts.get_all() +app.debug(datos) +``` + +Verificar si un acceso directo esta asignado. + +```python +acceso_directo = 'Shift+Ctrl+Alt+T' +app.debug(acceso_directo in app.shortcuts) +``` + +### set + +Establecer un acceso directo a un comando. + +```python +sc = app.shortcuts +acceso_directo = 'Shift+Ctrl+Alt+T' +comando = 'MacroDialog' +sc.set(acceso_directo, comando) +``` + +Establecer un acceso directo a una macro. + +```python +sc = app.shortcuts +acceso_directo = 'Shift+Ctrl+Alt+M' +macro = {'library': 'test', 'name': 'pruebas'} +sc.set(acceso_directo, macro) +``` + + +### get_by_shortcut + +Devolver el comando asociado a un acceso directo. + +```python +sc = app.shortcuts +acceso_directo = 'Shift+Ctrl+Alt+M' +comando = sc.get_by_shortcut(acceso_directo) +app.debug(comando) +``` + + +### get_by_command + +Devolver el acceso directo asociado a un comando. Puede haber más de uno. + +```python +sc = app.shortcuts +comando = 'MacroDialog' +acceso_directo = sc.get_by_command(comando) +app.debug(acceso_directo) +``` + + +### remove_by_shortcut + +Eliminar por acceso directo. + +```python +sc = app.shortcuts +acceso_directo = 'Shift+Ctrl+Alt+T' +sc.remove_by_shortcut(acceso_directo) +``` + + +### remove_by_command + +Eliminar por comando. + +```python +sc = app.shortcuts +macro = {'library': 'test', 'name': 'pruebas'} +sc.remove_by_command(macro) +``` + +### reset + +Reiniciar todas las modificaciones. + +```python +app.shortcuts.reset() +``` + + +#### Modificar accesos directos, solo en una aplicación. + +Por ejemplo Calc. + +```python +sc = app.shortcuts['calc'] +``` + +Los métodos son los mismos que los globales. + +Para las demas aplicaciones: `writer`, `draw`, `impress`, `math`. diff --git a/doc/public/404.html b/doc/public/404.html index bf84de5..f94e603 100644 --- a/doc/public/404.html +++ b/doc/public/404.html @@ -9,15 +9,15 @@ 404 Page not found - - - - - - - + + + + + + + - + + + + + + + + + +
+
+
+ +
+
+ + + + +
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ +

+ + Menús +

+ + + + + + +

insert

+

Insertar nuevo menú en Calc.

+

En la propiedad CommandURL es posible establecer tanto un comando UNO de LibreOffice, como un diccionario con los datos de una macro.

+

El nombre del menú es importante para cuando se quiera eliminar.

+
nombre_menu = 'zaz.my.menu'
+menu = {
+    'Label': 'My menu',
+    'CommandURL': nombre_menu,
+    'Submenu': [
+        {
+            'Label': 'Open Macros Dialog...',
+            'CommandURL': 'MacroDialog',
+        },
+        {
+            'Label': '-',
+        },
+        {
+            'Label': 'My macro',
+            'CommandURL': {'library': 'test', 'name': 'hola'},
+        },
+        {
+            'Label': 'Execute macro...',
+            'CommandURL': 'RunMacro',
+            'ShortCut': 'Shift+Ctrl+Alt+E',
+        },
+    ]
+}
+
+menus_calc = app.menus['calc']
+menus_calc.insert(menu)
+

remove

+

Eliminar un menú existente.

+
nombre_menu = 'zaz.my.menu'
+menus_calc = app.menus['calc']
+menus_calc.remove(nombre_menu)
+

Insertar nuevo menú en uno existente.

+

Dentro del menú Herramientas (tools), después de la opción Macros...

+
menu = app.menus['calc']['tools']
+
+menu_nombre = 'zaz.my.menu'
+menu_nuevo = {
+    'Label': 'My menu',
+    'CommandURL': menu_nombre,
+    'Submenu': [
+        {
+            'Label': 'Open Macros Dialog...',
+            'CommandURL': 'MacroDialog',
+        },
+        {
+            'Label': '-',
+        },
+        {
+            'Label': 'My macro',
+            'CommandURL': {'library': 'test', 'name': 'hello'},
+        },
+        {
+            'Label': 'Execute macro...',
+            'CommandURL': 'RunMacro',
+            'ShortCut': 'Shift+Ctrl+Alt+E',
+        },
+    ]
+}
+
+if menu_nombre in menu:
+    menu.remove(menu_nombre)
+else:
+    menu.insert(menu_nuevo, '.uno:MacrosMenu')
+

debug

+

Para saber los nombres de cualquier menú.

+
menu = app.menus['calc']['tools']
+menu.debug()
+
(0) .uno:SpellDialog
+(1) .uno:SpellOnline
+(2) .uno:ThesaurusDialog
+(3) .uno:LanguageMenu
+  ├─ (0) .uno:SetLanguageAllTextMenu
+  ├─ (1) ----------
+  ├─ (2) .uno:Hyphenate
+  ├─ (3) .uno:ChineseConversion
+  ├─ (4) .uno:HangulHanjaConversion
+  ├─ (5) ----------
+  ├─ (6) .uno:MoreDictionaries
+(4) ----------
+(5) .uno:AutoCorrectDlg
+(6) .uno:AutoComplete
+(7) .uno:ImageMapDialog
+(8) ----------
+(9) .uno:RedactDoc
+(10) .uno:AutoRedactDoc
+(11) ----------
+(12) .uno:GoalSeekDialog
+(13) .uno:SolverDialog
+(14) .uno:AuditMenu
+  ├─ (0) .uno:ShowPrecedents
+  ├─ (1) .uno:ShowDependents
+  ├─ (2) ----------
+  ├─ (3) .uno:ClearArrows
+  ├─ (4) .uno:ClearArrowPrecedents
+  ├─ (5) .uno:ClearArrowDependents
+  ├─ (6) ----------
+  ├─ (7) .uno:ShowErrors
+  ├─ (8) .uno:RefreshArrows
+  ├─ (9) ----------
+  ├─ (10) .uno:AuditingFillMode
+  ├─ (11) .uno:AutoRefreshArrows
+  ├─ (12) .uno:ShowInvalid
+(15) .uno:ScenarioManager
+(16) ----------
+(17) .uno:ToolsFormsMenu
+  ├─ (0) .uno:SwitchControlDesignMode
+  ├─ (1) .uno:UseWizards
+  ├─ (2) ----------
+  ├─ (3) .uno:ControlProperties
+  ├─ (4) .uno:FormProperties
+  ├─ (5) ----------
+  ├─ (6) .uno:ShowFmExplorer
+  ├─ (7) .uno:TabDialog
+  ├─ (8) .uno:AddField
+  ├─ (9) ----------
+  ├─ (10) .uno:OpenReadOnly
+  ├─ (11) .uno:AutoControlFocus
+(18) ----------
+(19) .uno:ShareDocument
+(20) .uno:Protect
+(21) .uno:ToolProtectionDocument
+(22) ----------
+(23) .uno:MacrosMenu
+  ├─ (0) .uno:MacroRecorder
+  ├─ (1) .uno:RunMacro
+  ├─ (2) .uno:BasicIDEAppear
+  ├─ (3) .uno:ScriptOrganizer
+  ├─ (4) ----------
+  ├─ (5) .uno:MacroSignature
+  ├─ (6) .uno:MacroOrganizer?TabId:short=1
+  ├─ (7) ----------
+  ├─ (8) .uno:OpenXMLFilterSettings
+(24) .uno:DevelopmentToolsDockingWindow
+(25) ----------
+(26) service:com.sun.star.deployment.ui.PackageManagerDialog
+(27) .uno:ConfigureDialog
+(28) .uno:OptionsTreeDialog
+
+ + + + +
+ +
+ + +
+ + +
+ + + +
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + diff --git a/doc/public/es/application/menus/index.xml b/doc/public/es/application/menus/index.xml new file mode 100644 index 0000000..8d8a701 --- /dev/null +++ b/doc/public/es/application/menus/index.xml @@ -0,0 +1,10 @@ + + + + Menús on Documentación para EasyMacro + https://doc.cuates.net/easymacro/es/application/menus/ + Recent content in Menús on Documentación para EasyMacro + Hugo -- gohugo.io + en-us + + diff --git a/doc/public/es/application/shortcuts/index.html b/doc/public/es/application/shortcuts/index.html new file mode 100644 index 0000000..ad25d2f --- /dev/null +++ b/doc/public/es/application/shortcuts/index.html @@ -0,0 +1,1198 @@ + + + + + + + + + + + + Accesos directos :: Documentación para EasyMacro + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+ + + + +
+
+ +
+
+ + +
+
+ +
+ +
+ +
+ +

+ + Accesos directos +

+ + + + + + +

Globales

+

Iterar en todos los accesos directos. Accesos directos disponibles para todas las aplicaciones.

+
for acceso_directo, comando in app.shortcuts:
+    app.debug(acceso_directo, comando)
+

Devolver una lista de tuplas con toda la información.

+
datos = app.shortcuts.get_all()
+app.debug(datos)
+

Verificar si un acceso directo esta asignado.

+
acceso_directo = 'Shift+Ctrl+Alt+T'
+app.debug(acceso_directo in app.shortcuts)
+

set

+

Establecer un acceso directo a un comando.

+
sc = app.shortcuts
+acceso_directo = 'Shift+Ctrl+Alt+T'
+comando = 'MacroDialog'
+sc.set(acceso_directo, comando)
+

Establecer un acceso directo a una macro.

+
sc = app.shortcuts
+acceso_directo = 'Shift+Ctrl+Alt+M'
+macro = {'library': 'test', 'name': 'pruebas'}
+sc.set(acceso_directo, macro)
+

get_by_shortcut

+

Devolver el comando asociado a un acceso directo.

+
sc = app.shortcuts
+acceso_directo = 'Shift+Ctrl+Alt+M'
+comando = sc.get_by_shortcut(acceso_directo)
+app.debug(comando)
+

get_by_command

+

Devolver el acceso directo asociado a un comando. Puede haber más de uno.

+
sc = app.shortcuts
+comando = 'MacroDialog'
+acceso_directo = sc.get_by_command(comando)
+app.debug(acceso_directo)
+

remove_by_shortcut

+

Eliminar por acceso directo.

+
sc = app.shortcuts
+acceso_directo = 'Shift+Ctrl+Alt+T'
+sc.remove_by_shortcut(acceso_directo)
+

remove_by_command

+

Eliminar por comando.

+
sc = app.shortcuts
+macro = {'library': 'test', 'name': 'pruebas'}
+sc.remove_by_command(macro)
+

reset

+

Reiniciar todas las modificaciones.

+
app.shortcuts.reset()
+

Modificar accesos directos, solo en una aplicación.

+

Por ejemplo Calc.

+
sc = app.shortcuts['calc']
+

Los métodos son los mismos que los globales.

+

Para las demas aplicaciones: writer, draw, impress, math.

+ + + + + +
+ +
+ + +
+ + +
+ + + +
+ +
+
+
+ + + + + + + + + + + + + + + + + + + + diff --git a/doc/public/es/application/shortcuts/index.xml b/doc/public/es/application/shortcuts/index.xml new file mode 100644 index 0000000..ced05fd --- /dev/null +++ b/doc/public/es/application/shortcuts/index.xml @@ -0,0 +1,10 @@ + + + + Accesos directos on Documentación para EasyMacro + https://doc.cuates.net/easymacro/es/application/shortcuts/ + Recent content in Accesos directos on Documentación para EasyMacro + Hugo -- gohugo.io + en-us + + diff --git a/doc/public/es/calc/index.html b/doc/public/es/calc/index.html index 8834018..f435dbc 100644 --- a/doc/public/es/calc/index.html +++ b/doc/public/es/calc/index.html @@ -12,22 +12,22 @@ Calc :: Documentación para EasyMacro - - - - - - - - - - + + + + + + + + + + - + - + - +