+ +### **filters** + +Devolver todos los filtros soportados en LibreOffice. Mire la [ayuda][2] y en [API FilterFactory][3] para más detalles. + +```py + filtros = app.filters() + for f in filtros: + info = f"Nombre UI: {f['UIName']} - Nombre: {f['Name']} - Tipo: {f['Type']}" + app.debug(info) +``` + +
+ +### **dispatch** + +Ejecutar cualquier comando `UNO` de LibreOffice, mire la [lista de comandos][4] y [API dispatch][5]. + +Este método automáticamente agrega el prefijo necesario: `.uno:` + +```py + doc = app.active + comando = 'Gallery' + app.dispatch(doc, comando) +``` + +!!! tip "Recomendación" + + Use este método solamente si no hay un método equivalente en `easymacro` o directamente en el API de LibreOffice. + +
+ +### **clipboard** + +#### **set** + +Envíar contenido (solo texto) al portapapeles. + +```py + app.clipboard.set('Los 7 samuráis') +``` + +#### **get** + +Recuperar contenido del portapapeles. + +```py + content = app.clipboard.get() + app.debug(content) +``` + +
+ +### **comandos** + +!!! warning "Cuidado" + + En este momento, en LibreOffice 7.4, este comando provoca el cierre de la aplicación. + +#### **disable** + +Deshabilitar un comando. Para una lista de comandos mire [DispatchCommands][4]. + +```py + comando = 'OpenFromCalc' + resultado = app.cmd.disable(comando) + app.debug(resultado) +``` + +`OpenFromCalc` es la opción para abrir documentos en Calc, deshabilita o habilita la entrada del menú y el icono en la barra de herramientas. + +
+ +#### **enabled** + +Habilitar un comando. + +```py + comando = 'OpenFromCalc' + resultado = app.cmd.enabled(comando) + app.debug(resultado) +``` + +
+ +### **Configuración** + +#### **get_config** + +Obtener valores de la configuración de LibreOffice. + +```py + nombre_node = '/org.openoffice.Office.Common/Help' + clave = 'System' + valor = app.get_config(nombre_node, clave) + app.debug(valor) + + nombre_node = '/org.openoffice.Office.Common/Misc/' + clave = 'FirstRun' + valor = app.get_config(nombre_node, clave) + app.debug(valor) + + clave = 'UseSystemFileDialog' + valor = app.get_config(nombre_node, clave) + app.debug(valor) +``` + +``` +17/08/2022 14:14:12 - DEBUG - UNIX +17/08/2022 14:14:12 - DEBUG - False +17/08/2022 14:14:12 - DEBUG - True +``` + +
+ +#### **set_config** + +Establece un nuevo valor en la configuración de LibreOffice. + +```py + nombre_nodo = '/org.openoffice.Office.UI/ColorScheme' + clave = 'CurrentColorScheme' + nuevo_valor = 'LibreOffice Dark' + resultado = app.set_config(nombre_nodo, clave, nuevo_valor) + app.debug(resultado) +``` + +
+ +Algunos nodos y claves interesantes: + +* `/org.openoffice.Office.Common/Save/Document` + * AutoSave + * AutoSaveTimeIntervall + + +!!! warning "Atención" + + No todos los valores de los nodos se pueden cambiar, algunos valores son de solo lectura. + +
+ +[1]: https://api.libreoffice.org/docs/idl/ref/structcom_1_1sun_1_1star_1_1awt_1_1FontDescriptor.html +[2]: https://help.libreoffice.org/latest/en-US/text/shared/guide/convertfilters.html +[3]: https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1document_1_1FilterFactory.html +[4]: https://wiki.documentfoundation.org/Development/DispatchCommands +[5]: https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1frame_1_1XDispatch.html#a42beb1ea2ddae35c076b6e65867025ea diff --git a/doc/content/es/application/menus/_index.md b/doc/docs/app/menus.md similarity index 56% rename from doc/content/es/application/menus/_index.md rename to doc/docs/app/menus.md index b41322a..9bebb5a 100644 --- a/doc/content/es/application/menus/_index.md +++ b/doc/docs/app/menus.md @@ -1,9 +1,5 @@ -+++ -title = "Menús" -weight = 2 -+++ -### insert +### **insert** Insertar nuevo menú en Calc. @@ -11,93 +7,102 @@ En la propiedad `CommandURL` es posible establecer tanto un comando UNO de Libre 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', - }, - ] -} +```py + 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) + menus_calc = app.menus['calc'] + menus_calc.insert(menu) ``` +!!! tip -### remove + Para controlar los menús de las demás aplicaciones, solo hay que cambiar el nombre de la aplicación. + +
+ +### **remove** Eliminar un menú existente. -```python -nombre_menu = 'zaz.my.menu' -menus_calc = app.menus['calc'] -menus_calc.remove(nombre_menu) +```py + nombre_menu = 'zaz.my.menu' + menus_calc = app.menus['calc'] + menus_calc.remove(nombre_menu) ``` -#### Insertar nuevo menú en uno existente. +
+ +### **Insertar en menú existente** Dentro del menú Herramientas (`tools`), después de la opción `Macros...` -```python -menu = app.menus['calc']['tools'] +```py + 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', - }, - ] -} + 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') + if menu_nombre in menu: + menu.remove(menu_nombre) + else: + menu.insert(menu_nuevo, '.uno:MacrosMenu') ``` -### debug +
+ +### **debug** Para saber los nombres de cualquier menú. -```python -menu = app.menus['calc']['tools'] -menu.debug() +```py + menu = app.menus['calc']['tools'] + menu.debug() ``` -``` +```sh (0) .uno:SpellDialog (1) .uno:SpellOnline (2) .uno:ThesaurusDialog @@ -169,3 +174,5 @@ menu.debug() (27) .uno:ConfigureDialog (28) .uno:OptionsTreeDialog ``` + +
\ No newline at end of file diff --git a/doc/docs/app/shortcuts.md b/doc/docs/app/shortcuts.md new file mode 100644 index 0000000..855747e --- /dev/null +++ b/doc/docs/app/shortcuts.md @@ -0,0 +1,126 @@ + +### **Globales** + +Iterar en todos los accesos directos. Accesos directos disponibles para todas las aplicaciones. + +```py + for acceso_directo, comando in app.shortcuts: + app.debug(acceso_directo, comando) +``` + +Devolver una lista de tuplas con toda la información. + +```py + datos = app.shortcuts.get_all() + app.debug(datos) +``` + +Verificar si un acceso directo esta asignado. + +```py + acceso_directo = 'Shift+Ctrl+Alt+T' + app.debug(acceso_directo in app.shortcuts) +``` + +
+ +### **set** + +Establecer un acceso directo a un comando. + +```py + sc = app.shortcuts + acceso_directo = 'Shift+Ctrl+Alt+T' + comando = 'MacroDialog' + sc.set(acceso_directo, comando) +``` + +Establecer un acceso directo a una macro. + +!!! tip inline end + + Para la asignación de una macros, aplican las mismas reglas de: [ejecutar macros](../../tools/macros/) + +```py + 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. + +```py + 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. + +```py + sc = app.shortcuts + comando = 'MacroDialog' + acceso_directo = sc.get_by_command(comando) + app.debug(acceso_directo) +``` + +
+ +### **remove_by_shortcut** + +Eliminar por acceso directo. + +```py + sc = app.shortcuts + acceso_directo = 'Shift+Ctrl+Alt+T' + sc.remove_by_shortcut(acceso_directo) +``` + +
+ +### **remove_by_command** + +Eliminar por comando. + +```py + sc = app.shortcuts + macro = {'library': 'test', 'name': 'pruebas'} + sc.remove_by_command(macro) +``` + +
+ +### **reset** + +Reiniciar todas las modificaciones. + +```py + app.shortcuts.reset() +``` +
+ +### **Por aplicación** + +Modificar accesos directos, solo en una aplicación. + +Por ejemplo Calc. + +```py + sc = app.shortcuts['calc'] +``` + +Los métodos son los mismos que los globales. + +Para las demas aplicaciones: `writer`, `draw`, `impress`, `math`. + +
\ No newline at end of file diff --git a/doc/content/es/tools_debug/_index.md b/doc/docs/debug.md similarity index 77% rename from doc/content/es/tools_debug/_index.md rename to doc/docs/debug.md index 54d0c87..a5107ae 100644 --- a/doc/content/es/tools_debug/_index.md +++ b/doc/docs/debug.md @@ -1,15 +1,14 @@ -+++ -title = "Herramientas para depurar" -weight = 2 -+++ +## Herramientas para depurar -### INFO_DEBUG +
+ +### **INFO_DEBUG** Mostrar información de depuración en un cuadro de mensaje. Si tiene cualquier problema en su código durante el desarrollo de sus macros, puede [abrir un ticket][1] de soporte en el sistema de ticket de este proyecto. Siempre copie la información de depuración mostrada en este mensaje. -```python +```py import easymacro as app def info(): @@ -17,14 +16,14 @@ def info(): return ``` - + -### debug +### **debug** Mostrar información en la terminal. -```python +```py import easymacro as app def test_debug(): @@ -33,16 +32,23 @@ def test_debug(): return ``` +Para ver este mensaje, es necesario iniciar LibreOffice desde la línea de comandos: ``` -11/08/2022 18:15:45 - DEBUG - Verificar esta información... +soffice --calc ``` +Después de ejecutar la macro anterior, debe de ver: +``` +21/04/2023 17:04:49 - DEBUG - Verificar esta información... +``` -### info +
+ +### **info** Mostrar mensajes informativos en la terminal. -```python +```py import easymacro as app def test_info(): @@ -55,12 +61,13 @@ def test_info(): 11/08/2022 18:23:53 - INFO - Iniciando proceso... ``` +
-### error +### **error** Mostrar mensajes de error en la terminal. -```python +```py import easymacro as app def test_error(): @@ -73,12 +80,13 @@ def test_error(): 11/08/2022 18:27:34 - ERROR - Error 505 ``` +
-### save_log +### **save_log** Guardar registro en un archivo, automáticamente se agrega la fecha y hora. -```python +```py import easymacro as app def test_save_log(): @@ -95,12 +103,15 @@ cat ~/log.txt 2022-08-11 18:30:11 - 'Maldito Mundo' ``` +
-### msgbox +### **msgbox** Mostrar cualquier información en un cuadro de mensaje. ```python +import easymacro as app + def message(): msg = 'Por favor, consume menos.' @@ -117,11 +128,19 @@ def message(): return ``` -### catch_exception +
+ +### **catch_exception** Capturar cualquier error que se produzca al ejecutar una macro. -```python +!!! warning inline end "Cuidado" + + Usa este método solo en tiempo de desarrollo. **No la use en producción**. + +```py +import easymacro as app + @app.catch_exception def test_capturar_error(): r = 1 / 0 @@ -138,28 +157,30 @@ Traceback (most recent call last): ZeroDivisionError: division by zero ``` -{{% notice warning %}} -Usa este método solo en tiempo de desarrollo. No la uses en producción. -{{% /notice %}} +
- -### mri +### **mri** [MRI][2] es la mejor extensión para inspeccionar cualquier objeto UNO de LibreOffice. Necesita instalarla primero para poder llamarla. +```py +import easymacro as app -```python def inspeccionar_objeto(): obj = app.active app.mri(obj) return ``` -### inspect +
+ +### **inspect** Inspeccionar un objeto. -```python +```py +import easymacro as app + def inspeccionar_objeto(): doc = app.active data = app.inspect(doc) @@ -170,7 +191,7 @@ def inspeccionar_objeto(): return ``` -Vaciar en una hoja de calculo. +Vaciar la información del objeto en una hoja de calculo. ```python def inspeccionar_objeto(): diff --git a/doc/docs/docs/index.md b/doc/docs/docs/index.md new file mode 100644 index 0000000..c1c1964 --- /dev/null +++ b/doc/docs/docs/index.md @@ -0,0 +1,75 @@ +--- +title: Documentos +--- + +## Trabajar con Documentos + +
+ +### **active** + +Devuelve el documento activo. + +```py + doc = app.active + app.msgbox(doc.title) +``` + +
+ +### **iteration** + +Iterar en todos los documentos abiertos. + +```py + for doc in app.docs: + app.debug(doc.type, doc.title) +``` + +
+ +### **count** + +Contar los documentos abiertos. + +```py + cuantos = len(app.docs) + app.debug(cuantos) +``` + +
+ +### **contain** + +Verificar si un documento esta en la colección. + +```py + resultado = 'mi_archivo.ods' in app.docs + app.debug(resultado) +``` + +
+ +### **index** + +Devolver por índice. + +```py + doc = app.docs[1] + app.debug(doc.type, doc.title) +``` + +
+ +### **name** + +Devolver por nombre. + +```py + nombre = 'mi_archivo.ods' + if nombre in app.docs: + doc = app.docs[nombre] + app.debug(doc.type, doc.title) +``` + +
\ No newline at end of file diff --git a/doc/docs/docs/methods.md b/doc/docs/docs/methods.md new file mode 100644 index 0000000..460070a --- /dev/null +++ b/doc/docs/docs/methods.md @@ -0,0 +1,263 @@ + +## Métodos comúnes a todos los documentos. + +
+ +### **clear_undo** + +La mayoría de las acciones realizadas por código, quedan en el historial de acciones, por lo que el usuario puede deshacerlas. Para evitar esto se puede limpiar este historial. + +```py + doc = app.active + doc.clear_undo() +``` + +
+ +### **close** + +Cerrar un archivo. + +```py + doc = app.docs.new() + app.msgbox(doc.title) + doc.close() +``` + +
+ +### **copy** + +Copiar la selección activa al portapapeles. + +```py + doc = app.active + doc.copy() +``` + +
+ +### **export** + +Exportar a otros formatos. + +```py + doc = app.docs.new() + ruta = '/home/elmau/miarchivo.xlsx' + filtro = 'xlsx' + doc.export(ruta, filtro) + + ruta = '/home/elmau/miarchivo.xls' + filtro = 'xls' + doc.export(ruta, filtro) + + doc = app.docs.new('writer') + ruta = '/home/elmau/miarchivo.docx' + filtro = 'docx' + doc.export(ruta, filtro) + + ruta = '/home/elmau/miarchivo.doc' + filtro = 'doc' + doc.export(ruta, filtro) + + ruta = '/home/elmau/miarchivo.rtf' + filtro = 'rtf' + doc.export(ruta, filtro) +``` + +Exportar en memoria. + +```python +doc = app.docs.new() +filtro = 'xlsx' +excel_doc = doc.export(filter_name=filtro) +``` + +
+ +### **new** + +Crear nuevo documento, la aplicación predeterminada es Calc. + +```py + doc = app.docs.new() + app.debug(doc.type) +``` + +Para un nuevo documento `writer`. + +```py + doc = app.docs.new('writer') + app.debug(doc.type) +``` + +Otros documentos. + +```py + doc = app.docs.new('draw') + app.debug(doc.type) + + doc = app.docs.new('impress') + app.debug(doc.type) + + doc = app.docs.new('math') + app.debug(doc.type) +``` + +Crear con argumentos. + +```py + propiedades = {'Hidden': True} + doc = app.docs.new('writer', propiedades) + mensaje = f'{doc.type} - {doc.title}' + app.msgbox(mensaje) + doc.visible = True +``` + +!!! tip + + No es necesario que un documento este visible para manipularse. + +
+ +### **open** + +Abrir archivos. + +```py + ruta = '/home/elmau/mi_archivo.ods' + doc = app.docs.open(ruta) +``` + +!!! tip "Consejo" + + No es necesario pasar las rutas en formato URL. + +Puede abrir cualquier archivo que sea soportado por LibreOffice. + +```py + ruta = '/home/elmau/ejemplo.xlsx' + doc = app.docs.open(ruta) +``` + +Abrir con argumentos. + +```py + ruta = '/home/elmau/ejemplo.ods' + argumentos = {'Password': 'siscaloburropanzon'} + doc = app.docs.open(ruta, argumentos) +``` + +
+ +### **paste** + +Copiar el contenido del portapapeles, en la selección actual. + +```py + doc = app.active + doc.paste() +``` + +
+ +### **paste_special** + +Mostrar el cuadro de diálogo `Pegado Especial`. + +!!! tip "Consejo" + + Solo se mostrará si existe contenido en el portapapeles. + +```py + doc = app.active + doc.paste_special() +``` + +
+ +### **paste_values** + +Pegar solo los valores. + +```py + doc = app.active + doc.paste_values() +``` + +Si el destino no esta vacío, el usuario verá el cuadro de mensaje de confirmación. + +
+ +### **save** + +Guardar un nuevo documento. + +```py + path = '/home/elmau/nuevo_documento.ods' + doc = app.docs.new() + doc.save(path) +``` + +Cualquier archivo, previamente guardado, que sea modificado puede ser guardado con: + +```python + doc.save() +``` + +Abrir un archivo existente y guardarlo con otro nombre. + +```py + ruta = '/home/mau/ejemplo.ods' + doc = app.docs.open(ruta) + nueva_ruta = '/home/mau/otro_nombre.ods' + doc.save(nueva_ruta) +``` + +
+ +### **set_focus** + +Enviar el foco al documento. + +```py + for doc in app.docs: + app.debug(doc.title) + doc.set_focus() + app.sleep(1) +``` + +
+ +### **to_pdf** + +Exportar a PDF. + +```py + doc = app.active + ruta = '/home/elmau/ejemplo.pdf' + doc.to_pdf(ruta) +``` + +Si no se establece una ruta, se devuelve el PDF en memoria. + +```py + doc = app.active + pdf = doc.to_pdf() + app.debug(pdf) +``` + +Mire las [opciones del filtro de exportación a PDF][1], puede pasarlas como un diccionario como segundo argumento de este método. + +Por ejemplo, exportar solo las páginas 2 a 4: + +```py + doc = app.active + ruta = '/home/elmau/ejemplo.pdf' + opciones = {'PageRange': '2-4'} + doc.to_pdf(ruta, opciones) +``` + +
+ +[1]: https://wiki.documentfoundation.org/Macros/Python_Guide/PDF_export_filter_data diff --git a/doc/docs/docs/properties.md b/doc/docs/docs/properties.md new file mode 100644 index 0000000..376d498 --- /dev/null +++ b/doc/docs/docs/properties.md @@ -0,0 +1,220 @@ + + +## Propiedades comúnes a todos los documentos. + +
+ +Recordemos, el documento activo lo referenciamos con: + +```py + doc = app.active +``` + +
+ +### **dir** + +**Solo lectura**. Devolver solo el directorio de la ruta en disco del documento. + +```py + doc = app.active + app.debug(doc.dir) +``` + +
+ +### **file_name** + +**Solo lectura**. Devolver el nombre con extensión de la ruta del documento. + +```py + doc = app.active + app.debug(doc.file_name) +``` + +
+ +### **is_modified** + +**Solo lectura**. Si el documento ha sido modificado. + +```py + doc = app.active + app.debug(doc.is_modified) +``` + +
+ +### **is_read_only** + +**Solo lectura**. Si el documento es de solo lectura. + +```py + doc = app.active + app.debug(doc.is_read_only) +``` + +
+ +### **is_saved** + +**Solo lectura**. Si el documento ya ha sido guardado en disco. + +```py + doc = app.active + app.debug(doc.is_saved) +``` + +
+ +### **name** + +**Solo lectura**. Devolver el nombre sin extensión de la ruta del documento. + +```py + doc = app.active + app.debug(doc.name) +``` + +
+ +### **obj** + +**Solo lectura**. Devolver el objeto original pyUNO. + +```py + doc = app.active + app.debug(type(doc)) + app.debug(type(doc.obj)) +``` + +```sh +18/08/2022 21:59:05 - DEBUG -
+ +### **path** + +**Solo lectura**. Devolver la ruta en disco del documento. + +```py + doc = app.active + app.debug(doc.path) +``` + +
+ +### **selection** + +Devolver la selección actual. + +```py + doc = app.active + selection = doc.selection + app.debug(selection) +``` + +
+ +!!! warning "Cuidado" + + La selección actual pueden ser muchas cosas diferentes. + +
+ +### **status_bar** + +Controlar la barra de estado, es importante siempre actualizar en otro hilo. + +```py +@app.run_in_thread +def controlar_barra_estado(sb, texto, limite): + sb.start(texto, limite) + for i in range(limite): + sb.setValue(i) + app.sleep(1) + sb.end() + return + +def main(): + doc = app.active + controlar_barra_estado(doc.status_bar, 'Línea: ', 10) + return +``` + +Es importante siempre devolver el control de la barra de estado a la aplicación con el método `end`. + +
+ +### **title** + +Título del documento. + +```py + doc = app.active + app.debug(doc.title) + doc.title = 'Nuevo Titulo' + app.debug(doc.title) +``` + +!!! tip "Consejo" + + El cambio no es permanente, solo mientras el documento esta abierto. + +
+ +### **type** + +**Solo lectura**. Devolver el tipo de documento: calc, writer, etc. + +```py + doc = app.active + app.debug(doc.type) +``` + +
+ +### **uid** + +**Solo lectura**. Devolver el valor interno RuntimeUID del documento. + +```py + doc = app.active + app.debug(doc.uid) +``` + +
+ +### **visible** + +Ocultar o mostrar un documento. + +```py + doc = app.active + doc.visible = False + app.msgbox(doc.visible) + doc.visible = True +``` + +!!! tip "Consejo" + + No es necesario que el documento este visible para manipularse. + +
+ +### **zoom** + +Devolver o establecer el porcentaje de zoom del documento. + +```py + doc = app.active + zoom = doc.zoom + app.msgbox(zoom) + doc.zoom = zoom * 2 + app.msgbox(doc.zoom) + doc.zoom = zoom +``` + +
diff --git a/doc/docs/img/favicon.ico b/doc/docs/img/favicon.ico new file mode 100644 index 0000000..563a626 Binary files /dev/null and b/doc/docs/img/favicon.ico differ diff --git a/doc/docs/img/install_01.png b/doc/docs/img/install_01.png new file mode 100644 index 0000000..3783237 Binary files /dev/null and b/doc/docs/img/install_01.png differ diff --git a/doc/docs/img/logo.png b/doc/docs/img/logo.png new file mode 100644 index 0000000..88c98f1 Binary files /dev/null and b/doc/docs/img/logo.png differ diff --git a/doc/docs/index.md b/doc/docs/index.md new file mode 100644 index 0000000..7c6c277 --- /dev/null +++ b/doc/docs/index.md @@ -0,0 +1,29 @@ +# Bienvenido a la documentación para EasyMacro + +**Software Libre, no software gratis** + +
+ +**easymacro** es una librería para desarrollar más fácilmente macros en LibreOffice con Python. Es una capa de abstracción entre la extensa y compleja API UNO de LibreOffice y tu código. + +Probablemente, será más feliz si la usa :) + +Puede utilizar **easymacro** con cualquier extensión o directamente en sus macros. + +
+ +- Proyectos similiares o relacionados en Python: + * [python-ooo-dev-tools](https://python-ooo-dev-tools.readthedocs.io) + * [oooscript](https://oooscript.readthedocs.io) + * [python-ooouno-ex](https://github.com/Amourspirit/python-ooouno-ex) +- Proyectos similiares o relacionados en otros lenguajes: + * [Java LibreOffice Programming](https://flywire.github.io/lo-p/) + +
+ +Aportaciones: + +- en Moneda Libre Ğ1 (Junas):
+`A5DdXxCKPw3QKWVdDVs7CzkNugNUW1sHu5zDJFWxCU2h` + +
\ No newline at end of file diff --git a/doc/content/es/installation/_index.md b/doc/docs/install.md similarity index 61% rename from doc/content/es/installation/_index.md rename to doc/docs/install.md index e918db2..9b901dd 100644 --- a/doc/content/es/installation/_index.md +++ b/doc/docs/install.md @@ -1,8 +1,3 @@ -+++ -title = "Instalación" -weight = 1 -+++ - ## Clonar repositorio Clone el repositorio en su directorio de proyectos favorito. @@ -19,13 +14,13 @@ cd easymacro/source copie la carpeta `easymacro` a la carpeta **pythonpath** en la carpeta de macros Python dentro de su perfil de usuario. Reemplace **USUARIO** por su usuario real. ``` -/home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/pythonpath +/home/USUARIO/.config/libreoffice/4/user/Scripts/python/pythonpath ``` -o use un vínculo simbólico. Reemplace **RUTA_ABSOLUTA** por la ruta absoluta donde se localice **easymacro** en su sistema de archivos y **USUARIO** por su nombre de usuario. +o use un vínculo simbólico (recomendado). Reemplace **RUTA_ABSOLUTA** por la ruta absoluta donde se localice **easymacro** en su sistema de archivos y **USUARIO** por su nombre de usuario. ``` -ln -s `RUTA_ABSOLUTA`/easymacro/source/easymacro /home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/pythonpath/ +ln -s RUTA_ABSOLUTA/easymacro/source/easymacro /home/USUARIO/.config/libreoffice/4/user/Scripts/python/pythonpath/ ``` @@ -34,12 +29,12 @@ ln -s `RUTA_ABSOLUTA`/easymacro/source/easymacro /home/`USUARIO`/.config/libreof En su archivo de macros favorito, por ejemplo **mismacros.py**. Use su editor de texto plano o IDE favorito. ``` -vim /home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/mismacros.py +vim /home/USUARIO/.config/libreoffice/4/user/Scripts/python/mismacros.py ``` Copie el siguiente código: -```python +```py import easymacro as app def main(): @@ -49,7 +44,7 @@ def main(): Ejecute la macro **main** desde LibreOffice, si ve un cuadro de mensaje con información similar a la siguiente, !felicidades¡ - + Esta todo listo para empezar a desarrollar macros con **easymacro**. diff --git a/doc/docs/tools/datetime.md b/doc/docs/tools/datetime.md new file mode 100644 index 0000000..6d66fe4 --- /dev/null +++ b/doc/docs/tools/datetime.md @@ -0,0 +1,177 @@ + +!!! tip "Atención" + + La fecha inicial en Calc y en Python son diferentes. + +
+ +### **today** + +Obtener la fecha actual. + +```py + d = app.dates + app.msgbox(d.today) +``` + +
+ +### **now** + +Obtener la fecha y hora actuales. + +```py + d = app.dates + app.msgbox(d.now) +``` + +
+ +### **time** + +Obtener la hora actual. + +```py + d = app.dates + app.msgbox(d.now.time()) +``` + +
+ +### **epoch** + +Obtener el [tiempo Unix][1] + +```py + d = app.dates + app.msgbox(d.epoch) +``` + +
+ +### **date** + +Devolver una fecha + +```py + d = app.dates + + date = d.date(1974, 1, 15) + app.msgbox(date) +``` + +
+ +### **time** + +Devolver una hora + +```py + d = app.dates + + time = d.time(10, 20, 15) + app.msgbox(time) +``` + +
+ +### **datetime** + +Devolver fecha y hora + +```py + d = app.dates + + dt = d.datetime(1974, 1, 15, 10, 11, 12) + app.msgbox(dt) +``` + +
+ +### **str_to_date** + +Convertir una cadena en fecha. Mira este [excelente recurso][2] + +```py + d = app.dates + + cadena = '1974-01-15' + plantilla = '%Y-%m-%d' + fecha = d.str_to_date(cadena, plantilla) + app.msgbox(fecha) + app.msgbox(type(fecha)) +``` + +Para obtener un valor válido para establecer en una celda de Calc. + +```py + d = app.dates + + cadena = '1974-01-15' + plantilla = '%Y-%m-%d' + fecha = d.str_to_date(cadena, plantilla, True) + app.msgbox(fecha) + app.msgbox(type(fecha)) +``` + +
+ +### **calc_to_date** + +Convierte el valor de una celda en una fecha Python, por ejemplo, la fecha inicial configurada en Calc. + +```py + d = app.dates + + valor_en_celda = 0 + fecha = d.calc_to_date(valor_en_celda) + app.msgbox(fecha) + app.msgbox(type(fecha)) +``` + +
+ +### **sleep** + +Pausar la ejecución por X segundos. + +!!! tip inline end "Atención" + + La pausa es bloqueante. + +```py + d = app.dates + + app.sleep(3) + app.msgbox('Fin') +``` + +
+ +### **start** y **end** + +Medir tiempo en segundos. + +```py + d = app.dates + + d.start() + app.sleep(5) + seconds = d.end() + app.msgbox(seconds) +``` + +Regresar timedelta en vez de segundos. + +```py + d = app.dates + + d.start() + app.sleep(5) + td = d.end(False) + app.msgbox(td) +``` + + +[1]: https://es.wikipedia.org/wiki/Tiempo_Unix +[2]: https://strftime.org diff --git a/doc/docs/tools/email.md b/doc/docs/tools/email.md new file mode 100644 index 0000000..72cf660 --- /dev/null +++ b/doc/docs/tools/email.md @@ -0,0 +1,144 @@ +## Enviar correo electrónico. + +!!! tip "Cuidado" + + Siempre guarda las contraseñas de la forma más segura posible. + +!!! warning "Cuidado" + + Consulta con el proveedor de tu correo electrónico, la configuración "exacta" necesaria para conectarse a tu servidor. Algunos proveedores no permiten (o dificultan) la conexión desde fuera de su infraestructura. + +
+ +### **send** + +Enviar un correo electrónico. + +```py + from conf import PASSWORD + + SERVIDOR = dict( + server = 'mail.correo.net' , + port = 405, + ssl = True, + user = 'no-responder@pruebas.mx', + password = PASSWORD, + ) + + body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales" + + mensaje = dict( + to = 'ingrid@bergman.mx', + subject = 'Te amo...', + body = body, + ) + + app.email.send(SERVIDOR, mensaje) +``` + +Algunos servidores requieren activar también `starttls`: + +```py + from conf import PASSWORD + + SERVIDOR = dict( + server = 'mail.correo.net' , + port = 405, + ssl = True, + starttls = True, + user = 'no-responder@pruebas.mx', + password = PASSWORD, + ) +``` + +!!! tip "Importante" + + Todos los correos se envían siempre en otro hilo de ejecución. + +
+ +#### Enviar con copia y copia oculta + +Dentro de los datos del mensaje, puede usar los campos `cc` (Con Copia) y `bcc` (Con Copia Oculta), así como separar por comas las direcciones destino para enviar a más de un correo. + +```py + to = 'mail1@correo.com,mail2@correo.com,mail3@correo.com' + cc = 'otro@correo.com' + bcc = 'oculto@correo.com' +``` + +
+ +#### Envíar más de un mensaje + +```py + mensaje1 = dict( + to = 'ingrid@correo.net', + subject = 'Te amo...', + body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales", + ) + mensaje2 = dict( + to = 'sophia@correo.net', + subject = 'A ti también...', + body = "Hola Sophia\n\n¿Como estas?\n\nSaludos cordiales", + ) + mensajes = (mensaje1, mensaje2) + + app.email.send(SERVIDOR, mensajes) +``` + +```sh +16/08/2022 13:01:49 - DEBUG - Connect to: mail.server.net +16/08/2022 13:01:50 - DEBUG - Email sent... +16/08/2022 13:01:51 - DEBUG - Email sent... +16/08/2022 13:01:51 - DEBUG - Close connection... +``` + +
+ +#### Adjuntos + +Enviar un archivo adjunto. + +```py + archivo = '/home/mau/temp.txt' + mensaje = dict( + to = 'ingrid@bergman.mx', + subject = 'Te amo...', + body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales", + files = archivo, + ) + + app.email.send(SERVIDOR, mensaje) +``` + +O varios. + +```py + archivos = ( + '/home/mau/temp.txt', + '/home/mau/datos.csv', + ) +``` + +
+ +#### Guardar mensajes + +Si su cliente de correo usa el formato `mbox` (Thunderbird por ejemplo), puede guardar los correos enviados en una carpeta dentro de la configuración de su cliente de correo. + +```py + ruta = '/home/elmau/.thunderbird/7iznrbyw.default/Mail/Local Folders/LibreOffice' + mensaje = dict( + to = 'ingrid@bergman.mx', + subject = 'Te amo...', + body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales", + path = ruta, + ) + + app.email.send(SERVIDOR, mensaje) +``` + + + + diff --git a/doc/content/es/tools/_index.md b/doc/docs/tools/index.md similarity index 60% rename from doc/content/es/tools/_index.md rename to doc/docs/tools/index.md index cd82b8d..9b0f46b 100644 --- a/doc/content/es/tools/_index.md +++ b/doc/docs/tools/index.md @@ -1,103 +1,114 @@ -+++ -title = "Herramientas" -weight = 3 -+++ +--- +title: Información +--- -Recuerda, es necesario importar la librería. +Recuerda, es necesario importar primero la librería. -```python +```py import easymacro as app ``` -#### Información sobre la PC +
-### OS +## Información sobre la PC + +### **OS** Obtener el sistema operativo. -```python +```py app.msgbox(app.OS) ``` +
-### DESKTOP +### **DESKTOP** Obtener el tipo de escritorio, solo en GNU/Linux. -```python +```py app.msgbox(app.DESKTOP) ``` +
-### PC +### **PC** Obtener el nombre de la computadora. -```python +```py app.msgbox(app.PC) ``` +
-### USER +### **USER** Obtener el nombre de usuario. -```python +```py app.msgbox(app.USER) ``` +
-### IS_WIN +### **IS_WIN** Saber si estamos en Windows. -```python +```py app.msgbox(app.IS_WIN) ``` +
-### IS_MAC +### **IS_MAC** -Saber si estamos en OSX. +Saber si estamos en OS X. -```python +```py app.msgbox(app.IS_MAC) ``` -#### Información sobre LibreOffice +
-### NAME +## Información sobre LibreOffice + +### **NAME** Nombre de la aplicación. -```python +```py app.msgbox(app.NAME) ``` +
-### VERSION +### **VERSION** Versión de la aplicación. -```python +```py app.msgbox(app.VERSION) ``` +
-### LANG +### **LANG** Lenguaje de la aplicación. -```python +```py app.msgbox(app.LANG) ``` +
-### LANGUAGE +### **LANGUAGE** Lenguaje con variante. -```python +```py app.msgbox(app.LANGUAGE) ``` diff --git a/doc/docs/tools/macros.md b/doc/docs/tools/macros.md new file mode 100644 index 0000000..55b2d9a --- /dev/null +++ b/doc/docs/tools/macros.md @@ -0,0 +1,90 @@ +Podemos ejecutar cualquier macro disponible en LibreOffice. De forma predeterminada se llaman a las macros en Python localizadas en el perfil de usuario. + +### **call** + +```py +import easymacro as app + + +def mostrar_info(): + app.msgbox(app.INFO_DEBUG) + return + + +def main(args=None): + macro = { + 'library': 'examples', + 'name': 'mostrar_info', + } + app.macro.call(macro) + return +``` + +
+ +#### Macros compartidas. + +Ejecutar una macro compartida en LibreOffice Macros. + +```py + macro = { + 'library': 'HelloWorld', + 'name': 'HelloWorldPython', + 'location': 'share', + } + app.macro.call(macro) +``` + +
+ +#### Macros en Basic + +Ejecutar una macro Basic. + +```vbscript +Sub mostrar_info() + MsgBox "Mejor usa Python :)" +End Sub +``` + +```py + macro = { + 'language': 'Basic', + 'library': 'Standard', + 'module': 'Module1', + 'name': 'mostrar_info', + } + app.macro.call(macro) +``` + +
+ +#### Macros en JavaScript + +Si ejecutas este ejempplo, asegurate de ejecutarlo con un documento Writer abierto, la macro de ejemplo en JavaScript esta disponible en LibreOffice. + +```py + macro = { + 'language': 'JavaScript', + 'library': 'HelloWorld', + 'name': 'helloworld.js', + 'location': 'share', + } + app.macro.call(macro) +``` + +
+ +Cualquier macro se puede ejecutar en otro hilo. + +```py + app.macro.call(macro, True) +``` + +
+ +Más información en: [Scripting Framework URI Specification][1] + +
+ +[1]: https://wiki.documentfoundation.org/Documentation/DevGuide/Scripting_Framework#Scripting_Framework_URI_Specification diff --git a/doc/docs/tools/messages.md b/doc/docs/tools/messages.md new file mode 100644 index 0000000..2baeb6d --- /dev/null +++ b/doc/docs/tools/messages.md @@ -0,0 +1,69 @@ +## Cuadros de mensaje + +### **msgbox** + +Mostrar mensaje estandar. + +```py + mensaje = 'Maldito Mundo' + titulo = 'Mi Macro' + app.msgbox(mensaje, titulo) +``` + +
+ +### **warning** + +Mostrar mensaje con icono de advertencia. + +```py + mensaje = 'Cuidado, esta acción es peligrosa' + titulo = 'Mi Macro' + app.warning(mensaje, titulo) +``` + +
+ +### **errorbox** + +Mostrar mensaje con icono de error. + +```py + mensaje = 'ERROR: contacte a soporte' + titulo = 'Mi Macro' + app.errorbox(mensaje, titulo) +``` + +
+ +### **question** + +Hacer una pregunta mostrando el icono de interrogación y mostrando los botones de comando `Si` y `No`. La respuesta siempre es verdadera (`True`) si el usuario selecciona `si` y falsa (`False`) en caso contrario. + +```py + mensaje = '¿Es fácil Python?' + titulo = 'Mi Macro' + resultado = app.question(mensaje, titulo) + app.msgbox(resultado) +``` + +
+ +### **inputbox** + +Muestra un mensaje al usuario, permitiendo capturar una respuesta. + +```py + mensaje = 'Escribe tu nombre' + nombre = app.inputbox(mensaje) + app.msgbox(nombre) +``` + +Para ocultar solo en pantalla lo que captura el usuario, como contraseñas. + +```py + mensaje = 'Captura la contraseña' + echochar = '*' + contraseña = app.inputbox(mensaje, echochar=echochar) + app.msgbox(contraseña) +``` diff --git a/doc/docs/tools/paths.md b/doc/docs/tools/paths.md new file mode 100644 index 0000000..fba1146 --- /dev/null +++ b/doc/docs/tools/paths.md @@ -0,0 +1,678 @@ +## Trabajar con rutas y archivos. + +
+ +### **path** + +Obtener información de una ruta. + +```py + ruta_archivo = '/home/elmau/mi_archivo.ods' + p = app.paths(ruta_archivo) + + app.debug(p.path) + app.debug(p.file_name) + app.debug(p.name) + app.debug(p.ext) + app.debug(p.size) + app.debug(p.url) +``` + +``` +15/08/2022 14:40:08 - DEBUG - /home/elmau +15/08/2022 14:40:08 - DEBUG - mi_archivo.ods +15/08/2022 14:40:08 - DEBUG - mi_archivo +15/08/2022 14:40:08 - DEBUG - ods +15/08/2022 14:40:08 - DEBUG - 7011 +15/08/2022 14:40:08 - DEBUG - file:///home/elmau/mi_archivo.ods +``` + +Obtener la misma información como un tupla. + +```py + ruta_archivo = '/home/elmau/mi_archivo.ods' + p = app.paths(ruta_archivo) + app.debug(p.info) +``` + +``` +15/08/2022 14:43:01 - DEBUG - ('/home/elmau', 'mi_archivo.ods', 'mi_archivo', 'ods', 7011, 'file:///home/mau/mi_archivo.ods') +``` + +O como diccionario. + +```py + ruta_archivo = '/home/elmau/mi_archivo.ods' + p = app.paths(ruta_archivo) + app.debug(p.dict) +``` + +``` +15/08/2022 14:43:01 - DEBUG - {'path': '/home/elmau', 'file_name': 'mi_archivo.ods', 'name': 'mi_archivo', 'ext': 'ods', 'size': 7011, 'url': 'file:///home/mau/mi_archivo.ods'} +``` + +
+ +### **home** + +Obtener la carpeta de inicio del usuario. + +```py + p = app.paths + app.debug(p.home) +``` + +
+ +### **documents** + +Obtener la carpeta Documentos del usuario. + +```py + p = app.paths + app.debug(p.documents) +``` + +
+ +### **user_profile** + +Obtener la ruta del perfil de usuario. + +```py + p = app.paths + app.debug(p.user_profile) +``` + +
+ +### **user_config** + +Obtener la ruta de la carpeta `config` en el perfil de usuario. + +```py + p = app.paths + app.debug(p.user_config) +``` + +
+ +### **python** + +Obtener la ruta del ejecutable `python` + +```py + p = app.paths + app.debug(p.python) +``` + +
+ +### **to_system** + +Pasar una ruta en formato URL al formato del sistema de archivos del SO. + +```py + p = app.paths + ruta_url = 'file:///home/elmau/mi_archivo.ods' + ruta = p.to_system(ruta_url) + app.debug(ruta) +``` + +
+ +### **to_url** + +Pasar una ruta del sistema de archivos del SO al formato URL. + +```py + p = app.paths + ruta = '/home/mau/mi_archivo.ods' + ruta_url = p.to_url(ruta) + app.debug(ruta_url) +``` + +
+ +### **config** + +Obtener rutas de la configuración de LibreOffice. Por default obtiene la ruta de `Documentos`, para otras ruta mire [Api XPathSettings][1] + +```py + p = app.paths + ruta = p.config() + app.debug(ruta) + + ruta = p.config('UserConfig') + app.debug(ruta) +``` + +!!! tip "Atención" + + Algunas rutas pueden ser más de una, separados por `;`, en este caso, el resultado es una lista con las rutas. + +
+ +### **join** + +Concatenar rutas. + +```py + p = app.paths + ruta = p.join('/home/mau', 'pruebas', 'archivo.ods') + app.debug(ruta) +``` + +
+ +### **exists** + +Verificar si una ruta existe. + +```py + p = app.paths + resultado = p.exists('/home/mau/test/archivo.ods') + app.debug(resultado) +``` + +
+ +### **exists_app** + +Verificar si una aplicación existe. + +```py + p = app.paths + + resultado = p.exists_app('noexiste') + app.debug(resultado) + + resultado = p.exists_app('soffice') + app.debug(resultado) +``` + +
+ +### **is_dir** + +Verificar si la ruta es un directorio. + +```py + p = app.paths + resultado = p.is_dir('/home/elmau') + app.debug(resultado) +``` + +
+ +### **is_file** + +Verificar si la ruta es un archivo. + +```py + p = app.paths + resultado = p.is_file('/home/elmau/mi_archivo.ods') + app.debug(resultado) +``` + +
+ +### **temp_file** + +Crear un archivo temporal, es borrado automáticamente al cerrarse. + +```python + p = app.paths + + f = p.temp_file() + f.write(app.INFO_DEBUG) + f.close() +``` + +Usado en `contexto`, se cierra automáticamente. + +```py + with p.temp_file() as f: + app.debug(f.name) + f.write('test') +``` + +
+ +### **temp_dir** + +Crear un directorio temporal, al salir del contexto, es eliminado junto con todo su contenido del sistema de archivos. + +```py + p = app.paths + + with p.temp_dir() as d: + app.debug(p.exists(d)) + app.debug(d) + + app.debug(p.exists(d)) +``` + +
+ +### **get** + +Permitir al usuario seleccionar archivos, devuelve solo la ruta. De forma predeterminada abre en la carpeta `Documentos`. + +```py + p = app.paths + ruta = p.get() + app.debug(ruta) +``` + +Establecer que abra en otro directorio. + +```py + ruta = p.get('/tmp') + app.debug(ruta) +``` + +Agregar un filtro. + +```py + ruta = p.get(filters='ods') + app.debug(ruta) +``` + +Agregar multiples filtros. + +```py + ruta = p.get(filters='xml,txt') + app.debug(ruta) +``` + +Permitir selecciones multiples. + +```py + rutas = p.get(filters='xml,txt', multiple=True) + app.debug(rutas) +``` + +
+ +### **get_dir** + +Permitir al usuario seleccionar un directorio, devuelve solo la ruta. De forma predeterminada abre en la carpeta `Documentos`. + +```py + p = app.paths + ruta = p.get_dir() + app.debug(ruta) +``` + +Establecer que abra en otro directorio. + +```py + ruta = p.get_dir('/tmp') + app.debug(ruta) +``` + +
+ +### **get_for_save** + +Permitir seleccionar un directorio y capturar el nombre del archivo, devuelve la ruta completa. + +```py + p = app.paths + ruta = p.get_for_save() + app.debug(ruta) +``` + +Establecer que inicie en otro directorio. + +```py + ruta = p.get_for_save('/tmp') + app.debug(ruta) +``` + +Si se establece un filtro, automáticamente se agrega la extensión. + +```python + ruta = p.get_for_save(filters='txt') + app.debug(ruta) +``` + +!!! tip "Atención" + + Si el archivo capturado existe, el usuario verá una advertencia de sobreescritura. + +
+ +### **files** + +Obtener archivos de una ruta, no recursivamente. De forma predeterminada regresa todos, incluyendo archivos ocultos. + +```py + ruta = '/home/elmau' + + p = app.paths + archivos = p.files(ruta) + for a in archivos: + app.debug(a) +``` + +Filtrar por tipo de archivo. + +```py + p = app.paths + archivos = p.files(ruta, '*.pdf') +``` + +Obtener archivos de forma recursiva. + +```py + p = app.paths + archivos = p.files(ruta, '**/*.xml') +``` + +!!! warning "Cuidado:" + + Dependiendo de la cantidad de archivo en la ruta origen, este proceso puede ser costoso en tiempo. + +
+ +### **walk** + +Obtener archivos de forma recursiva. + +```py + p = app.paths + + ruta = '/home/elmau/Documents' + archivos = p.walk(ruta) + for a in archivos: + app.debug(a) +``` + +Con filtro. + +```py + archivos = p.walk(ruta, 'ods') +``` + +Varios filtros. + +```py + archivos = p.walk(ruta, 'ods|odt') +``` + +
+ +### **dirs** + +Obtener los directorios de una ruta, no recursivamente. + +```py + p = app.paths + ruta = '/home/elmau/Documents' + folders = p.dirs(ruta) + for f in folders: + app.debug(f) +``` + +
+ +### **walk_dirs** + +Obtener los directorios de una ruta, recursivamente. + +```py + p = app.paths + ruta = '/home/elmau/Documents' + folders = p.walk_dirs(ruta) + for f in folders: + app.debug(f) +``` + +Obtener información en una lista de tuplas: (`ID_FOLDER`, `ID_PADRE`, `NOMBRE`) + +```py + folders = p.walk_dirs(ruta, True) +``` + +
+ +### **extension** + +Obtener la ruta de instalación de una extensión a partir de su ID. + +```py + p = app.paths + id_ext = 'net.elmau.zaz.talk' + ruta = p.extension(id_ext) + app.debug(ruta) +``` + +
+ +### **replace_ext** + +Reemplazar extensión de un archivo. El reemplazo es solo en la variable, no en el archivo físico. + +```py + p = app.paths + ruta = '/home/elmau/mi_archivo.ods' + ruta_nueva = p.replace_ext(ruta, 'pdf') + app.debug(ruta_nueva) +``` + +
+ +### **open** + +Abrir cualquier archivo con el programa predeterminado del SO. + +```py + p = app.paths + ruta = '/home/elmau/archivo.pdf' + p.open(ruta) + + ruta = '/home/elmau/index.html' + p.open(ruta) +``` + +
+ +### **save** y **read** + +Guardar y leer datos, el encoding predeterminado es UTF8. + +```py + p = app.paths + datos = """¿Quieres saber quién eres? No preguntes. Actúa. + La acción te delineará y definirá. + + Thomas Jefferson + """ + + ruta = '/home/elmau/temp.txt' + p.save(ruta, datos) + + datos = p.read(ruta) + app.msgbox(datos) +``` + +Cambiar el encoding. + +```py + app.paths.save(ruta, datos, 'iso-8859-1') +``` + +
+ +### **save_bin** y **read_bin** + +Guardar y leer datos binarios. + +```py + p = app.paths + datos = b'Datos binarios' + + ruta = '/home/elmau/temp.bin' + p.save_bin(ruta, datos) + + datos = p.read_bin(ruta) + app.msgbox(datos) +``` + +
+ +### **save_json** y **read_json** + +Guardar y leer en formato json. + +```py + p = app.paths + + ruta = '/home/elmau/datos.json' + datos = { + 'tipo': 'calc', + 'nombre': 'miarchivo.ods', + } + p.save_json(ruta, datos) + + datos = p.read_json(ruta) + app.msgbox(datos) +``` + +
+ +### **save_csv** y **read_csv** + +Exportar e importar datos en formato CSV. Vea la documentación [CSV][2] para los argumentos que puede usar. + +```py + p = app.paths + + ruta = '/home/elmau/datos.csv' + ahora = app.dates.now + datos = ( + (1, 'uno', ahora), + (2, 'dos', ahora), + (3, 'tres', ahora), + ) + p.save_csv(ruta, datos) + + datos = p.read_csv(ruta) + app.msgbox(datos) +``` + +
+ +### **kill** + +Borra archivos o directorios con todo su contenido. Devuelve verdadero (True) en caso de exito y falso (Falso) en cualquier otro caso. + +!!! warning inline end "Cuidado" + + Este proceso es destructivo, es buena practica siempre solicitar confirmación al usuario. + +```py + p = app.paths + + ruta = '/home/elmau/temp.bin' + resultado = p.kill(ruta) + app.msgbox(resultado) +``` + +
+ +### **copy** + +Copiar archivos. Devuelve la ruta completa final destino. + +De un archivo origen a una carpeta destino con el mismo nombre. + +```py + p = app.paths + + ruta_origen = '/home/elmau/temp.txt' + ruta_destino = '/home/elmau/Desktop' + ruta = p.copy(ruta_origen, ruta_destino) + app.debug(ruta) +``` + +Cambiando el nombre destino. + +```py + ruta_origen = '/home/elmau/temp.txt' + ruta_destino = '/home/elmau/Desktop' + nuevo_nombre = 'datos.csv' + ruta = p.copy(ruta_origen, ruta_destino, nuevo_nombre) + app.debug(ruta) +``` + +
+ +### **zip** + +Comprimir un archivo en el mismo directorio, lo comprime y le asigna el mismo nombre con extensión `zip`. + +```py + p = app.paths + origen = '/home/elmau/temp.txt' + destino = p.zip(origen) + app.debug(destino) +``` + +Comprimir varios archivos estableciendo ruta y nombre destino. + +```py + archivos = ( + '/home/elmau/temp.txt', + '/home/elmau/ids', + '/home/elmau/ids.ods') + destino = p.zip(archivos, '/home/elmau/destino.zip') + app.debug(destino) +``` + +Comprimir un directorio. + +```py + directorio = '/home/elmau/pruebas' + destino = p.zip(directorio, '/home/elmau/pruebas.zip') + app.debug(destino) +``` + +
+ +### **zip_content** + +Devuelve una lista con los nombres de los archivos contenidos en el archivo `zip`. + +```py + archivo = '/home/elmau/temp.zip' + contenido = p.zip_content(archivo) + app.debug(contenido) +``` + +
+ +### **unzip** + +Descomprime un archivo `zip` en el mismo directorio. + +```py + p = app.paths + + archivo = '/home/elmau/temp.zip' + p.unzip(archivo) +``` + +Descomprime un archivo `zip` en otro directorio. + +```py + archivo = '/home/elmau/temp.zip' + destino = '/home/elmau/Desktop' + p.unzip(archivo, destino) +``` + + +[1]: http://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1util_1_1XPathSettings.html +[2]: https://docs.python.org/3.7/library/csv.html diff --git a/doc/docs/tools/request.md b/doc/docs/tools/request.md new file mode 100644 index 0000000..6e394f6 --- /dev/null +++ b/doc/docs/tools/request.md @@ -0,0 +1,76 @@ +Gracias a [mureq](https://github.com/slingamn/mureq) una sencilla librería para hacer peticiciones HTTP, similar a [requests](https://requests.readthedocs.io) pero más sencilla y en un solo archivo. + +### **get** + +Método `get`. + +```py +def prueba_get(): + + url = 'https://api.ipify.org' + respuesta = app.url.get(url) + if respuesta.status_code == 200: + mi_ip = respuesta.body.decode() + app.debug(f'IP: {mi_ip}') + else: + app.debug(respuesta.status_code) + + return +``` + +```sh +16/08/2022 22:14:13 - DEBUG - IP: 199.203.174.159 +``` + +
+ +#### **json** + +Respuestas en formato json. + +```py +def prueba_get(): + + url = 'https://api.ipify.org/?format=json' + respuesta = app.url.get(url) + if respuesta.status_code == 200: + datos = respuesta.json() + app.debug(f'IP: {datos["ip"]}') + else: + app.debug(respuesta.status_code) + + return +``` + +
+ +## **post** + +Método `post` + +```py +def prueba_post(): + + url = 'https://translate.terraprint.co/translate' + data = dict( + q = 'Hello World', + source = 'en', + target = 'es', + ) + respuesta = app.url.post(url, json=data) + if respuesta.status_code != 200: + app.debug(respuesta.status_code) + return + + datos = respuesta.json() + app.debug(datos) + + return +``` + +```sh +elmau@oficina ~> soffice --calc +22/04/2023 14:57:50 - DEBUG - {'translatedText': 'Hola Mundo'} +``` + +
\ No newline at end of file diff --git a/doc/content/es/tools/threads/_index.md b/doc/docs/tools/threads.md similarity index 67% rename from doc/content/es/tools/threads/_index.md rename to doc/docs/tools/threads.md index b78ac01..1350b1f 100644 --- a/doc/content/es/tools/threads/_index.md +++ b/doc/docs/tools/threads.md @@ -1,18 +1,12 @@ -+++ -title = "Hilos" -weight = 5 -+++ - -#### Ejecutar macros en otros hilos. +## Ejecutar macros en otros hilos. Las macros se ejecutan en un hilo que bloquea cualquier otro proceso dentro de la aplicación. Si ejecutas la siguiente macro `main`, nota que no puedes hacer algo más dentro de LibreOffice durante los 5 segundos que dura el proceso. -```python +```py import easymacro as app - def hacer_pausa(segundos): app.sleep(segundos) app.debug('He terminado') @@ -24,13 +18,15 @@ def main(): return ``` -Hasta que aparece el cuadro de mensaje con la palabra `Fin` y lo cierras, el usuario puede seguir usando la aplicación. +Hasta que aparece el cuadro de mensaje con la palabra `Fin` y lo cierras, el usuario puede seguir usando la aplicación. En algunos casos no queremos esto, para ello se usan los hilos de ejecución. -### run_in_thread +
+ +### **run_in_thread** Ahora ejecutamos la macro en otro hilo, "decorando" cualquier macro con `run_in_thread` -```python +```py @app.run_in_thread def hacer_pausa(segundos): app.sleep(segundos) @@ -45,6 +41,8 @@ def main(): Nota que ahora el mensaje aparece inmediatamente y no tras los 5 segundos. -{{% notice warning %}} -Ponga mucha atención en **no ejecutar macros en otros hilo** que dependen de algo suceptible de ser cambiado o interceptado por el usuario, por ejemplo, la celda activa. -{{% /notice %}} +!!! warning "Cuidado" + + Ponga mucha atención en **no ejecutar macros en otros hilos** que dependen de algo suceptible de ser cambiado o interceptado por el usuario, por ejemplo, la celda activa. + +
\ No newline at end of file diff --git a/doc/content/es/tools/timer/_index.md b/doc/docs/tools/timer.md similarity index 76% rename from doc/content/es/tools/timer/_index.md rename to doc/docs/tools/timer.md index 6d32858..63d4772 100644 --- a/doc/content/es/tools/timer/_index.md +++ b/doc/docs/tools/timer.md @@ -1,16 +1,15 @@ -+++ -title = "Timer" -weight = 7 -+++ El `timer` siempre se ejecuta en otro hilo. -### once +### **once** Ejecutar macro una sola vez en X segundos. +!!! tip "Atención" -```python + Asegurese siempre de establecer un nombre único para cada timer. + +```py import easymacro as app @@ -18,7 +17,7 @@ NOMBRE = 'reloj' def mostrar_hora(): - app.debug(app.dates.now_time) + app.debug(app.dates.now.time()) return @@ -37,14 +36,16 @@ def main(args=None): return ``` -### cancel +
+ +### **cancel** Cancelar ejecución, antes del tiempo establecido. -```python +```py def main(args=None): iniciar_conteo() - app.sleep(3) + app.sleep(2) detener_conteo() return @@ -53,21 +54,23 @@ def detener_conteo(): return ``` -``` -16/08/2022 21:18:50 - INFO - Event: "reloj", started... execute in 60 seconds +```sh +16/08/2022 21:18:50 - INFO - Event: "reloj", started... execute in 5 seconds 16/08/2022 21:18:55 - INFO - Cancel event: "reloj", ok... ``` -### start +
+ +### **start** Ejecutar macro cada X segundos. -```python +```py NOMBRE = 'reloj' def mostrar_hora(): - app.debug(app.dates.now_time) + app.debug(app.dates.now.time()) return @@ -80,22 +83,25 @@ def iniciar_reloj(): app.timer.start(NOMBRE, segundos, macro) return + def main(args=None): iniciar_reloj() return ``` -### stop +
+ +### **stop** Detener timer. -```python +```py def detener_reloj(): app.timer.stop(NOMBRE) return ``` -``` +```sh 16/08/2022 21:25:37 - INFO - Timer 'reloj' started, execute macro: 'mostrar_hora' 16/08/2022 21:25:38 - DEBUG - 21:25:38 16/08/2022 21:25:39 - DEBUG - 21:25:39 @@ -105,12 +111,10 @@ def detener_reloj(): 16/08/2022 21:25:48 - INFO - Timer stopped... ``` +
-{{% notice tip %}} -Asegurese siempre de establecer un nombre único para cada timer. -{{% /notice %}} +!!! warning "Cuidado" + Asegurese siempre de ejecutar macros que NO bloqueen la interfaz del usuario. -{{% notice warning %}} -Asegurese siempre de ejecutar macros que NO bloqueen la interfaz del usuario. -{{% /notice %}} +
\ No newline at end of file diff --git a/doc/docs/tools/utils.md b/doc/docs/tools/utils.md new file mode 100644 index 0000000..f1ae3d3 --- /dev/null +++ b/doc/docs/tools/utils.md @@ -0,0 +1,210 @@ + +### **dict_to_property** + +Convertir diccionarios en PropertyValue + +```py + datos = { + 'Hidden': True, + 'Password': 'letmein', + } + propiedades = app.dict_to_property(datos) + + app.msgbox(propiedades) +``` + +
+ +### **data_to_dict** + +Convertir `PropertyValue` en diccionarios + +```py + datos = app.data_to_dict(propiedades) + app.msgbox(datos) +``` + +Convertir `tuplas` a diccionario. + +```py + tupla_de_tuplas = ( + ('Hidden', True), + ('Password', 'letmein'), + ) + datos = app.data_to_dict(tupla_de_tuplas) + app.msgbox(datos) +``` + +Convertir `listas` a diccionario. + +```py + lista_de_listas = [ + ['Hidden', True], + ['Password', 'letmein'], + ] + datos = app.data_to_dict(lista_de_listas) + app.msgbox(datos) +``` + +
+ +### **sleep** + +Hacer una pausa de X segundos. + +```py + app.sleep(5) +``` + +
+ +### **render** + +Reemplazar variables en cadenas de texto. + +```py + plantilla = """Hola $nombre + + Te envío este archivo: $archivo + + Saludos cordiales + """ + + datos = { + 'nombre': 'Ingrid Bergman', + 'archivo': 'carta_de_amor.odt' + } + + resultado = app.render(plantilla, datos) + + app.msgbox(resultado) +``` + +
+ +### **run** + +Ejecutar un programa. + +```py + nombre_aplicacion = 'gnome-calculator' + app.shell.run(nombre_aplicacion) +``` + +Ejecutar comandos shell y capturar la salida. + +```py + comandos = 'ls -lh ~' + resultado = app.shell.run(comandos, True) + app.debug(resultado) +``` + +```sh +drwxr-xr-x 4 mau mau 4.0K Aug 15 23:36 Desktop +drwxr-xr-x 6 mau mau 4.0K Jun 9 23:32 Documents +drwxr-xr-x 5 mau mau 4.0K Aug 16 13:09 Downloads +drwxr-xr-x 3 mau mau 4.0K Aug 14 15:19 Pictures +drwxr-xr-x 10 mau mau 4.0K Jun 19 19:36 Projects +drwxr-xr-x 2 mau mau 4.0K May 11 22:36 Templates +drwxr-xr-x 2 mau mau 4.0K Jul 19 13:37 Videos +``` + +Ejectuar comandos y capturar la salida línea a línea. + +```py + comandos = 'ls -lh /home/elmau' + for linea in app.shell.popen(comandos): + app.debug(linea) +``` + +
+ +### **digest** + +Obtener hash. Por default se regresa en hexadecimal. + +```py + datos = 'LibreOffice con Python' + + digest = app.hash.digest('md5', datos) + app.debug('MD5 = ', digest) + + digest = app.hash.digest('sha1', datos) + app.debug('SHA1 = ', digest) + + digest = app.hash.digest('sha256', datos) + app.debug('SHA256 = ', digest) + + digest = app.hash.digest('sha512', datos) + app.debug('SHA512 = ', digest) +``` + +``` +16/08/2022 18:48:07 - DEBUG - MD5 = 3801759ead20abc3ce0d0095289bdcfd +16/08/2022 18:48:07 - DEBUG - SHA1 = 1df74aaae9658c21074aa5a2d4c2055dcf79f0db +16/08/2022 18:48:07 - DEBUG - SHA256 = 228e90b15b6259307e580677939b1f2f45e9317461e98f603af8fcac0f9a598f +16/08/2022 18:48:07 - DEBUG - SHA512 = 3ef45f79f3bfd2b251d250489c91b631306456405510397fb1a7ee37005d196376b7d6ca86a9895f4eb97eb74813965c24d6564a383f4bdb1360665c8fbb192a +``` + +Para obtener bytes. + +```py + digest = app.hash.digest('md5', datos, False) + app.debug('MD5 = ', digest) +``` + +```sh +16/08/2022 18:48:07 - DEBUG - MD5 = b'8\x01u\x9e\xad \xab\xc3\xce\r\x00\x95(\x9b\xdc\xfd' +``` + +
+ +### **config** + +Puede guardar datos de configuración de su macro o extensión dentro del perfil de usuario. + +```py + nombre = 'mi_extension' + datos = { + 'ruta': '/home/mau/pruebas', + 'guardar': True, + } + + if app.config.set(nombre, datos): + app.debug('Configuración guardada...') +``` + +Y recuperarlos en cualquier momento. + +```py + datos = app.config.get(nombre) + app.debug(datos) +``` + +!!! tip + + No olvide respaldar el perfil de usuario si quiere conservar esta información cuando se reinstala LibreOffice o falla el perfil de usuario. + +
+ +### **color** + +Puede ver los colores que puede usar en Wikipedia [Colores Web][1] + +```py + color_nombre = 'darkblue' + color = app.color(color_nombre) + app.debug(color) + + color_rgb = (125, 200, 10) + color = app.color(color_rgb) + app.debug(color) + + color_html = '#008080' + color = app.color(color_html) + app.debug(color) +``` + +
+ +[1]: https://es.wikipedia.org/wiki/Colores_web diff --git a/doc/layouts/partials/logo.html b/doc/layouts/partials/logo.html deleted file mode 100644 index fc67e09..0000000 --- a/doc/layouts/partials/logo.html +++ /dev/null @@ -1,53 +0,0 @@ - - - - - diff --git a/doc/mkdocs.yml b/doc/mkdocs.yml new file mode 100644 index 0000000..2ce9bd3 --- /dev/null +++ b/doc/mkdocs.yml @@ -0,0 +1,56 @@ +site_name: EasyMacro para LibreOffice +site_url: https://doc.cuates.net/easymacro/ +repo_url: https://git.cuates.net/elmau/easymacro/ +nav: + - Home: index.md + - Instalación: install.md + - Depurar: debug.md + - Herramientas: + - tools/index.md + - Mensajes: tools/messages.md + - Fechas y tiempo: tools/datetime.md + - Rutas y archivos: tools/paths.md + - Correo electrónico: tools/email.md + - Hilos: tools/threads.md + - Ejecutar macros: tools/macros.md + - Timer: tools/timer.md + - Peticiones HTTP: tools/request.md + - Utilidades: tools/utils.md + - LibreOffice: + - app/index.md + - Accesos directos: app/shortcuts.md + - Menús: app/menus.md + - Documentos: + - docs/index.md + - Propiedades: docs/properties.md + - Métodos: docs/methods.md +theme: + name: material + locale: es + font: false + highlightjs: true + palette: + primary: green + features: + - navigation.path + - content.code.copy + - content.code.select +markdown_extensions: + - admonition + - pymdownx.details + - pymdownx.superfences + - pymdownx.highlight: + anchor_linenums: true + line_spans: __span + pygments_lang_class: true + - pymdownx.inlinehilite + - pymdownx.snippets + - pymdownx.superfences +#~ extra: + #~ alternate: + #~ - name: Español + #~ link: / + #~ lang: es + #~ - name: English + #~ link: /en/ + #~ lang: en diff --git a/doc/public/404.html b/doc/public/404.html deleted file mode 100644 index ec988c9..0000000 --- a/doc/public/404.html +++ /dev/null @@ -1,59 +0,0 @@ - - - - - - - - -
-
-
-
- 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - category :: - - Categories -
- - - - - - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/categories/index.xml b/doc/public/categories/index.xml
deleted file mode 100644
index 1ab2055..0000000
--- a/doc/public/categories/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-separator in menu */ - -} - -body { - color: var(--MAIN-TEXT-color) !important; -} - -textarea:focus, input[type="email"]:focus, input[type="number"]:focus, input[type="password"]:focus, input[type="search"]:focus, input[type="tel"]:focus, input[type="text"]:focus, input[type="url"]:focus, input[type="color"]:focus, input[type="date"]:focus, input[type="datetime"]:focus, input[type="datetime-local"]:focus, input[type="month"]:focus, input[type="time"]:focus, input[type="week"]:focus, select[multiple=multiple]:focus { - border-color: none; - box-shadow: none; -} - -h2, h3, h4, h5 { - color: var(--MAIN-TITLES-TEXT-color) !important; -} - -a { - color: var(--MAIN-LINK-color); -} - -.anchor { - color: var(--MAIN-ANCHOR-color); -} - -a:hover { - color: var(--MAIN-LINK-HOVER-color); -} - -#sidebar ul li.visited > a .read-icon { - color: var(--MENU-VISITED-color); -} - -#body a.highlight:after { - display: block; - content: ""; - height: 1px; - width: 0%; - -webkit-transition: width 0.5s ease; - -moz-transition: width 0.5s ease; - -ms-transition: width 0.5s ease; - transition: width 0.5s ease; - background-color: var(--MAIN-LINK-HOVER-color); -} -#sidebar { - background-color: var(--MENU-SECTIONS-BG-color); -} -#sidebar #header-wrapper { - background: var(--MENU-HEADER-BG-color); - color: var(--MENU-SEARCH-BOX-color); - border-color: var(--MENU-HEADER-BORDER-color); -} -#sidebar .searchbox { - border-color: var(--MENU-SEARCH-BOX-color); - background: var(--MENU-SEARCH-BG-color); -} -#sidebar ul.topics > li.parent, #sidebar ul.topics > li.active { - background: var(--MENU-SECTIONS-ACTIVE-BG-color); -} -#sidebar .searchbox * { - color: var(--MENU-SEARCH-BOX-ICONS-color); -} - -#sidebar a { - color: var(--MENU-SECTIONS-LINK-color); -} - -#sidebar a:hover { - color: var(--MENU-SECTIONS-LINK-HOVER-color); -} - -#sidebar ul li.active > a { - background: var(--MENU-SECTION-ACTIVE-CATEGORY-BG-color); - color: var(--MENU-SECTION-ACTIVE-CATEGORY-color) !important; -} - -#sidebar hr { - border-color: var(--MENU-SECTION-HR-color); -} - -#body .tags a.tag-link { - background-color: var(--MENU-HEADER-BG-color); -} - -#body .tags a.tag-link:before { - border-right-color: var(--MENU-HEADER-BG-color); -} - -#homelinks { - background: var(--MENU-HEADER-BG-color); - background-color: var(--MENU-HEADER-BORDER-color); - border-bottom-color: var(--MENU-HEADER-BORDER-color); -} - -#homelinks a { - color: var(--MENU-HOME-LINK-color); -} - -#homelinks a:hover { - color: var(--MENU-HOME-LINK-HOVERED-color); -} \ No newline at end of file diff --git a/doc/public/css/theme-green.css b/doc/public/css/theme-green.css deleted file mode 100644 index c074679..0000000 --- a/doc/public/css/theme-green.css +++ /dev/null @@ -1,128 +0,0 @@ - -:root{ - - --MAIN-TEXT-color:#323232; /* Color of text by default */ - --MAIN-TITLES-TEXT-color: #5e5e5e; /* Color of titles h2-h3-h4-h5 */ - --MAIN-LINK-color:#599a3e; /* Color of links */ - --MAIN-LINK-HOVER-color:#3f6d2c; /* Color of hovered links */ - --MAIN-ANCHOR-color: #599a3e; /* color of anchors on titles */ - - --MENU-HOME-LINK-color: #323232; /* Color of the home button text */ - --MENU-HOME-LINK-HOVER-color: #5e5e5e; /* Color of the hovered home button text */ - - --MENU-HEADER-BG-color:#74b559; /* Background color of menu header */ - --MENU-HEADER-BORDER-color:#9cd484; /*Color of menu header border */ - - --MENU-SEARCH-BG-color:#599a3e; /* Search field background color (by default borders + icons) */ - --MENU-SEARCH-BOX-color: #84c767; /* Override search field border color */ - --MENU-SEARCH-BOX-ICONS-color: #c7f7c4; /* Override search field icons color */ - - --MENU-SECTIONS-ACTIVE-BG-color:#1b211c; /* Background color of the active section and its childs */ - --MENU-SECTIONS-BG-color:#222723; /* Background color of other sections */ - --MENU-SECTIONS-LINK-color: #ccc; /* Color of links in menu */ - --MENU-SECTIONS-LINK-HOVER-color: #e6e6e6; /* Color of links in menu, when hovered */ - --MENU-SECTION-ACTIVE-CATEGORY-color: #777; /* Color of active category text */ - --MENU-SECTION-ACTIVE-CATEGORY-BG-color: #fff; /* Color of background for the active category (only) */ - - --MENU-VISITED-color: #599a3e; /* Color of 'page visited' icons in menu */ - --MENU-SECTION-HR-color: #18211c; /* Color of
separator in menu */ - -} - -body { - color: var(--MAIN-TEXT-color) !important; -} - -textarea:focus, input[type="email"]:focus, input[type="number"]:focus, input[type="password"]:focus, input[type="search"]:focus, input[type="tel"]:focus, input[type="text"]:focus, input[type="url"]:focus, input[type="color"]:focus, input[type="date"]:focus, input[type="datetime"]:focus, input[type="datetime-local"]:focus, input[type="month"]:focus, input[type="time"]:focus, input[type="week"]:focus, select[multiple=multiple]:focus { - border-color: none; - box-shadow: none; -} - -h2, h3, h4, h5 { - color: var(--MAIN-TITLES-TEXT-color) !important; -} - -a { - color: var(--MAIN-LINK-color); -} - -.anchor { - color: var(--MAIN-ANCHOR-color); -} - -a:hover { - color: var(--MAIN-LINK-HOVER-color); -} - -#sidebar ul li.visited > a .read-icon { - color: var(--MENU-VISITED-color); -} - -#body a.highlight:after { - display: block; - content: ""; - height: 1px; - width: 0%; - -webkit-transition: width 0.5s ease; - -moz-transition: width 0.5s ease; - -ms-transition: width 0.5s ease; - transition: width 0.5s ease; - background-color: var(--MAIN-LINK-HOVER-color); -} -#sidebar { - background-color: var(--MENU-SECTIONS-BG-color); -} -#sidebar #header-wrapper { - background: var(--MENU-HEADER-BG-color); - color: var(--MENU-SEARCH-BOX-color); - border-color: var(--MENU-HEADER-BORDER-color); -} -#sidebar .searchbox { - border-color: var(--MENU-SEARCH-BOX-color); - background: var(--MENU-SEARCH-BG-color); -} -#sidebar ul.topics > li.parent, #sidebar ul.topics > li.active { - background: var(--MENU-SECTIONS-ACTIVE-BG-color); -} -#sidebar .searchbox * { - color: var(--MENU-SEARCH-BOX-ICONS-color); -} - -#sidebar a { - color: var(--MENU-SECTIONS-LINK-color); -} - -#sidebar a:hover { - color: var(--MENU-SECTIONS-LINK-HOVER-color); -} - -#sidebar ul li.active > a { - background: var(--MENU-SECTION-ACTIVE-CATEGORY-BG-color); - color: var(--MENU-SECTION-ACTIVE-CATEGORY-color) !important; -} - -#sidebar hr { - border-color: var(--MENU-SECTION-HR-color); -} - -#body .tags a.tag-link { - background-color: var(--MENU-HEADER-BG-color); -} - -#body .tags a.tag-link:before { - border-right-color: var(--MENU-HEADER-BG-color); -} - -#homelinks { - background: var(--MENU-HEADER-BG-color); - background-color: var(--MENU-HEADER-BORDER-color); - border-bottom-color: var(--MENU-HEADER-BORDER-color); -} - -#homelinks a { - color: var(--MENU-HOME-LINK-color); -} - -#homelinks a:hover { - color: var(--MENU-HOME-LINK-HOVERED-color); -} \ No newline at end of file diff --git a/doc/public/css/theme-red.css b/doc/public/css/theme-red.css deleted file mode 100644 index c5f2674..0000000 --- a/doc/public/css/theme-red.css +++ /dev/null @@ -1,128 +0,0 @@ - -:root{ - - --MAIN-TEXT-color:#323232; /* Color of text by default */ - --MAIN-TITLES-TEXT-color: #5e5e5e; /* Color of titles h2-h3-h4-h5 */ - --MAIN-LINK-color:#f31c1c; /* Color of links */ - --MAIN-LINK-HOVER-color:#d01616; /* Color of hovered links */ - --MAIN-ANCHOR-color: #f31c1c; /* color of anchors on titles */ - - --MENU-HOME-LINK-color: #ccc; /* Color of the home button text */ - --MENU-HOME-LINK-HOVER-color: #e6e6e6; /* Color of the hovered home button text */ - - --MENU-HEADER-BG-color:#dc1010; /* Background color of menu header */ - --MENU-HEADER-BORDER-color:#e23131; /*Color of menu header border */ - - --MENU-SEARCH-BG-color:#b90000; /* Search field background color (by default borders + icons) */ - --MENU-SEARCH-BOX-color: #ef2020; /* Override search field border color */ - --MENU-SEARCH-BOX-ICONS-color: #fda1a1; /* Override search field icons color */ - - --MENU-SECTIONS-ACTIVE-BG-color:#2b2020; /* Background color of the active section and its childs */ - --MENU-SECTIONS-BG-color:#312525; /* Background color of other sections */ - --MENU-SECTIONS-LINK-color: #ccc; /* Color of links in menu */ - --MENU-SECTIONS-LINK-HOVER-color: #e6e6e6; /* Color of links in menu, when hovered */ - --MENU-SECTION-ACTIVE-CATEGORY-color: #777; /* Color of active category text */ - --MENU-SECTION-ACTIVE-CATEGORY-BG-color: #fff; /* Color of background for the active category (only) */ - - --MENU-VISITED-color: #ff3333; /* Color of 'page visited' icons in menu */ - --MENU-SECTION-HR-color: #2b2020; /* Color of
separator in menu */ - -} - -body { - color: var(--MAIN-TEXT-color) !important; -} - -textarea:focus, input[type="email"]:focus, input[type="number"]:focus, input[type="password"]:focus, input[type="search"]:focus, input[type="tel"]:focus, input[type="text"]:focus, input[type="url"]:focus, input[type="color"]:focus, input[type="date"]:focus, input[type="datetime"]:focus, input[type="datetime-local"]:focus, input[type="month"]:focus, input[type="time"]:focus, input[type="week"]:focus, select[multiple=multiple]:focus { - border-color: none; - box-shadow: none; -} - -h2, h3, h4, h5 { - color: var(--MAIN-TITLES-TEXT-color) !important; -} - -a { - color: var(--MAIN-LINK-color); -} - -.anchor { - color: var(--MAIN-ANCHOR-color); -} - -a:hover { - color: var(--MAIN-LINK-HOVER-color); -} - -#sidebar ul li.visited > a .read-icon { - color: var(--MENU-VISITED-color); -} - -#body a.highlight:after { - display: block; - content: ""; - height: 1px; - width: 0%; - -webkit-transition: width 0.5s ease; - -moz-transition: width 0.5s ease; - -ms-transition: width 0.5s ease; - transition: width 0.5s ease; - background-color: var(--MAIN-LINK-HOVER-color); -} -#sidebar { - background-color: var(--MENU-SECTIONS-BG-color); -} -#sidebar #header-wrapper { - background: var(--MENU-HEADER-BG-color); - color: var(--MENU-SEARCH-BOX-color); - border-color: var(--MENU-HEADER-BORDER-color); -} -#sidebar .searchbox { - border-color: var(--MENU-SEARCH-BOX-color); - background: var(--MENU-SEARCH-BG-color); -} -#sidebar ul.topics > li.parent, #sidebar ul.topics > li.active { - background: var(--MENU-SECTIONS-ACTIVE-BG-color); -} -#sidebar .searchbox * { - color: var(--MENU-SEARCH-BOX-ICONS-color); -} - -#sidebar a { - color: var(--MENU-SECTIONS-LINK-color); -} - -#sidebar a:hover { - color: var(--MENU-SECTIONS-LINK-HOVER-color); -} - -#sidebar ul li.active > a { - background: var(--MENU-SECTION-ACTIVE-CATEGORY-BG-color); - color: var(--MENU-SECTION-ACTIVE-CATEGORY-color) !important; -} - -#sidebar hr { - border-color: var(--MENU-SECTION-HR-color); -} - -#body .tags a.tag-link { - background-color: var(--MENU-HEADER-BG-color); -} - -#body .tags a.tag-link:before { - border-right-color: var(--MENU-HEADER-BG-color); -} - -#homelinks { - background: var(--MENU-HEADER-BG-color); - background-color: var(--MENU-HEADER-BORDER-color); - border-bottom-color: var(--MENU-HEADER-BORDER-color); -} - -#homelinks a { - color: var(--MENU-HOME-LINK-color); -} - -#homelinks a:hover { - color: var(--MENU-HOME-LINK-HOVERED-color); -} \ No newline at end of file diff --git a/doc/public/css/theme.css b/doc/public/css/theme.css deleted file mode 100644 index 98a5584..0000000 --- a/doc/public/css/theme.css +++ /dev/null @@ -1,1143 +0,0 @@ -@charset "UTF-8"; - -/* Tags */ -@import "tags.css"; - -#top-github-link, #body #breadcrumbs { - position: relative; - top: 50%; - -webkit-transform: translateY(-50%); - -moz-transform: translateY(-50%); - -o-transform: translateY(-50%); - -ms-transform: translateY(-50%); - transform: translateY(-50%); -} -.button, .button-secondary { - display: inline-block; - padding: 7px 12px; -} -.button:active, .button-secondary:active { - margin: 2px 0 -2px 0; -} -@font-face { - font-family: 'Novacento Sans Wide'; - src: url("../fonts/Novecentosanswide-UltraLight-webfont.eot"); - src: url("../fonts/Novecentosanswide-UltraLight-webfont.eot?#iefix") format("embedded-opentype"), url("../fonts/Novecentosanswide-UltraLight-webfont.woff2") format("woff2"), url("../fonts/Novecentosanswide-UltraLight-webfont.woff") format("woff"), url("../fonts/Novecentosanswide-UltraLight-webfont.ttf") format("truetype"), url("../fonts/Novecentosanswide-UltraLight-webfont.svg#novecento_sans_wideultralight") format("svg"); - font-style: normal; - font-weight: 200; -} -@font-face { - font-family: 'Work Sans'; - font-style: normal; - font-weight: 300; - src: url("../fonts/Work_Sans_300.eot?#iefix") format("embedded-opentype"), url("../fonts/Work_Sans_300.woff") format("woff"), url("../fonts/Work_Sans_300.woff2") format("woff2"), url("../fonts/Work_Sans_300.svg#WorkSans") format("svg"), url("../fonts/Work_Sans_300.ttf") format("truetype"); -} -@font-face { - font-family: 'Work Sans'; - font-style: normal; - font-weight: 500; - src: url("../fonts/Work_Sans_500.eot?#iefix") format("embedded-opentype"), url("../fonts/Work_Sans_500.woff") format("woff"), url("../fonts/Work_Sans_500.woff2") format("woff2"), url("../fonts/Work_Sans_500.svg#WorkSans") format("svg"), url("../fonts/Work_Sans_500.ttf") format("truetype"); -} -body { - background: #fff; - color: #777; -} -body #chapter h1 { - font-size: 3.5rem; -} -@media only all and (min-width: 48em) and (max-width: 59.938em) { - body #chapter h1 { - font-size: 3rem; - } -} -@media only all and (max-width: 47.938em) { - body #chapter h1 { - font-size: 2rem; - } -} -a { - color: #00bdf3; -} -a:hover { - color: #0082a7; -} -pre { - position: relative; - color: #ffffff; -} -.bg { - background: #fff; - border: 1px solid #eaeaea; -} -b, strong, label, th { - font-weight: 600; -} -.default-animation, #header #logo-svg, #header #logo-svg path, #sidebar, #sidebar ul, #body, #body .padding, #body .nav { - -webkit-transition: all 0.5s ease; - -moz-transition: all 0.5s ease; - transition: all 0.5s ease; -} -#grav-logo { - max-width: 60%; -} -#grav-logo path { - fill: #fff !important; -} -#sidebar { - font-weight: 300 !important; -} -fieldset { - border: 1px solid #ddd; -} -textarea, input[type="email"], input[type="number"], input[type="password"], input[type="search"], input[type="tel"], input[type="text"], input[type="url"], input[type="color"], input[type="date"], input[type="datetime"], input[type="datetime-local"], input[type="month"], input[type="time"], input[type="week"], select[multiple=multiple] { - background-color: white; - border: 1px solid #ddd; - box-shadow: inset 0 1px 3px rgba(0, 0, 0, 0.06); -} -textarea:hover, input[type="email"]:hover, input[type="number"]:hover, input[type="password"]:hover, input[type="search"]:hover, input[type="tel"]:hover, input[type="text"]:hover, input[type="url"]:hover, input[type="color"]:hover, input[type="date"]:hover, input[type="datetime"]:hover, input[type="datetime-local"]:hover, input[type="month"]:hover, input[type="time"]:hover, input[type="week"]:hover, select[multiple=multiple]:hover { - border-color: #c4c4c4; -} -textarea:focus, input[type="email"]:focus, input[type="number"]:focus, input[type="password"]:focus, input[type="search"]:focus, input[type="tel"]:focus, input[type="text"]:focus, input[type="url"]:focus, input[type="color"]:focus, input[type="date"]:focus, input[type="datetime"]:focus, input[type="datetime-local"]:focus, input[type="month"]:focus, input[type="time"]:focus, input[type="week"]:focus, select[multiple=multiple]:focus { - border-color: #00bdf3; - box-shadow: inset 0 1px 3px rgba(0,0,0,.06),0 0 5px rgba(0,169,218,.7) -} -#header-wrapper { - background: #8451a1; - color: #fff; - text-align: center; - border-bottom: 4px solid #9c6fb6; - padding: 1rem; -} -#header a { - display: inline-block; -} -#header #logo-svg { - width: 8rem; - height: 2rem; -} -#header #logo-svg path { - fill: #fff; -} -.searchbox { - margin-top: 1rem; - position: relative; - border: 1px solid #915eae; - background: #764890; - border-radius: 4px; -} -.searchbox label { - color: rgba(255, 255, 255, 0.8); - position: absolute; - left: 10px; - top: 3px; -} -.searchbox span { - color: rgba(255, 255, 255, 0.6); - position: absolute; - right: 10px; - top: 3px; - cursor: pointer; -} -.searchbox span:hover { - color: rgba(255, 255, 255, 0.9); -} -.searchbox input { - display: inline-block; - color: #fff; - width: 100%; - height: 30px; - background: transparent; - border: 0; - padding: 0 25px 0 30px; - margin: 0; - font-weight: 300; -} -.searchbox input::-webkit-input-placeholder { - color: rgba(255, 255, 255, 0.6); -} -.searchbox input::-moz-placeholder { - color: rgba(255, 255, 255, 0.6); -} -.searchbox input:-moz-placeholder { - color: rgba(255, 255, 255, 0.6); -} -.searchbox input:-ms-input-placeholder { - color: rgba(255, 255, 255, 0.6); -} -#sidebar-toggle-span { - display: none; -} -@media only all and (max-width: 47.938em) { - #sidebar-toggle-span { - display: inline; - } -} -#sidebar { - background-color: #322A38; - position: fixed; - top: 0; - width: 300px; - bottom: 0; - left: 0; - font-weight: 400; - font-size: 15px; -} -#sidebar a { - color: #ccc; -} -#sidebar a:hover { - color: #e6e6e6; -} -#sidebar a.subtitle { - color: rgba(204, 204, 204, 0.6); -} -#sidebar hr { - border-bottom: 1px solid #2a232f; -} -#sidebar a.padding { - padding: 0 1rem; -} -#sidebar h5 { - margin: 2rem 0 0; - position: relative; - line-height: 2; -} -#sidebar h5 a { - display: block; - margin-left: 0; - margin-right: 0; - padding-left: 1rem; - padding-right: 1rem; -} -#sidebar h5 i { - color: rgba(204, 204, 204, 0.6); - position: absolute; - right: 0.6rem; - top: 0.7rem; - font-size: 80%; -} -#sidebar h5.parent a { - background: #201b24; - color: #d9d9d9 !important; -} -#sidebar h5.active a { - background: #fff; - color: #777 !important; -} -#sidebar h5.active i { - color: #777 !important; -} -#sidebar h5 + ul.topics { - display: none; - margin-top: 0; -} -#sidebar h5.parent + ul.topics, #sidebar h5.active + ul.topics { - display: block; -} -#sidebar ul { - list-style: none; - padding: 0; - margin: 0; -} -#sidebar ul.searched a { - color: #999999; -} -#sidebar ul.searched .search-match a { - color: #e6e6e6; -} -#sidebar ul.searched .search-match a:hover { - color: white; -} -#sidebar ul.topics { - margin: 0 1rem; -} -#sidebar ul.topics.searched ul { - display: block; -} -#sidebar ul.topics ul { - display: none; - padding-bottom: 1rem; -} -#sidebar ul.topics ul ul { - padding-bottom: 0; -} -#sidebar ul.topics li.parent ul, #sidebar ul.topics > li.active ul { - display: block; -} -#sidebar ul.topics > li > a { - line-height: 2rem; - font-size: 1.1rem; -} -#sidebar ul.topics > li > a b { - opacity: 0.5; - font-weight: normal; -} -#sidebar ul.topics > li > a .fa { - margin-top: 9px; -} -#sidebar ul.topics > li.parent, #sidebar ul.topics > li.active { - background: #251f29; - margin-left: -1rem; - margin-right: -1rem; - padding-left: 1rem; - padding-right: 1rem; -} -#sidebar ul li.active > a { - background: #fff; - color: #777 !important; - margin-left: -1rem; - margin-right: -1rem; - padding-left: 1rem; - padding-right: 1rem; -} -#sidebar ul li { - padding: 0; -} -#sidebar ul li.visited + span { - margin-right: 16px; -} -#sidebar ul li a { - display: block; - padding: 2px 0; -} -#sidebar ul li a span { - text-overflow: ellipsis; - overflow: hidden; - white-space: nowrap; - display: block; -} -#sidebar ul li > a { - padding: 4px 0; -} -#sidebar ul li.visited > a .read-icon { - color: #9c6fb6; - display: inline; -} -#sidebar ul li li { - padding-left: 1rem; - text-indent: 0.2rem; -} -#main { - background: #f7f7f7; - margin: 0 0 1.563rem 0; -} -#body { - position: relative; - margin-left: 300px; - min-height: 100%; -} -#body img, #body .video-container { - margin: 3rem auto; - display: block; - text-align: center; -} -#body img.border, #body .video-container.border { - border: 2px solid #e6e6e6 !important; - padding: 2px; -} -#body img.shadow, #body .video-container.shadow { - box-shadow: 0 10px 30px rgba(0, 0, 0, 0.1); -} -#body img.inline { - display: inline !important; - margin: 0 !important; - vertical-align: bottom; -} -#body .bordered { - border: 1px solid #ccc; -} -#body .padding { - padding: 3rem 6rem; -} -@media only all and (max-width: 59.938em) { - #body .padding { - position: static; - padding: 15px 3rem; - } -} -@media only all and (max-width: 47.938em) { - #body .padding { - padding: 5px 1rem; - } -} -#body h1 + hr { - margin-top: -1.7rem; - margin-bottom: 3rem; -} -@media only all and (max-width: 59.938em) { - #body #navigation { - position: static; - margin-right: 0 !important; - width: 100%; - display: table; - } -} -#body .nav { - position: fixed; - top: 0; - bottom: 0; - width: 4rem; - font-size: 50px; - height: 100%; - cursor: pointer; - display: table; - text-align: center; -} -#body .nav > i { - display: table-cell; - vertical-align: middle; - text-align: center; -} -@media only all and (max-width: 59.938em) { - #body .nav { - display: table-cell; - position: static; - top: auto; - width: 50%; - text-align: center; - height: 100px; - line-height: 100px; - padding-top: 0; - } - #body .nav > i { - display: inline-block; - } -} -#body .nav:hover { - background: #F6F6F6; -} -#body .nav.nav-pref { - left: 0; -} -#body .nav.nav-next { - right: 0; -} -#body-inner { - margin-bottom: 5rem; -} -#chapter { - display: flex; - align-items: center; - justify-content: center; - height: 100%; - padding: 2rem 0; -} -#chapter #body-inner { - padding-bottom: 3rem; - max-width: 80%; -} -#chapter h3 { - font-family: "Work Sans", "Helvetica", "Tahoma", "Geneva", "Arial", sans-serif; - font-weight: 300; - text-align: center; -} -#chapter h1 { - font-size: 5rem; - border-bottom: 4px solid #F0F2F4; -} -#chapter p { - text-align: center; - font-size: 1.2rem; -} -#footer { - padding: 3rem 1rem; - color: #b3b3b3; - font-size: 13px; -} -#footer p { - margin: 0; -} -body { - font-family: "Work Sans", "Helvetica", "Tahoma", "Geneva", "Arial", sans-serif; - font-weight: 300; - line-height: 1.6; - font-size: 18px !important; -} -h2, h3, h4, h5, h6 { - font-family: "Work Sans", "Helvetica", "Tahoma", "Geneva", "Arial", sans-serif; - text-rendering: optimizeLegibility; - color: #5e5e5e; - font-weight: 400; - letter-spacing: -1px; -} -h1 { - font-family: "Novacento Sans Wide", "Helvetica", "Tahoma", "Geneva", "Arial", sans-serif; - text-align: center; - text-transform: uppercase; - color: #222; - font-weight: 200; -} -blockquote { - border-left: 10px solid #F0F2F4; -} -blockquote p { - font-size: 1.1rem; - color: #999; -} -blockquote cite { - display: block; - text-align: right; - color: #666; - font-size: 1.2rem; -} -div.notices { - margin: 2rem 0; - position: relative; -} -div.notices p { - padding: 15px; - display: block; - font-size: 1rem; - margin-top: 0rem; - margin-bottom: 0rem; - color: #666; -} -div.notices p:first-child:before { - position: absolute; - top: 2px; - color: #fff; - font-family: "Font Awesome 5 Free"; - font-weight: 900; - content: "\f06a"; - left: 10px; -} -div.notices p:first-child:after { - position: absolute; - top: 2px; - color: #fff; - left: 2rem; -} -div.notices.info p { - border-top: 30px solid #F0B37E; - background: #FFF2DB; -} -div.notices.info p:first-child:after { - content: 'Info'; -} -div.notices.warning p { - border-top: 30px solid rgba(217, 83, 79, 0.8); - background: #FAE2E2; -} -div.notices.warning p:first-child:after { - content: 'Warning'; -} -div.notices.note p { - border-top: 30px solid #6AB0DE; - background: #E7F2FA; -} -div.notices.note p:first-child:after { - content: 'Note'; -} -div.notices.tip p { - border-top: 30px solid rgba(92, 184, 92, 0.8); - background: #E6F9E6; -} -div.notices.tip p:first-child:after { - content: 'Tip'; -} - -/* attachments shortcode */ - -section.attachments { - margin: 2rem 0; - position: relative; -} - -section.attachments label { - font-weight: 400; - padding-left: 0.5em; - padding-top: 0.2em; - padding-bottom: 0.2em; - margin: 0; -} - -section.attachments .attachments-files { - padding: 15px; - display: block; - font-size: 1rem; - margin-top: 0rem; - margin-bottom: 0rem; - color: #666; -} - -section.attachments.orange label { - color: #fff; - background: #F0B37E; -} - -section.attachments.orange .attachments-files { - background: #FFF2DB; -} - -section.attachments.green label { - color: #fff; - background: rgba(92, 184, 92, 0.8); -} - -section.attachments.green .attachments-files { - background: #E6F9E6; -} - -section.attachments.blue label { - color: #fff; - background: #6AB0DE; -} - -section.attachments.blue .attachments-files { - background: #E7F2FA; -} - -section.attachments.grey label { - color: #fff; - background: #505d65; -} - -section.attachments.grey .attachments-files { - background: #f4f4f4; -} - -/* Children shortcode */ - -/* Children shortcode */ -.children p { - font-size: small; - margin-top: 0px; - padding-top: 0px; - margin-bottom: 0px; - padding-bottom: 0px; -} -.children-li p { - font-size: small; - font-style: italic; - -} -.children-h2 p, .children-h3 p { - font-size: small; - margin-top: 0px; - padding-top: 0px; - margin-bottom: 0px; - padding-bottom: 0px; -} -.children h3,.children h2 { - margin-bottom: 0px; - margin-top: 5px; -} - -code, kbd, pre, samp { - font-family: "Consolas", menlo, monospace; - font-size: 92%; -} -code { - border-radius: 2px; - white-space: nowrap; - color: #5e5e5e; - background: #FFF7DD; - border: 1px solid #fbf0cb; - padding: 0px 2px; -} -code + .copy-to-clipboard { - margin-left: -1px; - border-left: 0 !important; - font-size: inherit !important; - vertical-align: middle; - height: 21px; - top: 0; -} -pre { - padding: 1rem; - margin: 2rem 0; - background: #282c34; - border: 0; - border-radius: 2px; - line-height: 1.15; -} -pre code { - color: whitesmoke; - background: inherit; - white-space: inherit; - border: 0; - padding: 0; - margin: 0; - font-size: 15px; -} -hr { - border-bottom: 4px solid #F0F2F4; -} -.page-title { - margin-top: -25px; - padding: 25px; - float: left; - clear: both; - background: #9c6fb6; - color: #fff; -} -#body a.anchor-link { - color: #ccc; -} -#body a.anchor-link:hover { - color: #9c6fb6; -} -#body-inner .tabs-wrapper.ui-theme-badges { - background: #1d1f21; -} -#body-inner .tabs-wrapper.ui-theme-badges .tabs-nav li { - font-size: 0.9rem; - text-transform: uppercase; -} -#body-inner .tabs-wrapper.ui-theme-badges .tabs-nav li a { - background: #35393c; -} -#body-inner .tabs-wrapper.ui-theme-badges .tabs-nav li.current a { - background: #4d5257; -} -#body-inner pre { - white-space: pre-wrap; -} -.tabs-wrapper pre { - margin: 1rem 0; - border: 0; - padding: 0; - background: inherit; -} -table { - border: 1px solid #eaeaea; - table-layout: auto; -} -th { - background: #f7f7f7; - padding: 0.5rem; -} -td { - padding: 0.5rem; - border: 1px solid #eaeaea; -} -.button { - background: #9c6fb6; - color: #fff; - box-shadow: 0 3px 0 #00a5d4; -} -.button:hover { - background: #00a5d4; - box-shadow: 0 3px 0 #008db6; - color: #fff; -} -.button:active { - box-shadow: 0 1px 0 #008db6; -} -.button-secondary { - background: #F8B450; - color: #fff; - box-shadow: 0 3px 0 #f7a733; -} -.button-secondary:hover { - background: #f7a733; - box-shadow: 0 3px 0 #f69b15; - color: #fff; -} -.button-secondary:active { - box-shadow: 0 1px 0 #f69b15; -} -.bullets { - margin: 1.7rem 0; - margin-left: -0.85rem; - margin-right: -0.85rem; - overflow: auto; -} -.bullet { - float: left; - padding: 0 0.85rem; -} -.two-column-bullet { - width: 50%; -} -@media only all and (max-width: 47.938em) { - .two-column-bullet { - width: 100%; - } -} -.three-column-bullet { - width: 33.33333%; -} -@media only all and (max-width: 47.938em) { - .three-column-bullet { - width: 100%; - } -} -.four-column-bullet { - width: 25%; -} -@media only all and (max-width: 47.938em) { - .four-column-bullet { - width: 100%; - } -} -.bullet-icon { - float: left; - background: #9c6fb6; - padding: 0.875rem; - width: 3.5rem; - height: 3.5rem; - border-radius: 50%; - color: #fff; - font-size: 1.75rem; - text-align: center; -} -.bullet-icon-1 { - background: #9c6fb6; -} -.bullet-icon-2 { - background: #00f3d8; -} -.bullet-icon-3 { - background: #e6f300; -} -.bullet-content { - margin-left: 4.55rem; -} -.tooltipped { - position: relative; -} -.tooltipped:after { - position: absolute; - z-index: 1000000; - display: none; - padding: 5px 8px; - font: normal normal 11px/1.5 "Work Sans", "Helvetica", "Tahoma", "Geneva", "Arial", sans-serif; - color: #fff; - text-align: center; - text-decoration: none; - text-shadow: none; - text-transform: none; - letter-spacing: normal; - word-wrap: break-word; - white-space: pre; - pointer-events: none; - content: attr(aria-label); - background: rgba(0, 0, 0, 0.8); - border-radius: 3px; - -webkit-font-smoothing: subpixel-antialiased; -} -.tooltipped:before { - position: absolute; - z-index: 1000001; - display: none; - width: 0; - height: 0; - color: rgba(0, 0, 0, 0.8); - pointer-events: none; - content: ""; - border: 5px solid transparent; -} -.tooltipped:hover:before, .tooltipped:hover:after, .tooltipped:active:before, .tooltipped:active:after, .tooltipped:focus:before, .tooltipped:focus:after { - display: inline-block; - text-decoration: none; -} -.tooltipped-s:after, .tooltipped-se:after, .tooltipped-sw:after { - top: 100%; - right: 50%; - margin-top: 5px; -} -.tooltipped-s:before, .tooltipped-se:before, .tooltipped-sw:before { - top: auto; - right: 50%; - bottom: -5px; - margin-right: -5px; - border-bottom-color: rgba(0, 0, 0, 0.8); -} -.tooltipped-se:after { - right: auto; - left: 50%; - margin-left: -15px; -} -.tooltipped-sw:after { - margin-right: -15px; -} -.tooltipped-n:after, .tooltipped-ne:after, .tooltipped-nw:after { - right: 50%; - bottom: 100%; - margin-bottom: 5px; -} -.tooltipped-n:before, .tooltipped-ne:before, .tooltipped-nw:before { - top: -5px; - right: 50%; - bottom: auto; - margin-right: -5px; - border-top-color: rgba(0, 0, 0, 0.8); -} -.tooltipped-ne:after { - right: auto; - left: 50%; - margin-left: -15px; -} -.tooltipped-nw:after { - margin-right: -15px; -} -.tooltipped-s:after, .tooltipped-n:after { - transform: translateX(50%); -} -.tooltipped-w:after { - right: 100%; - bottom: 50%; - margin-right: 5px; - transform: translateY(50%); -} -.tooltipped-w:before { - top: 50%; - bottom: 50%; - left: -5px; - margin-top: -5px; - border-left-color: rgba(0, 0, 0, 0.8); -} -.tooltipped-e:after { - bottom: 50%; - left: 100%; - margin-left: 5px; - transform: translateY(50%); -} -.tooltipped-e:before { - top: 50%; - right: -5px; - bottom: 50%; - margin-top: -5px; - border-right-color: rgba(0, 0, 0, 0.8); -} -.highlightable { - padding: 1rem 0 1rem; - overflow: auto; - position: relative; -} -.hljs::selection, .hljs span::selection { - background: #b7b7b7; -} -.lightbox-active #body { - overflow: visible; -} -.lightbox-active #body .padding { - overflow: visible; -} -#github-contrib i { - vertical-align: middle; -} -.featherlight img { - margin: 0 !important; -} -.lifecycle #body-inner ul { - list-style: none; - margin: 0; - padding: 2rem 0 0; - position: relative; -} -.lifecycle #body-inner ol { - margin: 1rem 0 1rem 0; - padding: 2rem; - position: relative; -} -.lifecycle #body-inner ol li { - margin-left: 1rem; -} -.lifecycle #body-inner ol strong, .lifecycle #body-inner ol label, .lifecycle #body-inner ol th { - text-decoration: underline; -} -.lifecycle #body-inner ol ol { - margin-left: -1rem; -} -.lifecycle #body-inner h3[class*='level'] { - font-size: 20px; - position: absolute; - margin: 0; - padding: 4px 10px; - right: 0; - z-index: 1000; - color: #fff; - background: #1ABC9C; -} -.lifecycle #body-inner ol h3 { - margin-top: 1rem !important; - right: 2rem !important; -} -.lifecycle #body-inner .level-1 + ol { - background: #f6fefc; - border: 4px solid #1ABC9C; - color: #16A085; -} -.lifecycle #body-inner .level-1 + ol h3 { - background: #2ECC71; -} -.lifecycle #body-inner .level-2 + ol { - background: #f7fdf9; - border: 4px solid #2ECC71; - color: #27AE60; -} -.lifecycle #body-inner .level-2 + ol h3 { - background: #3498DB; -} -.lifecycle #body-inner .level-3 + ol { - background: #f3f9fd; - border: 4px solid #3498DB; - color: #2980B9; -} -.lifecycle #body-inner .level-3 + ol h3 { - background: #34495E; -} -.lifecycle #body-inner .level-4 + ol { - background: #e4eaf0; - border: 4px solid #34495E; - color: #2C3E50; -} -.lifecycle #body-inner .level-4 + ol h3 { - background: #34495E; -} -#top-bar { - background: #F6F6F6; - border-radius: 2px; - padding: 0 1rem; - height: 0; - min-height: 3rem; -} -#top-github-link { - position: relative; - z-index: 1; - float: right; - display: block; -} -#body #breadcrumbs { - height: auto; - margin-bottom: 0; - padding-left: 0; - line-height: 1.4; - overflow: hidden; - white-space: nowrap; - text-overflow: ellipsis; - width: 70%; - display: inline-block; - float: left; -} -#body #breadcrumbs span { - padding: 0 0.1rem; -} -@media only all and (max-width: 59.938em) { - #sidebar { - width: 230px; - } - #body { - margin-left: 230px; - } -} -@media only all and (max-width: 47.938em) { - #sidebar { - width: 230px; - left: -230px; - } - #body { - margin-left: 0; - width: 100%; - } - .sidebar-hidden { - overflow: hidden; - } - .sidebar-hidden #sidebar { - left: 0; - } - .sidebar-hidden #body { - margin-left: 230px; - overflow: hidden; - } - .sidebar-hidden #overlay { - position: absolute; - left: 0; - right: 0; - top: 0; - bottom: 0; - z-index: 10; - background: rgba(255, 255, 255, 0.5); - cursor: pointer; - } -} -.copy-to-clipboard { - background-image: url(../images/clippy.svg); - background-position: 50% 50%; - background-size: 16px 16px; - background-repeat: no-repeat; - width: 27px; - height: 1.45rem; - top: -1px; - display: inline-block; - vertical-align: middle; - position: relative; - color: #5e5e5e; - background-color: #FFF7DD; - margin-left: -.2rem; - cursor: pointer; - border-radius: 0 2px 2px 0; - margin-bottom: 1px; -} -.copy-to-clipboard:hover { - background-color: #E8E2CD; -} -pre .copy-to-clipboard { - position: absolute; - right: 4px; - top: 4px; - background-color: #C1C4C6; - color: #ccc; - border-radius: 2px; -} -pre .copy-to-clipboard:hover { - background-color: #00bdf3; - color: #fff; -} -.parent-element { - -webkit-transform-style: preserve-3d; - -moz-transform-style: preserve-3d; - transform-style: preserve-3d; -} - -#sidebar ul.topics > li > a .read-icon { - margin-top: 9px; -} - -#sidebar ul { - list-style: none; - padding: 0; - margin: 0; -} - -#sidebar #shortcuts li { - padding: 2px 0; - list-style: none; -} - -#sidebar ul li .read-icon { - display: none; - float: right; - font-size: 13px; - min-width: 16px; - margin: 4px 0 0 0; - text-align: right; -} -#sidebar ul li.visited > a .read-icon { - color: #00bdf3; - display: inline; -} - -#sidebar #shortcuts h3 { - font-family: "Novacento Sans Wide", "Helvetica", "Tahoma", "Geneva", "Arial", sans-serif; - color: white ; - margin-top:1rem; - padding-left: 1rem; -} - -#homelinks { - background-color: #9c6fb6; - color: #fff; - padding: 7px 0; - border-bottom: 4px solid #9c6fb6; -} - -#searchResults { - text-align: left; -} - -option { - color: initial; -} diff --git a/doc/public/en/index.html b/doc/public/en/index.html deleted file mode 100644 index 5009a9a..0000000 --- a/doc/public/en/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - LibreOffice -
- - - - - - -fonts
-Devolver todas las fuentes visibles en LibreOffice. Mire FontDescriptor
-fonts = app.fonts()
-for f in fonts:
- app.debug(f'Nombre: {f.Name} - Estilo: {f.StyleName}')
-filters
-Devolver todos los filtros soportados en LibreOffice. Mire la ayuda y en API FilterFactory para más detalles.
-filtros = app.filters()
-for f in filtros:
- info = f"Nombre UI: {f['UIName']} - Nombre: {f['Name']} - Tipo: {f['Type']}"
- app.debug(info)
-dispatch
-Ejecutar cualquier comando UNO de LibreOffice, mire la lista de comandos y API dispatch.
Este método automáticamente agrega el prefijo necesario: .uno:
doc = app.active
-comando = 'Gallery'
-app.dispatch(doc, comando)
-Use este método solamente si no hay un método equivalente en easymacro o directamente en el API de LibreOffice.
clipboard
-Envíar contenido al portapapeles.
-app.clipboard.set('Los 7 samuráis')
-Recuperar contenido del portapapeles.
-content = app.clipboard.get()
-app.debug(content)
-disable
-Deshabilitar un comando. Para una lista de comandos mire DispatchCommands.
-comando = 'OpenFromCalc'
-resultado = app.cmd.disable(comando)
-app.debug(resultado)
-OpenFromCalc es la opción para abrir documentos en Calc, deshabilita o habilita la entrada del menú y el icono en la barra de herramientas.
enabled
-Habilitar un comando.
-comando = 'OpenFromCalc'
-resultado = app.cmd.enabled(comando)
-app.debug(resultado)
-get_config
-Obtener valores de la configuración de LibreOffice.
-nombre_node = '/org.openoffice.Office.Common/Help'
-clave = 'System'
-valor = app.get_config(nombre_node, clave)
-app.debug(valor)
-
-nombre_node = '/org.openoffice.Office.Common/Misc/'
-clave = 'FirstRun'
-valor = app.get_config(nombre_node, clave)
-app.debug(valor)
-
-clave = 'UseSystemFileDialog'
-valor = app.get_config(nombre_node, clave)
-app.debug(valor)
-17/08/2022 14:14:12 - DEBUG - UNIX
-17/08/2022 14:14:12 - DEBUG - False
-17/08/2022 14:14:12 - DEBUG - True
-set_config
-Establece un nuevo valor en la configuración de LibreOffice.
-nombre_nodo = '/org.openoffice.Office.UI/ColorScheme'
-clave = 'CurrentColorScheme'
-nuevo_valor = 'LibreOffice Dark'
-resultado = app.set_config(nombre_nodo, clave, nuevo_valor)
-app.debug(resultado)
-Algunos nodos y claves interesantes:
--
-
/org.openoffice.Office.Common/Save/Document--
-
- AutoSave -
- AutoSaveTimeIntervall -
-
No todos los valores de los nodos se pueden cambiar, algunos valores son de solo lectura.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/application/index.xml b/doc/public/es/application/index.xml
deleted file mode 100644
index d53a722..0000000
--- a/doc/public/es/application/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - 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
deleted file mode 100644
index 8d8a701..0000000
--- a/doc/public/es/application/menus/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - 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
deleted file mode 100644
index ced05fd..0000000
--- a/doc/public/es/application/shortcuts/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Celdas y rangos -
- - - - - - -Trabajar con celdas y rangos
-selection
-Referencia por selección actual.
-seleccion = app.selection
-app.debug(seleccion)
-20/08/2022 15:32:36 - DEBUG - Cell: $Sheet1.$A$2
-20/08/2022 15:32:39 - DEBUG - Range: $Sheet1.$C$8:$D$11
-address
-Referencia por dirección.
-hoja = app.active_sheet
-celda = hoja['A1']
-rango = hoja['C10:D15']
-
-app.debug(celda)
-app.debug(rango)
-position
-Referencia por posición.
-Para celdas: HOJA[fila,columna]
Para rangos: HOJA[fila_inicial:fila_final, columna_inicial:columna_final]
hoja = app.active_sheet
-
-# ~ Cell A10
-celda = hoja[9,0]
-
-# ~ Range A1:C10
-rango = hoja[0:10,0:3]
-iter
-Iterar cada celda de un rango.
-hoja = app.active_sheet
-rango = hoja['B10:C15']
-
-for celda in rango:
- app.debug(celda)
-contains
-Verificar si un rango esta dentro de otro.
-hoja = app.active_sheet
-
-celda = hoja['C5']
-rango = hoja['A1:E10']
-
-resultado = celda in rango
-app.debug(resultado)
-
-celda = hoja['C50']
-resultado = celda in rango
-app.debug(resultado)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/cells/index.xml b/doc/public/es/calc/cells/index.xml
deleted file mode 100644
index 6d83b43..0000000
--- a/doc/public/es/calc/cells/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Métodos -
- - - - - - -clear
-Limpia el rango. Por default solo borra datos. Mire API CellFlags para más información.
-rango.clear()
-Para borrar todo.
-rango.clear(app.ALL)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/cells/methods/index.xml b/doc/public/es/calc/cells/methods/index.xml
deleted file mode 100644
index d64a5ac..0000000
--- a/doc/public/es/calc/cells/methods/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Propiedades -
- - - - - - -is_cell
-Verdadero (True) si el rango es de una sola celda.
-hoja = app.active_sheet
-
-celda = hoja['A1']
-app.debug(celda.is_cell)
-
-rango = hoja['A1:C5']
-app.debug(rango.is_cell)
-name
-Devuelve la dirección de la celda o rango como texto.
-hoja = app.active_sheet
-
-celda = hoja['A1']
-app.debug(celda.name)
-
-rango = hoja['A1:C5']
-app.debug(rango.name)
-address
-Devuelve la dirección de la celda como una estructura: com.sun.star.table.CellAddress
hoja = app.active_sheet
-
-celda = hoja['A1']
-if celda.is_cell:
- app.debug(celda.address)
-range_address
-Devuelve la dirección del rango como una estructura: com.sun.star.table.CellRangeAddress
hoja = app.active_sheet
-
-rango = hoja['A1:C5']
-if not rango.is_cell:
- app.debug(rango.range_address)
-filas y columnas
-Devolver el tamaño del rango en filas y columnas.
-hoja = app.active_sheet
-
-rango = hoja['A1:E100']
-filas = len(rango)
-columnas = rango.len_columns
-app.debug(filas, columnas)
-sheet
-Devuelve la hoja padre.
-rango = hoja['A1:C5']
-
-hoja = rango.sheet
-app.debug(hoja)
-doc
-Devuelve el documento padre.
-rango = hoja['A1:C5']
-
-doc = rango.doc
-app.debug(doc)
-style
-Devuelve o aplica el estilo de celda.
-rango = hoja['A1:C5']
-rango.style = 'Good'
-current_region
-Devuelve la región actual.
-celda = hoja['A1']
-rango = celda.current_region
-app.debug(rango)
-range_data
-Devuelve la región actual del rango excepto la primer fila.
-celda = hoja['A1']
-rango = celda.range_data
-app.debug(rango)
-back_color
-Devuelve o aplica el color de fondo del rango.
-rango = hoja['A1:E10']
-rango.back_color = 'red'
-type
-Devuelve el tipo de contenido de la celda: texto, número o formula.
-celda = hoja['A1']
-app.debug(celda.type)
-error
-Si la celda tiene una formula con error, devuelve el número de error.
-celda = hoja['A1']
-app.debug(celda.error)
-string
-Devuelve o establece el contenido de la celda como texto.
-celda = hoja['A1']
-celda.string = 'Maldito Mundo'
-app.debug(celda.type, celda.string)
-
-celda = hoja['A2']
-celda.string = 12345
-app.debug(celda.type, celda.string)
-float
-Devuelve o establece el contenido de la celda como valor.
-celda = hoja['A1']
-celda.float = 12345
-app.debug(celda.type, celda.float)
-formula
-Devuelve o establece la formula de la celda.
-celda = hoja['A1']
-celda.formula = '=RAND()'
-app.debug(celda.type, celda.formula)
-date
-Devuelve o establece el contenido de la celda como fecha.
-celda = hoja['A1']
-celda.date = app.dates.date(1974, 1, 15)
-app.debug(type(celda.date), celda.date)
-20/08/2022 18:38:53 - DEBUG - <class 'datetime.date'> 1974-01-15
-time
-Devuelve o establece el contenido de la celda como tiempo.
-celda = hoja['A1']
-celda.time = app.dates.time(10, 11, 12)
-app.debug(type(celda.time), celda.time)
-datetime
-Devuelve o establece el contenido de la celda como fecha y tiempo.
-celda = hoja['A1']
-celda.datetime = app.dates.datetime(1974, 1, 15, 10, 11, 12)
-app.debug(type(celda.datetime), celda.datetime)
-value
-Devuelve o establece el valor de la celda, estableciendo el tipo de dato automáticamente.
-hoja = app.active_sheet
-
-celda = hoja['A1']
-celda.value = 'Soy Texto'
-app.debug(celda.type, celda.value)
-
-celda = hoja['A2']
-celda.value = 12345
-app.debug(celda.type, celda.value)
-
-celda = hoja['A3']
-celda.value = '=RAND()'
-app.debug(celda.type, celda.value)
-
-celda = hoja['A4']
-celda.value = app.dates.date(1974, 1, 15)
-app.debug(celda.type, celda.value)
-data_array
-Devuelve o establece los datos de un rango. Es un alias de DataArray.
-rango = app.selection
-datos = rango.data_array
-app.debug(datos)
-rango.data_array = datos
-El tamaño de los datos, debe ser exactamente del tamaño del rango destino. De lo contrario obtendrá un error.
-formula_array
-Devuelve o establece los datos de un rango. Es un alias de FormulaArray.
-rango = app.selection
-
-datos = rango.data_array
-app.debug(datos)
-datos = rango.formula_array
-app.debug(datos)
-rango.formula_array = datos
-data_array devolverá los resultados de las celdas con formulas. formula_array devolverá las formulas en dichas celdas.
-data
-Alias de data_array al obtener los datos. Al establecer los datos, si es un rango se comporta como data_array, pero si es una celda, se autoajusta al tamaño de los datos.
hoja = app.active_sheet
-celda = hoja['A1']
-datos = (
- (1, 'Uno'),
- (2, 'Dos'),
- (3, 'Tres'),
-)
-
-celda.data = datos
-app.debug(celda.current_region.data)
-Siempre valide que haya suficientes celdas libres para los datos para evitar sobreescribirlos.
-dict
-Devuelve o establece los datos como diccionarios.
-hoja = app.active_sheet
-celda = hoja['A1']
-
-datos = (
- {'No': 1, 'Nombre': 'Ingrid'},
- {'No': 2, 'Nombre': 'Sophia'},
- {'No': 3, 'Nombre': 'Scarlette'},
-)
-
-celda.dict = datos
-app.debug(celda.current_region.dict)
-next_free
-Devuelve la siguiente celda libre después de la región actual.
-hoja = app.active_sheet
-celda = hoja['A1']
-
-celda_libre = celda.next_free
-app.debug(celda_libre)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/cells/properties/index.xml b/doc/public/es/calc/cells/properties/index.xml
deleted file mode 100644
index 1f89d74..0000000
--- a/doc/public/es/calc/cells/properties/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Calc -
- - - - - - -Trabajar con Calc
-active
-doc = app.active
-app.debug(doc.type)
-Propiedades
-headers
-Mostrar u ocultar encabezados de filas y columnas.
-doc = app.active
-app.msgbox(doc.headers)
-doc.headers = not doc.headers
-app.msgbox(doc.headers)
-doc.headers = not doc.headers
-tabs
-Mostrar u ocultar las pestañas de las hojas.
-doc = app.active
-app.msgbox(doc.tabs)
-doc.tabs = not doc.tabs
-app.msgbox(doc.tabs)
-doc.tabs = not doc.tabs
-selection
-Devolver la selección activa.
-doc = app.active
-seleccion = doc.selection
-app.debug(seleccion)
-Cuidado, la selección actual pueden ser muchas cosas diferentes.
-names
-Devolver una tupla con los nombres de todas las hojas.
-doc = app.active
-nombres = doc.names
-app.debug(nombres)
-active
-Devuelve la hoja activa.
-doc = app.active
-hoja = doc.active
-app.debug(hoja)
-Métodos
-activate
-Activar hoja, argumento como objeto.
-doc = app.active
-hoja = doc[-1]
-doc.activate(hoja)
-Activar hoja por nombre.
-doc = app.active
-doc.activate('Hoja3')
-select
-Seleccionar una celda o rango.
-doc = app.active
-cell = doc[0]['A1']
-doc.select(cell)
-NO es necesario seleccionar celdas o rangos para manipularlos.
-start_range_selection
-Permitir al usuario seleccionar un rango. Es necesario pasarle una clase con el nombre que prefiera (Eventos es recomendable) con dos métodos para procesar la captura como en el siguiente ejemplo:
class Eventos():
-
- def __init__(self, doc):
- self.doc = doc
-
- def range_selection_done(self, range_selection):
- if range_selection:
- app.debug(range_selection)
- self.doc.remove_range_selection_listener()
- return
-
- def range_selection_aborted(self):
- self.doc.remove_range_selection_listener()
- return
-
-
-def main():
- doc = app.active
- doc.start_range_selection(Eventos)
- return
-insert
-Inserta una nueva hoja.
-doc = app.active
-hoja = doc.insert('OtraHoja')
-Insertar varias hojas. Devolverá la última insertada.
-nombres = ('Enero', 'Febrero', 'Marzo')
-hoja = doc.insert(nombres)
-app.debug(hoja)
-Creando una nueva instancia y asignandola.
- doc = app.active
- doc['NuevaHoja'] = doc.new_sheet()
-Si la hoja existe, obtendrá un error, verifique siempre que no exista primero.
-move
-Mover hojas.
-Pasar la hoja como objeto, de forma predetermianda se mueve a la última posición.
-doc = app.active
-hoja = doc[0]
-doc.move(hoja)
-Pasar la hoja por nombre.
-doc = app.active
-doc.move('Hoja1')
-Especificar la posición destino.
-doc = app.active
-hoja = doc[0]
-doc.move(hoja, 2)
-remove
-Eliminar hoja.
-doc = app.active
-sheet = doc[0]
-
-doc.remove(sheet)
-Eliminar por nombre.
-doc.remove('Hoja2')
-copy
-Copiar hoja dentro del mismo documento.
-doc = app.active
-hoja = doc[0]
-
-doc.copy_sheet(hoja, 'Otra hoja')
-Por nombre.
-doc.copy_sheet('Hoja1', 'Hoja2')
-Si no se establece el nuevo nombre, se generá de forma automática: nombre + índice.
doc.copy_sheet(hoja)
-copy_from
-Copiar hojas de otro documento. Copiar con el mismo nombre.
-doc = app.active
-documento_origen = app.docs['Contactos.ods']
-nombre_origen = 'Nombres'
-
-doc.copy_from(documento_origen, nombre_origen)
-Copiar con un nuevo nombre.
-doc.copy_from(documento_origen, nombre_origen, 'NuevoNombre')
-Si solo se establece el documento origen, se copian todas las hojas.
-doc.copy_from(documento_origen)
-sort
-Ordenar hojas en orden alfabetico.
-doc = app.active
-doc.sort()
-Ordenar de forma inversa.
-doc = app.active
-doc.sort(True)
-Eventos del documento.
-Obtener una tupla con los eventos soportados por el documento.
-doc = app.active
-nombres = doc.events.names
-app.debug(nombres)
-Asignar una macro a un evento.
-def doc_on_focus(event):
- app.debug('Documento activado...')
- return
-
-
-def main():
- doc = app.active
- events = doc.events
- if 'OnFocus' in events:
- macro = {'library': 'test', 'name': 'doc_on_focus'}
- events['OnFocus'] = macro
- return
-Eliminar la asignación del evento.
-doc = app.active
-doc.events['OnFocus'] = {}
-O
-doc = app.active
-doc.events.remove('OnFocus')
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/index.xml b/doc/public/es/calc/index.xml
deleted file mode 100644
index a00c072..0000000
--- a/doc/public/es/calc/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Conjuntos de Rangos -
- - - - - - -Trabajar con conjuntos de rangos
-Selección
-Obtener una referencia desde la selección actual. Deben de estar seleccionados más de un rango de celdas.
-doc = app.active
-seleccion = doc.selection
-app.debug(seleccion)
-20/08/2022 13:21:17 - DEBUG - Ranges: ('Sheet1.A5:C8', 'Sheet1.E11:F14')
-len
-Contar los rangos.
-doc = app.active
-contar = len(doc.selection)
-app.debug(contar)
-iter
-Iterar entre los rangos.
-doc = app.active
-for rango in doc.selection:
- app.debug(rango)
-20/08/2022 13:27:03 - DEBUG - Range: $Sheet1.$B$4:$D$7
-20/08/2022 13:27:03 - DEBUG - Range: $Sheet1.$G$10:$H$14
-index
-Referencia a un rango por índice.
-doc = app.active
-rangos = doc.selection
-
-rango = rangos[1]
-app.debug(rango)
-address
-Referencia a un rango por su dirección.
-rango = rangos['Hoja1.A1:B5']
-app.debug(rango)
-contain
-Verificar si un rango esta en la colección.
-doc = app.active
-hoja = doc.active
-rangos = doc.selection
-
-resultado = hoja['D5:F10'] in rangos
-app.debug(resultado)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/ranges/index.xml b/doc/public/es/calc/ranges/index.xml
deleted file mode 100644
index a2974e5..0000000
--- a/doc/public/es/calc/ranges/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Métodos -
- - - - - - -ranges
-Crear un nuevo contender de rangos vacío.
-doc = app.active
-rangos = doc.ranges()
-app.debug(rangos)
-add
-doc = app.active
-hoja = doc.active
-
-rangos = doc.ranges()
-rangos.add(hoja['A1:B2'])
-rangos.add(hoja['D5:F10'])
-app.debug(rangos)
-remove
-rangos.remove(hoja['A1:B2'])
-get_ranges
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/ranges/methods/index.xml b/doc/public/es/calc/ranges/methods/index.xml
deleted file mode 100644
index 110df53..0000000
--- a/doc/public/es/calc/ranges/methods/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Propiedades -
- - - - - - -names
-Devolver las direcciones de los rangos.
-doc = app.active
-rangos = doc.selection
-
-nombres = rangos.names
-app.debug(nombres)
-data
-Devolver y establecer datos.
-doc = app.active
-rangos = doc.selection
-
-datos = rangos.data
-app.debug(datos)
-rangos.data = datos
-Cada rango debe tener exactamente el mismo tamaño.
-style
-Establecer el estilo de todos los rangos.
-doc = app.active
-rangos = doc.selection
-rangos.style = 'Good'
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/ranges/properties/index.xml b/doc/public/es/calc/ranges/properties/index.xml
deleted file mode 100644
index e30f32e..0000000
--- a/doc/public/es/calc/ranges/properties/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Eventos -
- - - - - - -Eventos de la hoja.
-Obtener una tupla con los eventos soportados por la hoja.
-hoja = app.active.active
-nombres = hoja.events.names
-app.debug(nombres)
-Asignar una macro a un evento.
-def on_select(source):
- app.debug(source.AbsoluteName)
- return
-
-
-def main():
- doc = app.active
- hoja = doc.active
-
- if 'OnSelect' in hoja.events:
- macro = {'library': 'test', 'name': 'on_select'}
- hoja.events['OnSelect'] = macro
-
- return
-Eliminar la asignación del evento.
-hoja.events['OnSelect'] = {}
-O
-hoja.events.remove('OnFocus')
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/sheets/events/index.xml b/doc/public/es/calc/sheets/events/index.xml
deleted file mode 100644
index c0fb17b..0000000
--- a/doc/public/es/calc/sheets/events/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Hojas -
- - - - - - -Trabajar con hojas
-Referencia por índice
-doc = app.active
-hoja = doc[0]
-app.debug(hoja.name)
-Referencia por nombre
-doc = app.active
-hoja = doc['datos']
-app.debug(hoja.name)
-in
-Verificar por nombre si una hoja existe.
-doc = app.active
-existe = 'Hoja2' in doc
-app.debug(existe)
-len
-Contar la cantidad de hojas en el documento.
-doc = app.active
-contar = len(doc)
-app.debug(contar)
-iter
-Recorrer todas las hojas.
- doc = app.active
- for hoja in doc:
- app.debug(hoja)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/sheets/index.xml b/doc/public/es/calc/sheets/index.xml
deleted file mode 100644
index adbdf5b..0000000
--- a/doc/public/es/calc/sheets/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Métodos -
- - - - - - -unprotect
-Quitar contraseña.
-hoja = app.active.active
-
-hoja.password = 'siscaloburropanzon'
-app.msgbox(hoja.is_protected)
-
-hoja.unprotect('siscaloburropanzon')
-app.msgbox(hoja.is_protected)
-activate
-Pasar el foco a la hoja.
-doc = app.active
-hoja = doc[-1]
-hoja.activate()
-move
-Mover a la última posición.
-doc = app.active
-hoja = doc[0]
-hoja.move()
-Mover a una posición especifica.
-doc = app.active
-hoja = doc[0]
-hoja.move(3)
-remove
-Remover hoja.
-sheet = app.active.active
-sheet.remove()
-Siempre debe existir al menos una hoja.
-copy
- -Siempre valida que no exista el nuevo nombre.
-doc = app.active
-hoja = doc[0]
-
-nuevo_nombre = f'{hoja.name}_2'
-if not nuevo_nombre in doc:
- hoja.copy(nuevo_nombre)
-Si no se establece el nuevo nombre, se generá de forma automática: nombre + índice.
hoja.copy()
-copy_to
-Copiar la hoja a otro documento. Se usa el mismo nombre.
-doc = app.active
-hoja = doc.active
-
-documento_nuevo = app.docs.new()
-hoja.copy_to(documento_nuevo)
-Usar un nuevo nombre.
-hoja.copy_to(documento_nuevo, 'Nuevo nombre')
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/sheets/methods/index.xml b/doc/public/es/calc/sheets/methods/index.xml
deleted file mode 100644
index 71bcaed..0000000
--- a/doc/public/es/calc/sheets/methods/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Propiedades -
- - - - - - -doc
-Devuelve al documento Calc donde esta la hoja.
-doc = app.active
-hoja = doc.active
-
-doc = hoja.doc
-app.debug(doc.title)
-name
-Nombre visible y editable por el usuario.
-doc = app.active
-hoja = doc.active
-
-app.msgbox(hoja.name)
-hoja.name = 'Nuevo Nombre'
-app.msgbox(hoja.name)
-code_name
-Nombre editable y accesible solo por código.
-doc = app.active
-hoja = doc.active
-
-app.msgbox(hoja.code_name)
-hoja.code_name = 'datos'
-app.msgbox(hoja.code_name)
-visible
-Muestra u oculta la hoja
-hoja = app.active.active
-
-app.msgbox(hoja.visible)
-hoja.visible = not hoja.visible
-app.msgbox(hoja.visible)
-hoja.visible = not hoja.visible
-Solo funcionará con dos o más hojas, por que debe haber al menos una visible.
-color
-Color de la pestaña.
-hoja = app.active.active
-app.msgbox(hoja.color)
-
-hoja.color = 'red'
-app.msgbox(hoja.color)
-
-# RGB
-hoja.color = (125, 200, 10)
-app.msgbox(hoja.color)
-used_area
-Referencia al área de usuario actual.
-hoja = app.active.active
-
-rango = hoja.used_area
-app.debug(rango)
-is_protected
-Devuelve verdadero (True) si la hoja esta protegida
-hoja = app.active.active
-
-esta_protegida = hoja.is_protected
-app.debug(esta_protegida)
-password
-Establecer una contraseña.
-hoja = app.active.active
-hoja.password = 'siscaloburropanzon'
-app.debug(hoja.is_protected)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/calc/sheets/properties/index.xml b/doc/public/es/calc/sheets/properties/index.xml
deleted file mode 100644
index 1af3c81..0000000
--- a/doc/public/es/calc/sheets/properties/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - category :: - - Categories -
- - - - - - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/categories/index.xml b/doc/public/es/categories/index.xml
deleted file mode 100644
index 7c5fcbe..0000000
--- a/doc/public/es/categories/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Cuadros de diálogo -
- - - - - - -Trabajar con cuadros de diálogo
-create
-Desde archivo
-Crear un cuadro de diálogo desde un archivo xdl previamente creado desde el editor de cuadros de diálogo dentro de LibreOffice y exportado a un archivo.
def crear_cuadro_de_dialogo():
- path = '/home/mau/Desktop/Dialog1.xdl'
- propiedades = {'Path': path}
-
- dialog = app.dialog.create(propiedades)
- dialog.open()
- return
-Desde mis macros
-Si el cuadro de diálogo esta en la librería Standard.
def crear_cuadro_de_dialogo():
- propiedades = {
- 'Location': 'user',
- 'Name': 'Dialog1',
- }
- dialog = app.dialog.create(propiedades)
- dialog.open()
- return
-Si el cuadro de diálogo esta en otra librería.
-def crear_cuadro_de_dialogo():
- propiedades = {
- 'Location': 'user',
- 'Library': 'MiAplicacion',
- 'Name': 'Dialog2',
- }
- dialog = app.dialog.create(propiedades)
- dialog.open()
- return
-Si el cuadro de diálogo esta en el documento activo en la librería Standard.
def crear_cuadro_de_dialogo():
- propiedades = {
- 'Location': 'document',
- 'Name': 'miApp',
- }
- dialog = app.dialog.create(propiedades)
- dialog.open()
- return
-Crear dinámicamente
-Crear un cuadro de diálogo vacío.
-def crear_cuadro_de_dialogo():
- dialog = app.dialog.create()
- dialog.open()
- return
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/dialog/index.xml b/doc/public/es/dialog/index.xml
deleted file mode 100644
index 27ff43b..0000000
--- a/doc/public/es/dialog/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Documentos -
- - - - - - -Trabajar con Documentos
-active
-Documento activo.
-doc = app.active
-app.msgbox(doc.title)
-iteration
-Iterar en todos los documentos abiertos.
-for doc in app.docs:
- app.debug(doc.type, doc.title)
-count
-Contar los documentos abiertos.
-cuantos = len(app.docs)
-app.debug(cuantos)
-contain
-Verificar si un documento esta en la colección.
-resultado = 'mi_archivo.ods' in app.docs
-app.debug(resultado)
-index
-Devolver por índice.
-doc = app.docs[1]
-app.debug(doc.type, doc.title)
-name
-Devolver por nombre.
-nombre = 'mi_archivo.ods'
-if nombre in app.docs:
- doc = app.docs[nombre]
- app.debug(doc.type, doc.title)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/documents/index.xml b/doc/public/es/documents/index.xml
deleted file mode 100644
index 7bba374..0000000
--- a/doc/public/es/documents/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Métodos -
- - - - - - -new
-Crear nuevo documento, la aplicación predeterminada es Calc.
-doc = app.docs.new()
-app.debug(doc.type)
-Para un nuevo documento writer.
doc = app.docs.new('writer')
-app.debug(doc.type)
-Otros documentos.
-doc = app.docs.new('draw')
-app.debug(doc.type)
-
-doc = app.docs.new('impress')
-app.debug(doc.type)
-
-doc = app.docs.new('math')
-app.debug(doc.type)
-Crear con argumentos.
-propiedades = {'Hidden': True}
-doc = app.docs.new('writer', propiedades)
-mensaje = f'{doc.type} - {doc.title}'
-app.msgbox(mensaje)
-doc.visible = True
-No es necesario que el documento este visible para manipularse.
-open
-Abrir archivos.
-ruta = '/home/mau/Mi_archivo.ods'
-doc = app.docs.open(ruta)
-No es necesario pasar las rutas en formato URL.
-Puede abrir cualquier archivo que sea soportado por LibreOffice.
-ruta = '/home/mau/ejemplo.xlsx'
-doc = app.docs.open(ruta)
-Abrir con argumentos.
-ruta = '/home/mau/ejemplo.ods'
-argumentos = {'Password': 'siscaloburropanzon'}
-doc = app.docs.open(ruta, argumentos)
-save
-Guardar un nuevo documento.
-path = '/home/mau/nuevo_documento.ods'
-doc = app.docs.new()
-doc.save(path)
-Cualquier archivo, previamente guardado, que sea modificado puede ser guardado con:
-doc.save()
-Abrir un archivo existente y guardarlo con otro nombre.
-ruta = '/home/mau/ejemplo.ods'
-doc = app.docs.open(ruta)
-nueva_ruta = '/home/mau/otro_nombre.ods'
-doc.save(nueva_ruta)
-close
-Cerrar un archivo.
-doc = app.docs.new()
-app.msgbox(doc.title)
-doc.close()
-to_pdf
-Exportar a PDF.
-doc = app.active
-ruta = '/home/mau/ejemplo.pdf'
-doc.to_pdf(ruta)
-Si no se establece una ruta, se devuelve el PDF en memoria.
-doc = app.active
-pdf = doc.to_pdf()
-app.debug(pdf)
-Mire las opciones del filtro de exportación a PDF, puede pasarlas como un diccionario como segundo argumento de este método.
-export
-Exportar a otros formatos.
-doc = app.docs.new()
-ruta = '/home/mau/miarchivo.xlsx'
-filtro = 'xlsx'
-doc.export(ruta, filtro)
-
-ruta = '/home/mau/miarchivo.xls'
-filtro = 'xls'
-doc.export(ruta, filtro)
-
-doc = app.docs.new('writer')
-ruta = '/home/mau/miarchivo.docx'
-filtro = 'docx'
-doc.export(ruta, filtro)
-
-ruta = '/home/mau/miarchivo.doc'
-filtro = 'doc'
-doc.export(ruta, filtro)
-
-ruta = '/home/mau/miarchivo.rtf'
-filtro = 'rtf'
-doc.export(ruta, filtro)
-Exportar en memoria.
-doc = app.docs.new()
-filtro = 'xlsx'
-excel_doc = doc.export(filter_name=filtro)
-set_focus
-Enviar el foco al documento.
-for doc in app.docs:
- app.debug(doc.title)
- doc.set_focus()
- app.sleep(1)
-copy
-Copiar la selección activa al portapapeles.
-doc = app.active
-doc.copy()
-paste
-Copiar el contenido del portapapeles, en la selección actual.
-doc = app.active
-doc.paste()
-paste_special
-Mostrar el cuadro de diálogo Pegado Especial.
Solo se mostrará si existe contenido en el portapapeles.
-doc = app.active
-doc.paste_special()
-paste_values
-Pegar solo los valores.
-doc = app.active
-doc.paste_values()
-Si el destino no esta vacío, el usuario verá el cuadro de mensaje de confirmación.
-clear_undo
-La mayoría de las acciones realizadas por código, quedan en el historial de acciones, por lo que el usuario puede deshacerlas. Para eviar esto se puede limpiar este historial.
-doc = app.active
-doc.clear_undo()
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/documents/methods/index.xml b/doc/public/es/documents/methods/index.xml
deleted file mode 100644
index ebdfb1a..0000000
--- a/doc/public/es/documents/methods/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Propiedades -
- - - - - - -Propiedades comúnes a todos los documentos.
-obj
-Solo lectura. Devolver el objeto original pyUNO.
-doc = app.active
-app.debug(type(doc))
-app.debug(type(doc.obj))
-18/08/2022 21:59:05 - DEBUG - <class 'easymacro.easycalc.LOCalc'>
-18/08/2022 21:59:05 - DEBUG - <class 'pyuno'>
-title
-Título del documento.
-doc = app.active
-app.debug(doc.title)
-doc.title = 'Nuevo Titulo'
-app.debug(doc.title)
-type
-Solo lectura. Devolver el tipo de documento: calc, writer, etc.
-doc = app.active
-app.debug(doc.type)
-uid
-Solo lectura. Devolver el valor interno RuntimeUID del documento.
-doc = app.active
-app.debug(doc.uid)
-is_saved
-Solo lectura. Si el documento ya ha sido guardado en disco.
-doc = app.active
-app.debug(doc.is_saved)
-is_modified
-Solo lectura. Si el documento ha sido modificado.
-doc = app.active
-app.debug(doc.is_modified)
-is_read_only
-Solo lectura. Si el documento es de solo lectura.
-doc = app.active
-app.debug(doc.is_read_only)
-path
-Solo lectura. Devolver la ruta en disco del documento.
-doc = app.active
-app.debug(doc.path)
-dir
-Solo lectura. Devolver solo el directorio de la ruta en disco del documento.
-doc = app.active
-app.debug(doc.dir)
-file_name
-Solo lectura. Devolver el nombre con extensión de la ruta del documento.
-doc = app.active
-app.debug(doc.file_name)
-name
-Solo lectura. Devolver el nombre sin extensión de la ruta del documento.
-doc = app.active
-app.debug(doc.name)
-visible
-Ocultar o mostrar un documento.
-doc = app.active
-doc.visible = False
-app.msgbox(doc.visible)
-doc.visible = True
-No es necesario que el documento este visible para manipularse.
-zoom
-Devolver o establecer el porcentaje de zoom del documento.
-doc = app.active
-zoom = doc.zoom
-app.msgbox(zoom)
-doc.zoom = zoom * 2
-app.msgbox(doc.zoom)
-doc.zoom = zoom
-status_bar
-Controlar la barra de estado, es importante siempre actualizar en otro hilo.
-@app.run_in_thread
-def controlar_barra_estado(sb, texto, limite):
- sb.start(texto, limite)
- for i in range(limite):
- sb.setValue(i)
- app.sleep(1)
- sb.end()
- return
-
-def main():
- doc = app.active
- controlar_barra_estado(doc.status_bar, 'Línea: ', 10)
- return
-Es importante siempre devolver el control de la barra de estado a la aplicación con el método end.
selection
-Devolver la selección actual.
-doc = app.active
-selection = doc.selection
-app.debug(selection)
-Cuidado, la selección actual pueden ser muchas cosas diferentes.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/documents/properties/index.xml b/doc/public/es/documents/properties/index.xml
deleted file mode 100644
index 0404236..0000000
--- a/doc/public/es/documents/properties/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Documentación de easymacro!
-Software Libre, no software gratis.
-easymacro es una librería para desarrollar más fácilmente macros en LibreOffice con Python. Es una capa de abstracción entre la extensa y compleja API UNO de LibreOffice y tu código.
-Probablemente, será más feliz si la usa :)
-Puede utilizar easymacro con cualquier extensión o directamente en sus macros.
-Aportaciones en Junas (G1)
-A5DdXxCKPw3QKWVdDVs7CzkNugNUW1sHu5zDJFWxCU2h
-Este proyecto esta en continuo desarrollo.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/index.json b/doc/public/es/index.json
deleted file mode 100644
index e0179b4..0000000
--- a/doc/public/es/index.json
+++ /dev/null
@@ -1,232 +0,0 @@
-[
-{
- "uri": "https://doc.cuates.net/easymacro/es/application/shortcuts/",
- "title": "Accesos directos",
- "tags": [],
- "description": "",
- "content": "Globales Iterar en todos los accesos directos. Accesos directos disponibles para todas las aplicaciones.\nfor acceso_directo, comando in app.shortcuts: app.debug(acceso_directo, comando) Devolver una lista de tuplas con toda la información.\ndatos = app.shortcuts.get_all() app.debug(datos) Verificar si un acceso directo esta asignado.\nacceso_directo = \u0026#39;Shift+Ctrl+Alt+T\u0026#39; app.debug(acceso_directo in app.shortcuts) set Establecer un acceso directo a un comando.\nsc = app.shortcuts acceso_directo = \u0026#39;Shift+Ctrl+Alt+T\u0026#39; comando = \u0026#39;MacroDialog\u0026#39; sc.set(acceso_directo, comando) Establecer un acceso directo a una macro.\nsc = app.shortcuts acceso_directo = \u0026#39;Shift+Ctrl+Alt+M\u0026#39; macro = {\u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;pruebas\u0026#39;} sc.set(acceso_directo, macro) get_by_shortcut Devolver el comando asociado a un acceso directo.\nsc = app.shortcuts acceso_directo = \u0026#39;Shift+Ctrl+Alt+M\u0026#39; 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.\nsc = app.shortcuts comando = \u0026#39;MacroDialog\u0026#39; acceso_directo = sc.get_by_command(comando) app.debug(acceso_directo) remove_by_shortcut Eliminar por acceso directo.\nsc = app.shortcuts acceso_directo = \u0026#39;Shift+Ctrl+Alt+T\u0026#39; sc.remove_by_shortcut(acceso_directo) remove_by_command Eliminar por comando.\nsc = app.shortcuts macro = {\u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;pruebas\u0026#39;} sc.remove_by_command(macro) reset Reiniciar todas las modificaciones.\napp.shortcuts.reset() Modificar accesos directos, solo en una aplicación. Por ejemplo Calc.\nsc = app.shortcuts[\u0026#39;calc\u0026#39;] Los métodos son los mismos que los globales.\nPara las demas aplicaciones: writer, draw, impress, math.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/sheets/",
- "title": "Hojas",
- "tags": [],
- "description": "",
- "content": "Trabajar con hojas Referencia por índice doc = app.active hoja = doc[0] app.debug(hoja.name) Referencia por nombre doc = app.active hoja = doc[\u0026#39;datos\u0026#39;] app.debug(hoja.name) in Verificar por nombre si una hoja existe.\ndoc = app.active existe = \u0026#39;Hoja2\u0026#39; in doc app.debug(existe) len Contar la cantidad de hojas en el documento.\ndoc = app.active contar = len(doc) app.debug(contar) iter Recorrer todas las hojas.\ndoc = app.active for hoja in doc: app.debug(hoja) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/installation/",
- "title": "Instalación",
- "tags": [],
- "description": "",
- "content": "Clonar repositorio Clone el repositorio en su directorio de proyectos favorito.\ngit clone https://git.cuates.net/elmau/easymacro Muévase al directorio\ncd easymacro/source copie la carpeta easymacro a la carpeta pythonpath en la carpeta de macros Python dentro de su perfil de usuario. Reemplace USUARIO por su usuario real.\n/home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/pythonpath o use un vínculo simbólico. Reemplace RUTA_ABSOLUTA por la ruta absoluta donde se localice easymacro en su sistema de archivos y USUARIO por su nombre de usuario.\nln -s `RUTA_ABSOLUTA`/easymacro/source/easymacro /home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/pythonpath/ Probar En su archivo de macros favorito, por ejemplo mismacros.py. Use su editor de texto plano o IDE favorito.\nvim /home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/mismacros.py Copie el siguiente código:\nimport easymacro as app def main(): app.msgbox(app.INFO_DEBUG) return Ejecute la macro main desde LibreOffice, si ve un cuadro de mensaje con información similar a la siguiente, !felicidades¡\nEsta todo listo para empezar a desarrollar macros con easymacro.\n!Feliz programación!\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/messages/",
- "title": "Mensajes",
- "tags": [],
- "description": "",
- "content": "Cuadros de mensaje msgbox Mostrar mensaje estandar.\nmensaje = \u0026#39;Maldito Mundo\u0026#39; titulo = \u0026#39;Mi Macro\u0026#39; app.msgbox(mensaje, titulo) warning Mostrar mensaje con icono de advertencia.\nmensaje = \u0026#39;Cuidado, esta acción es peligrosa\u0026#39; titulo = \u0026#39;Mi Macro\u0026#39; app.warning(mensaje, titulo) errorbox Mostrar mensaje con icono de error.\nmensaje = \u0026#39;ERROR: contacte a soporte\u0026#39; titulo = \u0026#39;Mi Macro\u0026#39; app.errorbox(mensaje, titulo) question Hacer una pregunta mostrando el icono de interrogación y mostrando los botones de comando Si y No. La respuesta siempre es verdadera (True) si el usuario selecciona si y falsa (False) en caso contrario.\nmensaje = \u0026#39;¿Es fácil Python?\u0026#39; titulo = \u0026#39;Mi Macro\u0026#39; resultado = app.question(mensaje, titulo) app.msgbox(resultado) inputbox Muestra un mensaje al usuario, permitiendo capturar una respuesta.\nmensaje = \u0026#39;Escribe tu nombre\u0026#39; nombre = app.inputbox(mensaje) app.msgbox(nombre) Para ocultar solo en pantalla lo que captura el usuario, como contraseñas.\nmensaje = \u0026#39;Captura la contraseña\u0026#39; echochar = \u0026#39;*\u0026#39; contraseña = app.inputbox(mensaje, echochar=echochar) app.msgbox(contraseña) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/cells/properties/",
- "title": "Propiedades",
- "tags": [],
- "description": "",
- "content": "is_cell Verdadero (True) si el rango es de una sola celda.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] app.debug(celda.is_cell) rango = hoja[\u0026#39;A1:C5\u0026#39;] app.debug(rango.is_cell) name Devuelve la dirección de la celda o rango como texto.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] app.debug(celda.name) rango = hoja[\u0026#39;A1:C5\u0026#39;] app.debug(rango.name) address Devuelve la dirección de la celda como una estructura: com.sun.star.table.CellAddress\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] if celda.is_cell: app.debug(celda.address) range_address Devuelve la dirección del rango como una estructura: com.sun.star.table.CellRangeAddress\nhoja = app.active_sheet rango = hoja[\u0026#39;A1:C5\u0026#39;] if not rango.is_cell: app.debug(rango.range_address) filas y columnas Devolver el tamaño del rango en filas y columnas.\nhoja = app.active_sheet rango = hoja[\u0026#39;A1:E100\u0026#39;] filas = len(rango) columnas = rango.len_columns app.debug(filas, columnas) sheet Devuelve la hoja padre.\nrango = hoja[\u0026#39;A1:C5\u0026#39;] hoja = rango.sheet app.debug(hoja) doc Devuelve el documento padre.\nrango = hoja[\u0026#39;A1:C5\u0026#39;] doc = rango.doc app.debug(doc) style Devuelve o aplica el estilo de celda.\nrango = hoja[\u0026#39;A1:C5\u0026#39;] rango.style = \u0026#39;Good\u0026#39; current_region Devuelve la región actual.\ncelda = hoja[\u0026#39;A1\u0026#39;] rango = celda.current_region app.debug(rango) range_data Devuelve la región actual del rango excepto la primer fila.\ncelda = hoja[\u0026#39;A1\u0026#39;] rango = celda.range_data app.debug(rango) back_color Devuelve o aplica el color de fondo del rango.\nrango = hoja[\u0026#39;A1:E10\u0026#39;] rango.back_color = \u0026#39;red\u0026#39; type Devuelve el tipo de contenido de la celda: texto, número o formula.\ncelda = hoja[\u0026#39;A1\u0026#39;] app.debug(celda.type) error Si la celda tiene una formula con error, devuelve el número de error.\ncelda = hoja[\u0026#39;A1\u0026#39;] app.debug(celda.error) string Devuelve o establece el contenido de la celda como texto.\ncelda = hoja[\u0026#39;A1\u0026#39;] celda.string = \u0026#39;Maldito Mundo\u0026#39; app.debug(celda.type, celda.string) celda = hoja[\u0026#39;A2\u0026#39;] celda.string = 12345 app.debug(celda.type, celda.string) float Devuelve o establece el contenido de la celda como valor.\ncelda = hoja[\u0026#39;A1\u0026#39;] celda.float = 12345 app.debug(celda.type, celda.float) formula Devuelve o establece la formula de la celda.\ncelda = hoja[\u0026#39;A1\u0026#39;] celda.formula = \u0026#39;=RAND()\u0026#39; app.debug(celda.type, celda.formula) date Devuelve o establece el contenido de la celda como fecha.\ncelda = hoja[\u0026#39;A1\u0026#39;] celda.date = app.dates.date(1974, 1, 15) app.debug(type(celda.date), celda.date) 20/08/2022 18:38:53 - DEBUG - \u0026lt;class \u0026#39;datetime.date\u0026#39;\u0026gt; 1974-01-15 time Devuelve o establece el contenido de la celda como tiempo.\ncelda = hoja[\u0026#39;A1\u0026#39;] celda.time = app.dates.time(10, 11, 12) app.debug(type(celda.time), celda.time) datetime Devuelve o establece el contenido de la celda como fecha y tiempo.\ncelda = hoja[\u0026#39;A1\u0026#39;] celda.datetime = app.dates.datetime(1974, 1, 15, 10, 11, 12) app.debug(type(celda.datetime), celda.datetime) value Devuelve o establece el valor de la celda, estableciendo el tipo de dato automáticamente.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] celda.value = \u0026#39;Soy Texto\u0026#39; app.debug(celda.type, celda.value) celda = hoja[\u0026#39;A2\u0026#39;] celda.value = 12345 app.debug(celda.type, celda.value) celda = hoja[\u0026#39;A3\u0026#39;] celda.value = \u0026#39;=RAND()\u0026#39; app.debug(celda.type, celda.value) celda = hoja[\u0026#39;A4\u0026#39;] celda.value = app.dates.date(1974, 1, 15) app.debug(celda.type, celda.value) data_array Devuelve o establece los datos de un rango. Es un alias de DataArray.\nrango = app.selection datos = rango.data_array app.debug(datos) rango.data_array = datos El tamaño de los datos, debe ser exactamente del tamaño del rango destino. De lo contrario obtendrá un error.\nformula_array Devuelve o establece los datos de un rango. Es un alias de FormulaArray.\nrango = app.selection datos = rango.data_array app.debug(datos) datos = rango.formula_array app.debug(datos) rango.formula_array = datos data_array devolverá los resultados de las celdas con formulas. formula_array devolverá las formulas en dichas celdas.\ndata Alias de data_array al obtener los datos. Al establecer los datos, si es un rango se comporta como data_array, pero si es una celda, se autoajusta al tamaño de los datos.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] datos = ( (1, \u0026#39;Uno\u0026#39;), (2, \u0026#39;Dos\u0026#39;), (3, \u0026#39;Tres\u0026#39;), ) celda.data = datos app.debug(celda.current_region.data) Siempre valide que haya suficientes celdas libres para los datos para evitar sobreescribirlos.\ndict Devuelve o establece los datos como diccionarios.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] datos = ( {\u0026#39;No\u0026#39;: 1, \u0026#39;Nombre\u0026#39;: \u0026#39;Ingrid\u0026#39;}, {\u0026#39;No\u0026#39;: 2, \u0026#39;Nombre\u0026#39;: \u0026#39;Sophia\u0026#39;}, {\u0026#39;No\u0026#39;: 3, \u0026#39;Nombre\u0026#39;: \u0026#39;Scarlette\u0026#39;}, ) celda.dict = datos app.debug(celda.current_region.dict) next_free Devuelve la siguiente celda libre después de la región actual.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] celda_libre = celda.next_free app.debug(celda_libre) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/ranges/properties/",
- "title": "Propiedades",
- "tags": [],
- "description": "",
- "content": "names Devolver las direcciones de los rangos.\ndoc = app.active rangos = doc.selection nombres = rangos.names app.debug(nombres) data Devolver y establecer datos.\ndoc = app.active rangos = doc.selection datos = rangos.data app.debug(datos) rangos.data = datos Cada rango debe tener exactamente el mismo tamaño.\nstyle Establecer el estilo de todos los rangos.\ndoc = app.active rangos = doc.selection rangos.style = \u0026#39;Good\u0026#39; "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/sheets/properties/",
- "title": "Propiedades",
- "tags": [],
- "description": "",
- "content": "doc Devuelve al documento Calc donde esta la hoja.\ndoc = app.active hoja = doc.active doc = hoja.doc app.debug(doc.title) name Nombre visible y editable por el usuario.\ndoc = app.active hoja = doc.active app.msgbox(hoja.name) hoja.name = \u0026#39;Nuevo Nombre\u0026#39; app.msgbox(hoja.name) code_name Nombre editable y accesible solo por código.\ndoc = app.active hoja = doc.active app.msgbox(hoja.code_name) hoja.code_name = \u0026#39;datos\u0026#39; app.msgbox(hoja.code_name) visible Muestra u oculta la hoja\nhoja = app.active.active app.msgbox(hoja.visible) hoja.visible = not hoja.visible app.msgbox(hoja.visible) hoja.visible = not hoja.visible Solo funcionará con dos o más hojas, por que debe haber al menos una visible.\ncolor Color de la pestaña.\nhoja = app.active.active app.msgbox(hoja.color) hoja.color = \u0026#39;red\u0026#39; app.msgbox(hoja.color) # RGB hoja.color = (125, 200, 10) app.msgbox(hoja.color) used_area Referencia al área de usuario actual.\nhoja = app.active.active rango = hoja.used_area app.debug(rango) is_protected Devuelve verdadero (True) si la hoja esta protegida\nhoja = app.active.active esta_protegida = hoja.is_protected app.debug(esta_protegida) password Establecer una contraseña.\nhoja = app.active.active hoja.password = \u0026#39;siscaloburropanzon\u0026#39; app.debug(hoja.is_protected) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/documents/properties/",
- "title": "Propiedades",
- "tags": [],
- "description": "",
- "content": "Propiedades comúnes a todos los documentos. obj Solo lectura. Devolver el objeto original pyUNO.\ndoc = app.active app.debug(type(doc)) app.debug(type(doc.obj)) 18/08/2022 21:59:05 - DEBUG - \u0026lt;class \u0026#39;easymacro.easycalc.LOCalc\u0026#39;\u0026gt; 18/08/2022 21:59:05 - DEBUG - \u0026lt;class \u0026#39;pyuno\u0026#39;\u0026gt; title Título del documento.\ndoc = app.active app.debug(doc.title) doc.title = \u0026#39;Nuevo Titulo\u0026#39; app.debug(doc.title) type Solo lectura. Devolver el tipo de documento: calc, writer, etc.\ndoc = app.active app.debug(doc.type) uid Solo lectura. Devolver el valor interno RuntimeUID del documento.\ndoc = app.active app.debug(doc.uid) is_saved Solo lectura. Si el documento ya ha sido guardado en disco.\ndoc = app.active app.debug(doc.is_saved) is_modified Solo lectura. Si el documento ha sido modificado.\ndoc = app.active app.debug(doc.is_modified) is_read_only Solo lectura. Si el documento es de solo lectura.\ndoc = app.active app.debug(doc.is_read_only) path Solo lectura. Devolver la ruta en disco del documento.\ndoc = app.active app.debug(doc.path) dir Solo lectura. Devolver solo el directorio de la ruta en disco del documento.\ndoc = app.active app.debug(doc.dir) file_name Solo lectura. Devolver el nombre con extensión de la ruta del documento.\ndoc = app.active app.debug(doc.file_name) name Solo lectura. Devolver el nombre sin extensión de la ruta del documento.\ndoc = app.active app.debug(doc.name) visible Ocultar o mostrar un documento.\ndoc = app.active doc.visible = False app.msgbox(doc.visible) doc.visible = True No es necesario que el documento este visible para manipularse.\nzoom Devolver o establecer el porcentaje de zoom del documento.\ndoc = app.active zoom = doc.zoom app.msgbox(zoom) doc.zoom = zoom * 2 app.msgbox(doc.zoom) doc.zoom = zoom status_bar Controlar la barra de estado, es importante siempre actualizar en otro hilo.\n@app.run_in_thread def controlar_barra_estado(sb, texto, limite): sb.start(texto, limite) for i in range(limite): sb.setValue(i) app.sleep(1) sb.end() return def main(): doc = app.active controlar_barra_estado(doc.status_bar, \u0026#39;Línea: \u0026#39;, 10) return Es importante siempre devolver el control de la barra de estado a la aplicación con el método end.\nselection Devolver la selección actual.\ndoc = app.active selection = doc.selection app.debug(selection) Cuidado, la selección actual pueden ser muchas cosas diferentes.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/ranges/",
- "title": "Conjuntos de Rangos",
- "tags": [],
- "description": "",
- "content": "Trabajar con conjuntos de rangos Selección Obtener una referencia desde la selección actual. Deben de estar seleccionados más de un rango de celdas.\ndoc = app.active seleccion = doc.selection app.debug(seleccion) 20/08/2022 13:21:17 - DEBUG - Ranges: (\u0026#39;Sheet1.A5:C8\u0026#39;, \u0026#39;Sheet1.E11:F14\u0026#39;) len Contar los rangos.\ndoc = app.active contar = len(doc.selection) app.debug(contar) iter Iterar entre los rangos.\ndoc = app.active for rango in doc.selection: app.debug(rango) 20/08/2022 13:27:03 - DEBUG - Range: $Sheet1.$B$4:$D$7 20/08/2022 13:27:03 - DEBUG - Range: $Sheet1.$G$10:$H$14 index Referencia a un rango por índice.\ndoc = app.active rangos = doc.selection rango = rangos[1] app.debug(rango) address Referencia a un rango por su dirección.\nrango = rangos[\u0026#39;Hoja1.A1:B5\u0026#39;] app.debug(rango) contain Verificar si un rango esta en la colección.\ndoc = app.active hoja = doc.active rangos = doc.selection resultado = hoja[\u0026#39;D5:F10\u0026#39;] in rangos app.debug(resultado) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/dates_and_time/",
- "title": "Fechas y tiempo",
- "tags": [],
- "description": "",
- "content": " La fecha inicial en Calc y en Python es diferente.\ntoday Obtener la fecha de hoy.\nd = app.dates app.msgbox(d.today) now Obtener la fecha y hora actuales.\nd = app.dates app.msgbox(d.now) time Obtener la hora actual.\nd = app.dates app.msgbox(d.now.time()) epoch Obtener el tiempo Unix\nd = app.dates app.msgbox(d.epoch) date Devolver una fecha\nd = app.dates date = d.date(1974, 1, 15) app.msgbox(date) time Devolver un tiempo\nd = app.dates time = d.time(10, 20, 15) app.msgbox(time) datetime Devolver fecha y hora\nd = app.dates dt = d.datetime(1974, 1, 15, 10, 11, 12) app.msgbox(dt) str_to_date Convertir una cadena en fecha. Mira este excelente recurso\nd = app.dates cadena = \u0026#39;1974-01-15\u0026#39; plantilla = \u0026#39;%Y-%m-%d\u0026#39; fecha = d.str_to_date(cadena, plantilla) app.msgbox(fecha) app.msgbox(type(fecha)) Para obtener un valor válido para establecer en una celda de Calc.\nd = app.dates cadena = \u0026#39;1974-01-15\u0026#39; plantilla = \u0026#39;%Y-%m-%d\u0026#39; fecha = d.str_to_date(cadena, plantilla, True) app.msgbox(fecha) app.msgbox(type(fecha)) calc_to_date Convierte el valor de una celda en una fecha Python, por ejemplo, la fecha inicial configurada en Calc.\nd = app.dates value_from_cell = 1 fecha = d.calc_to_date(value_from_cell) app.msgbox(fecha) app.msgbox(type(fecha)) start y end Medir tiempo en segundos.\nd = app.dates d.start() app.sleep(5) seconds = d.end() app.msgbox(seconds) Regresar timedelta en vez de segundos.\nd = app.dates d.start() app.sleep(5) td = d.end(False) app.msgbox(td) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools_debug/",
- "title": "Herramientas para depurar",
- "tags": [],
- "description": "",
- "content": "INFO_DEBUG Mostrar información de depuración en un cuadro de mensaje.\nSi tiene cualquier problema en su código durante el desarrollo de sus macros, puede abrir un ticket de soporte en el sistema de ticket de este proyecto. Siempre copie la información de depuración mostrada en este mensaje.\nimport easymacro as app def info(): app.msgbox(app.INFO_DEBUG) return debug Mostrar información en la terminal.\nimport easymacro as app def test_debug(): msg = \u0026#39;Verificar esta información...\u0026#39; app.debug(msg) return 11/08/2022 18:15:45 - DEBUG - Verificar esta información... info Mostrar mensajes informativos en la terminal.\nimport easymacro as app def test_info(): msg = \u0026#39;Iniciando proceso...\u0026#39; app.info(msg) return 11/08/2022 18:23:53 - INFO - Iniciando proceso... error Mostrar mensajes de error en la terminal.\nimport easymacro as app def test_error(): msg = \u0026#39;Error 505\u0026#39; app.error(msg) return 11/08/2022 18:27:34 - ERROR - Error 505 save_log Guardar registro en un archivo, automáticamente se agrega la fecha y hora.\nimport easymacro as app def test_save_log(): app.save_log(\u0026#39;/home/mau/log.txt\u0026#39;, \u0026#39;PyUNO\u0026#39;) app.save_log(\u0026#39;/home/mau/log.txt\u0026#39;, \u0026#39;Maldito Mundo\u0026#39;) return cat ~/log.txt 2022-08-11 18:30:11 - \u0026#39;PyUNO\u0026#39; 2022-08-11 18:30:11 - \u0026#39;Maldito Mundo\u0026#39; msgbox Mostrar cualquier información en un cuadro de mensaje.\ndef message(): msg = \u0026#39;Por favor, consume menos.\u0026#39; app.msgbox(msg) msg = (\u0026#39;uno\u0026#39;, 2, \u0026#39;tres\u0026#39;) app.msgbox(msg) msg = {\u0026#39;nombre\u0026#39;: \u0026#39;Teresa\u0026#39;} app.msgbox(msg) app.msgbox(app) return catch_exception Capturar cualquier error que se produzca al ejecutar una macro.\n@app.catch_exception def test_capturar_error(): r = 1 / 0 return 11/08/2022 18:44:36 - ERROR - test_capturar_error Traceback (most recent call last): File \u0026#34;/home/mau/.config/libreoffice/4/user/Scripts/python/pythonpath/easymacro/easytools.py\u0026#34;, line 115, in func return f(*args, **kwargs) File \u0026#34;/home/mau/.config/libreoffice/4/user/Scripts/python/test.py\u0026#34;, line 18, in test_capturar_error r = 1 / 0 ZeroDivisionError: division by zero Usa este método solo en tiempo de desarrollo. No la uses en producción.\nmri MRI es la mejor extensión para inspeccionar cualquier objeto UNO de LibreOffice. Necesita instalarla primero para poder llamarla.\ndef inspeccionar_objeto(): obj = app.active app.mri(obj) return inspect Inspeccionar un objeto.\ndef inspeccionar_objeto(): doc = app.active data = app.inspect(doc) for p in data.properties: app.debug(p) for m in data.methods: app.debug(m) return Vaciar en una hoja de calculo.\ndef inspeccionar_objeto(): doc = app.active app.inspect(doc, True) return "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/application/menus/",
- "title": "Menús",
- "tags": [],
- "description": "",
- "content": "insert Insertar nuevo menú en Calc.\nEn la propiedad CommandURL es posible establecer tanto un comando UNO de LibreOffice, como un diccionario con los datos de una macro.\nEl nombre del menú es importante para cuando se quiera eliminar.\nnombre_menu = \u0026#39;zaz.my.menu\u0026#39; menu = { \u0026#39;Label\u0026#39;: \u0026#39;My menu\u0026#39;, \u0026#39;CommandURL\u0026#39;: nombre_menu, \u0026#39;Submenu\u0026#39;: [ { \u0026#39;Label\u0026#39;: \u0026#39;Open Macros Dialog...\u0026#39;, \u0026#39;CommandURL\u0026#39;: \u0026#39;MacroDialog\u0026#39;, }, { \u0026#39;Label\u0026#39;: \u0026#39;-\u0026#39;, }, { \u0026#39;Label\u0026#39;: \u0026#39;My macro\u0026#39;, \u0026#39;CommandURL\u0026#39;: {\u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;hola\u0026#39;}, }, { \u0026#39;Label\u0026#39;: \u0026#39;Execute macro...\u0026#39;, \u0026#39;CommandURL\u0026#39;: \u0026#39;RunMacro\u0026#39;, \u0026#39;ShortCut\u0026#39;: \u0026#39;Shift+Ctrl+Alt+E\u0026#39;, }, ] } menus_calc = app.menus[\u0026#39;calc\u0026#39;] menus_calc.insert(menu) remove Eliminar un menú existente.\nnombre_menu = \u0026#39;zaz.my.menu\u0026#39; menus_calc = app.menus[\u0026#39;calc\u0026#39;] menus_calc.remove(nombre_menu) Insertar nuevo menú en uno existente. Dentro del menú Herramientas (tools), después de la opción Macros...\nmenu = app.menus[\u0026#39;calc\u0026#39;][\u0026#39;tools\u0026#39;] menu_nombre = \u0026#39;zaz.my.menu\u0026#39; menu_nuevo = { \u0026#39;Label\u0026#39;: \u0026#39;My menu\u0026#39;, \u0026#39;CommandURL\u0026#39;: menu_nombre, \u0026#39;Submenu\u0026#39;: [ { \u0026#39;Label\u0026#39;: \u0026#39;Open Macros Dialog...\u0026#39;, \u0026#39;CommandURL\u0026#39;: \u0026#39;MacroDialog\u0026#39;, }, { \u0026#39;Label\u0026#39;: \u0026#39;-\u0026#39;, }, { \u0026#39;Label\u0026#39;: \u0026#39;My macro\u0026#39;, \u0026#39;CommandURL\u0026#39;: {\u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;hello\u0026#39;}, }, { \u0026#39;Label\u0026#39;: \u0026#39;Execute macro...\u0026#39;, \u0026#39;CommandURL\u0026#39;: \u0026#39;RunMacro\u0026#39;, \u0026#39;ShortCut\u0026#39;: \u0026#39;Shift+Ctrl+Alt+E\u0026#39;, }, ] } if menu_nombre in menu: menu.remove(menu_nombre) else: menu.insert(menu_nuevo, \u0026#39;.uno:MacrosMenu\u0026#39;) debug Para saber los nombres de cualquier menú.\nmenu = app.menus[\u0026#39;calc\u0026#39;][\u0026#39;tools\u0026#39;] 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 "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/cells/methods/",
- "title": "Métodos",
- "tags": [],
- "description": "",
- "content": "clear Limpia el rango. Por default solo borra datos. Mire API CellFlags para más información.\nrango.clear() Para borrar todo.\nrango.clear(app.ALL) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/ranges/methods/",
- "title": "Métodos",
- "tags": [],
- "description": "",
- "content": "ranges Crear un nuevo contender de rangos vacío.\ndoc = app.active rangos = doc.ranges() app.debug(rangos) add doc = app.active hoja = doc.active rangos = doc.ranges() rangos.add(hoja[\u0026#39;A1:B2\u0026#39;]) rangos.add(hoja[\u0026#39;D5:F10\u0026#39;]) app.debug(rangos) remove rangos.remove(hoja[\u0026#39;A1:B2\u0026#39;]) get_ranges "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/sheets/methods/",
- "title": "Métodos",
- "tags": [],
- "description": "",
- "content": "unprotect Quitar contraseña.\nhoja = app.active.active hoja.password = \u0026#39;siscaloburropanzon\u0026#39; app.msgbox(hoja.is_protected) hoja.unprotect(\u0026#39;siscaloburropanzon\u0026#39;) app.msgbox(hoja.is_protected) activate Pasar el foco a la hoja.\ndoc = app.active hoja = doc[-1] hoja.activate() move Mover a la última posición.\ndoc = app.active hoja = doc[0] hoja.move() Mover a una posición especifica.\ndoc = app.active hoja = doc[0] hoja.move(3) remove Remover hoja.\nsheet = app.active.active sheet.remove() Siempre debe existir al menos una hoja.\ncopy Siempre valida que no exista el nuevo nombre.\ndoc = app.active hoja = doc[0] nuevo_nombre = f\u0026#39;{hoja.name}_2\u0026#39; if not nuevo_nombre in doc: hoja.copy(nuevo_nombre) Si no se establece el nuevo nombre, se generá de forma automática: nombre + índice.\nhoja.copy() copy_to Copiar la hoja a otro documento. Se usa el mismo nombre.\ndoc = app.active hoja = doc.active documento_nuevo = app.docs.new() hoja.copy_to(documento_nuevo) Usar un nuevo nombre.\nhoja.copy_to(documento_nuevo, \u0026#39;Nuevo nombre\u0026#39;) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/documents/methods/",
- "title": "Métodos",
- "tags": [],
- "description": "",
- "content": "new Crear nuevo documento, la aplicación predeterminada es Calc.\ndoc = app.docs.new() app.debug(doc.type) Para un nuevo documento writer.\ndoc = app.docs.new(\u0026#39;writer\u0026#39;) app.debug(doc.type) Otros documentos.\ndoc = app.docs.new(\u0026#39;draw\u0026#39;) app.debug(doc.type) doc = app.docs.new(\u0026#39;impress\u0026#39;) app.debug(doc.type) doc = app.docs.new(\u0026#39;math\u0026#39;) app.debug(doc.type) Crear con argumentos.\npropiedades = {\u0026#39;Hidden\u0026#39;: True} doc = app.docs.new(\u0026#39;writer\u0026#39;, propiedades) mensaje = f\u0026#39;{doc.type} - {doc.title}\u0026#39; app.msgbox(mensaje) doc.visible = True No es necesario que el documento este visible para manipularse.\nopen Abrir archivos.\nruta = \u0026#39;/home/mau/Mi_archivo.ods\u0026#39; doc = app.docs.open(ruta) No es necesario pasar las rutas en formato URL.\nPuede abrir cualquier archivo que sea soportado por LibreOffice.\nruta = \u0026#39;/home/mau/ejemplo.xlsx\u0026#39; doc = app.docs.open(ruta) Abrir con argumentos.\nruta = \u0026#39;/home/mau/ejemplo.ods\u0026#39; argumentos = {\u0026#39;Password\u0026#39;: \u0026#39;siscaloburropanzon\u0026#39;} doc = app.docs.open(ruta, argumentos) save Guardar un nuevo documento.\npath = \u0026#39;/home/mau/nuevo_documento.ods\u0026#39; doc = app.docs.new() doc.save(path) Cualquier archivo, previamente guardado, que sea modificado puede ser guardado con:\ndoc.save() Abrir un archivo existente y guardarlo con otro nombre.\nruta = \u0026#39;/home/mau/ejemplo.ods\u0026#39; doc = app.docs.open(ruta) nueva_ruta = \u0026#39;/home/mau/otro_nombre.ods\u0026#39; doc.save(nueva_ruta) close Cerrar un archivo.\ndoc = app.docs.new() app.msgbox(doc.title) doc.close() to_pdf Exportar a PDF.\ndoc = app.active ruta = \u0026#39;/home/mau/ejemplo.pdf\u0026#39; doc.to_pdf(ruta) Si no se establece una ruta, se devuelve el PDF en memoria.\ndoc = app.active pdf = doc.to_pdf() app.debug(pdf) Mire las opciones del filtro de exportación a PDF, puede pasarlas como un diccionario como segundo argumento de este método.\nexport Exportar a otros formatos.\ndoc = app.docs.new() ruta = \u0026#39;/home/mau/miarchivo.xlsx\u0026#39; filtro = \u0026#39;xlsx\u0026#39; doc.export(ruta, filtro) ruta = \u0026#39;/home/mau/miarchivo.xls\u0026#39; filtro = \u0026#39;xls\u0026#39; doc.export(ruta, filtro) doc = app.docs.new(\u0026#39;writer\u0026#39;) ruta = \u0026#39;/home/mau/miarchivo.docx\u0026#39; filtro = \u0026#39;docx\u0026#39; doc.export(ruta, filtro) ruta = \u0026#39;/home/mau/miarchivo.doc\u0026#39; filtro = \u0026#39;doc\u0026#39; doc.export(ruta, filtro) ruta = \u0026#39;/home/mau/miarchivo.rtf\u0026#39; filtro = \u0026#39;rtf\u0026#39; doc.export(ruta, filtro) Exportar en memoria.\ndoc = app.docs.new() filtro = \u0026#39;xlsx\u0026#39; excel_doc = doc.export(filter_name=filtro) set_focus Enviar el foco al documento.\nfor doc in app.docs: app.debug(doc.title) doc.set_focus() app.sleep(1) copy Copiar la selección activa al portapapeles.\ndoc = app.active doc.copy() paste Copiar el contenido del portapapeles, en la selección actual.\ndoc = app.active doc.paste() paste_special Mostrar el cuadro de diálogo Pegado Especial.\nSolo se mostrará si existe contenido en el portapapeles.\ndoc = app.active doc.paste_special() paste_values Pegar solo los valores.\ndoc = app.active doc.paste_values() Si el destino no esta vacío, el usuario verá el cuadro de mensaje de confirmación.\nclear_undo La mayoría de las acciones realizadas por código, quedan en el historial de acciones, por lo que el usuario puede deshacerlas. Para eviar esto se puede limpiar este historial.\ndoc = app.active doc.clear_undo() "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/paths/",
- "title": "Rutas y archivos",
- "tags": [],
- "description": "",
- "content": "Trabajar con rutas y archivos. path Obtener información de una ruta.\nruta_archivo = \u0026#39;/home/mau/mi_archivo.ods\u0026#39; p = app.paths(ruta_archivo) app.debug(p.path) app.debug(p.file_name) app.debug(p.name) app.debug(p.ext) app.debug(p.size) app.debug(p.url) 15/08/2022 14:40:08 - DEBUG - /home/mau 15/08/2022 14:40:08 - DEBUG - mi_archivo.ods 15/08/2022 14:40:08 - DEBUG - mi_archivo 15/08/2022 14:40:08 - DEBUG - ods 15/08/2022 14:40:08 - DEBUG - 7011 15/08/2022 14:40:08 - DEBUG - file:///home/mau/mi_archivo.ods Obtener la misma información como un tupla.\nruta_archivo = \u0026#39;/home/mau/mi_archivo.ods\u0026#39; p = app.paths(ruta_archivo) app.debug(p.info) 15/08/2022 14:43:01 - DEBUG - (\u0026#39;/home/mau\u0026#39;, \u0026#39;mi_archivo.ods\u0026#39;, \u0026#39;mi_archivo\u0026#39;, \u0026#39;ods\u0026#39;, 7011, \u0026#39;file:///home/mau/mi_archivo.ods\u0026#39;) O como diccionario.\nruta_archivo = \u0026#39;/home/mau/mi_archivo.ods\u0026#39; p = app.paths(ruta_archivo) app.debug(p.dict) 15/08/2022 14:43:01 - DEBUG - {\u0026#39;path\u0026#39;: \u0026#39;/home/mau\u0026#39;, \u0026#39;file_name\u0026#39;: \u0026#39;mi_archivo.ods\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;mi_archivo\u0026#39;, \u0026#39;ext\u0026#39;: \u0026#39;ods\u0026#39;, \u0026#39;size\u0026#39;: 7011, \u0026#39;url\u0026#39;: \u0026#39;file:///home/mau/mi_archivo.ods\u0026#39;} home Obtener la carpeta de inicio del usuario.\np = app.paths app.debug(p.home) documents Obtener la carpeta Documentos del usuario.\np = app.paths app.debug(p.documents) user_profile Obtener la ruta del perfil de usuario.\np = app.paths app.debug(p.user_profile) user_config Obtener la ruta de la carpeta config en el perfil de usuario.\np = app.paths app.debug(p.user_config) python Obtener la ruta del ejecutable python\np = app.paths app.debug(p.python) to_system Pasar una ruta en formato URL al formato del sistema de archivos del SO.\np = app.paths ruta_url = \u0026#39;file:///home/mau/mi_archivo.ods\u0026#39; ruta = p.to_system(ruta_url) app.debug(ruta) to_url Pasar una ruta del sistema de archivos del SO al formato URL.\np = app.paths ruta = \u0026#39;/home/mau/mi_archivo.ods\u0026#39; ruta_url = p.to_url(ruta) app.debug(ruta_url) config Obtener rutas de la configuración de LibreOffice. Por default obtiene la ruta de Documentos, para otras ruta mire Api XPathSettings\np = app.paths ruta = p.config() app.debug(ruta) ruta = p.config(\u0026#39;UserConfig\u0026#39;) app.debug(ruta) Algunas rutas pueden ser más de una, separados por ;, en este caso, el resultado es una lista con las rutas.\njoin Concatenar rutas.\np = app.paths ruta = p.join(\u0026#39;/home/mau\u0026#39;, \u0026#39;pruebas\u0026#39;, \u0026#39;archivo.ods\u0026#39;) app.debug(ruta) exists Verificar si una ruta existe.\np = app.paths resultado = p.exists(\u0026#39;/home/mau/test/archivo.ods\u0026#39;) app.debug(resultado) exists_app Verificar si una aplicación existe.\np = app.paths resultado = p.exists_app(\u0026#39;noexiste\u0026#39;) app.debug(resultado) resultado = p.exists_app(\u0026#39;soffice\u0026#39;) app.debug(resultado) is_dir Verificar si la ruta es un directorio.\np = app.paths resultado = p.is_dir(\u0026#39;/home/mau\u0026#39;) app.debug(resultado) is_file Verificar si la ruta es un archivo.\np = app.paths resultado = p.is_file(\u0026#39;/home/mau/mi_archivo.ods\u0026#39;) app.debug(resultado) temp_file Crear un archivo temporal, es borrado automáticamente al cerrarse.\np = app.paths f = p.temp_file() f.write(app.INFO_DEBUG) f.close() Usado en contexto, se cierra automáticamente.\nwith p.temp_file() as f: app.debug(f.name) f.write(\u0026#39;test\u0026#39;) temp_dir Crear un directorio temporal, al salir del contexto, es eliminado junto con todo su contenido del sistema de archivos.\np = app.paths with p.temp_dir() as d: app.debug(p.exists(d)) app.debug(d) app.debug(p.exists(d)) get Permitir al usuario seleccionar archivos, devuelve solo la ruta. De forma predeterminada abre en la carpeta Documentos.\np = app.paths ruta = p.get() app.debug(ruta) Establecer que abra en otro directorio.\nruta = p.get(\u0026#39;/tmp\u0026#39;) app.debug(ruta) Agregar un filtro.\nruta = p.get(filters=\u0026#39;ods\u0026#39;) app.debug(ruta) Agregar multiples filtros.\nruta = p.get(filters=\u0026#39;xml,txt\u0026#39;) app.debug(ruta) Permitir selecciones multiples.\nruta = p.get(filters=\u0026#39;xml,txt\u0026#39;, multiple=True) app.debug(ruta) get_dir Permitir al usuario seleccionar un directorio, devuelve solo la ruta. De forma predeterminada abre en la carpeta Documentos.\np = app.paths ruta = p.get_dir() app.debug(ruta) Establecer que abra en otro directorio.\nruta = p.get_dir(\u0026#39;/tmp\u0026#39;) app.debug(ruta) get_for_save Permitir seleccionar un directorio y capturar el nombre del archivo, devuelve la ruta completa.\np = app.paths ruta = p.get_for_save() app.debug(ruta) Establecer que inicie en otro directorio.\nruta = p.get_for_save(\u0026#39;/tmp\u0026#39;) app.debug(ruta) Si se establece un filtro, automáticamente se agrega la extensión.\nruta = p.get_for_save(filters=\u0026#39;txt\u0026#39;) app.debug(ruta) files Obtener archivos de una ruta, no recursivamente. De forma predeterminada regresa todos, incluyendo archivos ocultos.\nruta = \u0026#39;/home/mau\u0026#39; p = app.paths archivos = p.files(ruta) for a in archivos: app.debug(a) Filtrar por tipo de archivo.\np = app.paths archivos = p.files(ruta, \u0026#39;*.pdf\u0026#39;) Obtener archivos de forma recursiva.\np = app.paths archivos = p.files(ruta, \u0026#39;**/*.xml\u0026#39;) walk Obtener archivos de forma recursiva.\np = app.paths ruta = \u0026#39;/home/mau/Documents\u0026#39; archivos = p.walk(ruta) for a in archivos: app.debug(a) Con filtro.\narchivos = p.walk(ruta, \u0026#39;ods\u0026#39;) Con filtros.\narchivos = p.walk(ruta, \u0026#39;ods|odt\u0026#39;) dirs Obtener los directorios de una ruta, no recursivamente.\np = app.paths ruta = \u0026#39;/home/mau/Documents\u0026#39; folders = p.dirs(ruta) for f in folders: app.debug(f) walk_dirs Obtener los directorios de una ruta, no recursivamente.\np = app.paths ruta = \u0026#39;/home/mau/Documents\u0026#39; folders = p.walk_dirs(ruta) for f in folders: app.debug(f) Obtener información en una lista de tuplas: (ID_FOLDER, ID_PADRE, NOMBRE)\nfolders = p.walk_dirs(ruta, True) extension Obtener la ruta de instalación de una extensión a partir de su ID.\np = app.paths id_ext = \u0026#39;net.elmau.zaz.talk\u0026#39; ruta = p.extension(id_ext) app.debug(ruta) replace_ext Reemplazar extensión de un archivo.\np = app.paths ruta = \u0026#39;/home/mau/mi_archivo.ods\u0026#39; ruta_nueva = p.replace_ext(ruta, \u0026#39;pdf\u0026#39;) app.debug(ruta_nueva) open Abrir cualquier archivo con el programas predeterminado del SO.\np = app.paths ruta = \u0026#39;/home/mau/archivo.pdf\u0026#39; p.open(ruta) ruta = \u0026#39;/home/mau/index.html\u0026#39; p.open(ruta) save y read Guardar y leer datos, el encoding predeterminado es UTF8.\np = app.paths datos = \u0026#34;\u0026#34;\u0026#34;¿Quieres saber quién eres? No preguntes. Actúa. La acción te delineará y definirá. Thomas Jefferson \u0026#34;\u0026#34;\u0026#34; ruta = \u0026#39;/home/mau/temp.txt\u0026#39; p.save(ruta, datos) datos = p.read(ruta) app.msgbox(datos) Cambiar el encoding.\napp.paths.save(ruta, datos, \u0026#39;iso-8859-1\u0026#39;) save_bin y read_bin Guardar y leer datos binarios.\np = app.paths datos = b\u0026#39;Datos binarios\u0026#39; ruta = \u0026#39;/home/mau/temp.bin\u0026#39; p.save_bin(ruta, datos) datos = p.read_bin(ruta) app.msgbox(datos) save_json y read_json Guardar y leer en formato json.\np = app.paths ruta = \u0026#39;/home/mau/datos.json\u0026#39; datos = { \u0026#39;tipo\u0026#39;: \u0026#39;calc\u0026#39;, \u0026#39;nombre\u0026#39;: \u0026#39;miarchivo.ods\u0026#39;, } p.save_json(ruta, datos) datos = p.read_json(ruta) app.msgbox(datos) save_csv y read_csv Exportar e importar datos en formato CSV. Vea la documentación CSV para los argumentos que puede usar.\np = app.paths ruta = \u0026#39;/home/mau/datos.csv\u0026#39; ahora = app.dates.now datos = ( (1, \u0026#39;uno\u0026#39;, ahora), (2, \u0026#39;dos\u0026#39;, ahora), (3, \u0026#39;tres\u0026#39;, ahora), ) p.save_csv(ruta, datos) datos = p.read_csv(ruta) app.msgbox(datos) kill Borra archivos o directorios con todo su contenido. Devuelve verdadero (True) en caso de exito y falso (Falso) en cualquier otro caso.\nEste proceso es destructivo, es buena practica siempre solicitar confirmación al usuario.\np = app.paths ruta = \u0026#39;/home/mau/temp.bin\u0026#39; resultado = p.kill(ruta) app.msgbox(resultado) copy Copiar archivos. Devuelve la ruta completa final destino.\nDe un origen a una carpeta destino\np = app.paths ruta_origen = \u0026#39;/home/mau/temp.txt\u0026#39; ruta_destino = \u0026#39;/home/mau/Desktop\u0026#39; ruta = p.copy(ruta_origen, ruta_destino) app.debug(ruta) Cambiar el nombre destino.\nruta_origen = \u0026#39;/home/mau/temp.txt\u0026#39; ruta_destino = \u0026#39;/home/mau/Desktop\u0026#39; nuevo_nombre = \u0026#39;datos.csv\u0026#39; ruta = p.copy(ruta_origen, ruta_destino, nuevo_nombre) app.debug(ruta) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/cells/",
- "title": "Celdas y rangos",
- "tags": [],
- "description": "",
- "content": "Trabajar con celdas y rangos selection Referencia por selección actual.\nseleccion = app.selection app.debug(seleccion) 20/08/2022 15:32:36 - DEBUG - Cell: $Sheet1.$A$2 20/08/2022 15:32:39 - DEBUG - Range: $Sheet1.$C$8:$D$11 address Referencia por dirección.\nhoja = app.active_sheet celda = hoja[\u0026#39;A1\u0026#39;] rango = hoja[\u0026#39;C10:D15\u0026#39;] app.debug(celda) app.debug(rango) position Referencia por posición.\nPara celdas: HOJA[fila,columna]\nPara rangos: HOJA[fila_inicial:fila_final, columna_inicial:columna_final]\nhoja = app.active_sheet # ~ Cell A10 celda = hoja[9,0] # ~ Range A1:C10 rango = hoja[0:10,0:3] iter Iterar cada celda de un rango.\nhoja = app.active_sheet rango = hoja[\u0026#39;B10:C15\u0026#39;] for celda in rango: app.debug(celda) contains Verificar si un rango esta dentro de otro.\nhoja = app.active_sheet celda = hoja[\u0026#39;C5\u0026#39;] rango = hoja[\u0026#39;A1:E10\u0026#39;] resultado = celda in rango app.debug(resultado) celda = hoja[\u0026#39;C50\u0026#39;] resultado = celda in rango app.debug(resultado) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/email/",
- "title": "Correo electrónico",
- "tags": [],
- "description": "",
- "content": "Enviar correo electrónico. Siempre guarda las contraseñas de la forma más segura posible.\nsend Enviar un correo electrónico.\nfrom conf import PASSWORD SERVER = dict( server = \u0026#39;mail.correo.net\u0026#39; , port = 405, ssl = True, user = \u0026#39;no-responder@pruebas.mx\u0026#39;, password = PASSWORD, ) body = \u0026#34;Hola Ingrid\\n\\n¿Como estas?\\n\\nSaludos cordiales\u0026#34; message = dict( to = \u0026#39;ingrid@bergman.mx\u0026#39;, subject = \u0026#39;Te amo...\u0026#39;, body = body, ) app.email.send(SERVER, message) Puede usar los campos cc (Con Copia) y bcc (Con Copia Oculta), así como separar por comas las direcciones destino para enviar a más de un correo.\nto = \u0026#39;mail1@correo.com,mail2@correo.com,mail3@correo.com\u0026#39; cc = \u0026#39;otro@correo.com\u0026#39; bcc = \u0026#39;oculto@correo.com\u0026#39; Podemos enviar más de un mensaje.\nmensaje1 = dict( to = \u0026#39;ingrid@correo.net\u0026#39;, subject = \u0026#39;Te amo...\u0026#39;, body = \u0026#34;Hola Ingrid\\n\\n¿Como estas?\\n\\nSaludos cordiales\u0026#34;, ) mensaje2 = dict( to = \u0026#39;sophia@correo.net\u0026#39;, subject = \u0026#39;A ti también...\u0026#39;, body = \u0026#34;Hola Sophia\\n\\n¿Como estas?\\n\\nSaludos cordiales\u0026#34;, ) mensajes = (mensaje1, mensaje2) app.email.send(SERVER, mensajes) 16/08/2022 13:01:49 - DEBUG - Connect to: mail.server.net 16/08/2022 13:01:50 - DEBUG - Email sent... 16/08/2022 13:01:51 - DEBUG - Email sent... 16/08/2022 13:01:51 - DEBUG - Close connection... Enviar un archivo adjunto.\narchivo = \u0026#39;/home/mau/temp.txt\u0026#39; mensaje = dict( to = \u0026#39;ingrid@bergman.mx\u0026#39;, subject = \u0026#39;Te amo...\u0026#39;, body = \u0026#34;Hola Ingrid\\n\\n¿Como estas?\\n\\nSaludos cordiales\u0026#34;, files = archivo, ) app.email.send(SERVER, mensaje) O varios.\narchivos = ( \u0026#39;/home/mau/temp.txt\u0026#39;, \u0026#39;/home/mau/datos.csv\u0026#39;, ) Si tu cliente de correo usa el formato mbox, puede guardar los correos enviados en una carpeta dentro de la configuración de su cliente de correo.\nruta = \u0026#39;/home/mau/.thunderbird/7iznrbyw.default/Mail/Local Folders/LibreOffice\u0026#39; mensaje = dict( to = \u0026#39;ingrid@bergman.mx\u0026#39;, subject = \u0026#39;Te amo...\u0026#39;, body = \u0026#34;Hola Ingrid\\n\\n¿Como estas?\\n\\nSaludos cordiales\u0026#34;, path = ruta, ) app.email.send(SERVER, mensaje) Todos los correos se envían siempre en otro hilo de ejecución.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/sheets/events/",
- "title": "Eventos",
- "tags": [],
- "description": "",
- "content": "Eventos de la hoja. Obtener una tupla con los eventos soportados por la hoja.\nhoja = app.active.active nombres = hoja.events.names app.debug(nombres) Asignar una macro a un evento. def on_select(source): app.debug(source.AbsoluteName) return def main(): doc = app.active hoja = doc.active if \u0026#39;OnSelect\u0026#39; in hoja.events: macro = {\u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;on_select\u0026#39;} hoja.events[\u0026#39;OnSelect\u0026#39;] = macro return Eliminar la asignación del evento. hoja.events[\u0026#39;OnSelect\u0026#39;] = {} O\nhoja.events.remove(\u0026#39;OnFocus\u0026#39;) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/",
- "title": "Herramientas",
- "tags": [],
- "description": "",
- "content": "Recuerda, es necesario importar la librería.\nimport easymacro as app Información sobre la PC OS Obtener el sistema operativo.\napp.msgbox(app.OS) DESKTOP Obtener el tipo de escritorio, solo en GNU/Linux.\napp.msgbox(app.DESKTOP) PC Obtener el nombre de la computadora.\napp.msgbox(app.PC) USER Obtener el nombre de usuario.\napp.msgbox(app.USER) IS_WIN Saber si estamos en Windows.\napp.msgbox(app.IS_WIN) IS_MAC Saber si estamos en OSX.\napp.msgbox(app.IS_MAC) Información sobre LibreOffice NAME Nombre de la aplicación.\napp.msgbox(app.NAME) VERSION Versión de la aplicación.\napp.msgbox(app.VERSION) LANG Lenguaje de la aplicación.\napp.msgbox(app.LANG) LANGUAGE Lenguaje con variante.\napp.msgbox(app.LANGUAGE) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/application/",
- "title": "LibreOffice",
- "tags": [],
- "description": "",
- "content": "fonts Devolver todas las fuentes visibles en LibreOffice. Mire FontDescriptor\nfonts = app.fonts() for f in fonts: app.debug(f\u0026#39;Nombre: {f.Name} - Estilo: {f.StyleName}\u0026#39;) filters Devolver todos los filtros soportados en LibreOffice. Mire la ayuda y en API FilterFactory para más detalles.\nfiltros = app.filters() for f in filtros: info = f\u0026#34;Nombre UI: {f[\u0026#39;UIName\u0026#39;]} - Nombre: {f[\u0026#39;Name\u0026#39;]} - Tipo: {f[\u0026#39;Type\u0026#39;]}\u0026#34; app.debug(info) dispatch Ejecutar cualquier comando UNO de LibreOffice, mire la lista de comandos y API dispatch.\nEste método automáticamente agrega el prefijo necesario: .uno:\ndoc = app.active comando = \u0026#39;Gallery\u0026#39; app.dispatch(doc, comando) Use este método solamente si no hay un método equivalente en easymacro o directamente en el API de LibreOffice.\nclipboard Envíar contenido al portapapeles.\napp.clipboard.set(\u0026#39;Los 7 samuráis\u0026#39;) Recuperar contenido del portapapeles.\ncontent = app.clipboard.get() app.debug(content) disable Deshabilitar un comando. Para una lista de comandos mire DispatchCommands.\ncomando = \u0026#39;OpenFromCalc\u0026#39; resultado = app.cmd.disable(comando) app.debug(resultado) OpenFromCalc es la opción para abrir documentos en Calc, deshabilita o habilita la entrada del menú y el icono en la barra de herramientas.\nenabled Habilitar un comando.\ncomando = \u0026#39;OpenFromCalc\u0026#39; resultado = app.cmd.enabled(comando) app.debug(resultado) get_config Obtener valores de la configuración de LibreOffice.\nnombre_node = \u0026#39;/org.openoffice.Office.Common/Help\u0026#39; clave = \u0026#39;System\u0026#39; valor = app.get_config(nombre_node, clave) app.debug(valor) nombre_node = \u0026#39;/org.openoffice.Office.Common/Misc/\u0026#39; clave = \u0026#39;FirstRun\u0026#39; valor = app.get_config(nombre_node, clave) app.debug(valor) clave = \u0026#39;UseSystemFileDialog\u0026#39; valor = app.get_config(nombre_node, clave) app.debug(valor) 17/08/2022 14:14:12 - DEBUG - UNIX 17/08/2022 14:14:12 - DEBUG - False 17/08/2022 14:14:12 - DEBUG - True set_config Establece un nuevo valor en la configuración de LibreOffice.\nnombre_nodo = \u0026#39;/org.openoffice.Office.UI/ColorScheme\u0026#39; clave = \u0026#39;CurrentColorScheme\u0026#39; nuevo_valor = \u0026#39;LibreOffice Dark\u0026#39; resultado = app.set_config(nombre_nodo, clave, nuevo_valor) app.debug(resultado) Algunos nodos y claves interesantes:\n/org.openoffice.Office.Common/Save/Document AutoSave AutoSaveTimeIntervall No todos los valores de los nodos se pueden cambiar, algunos valores son de solo lectura.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/documents/",
- "title": "Documentos",
- "tags": [],
- "description": "",
- "content": "Trabajar con Documentos active Documento activo.\ndoc = app.active app.msgbox(doc.title) iteration Iterar en todos los documentos abiertos.\nfor doc in app.docs: app.debug(doc.type, doc.title) count Contar los documentos abiertos.\ncuantos = len(app.docs) app.debug(cuantos) contain Verificar si un documento esta en la colección.\nresultado = \u0026#39;mi_archivo.ods\u0026#39; in app.docs app.debug(resultado) index Devolver por índice.\ndoc = app.docs[1] app.debug(doc.type, doc.title) name Devolver por nombre.\nnombre = \u0026#39;mi_archivo.ods\u0026#39; if nombre in app.docs: doc = app.docs[nombre] app.debug(doc.type, doc.title) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/threads/",
- "title": "Hilos",
- "tags": [],
- "description": "",
- "content": "Ejecutar macros en otros hilos. Las macros se ejecutan en un hilo que bloquea cualquier otro proceso dentro de la aplicación.\nSi ejecutas la siguiente macro main, nota que no puedes hacer algo más dentro de LibreOffice durante los 5 segundos que dura el proceso.\nimport easymacro as app def hacer_pausa(segundos): app.sleep(segundos) app.debug(\u0026#39;He terminado\u0026#39;) return def main(): hacer_pausa(5) app.msgbox(\u0026#39;Fin...\u0026#39;) return Hasta que aparece el cuadro de mensaje con la palabra Fin y lo cierras, el usuario puede seguir usando la aplicación.\nrun_in_thread Ahora ejecutamos la macro en otro hilo, \u0026ldquo;decorando\u0026rdquo; cualquier macro con run_in_thread\n@app.run_in_thread def hacer_pausa(segundos): app.sleep(segundos) app.debug(\u0026#39;He terminado\u0026#39;) return def main(): hacer_pausa(5) app.msgbox(\u0026#39;Fin...\u0026#39;) return Nota que ahora el mensaje aparece inmediatamente y no tras los 5 segundos.\nPonga mucha atención en no ejecutar macros en otros hilo que dependen de algo suceptible de ser cambiado o interceptado por el usuario, por ejemplo, la celda activa.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/calc/",
- "title": "Calc",
- "tags": [],
- "description": "",
- "content": "Trabajar con Calc active doc = app.active app.debug(doc.type) Propiedades headers Mostrar u ocultar encabezados de filas y columnas.\ndoc = app.active app.msgbox(doc.headers) doc.headers = not doc.headers app.msgbox(doc.headers) doc.headers = not doc.headers tabs Mostrar u ocultar las pestañas de las hojas.\ndoc = app.active app.msgbox(doc.tabs) doc.tabs = not doc.tabs app.msgbox(doc.tabs) doc.tabs = not doc.tabs selection Devolver la selección activa.\ndoc = app.active seleccion = doc.selection app.debug(seleccion) Cuidado, la selección actual pueden ser muchas cosas diferentes.\nnames Devolver una tupla con los nombres de todas las hojas.\ndoc = app.active nombres = doc.names app.debug(nombres) active Devuelve la hoja activa.\ndoc = app.active hoja = doc.active app.debug(hoja) Métodos activate Activar hoja, argumento como objeto.\ndoc = app.active hoja = doc[-1] doc.activate(hoja) Activar hoja por nombre.\ndoc = app.active doc.activate(\u0026#39;Hoja3\u0026#39;) select Seleccionar una celda o rango.\ndoc = app.active cell = doc[0][\u0026#39;A1\u0026#39;] doc.select(cell) NO es necesario seleccionar celdas o rangos para manipularlos.\nstart_range_selection Permitir al usuario seleccionar un rango. Es necesario pasarle una clase con el nombre que prefiera (Eventos es recomendable) con dos métodos para procesar la captura como en el siguiente ejemplo:\nclass Eventos(): def __init__(self, doc): self.doc = doc def range_selection_done(self, range_selection): if range_selection: app.debug(range_selection) self.doc.remove_range_selection_listener() return def range_selection_aborted(self): self.doc.remove_range_selection_listener() return def main(): doc = app.active doc.start_range_selection(Eventos) return insert Inserta una nueva hoja.\ndoc = app.active hoja = doc.insert(\u0026#39;OtraHoja\u0026#39;) Insertar varias hojas. Devolverá la última insertada.\nnombres = (\u0026#39;Enero\u0026#39;, \u0026#39;Febrero\u0026#39;, \u0026#39;Marzo\u0026#39;) hoja = doc.insert(nombres) app.debug(hoja) Creando una nueva instancia y asignandola.\ndoc = app.active doc[\u0026#39;NuevaHoja\u0026#39;] = doc.new_sheet() Si la hoja existe, obtendrá un error, verifique siempre que no exista primero.\nmove Mover hojas.\nPasar la hoja como objeto, de forma predetermianda se mueve a la última posición.\ndoc = app.active hoja = doc[0] doc.move(hoja) Pasar la hoja por nombre.\ndoc = app.active doc.move(\u0026#39;Hoja1\u0026#39;) Especificar la posición destino.\ndoc = app.active hoja = doc[0] doc.move(hoja, 2) remove Eliminar hoja.\ndoc = app.active sheet = doc[0] doc.remove(sheet) Eliminar por nombre.\ndoc.remove(\u0026#39;Hoja2\u0026#39;) copy Copiar hoja dentro del mismo documento.\ndoc = app.active hoja = doc[0] doc.copy_sheet(hoja, \u0026#39;Otra hoja\u0026#39;) Por nombre.\ndoc.copy_sheet(\u0026#39;Hoja1\u0026#39;, \u0026#39;Hoja2\u0026#39;) Si no se establece el nuevo nombre, se generá de forma automática: nombre + índice.\ndoc.copy_sheet(hoja) copy_from Copiar hojas de otro documento. Copiar con el mismo nombre.\ndoc = app.active documento_origen = app.docs[\u0026#39;Contactos.ods\u0026#39;] nombre_origen = \u0026#39;Nombres\u0026#39; doc.copy_from(documento_origen, nombre_origen) Copiar con un nuevo nombre.\ndoc.copy_from(documento_origen, nombre_origen, \u0026#39;NuevoNombre\u0026#39;) Si solo se establece el documento origen, se copian todas las hojas.\ndoc.copy_from(documento_origen) sort Ordenar hojas en orden alfabetico.\ndoc = app.active doc.sort() Ordenar de forma inversa.\ndoc = app.active doc.sort(True) Eventos del documento. Obtener una tupla con los eventos soportados por el documento.\ndoc = app.active nombres = doc.events.names app.debug(nombres) Asignar una macro a un evento. def doc_on_focus(event): app.debug(\u0026#39;Documento activado...\u0026#39;) return def main(): doc = app.active events = doc.events if \u0026#39;OnFocus\u0026#39; in events: macro = {\u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;doc_on_focus\u0026#39;} events[\u0026#39;OnFocus\u0026#39;] = macro return Eliminar la asignación del evento. doc = app.active doc.events[\u0026#39;OnFocus\u0026#39;] = {} O\ndoc = app.active doc.events.remove(\u0026#39;OnFocus\u0026#39;) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/macros/",
- "title": "Ejecutar macros",
- "tags": [],
- "description": "",
- "content": "Ejecutar cualquier macro, de forma predeterminada se llaman a las macros en Python localizadas en el perfil de usuario.\nimport easymacro as app def mostrar_info(): app.msgbox(app.INFO_DEBUG) return def main(args=None): macro = { \u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;mostrar_info\u0026#39;, } app.macro.call(macro) return Ejecutar una macro compartida en LibreOffice Macros.\nmacro = { \u0026#39;library\u0026#39;: \u0026#39;HelloWorld\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;HelloWorldPython\u0026#39;, \u0026#39;location\u0026#39;: \u0026#39;share\u0026#39;, } app.macro.call(macro) Ejecutar una macro Basic.\nSub mostrar_info() MsgBox \u0026#34;Mejor usa Python :)\u0026#34; End Sub macro = { \u0026#39;language\u0026#39;: \u0026#39;Basic\u0026#39;, \u0026#39;library\u0026#39;: \u0026#39;Standard\u0026#39;, \u0026#39;module\u0026#39;: \u0026#39;Module1\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;mostrar_info\u0026#39;, } app.macro.call(macro) Cualquier macro se puede ejecutar en otro hilo.\napp.macro.call(macro, True) Más información en: Scripting Framework URI Specification\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/timer/",
- "title": "Timer",
- "tags": [],
- "description": "",
- "content": "El timer siempre se ejecuta en otro hilo.\nonce Ejecutar macro una sola vez en X segundos.\nimport easymacro as app NOMBRE = \u0026#39;reloj\u0026#39; def mostrar_hora(): app.debug(app.dates.now_time) return def iniciar_conteo(): segundos = 5 macro = { \u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;mostrar_hora\u0026#39;, } app.timer.once(NOMBRE, segundos, macro) return def main(args=None): iniciar_conteo() return cancel Cancelar ejecución, antes del tiempo establecido.\ndef main(args=None): iniciar_conteo() app.sleep(3) detener_conteo() return def detener_conteo(): app.timer.cancel(NOMBRE) return 16/08/2022 21:18:50 - INFO - Event: \u0026#34;reloj\u0026#34;, started... execute in 60 seconds 16/08/2022 21:18:55 - INFO - Cancel event: \u0026#34;reloj\u0026#34;, ok... start Ejecutar macro cada X segundos.\nNOMBRE = \u0026#39;reloj\u0026#39; def mostrar_hora(): app.debug(app.dates.now_time) return def iniciar_reloj(): segundos = 1 macro = { \u0026#39;library\u0026#39;: \u0026#39;test\u0026#39;, \u0026#39;name\u0026#39;: \u0026#39;mostrar_hora\u0026#39;, } app.timer.start(NOMBRE, segundos, macro) return def main(args=None): iniciar_reloj() return stop Detener timer.\ndef detener_reloj(): app.timer.stop(NOMBRE) return 16/08/2022 21:25:37 - INFO - Timer \u0026#39;reloj\u0026#39; started, execute macro: \u0026#39;mostrar_hora\u0026#39; 16/08/2022 21:25:38 - DEBUG - 21:25:38 16/08/2022 21:25:39 - DEBUG - 21:25:39 ... 16/08/2022 21:25:47 - DEBUG - 21:25:47 16/08/2022 21:25:48 - DEBUG - 21:25:48 16/08/2022 21:25:48 - INFO - Timer stopped... Asegurese siempre de establecer un nombre único para cada timer.\nAsegurese siempre de ejecutar macros que NO bloqueen la interfaz del usuario.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/url/",
- "title": "URL",
- "tags": [],
- "description": "",
- "content": "get Método get.\ndef prueba_get(): url = \u0026#39;https://api.ipify.org\u0026#39; respuesta = app.url.get(url) if respuesta.status_code == 200: mi_ip = respuesta.body.decode() app.debug(f\u0026#39;IP: {mi_ip}\u0026#39;) else: app.debug(respuesta.status_code) return 16/08/2022 22:14:13 - DEBUG - IP: 199.203.174.159 Respuestas en formato json.\ndef prueba_get(): url = \u0026#39;https://api.ipify.org/?format=json\u0026#39; respuesta = app.url.get(url) if respuesta.status_code == 200: datos = respuesta.json() app.debug(f\u0026#39;IP: {datos[\u0026#34;ip\u0026#34;]}\u0026#39;) else: app.debug(respuesta.status_code) return "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tools/utils/",
- "title": "Utilidades",
- "tags": [],
- "description": "",
- "content": "dict_to_property Convertir diccionarios en PropertyValue\ndatos = { \u0026#39;Hidden\u0026#39;: True, \u0026#39;Password\u0026#39;: \u0026#39;letmein\u0026#39;, } propiedades = app.dict_to_property(datos) app.msgbox(propiedades) data_to_dict Convertir PropertyValue en diccionarios\ndatos = app.data_to_dict(propiedades) app.msgbox(datos) Convertir tuplas a diccionario.\ntupla_de_tuplas = ( (\u0026#39;Hidden\u0026#39;, True), (\u0026#39;Password\u0026#39;, \u0026#39;letmein\u0026#39;), ) datos = app.data_to_dict(tupla_de_tuplas) app.msgbox(datos) Convertir listas a diccionario.\nlista_de_listas = [ [\u0026#39;Hidden\u0026#39;, True], [\u0026#39;Password\u0026#39;, \u0026#39;letmein\u0026#39;], ] datos = app.data_to_dict(lista_de_listas) app.msgbox(datos) sleep Hacer una pausa de X segundos.\napp.sleep(5) render Reemplazar variables en cadenas de texto.\nplantilla = \u0026#34;\u0026#34;\u0026#34;Hola $nombre Te envío este archivo: $archivo Saludos cordiales \u0026#34;\u0026#34;\u0026#34; datos = { \u0026#39;nombre\u0026#39;: \u0026#39;Ingrid Bergman\u0026#39;, \u0026#39;archivo\u0026#39;: \u0026#39;carta_de_amor.odt\u0026#39; } resultado = app.render(plantilla, datos) app.msgbox(resultado) run Ejecutar un programa.\nnombre_aplicacion = \u0026#39;gnome-calculator\u0026#39; app.shell.run(nombre_aplicacion) Ejecutar comandos shell y capturar la salida.\ncomandos = \u0026#39;ls -lh ~\u0026#39; resultado = app.shell.run(comandos, True) app.debug(resultado) drwxr-xr-x 4 mau mau 4.0K Aug 15 23:36 Desktop drwxr-xr-x 6 mau mau 4.0K Jun 9 23:32 Documents drwxr-xr-x 5 mau mau 4.0K Aug 16 13:09 Downloads drwxr-xr-x 3 mau mau 4.0K Aug 14 15:19 Pictures drwxr-xr-x 10 mau mau 4.0K Jun 19 19:36 Projects drwxr-xr-x 2 mau mau 4.0K May 11 22:36 Templates drwxr-xr-x 2 mau mau 4.0K Jul 19 13:37 Videos Ejectuar comandos y capturar la salida línea a línea.\ncomandos = \u0026#39;ls -lh /home/mau\u0026#39; for line in app.shell.popen(comandos): app.debug(line) digest Obtener hash. Por default se regresa en hexadecimal.\ndatos = \u0026#39;LibreOffice con Python\u0026#39; digest = app.hash.digest(\u0026#39;md5\u0026#39;, datos) app.debug(\u0026#39;MD5 = \u0026#39;, digest) digest = app.hash.digest(\u0026#39;sha1\u0026#39;, datos) app.debug(\u0026#39;SHA1 = \u0026#39;, digest) digest = app.hash.digest(\u0026#39;sha256\u0026#39;, datos) app.debug(\u0026#39;SHA256 = \u0026#39;, digest) digest = app.hash.digest(\u0026#39;sha512\u0026#39;, datos) app.debug(\u0026#39;SHA512 = \u0026#39;, digest) 16/08/2022 18:48:07 - DEBUG - MD5 = 3801759ead20abc3ce0d0095289bdcfd 16/08/2022 18:48:07 - DEBUG - SHA1 = 1df74aaae9658c21074aa5a2d4c2055dcf79f0db 16/08/2022 18:48:07 - DEBUG - SHA256 = 228e90b15b6259307e580677939b1f2f45e9317461e98f603af8fcac0f9a598f 16/08/2022 18:48:07 - DEBUG - SHA512 = 3ef45f79f3bfd2b251d250489c91b631306456405510397fb1a7ee37005d196376b7d6ca86a9895f4eb97eb74813965c24d6564a383f4bdb1360665c8fbb192a Para obtener bytes.\ndigest = app.hash.digest(\u0026#39;md5\u0026#39;, datos, False) app.debug(\u0026#39;MD5 = \u0026#39;, digest) 16/08/2022 18:48:07 - DEBUG - MD5 = b\u0026#39;8\\x01u\\x9e\\xad \\xab\\xc3\\xce\\r\\x00\\x95(\\x9b\\xdc\\xfd\u0026#39; config Puede guardar datos de configuración de su macro o extensión dentro del perfil de usuario.\nnombre = \u0026#39;mi_extension\u0026#39; datos = { \u0026#39;ruta\u0026#39;: \u0026#39;/home/mau/pruebas\u0026#39;, \u0026#39;guardar\u0026#39;: True, } if app.config.set(nombre, datos): app.debug(\u0026#39;Configuración guardada...\u0026#39;) Y recuperarlos en cualquier momento.\ndatos = app.config.get(nombre) app.debug(datos) color Puede ver los colores que puede usar en Wikipedia Colores Web\ncolor_nombre = \u0026#39;darkblue\u0026#39; color = app.color(color_nombre) app.debug(color) color_rgb = (125, 200, 10) color = app.color(color_rgb) app.debug(color) color_html = \u0026#39;#008080\u0026#39; color = app.color(color_html) app.debug(color) "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/dialog/",
- "title": "Cuadros de diálogo",
- "tags": [],
- "description": "",
- "content": "Trabajar con cuadros de diálogo create Desde archivo Crear un cuadro de diálogo desde un archivo xdl previamente creado desde el editor de cuadros de diálogo dentro de LibreOffice y exportado a un archivo.\ndef crear_cuadro_de_dialogo(): path = \u0026#39;/home/mau/Desktop/Dialog1.xdl\u0026#39; propiedades = {\u0026#39;Path\u0026#39;: path} dialog = app.dialog.create(propiedades) dialog.open() return Desde mis macros Si el cuadro de diálogo esta en la librería Standard.\ndef crear_cuadro_de_dialogo(): propiedades = { \u0026#39;Location\u0026#39;: \u0026#39;user\u0026#39;, \u0026#39;Name\u0026#39;: \u0026#39;Dialog1\u0026#39;, } dialog = app.dialog.create(propiedades) dialog.open() return Si el cuadro de diálogo esta en otra librería.\ndef crear_cuadro_de_dialogo(): propiedades = { \u0026#39;Location\u0026#39;: \u0026#39;user\u0026#39;, \u0026#39;Library\u0026#39;: \u0026#39;MiAplicacion\u0026#39;, \u0026#39;Name\u0026#39;: \u0026#39;Dialog2\u0026#39;, } dialog = app.dialog.create(propiedades) dialog.open() return Si el cuadro de diálogo esta en el documento activo en la librería Standard.\ndef crear_cuadro_de_dialogo(): propiedades = { \u0026#39;Location\u0026#39;: \u0026#39;document\u0026#39;, \u0026#39;Name\u0026#39;: \u0026#39;miApp\u0026#39;, } dialog = app.dialog.create(propiedades) dialog.open() return Crear dinámicamente Crear un cuadro de diálogo vacío.\ndef crear_cuadro_de_dialogo(): dialog = app.dialog.create() dialog.open() return "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/",
- "title": "",
- "tags": [],
- "description": "",
- "content": "Documentación de easymacro! Software Libre, no software gratis. easymacro es una librería para desarrollar más fácilmente macros en LibreOffice con Python. Es una capa de abstracción entre la extensa y compleja API UNO de LibreOffice y tu código.\nProbablemente, será más feliz si la usa :)\nPuede utilizar easymacro con cualquier extensión o directamente en sus macros.\nAportaciones en Junas (G1)\nA5DdXxCKPw3QKWVdDVs7CzkNugNUW1sHu5zDJFWxCU2h Este proyecto esta en continuo desarrollo.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/categories/",
- "title": "Categories",
- "tags": [],
- "description": "",
- "content": ""
-},
-{
- "uri": "https://doc.cuates.net/easymacro/es/tags/",
- "title": "Tags",
- "tags": [],
- "description": "",
- "content": ""
-}]
\ No newline at end of file
diff --git a/doc/public/es/index.xml b/doc/public/es/index.xml
deleted file mode 100644
index 255a290..0000000
--- a/doc/public/es/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Instalación -
- - - - - - -Clonar repositorio
-Clone el repositorio en su directorio de proyectos favorito.
-git clone https://git.cuates.net/elmau/easymacro
-Muévase al directorio
-cd easymacro/source
-copie la carpeta easymacro a la carpeta pythonpath en la carpeta de macros Python dentro de su perfil de usuario. Reemplace USUARIO por su usuario real.
/home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/pythonpath
-o use un vínculo simbólico. Reemplace RUTA_ABSOLUTA por la ruta absoluta donde se localice easymacro en su sistema de archivos y USUARIO por su nombre de usuario.
-ln -s `RUTA_ABSOLUTA`/easymacro/source/easymacro /home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/pythonpath/
-Probar
-En su archivo de macros favorito, por ejemplo mismacros.py. Use su editor de texto plano o IDE favorito.
-vim /home/`USUARIO`/.config/libreoffice/4/user/Scripts/python/mismacros.py
-Copie el siguiente código:
-import easymacro as app
-
-def main():
- app.msgbox(app.INFO_DEBUG)
- return
-Ejecute la macro main desde LibreOffice, si ve un cuadro de mensaje con información similar a la siguiente, !felicidades¡
-
Esta todo listo para empezar a desarrollar macros con easymacro.
-!Feliz programación!
- - - - - - - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/installation/index.xml b/doc/public/es/installation/index.xml
deleted file mode 100644
index 3997991..0000000
--- a/doc/public/es/installation/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - tag :: - - Tags -
- - - - - - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tags/index.xml b/doc/public/es/tags/index.xml
deleted file mode 100644
index a94ac6d..0000000
--- a/doc/public/es/tags/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Fechas y tiempo -
- - - - - - - -La fecha inicial en Calc y en Python es diferente.
-today
-Obtener la fecha de hoy.
-d = app.dates
-app.msgbox(d.today)
-now
-Obtener la fecha y hora actuales.
-d = app.dates
-app.msgbox(d.now)
-time
-Obtener la hora actual.
-d = app.dates
-app.msgbox(d.now.time())
-epoch
-Obtener el tiempo Unix
-d = app.dates
-app.msgbox(d.epoch)
-date
-Devolver una fecha
-d = app.dates
-
-date = d.date(1974, 1, 15)
-app.msgbox(date)
-time
-Devolver un tiempo
-d = app.dates
-
-time = d.time(10, 20, 15)
-app.msgbox(time)
-datetime
-Devolver fecha y hora
-d = app.dates
-
-dt = d.datetime(1974, 1, 15, 10, 11, 12)
-app.msgbox(dt)
-str_to_date
-Convertir una cadena en fecha. Mira este excelente recurso
-d = app.dates
-
-cadena = '1974-01-15'
-plantilla = '%Y-%m-%d'
-fecha = d.str_to_date(cadena, plantilla)
-app.msgbox(fecha)
-app.msgbox(type(fecha))
-Para obtener un valor válido para establecer en una celda de Calc.
-d = app.dates
-
-cadena = '1974-01-15'
-plantilla = '%Y-%m-%d'
-fecha = d.str_to_date(cadena, plantilla, True)
-app.msgbox(fecha)
-app.msgbox(type(fecha))
-calc_to_date
-Convierte el valor de una celda en una fecha Python, por ejemplo, la fecha inicial configurada en Calc.
-d = app.dates
-
-value_from_cell = 1
-fecha = d.calc_to_date(value_from_cell)
-app.msgbox(fecha)
-app.msgbox(type(fecha))
-start y end
-Medir tiempo en segundos.
-d = app.dates
-
-d.start()
-app.sleep(5)
-seconds = d.end()
-app.msgbox(seconds)
-Regresar timedelta en vez de segundos.
-d = app.dates
-
-d.start()
-app.sleep(5)
-td = d.end(False)
-app.msgbox(td)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/dates_and_time/index.xml b/doc/public/es/tools/dates_and_time/index.xml
deleted file mode 100644
index 96593af..0000000
--- a/doc/public/es/tools/dates_and_time/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Correo electrónico -
- - - - - - -Enviar correo electrónico.
- -Siempre guarda las contraseñas de la forma más segura posible.
-send
-Enviar un correo electrónico.
-from conf import PASSWORD
-
-SERVER = dict(
- server = 'mail.correo.net' ,
- port = 405,
- ssl = True,
- user = 'no-responder@pruebas.mx',
- password = PASSWORD,
-)
-
-body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales"
-
-message = dict(
- to = 'ingrid@bergman.mx',
- subject = 'Te amo...',
- body = body,
-)
-
-app.email.send(SERVER, message)
-Puede usar los campos cc (Con Copia) y bcc (Con Copia Oculta), así como separar por comas las direcciones destino para enviar a más de un correo.
to = 'mail1@correo.com,mail2@correo.com,mail3@correo.com'
-cc = 'otro@correo.com'
-bcc = 'oculto@correo.com'
-Podemos enviar más de un mensaje.
-mensaje1 = dict(
- to = 'ingrid@correo.net',
- subject = 'Te amo...',
- body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales",
-)
-mensaje2 = dict(
- to = 'sophia@correo.net',
- subject = 'A ti también...',
- body = "Hola Sophia\n\n¿Como estas?\n\nSaludos cordiales",
-)
-mensajes = (mensaje1, mensaje2)
-
-app.email.send(SERVER, mensajes)
-16/08/2022 13:01:49 - DEBUG - Connect to: mail.server.net
-16/08/2022 13:01:50 - DEBUG - Email sent...
-16/08/2022 13:01:51 - DEBUG - Email sent...
-16/08/2022 13:01:51 - DEBUG - Close connection...
-Enviar un archivo adjunto.
-archivo = '/home/mau/temp.txt'
-mensaje = dict(
- to = 'ingrid@bergman.mx',
- subject = 'Te amo...',
- body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales",
- files = archivo,
-)
-
-app.email.send(SERVER, mensaje)
-O varios.
-archivos = (
- '/home/mau/temp.txt',
- '/home/mau/datos.csv',
-)
-Si tu cliente de correo usa el formato mbox, puede guardar los correos enviados en una carpeta dentro de la configuración de su cliente de correo.
ruta = '/home/mau/.thunderbird/7iznrbyw.default/Mail/Local Folders/LibreOffice'
-mensaje = dict(
- to = 'ingrid@bergman.mx',
- subject = 'Te amo...',
- body = "Hola Ingrid\n\n¿Como estas?\n\nSaludos cordiales",
- path = ruta,
-)
-
-app.email.send(SERVER, mensaje)
-Todos los correos se envían siempre en otro hilo de ejecución.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/email/index.xml b/doc/public/es/tools/email/index.xml
deleted file mode 100644
index e68463e..0000000
--- a/doc/public/es/tools/email/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Herramientas -
- - - - - - -Recuerda, es necesario importar la librería.
-import easymacro as app
-Información sobre la PC
-OS
-Obtener el sistema operativo.
-app.msgbox(app.OS)
-DESKTOP
-Obtener el tipo de escritorio, solo en GNU/Linux.
-app.msgbox(app.DESKTOP)
-PC
-Obtener el nombre de la computadora.
-app.msgbox(app.PC)
-USER
-Obtener el nombre de usuario.
-app.msgbox(app.USER)
-IS_WIN
-Saber si estamos en Windows.
-app.msgbox(app.IS_WIN)
-IS_MAC
-Saber si estamos en OSX.
-app.msgbox(app.IS_MAC)
-Información sobre LibreOffice
-NAME
-Nombre de la aplicación.
-app.msgbox(app.NAME)
-VERSION
-Versión de la aplicación.
-app.msgbox(app.VERSION)
-LANG
-Lenguaje de la aplicación.
-app.msgbox(app.LANG)
-LANGUAGE
-Lenguaje con variante.
-app.msgbox(app.LANGUAGE)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/index.xml b/doc/public/es/tools/index.xml
deleted file mode 100644
index c5e10ff..0000000
--- a/doc/public/es/tools/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Ejecutar macros -
- - - - - - -Ejecutar cualquier macro, de forma predeterminada se llaman a las macros en Python localizadas en el perfil de usuario.
-import easymacro as app
-
-
-def mostrar_info():
- app.msgbox(app.INFO_DEBUG)
- return
-
-
-def main(args=None):
- macro = {
- 'library': 'test',
- 'name': 'mostrar_info',
- }
- app.macro.call(macro)
- return
-Ejecutar una macro compartida en LibreOffice Macros.
-macro = {
- 'library': 'HelloWorld',
- 'name': 'HelloWorldPython',
- 'location': 'share',
-}
-app.macro.call(macro)
-Ejecutar una macro Basic.
-Sub mostrar_info()
- MsgBox "Mejor usa Python :)"
-End Sub
-macro = {
- 'language': 'Basic',
- 'library': 'Standard',
- 'module': 'Module1',
- 'name': 'mostrar_info',
-}
-app.macro.call(macro)
-Cualquier macro se puede ejecutar en otro hilo.
-app.macro.call(macro, True)
-Más información en: Scripting Framework URI Specification
- - - - - - - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/macros/index.xml b/doc/public/es/tools/macros/index.xml
deleted file mode 100644
index 8b3be1a..0000000
--- a/doc/public/es/tools/macros/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Mensajes -
- - - - - - -Cuadros de mensaje
-msgbox
-Mostrar mensaje estandar.
-mensaje = 'Maldito Mundo'
-titulo = 'Mi Macro'
-app.msgbox(mensaje, titulo)
-warning
-Mostrar mensaje con icono de advertencia.
-mensaje = 'Cuidado, esta acción es peligrosa'
-titulo = 'Mi Macro'
-app.warning(mensaje, titulo)
-errorbox
-Mostrar mensaje con icono de error.
-mensaje = 'ERROR: contacte a soporte'
-titulo = 'Mi Macro'
-app.errorbox(mensaje, titulo)
-question
-Hacer una pregunta mostrando el icono de interrogación y mostrando los botones de comando Si y No. La respuesta siempre es verdadera (True) si el usuario selecciona si y falsa (False) en caso contrario.
mensaje = '¿Es fácil Python?'
-titulo = 'Mi Macro'
-resultado = app.question(mensaje, titulo)
-app.msgbox(resultado)
-inputbox
-Muestra un mensaje al usuario, permitiendo capturar una respuesta.
-mensaje = 'Escribe tu nombre'
-nombre = app.inputbox(mensaje)
-app.msgbox(nombre)
-Para ocultar solo en pantalla lo que captura el usuario, como contraseñas.
-mensaje = 'Captura la contraseña'
-echochar = '*'
-contraseña = app.inputbox(mensaje, echochar=echochar)
-app.msgbox(contraseña)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/messages/index.xml b/doc/public/es/tools/messages/index.xml
deleted file mode 100644
index 572ede1..0000000
--- a/doc/public/es/tools/messages/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Rutas y archivos -
- - - - - - -Trabajar con rutas y archivos.
-path
-Obtener información de una ruta.
-ruta_archivo = '/home/mau/mi_archivo.ods'
-p = app.paths(ruta_archivo)
-
-app.debug(p.path)
-app.debug(p.file_name)
-app.debug(p.name)
-app.debug(p.ext)
-app.debug(p.size)
-app.debug(p.url)
-15/08/2022 14:40:08 - DEBUG - /home/mau
-15/08/2022 14:40:08 - DEBUG - mi_archivo.ods
-15/08/2022 14:40:08 - DEBUG - mi_archivo
-15/08/2022 14:40:08 - DEBUG - ods
-15/08/2022 14:40:08 - DEBUG - 7011
-15/08/2022 14:40:08 - DEBUG - file:///home/mau/mi_archivo.ods
-Obtener la misma información como un tupla.
-ruta_archivo = '/home/mau/mi_archivo.ods'
-p = app.paths(ruta_archivo)
-app.debug(p.info)
-15/08/2022 14:43:01 - DEBUG - ('/home/mau', 'mi_archivo.ods', 'mi_archivo', 'ods', 7011, 'file:///home/mau/mi_archivo.ods')
-O como diccionario.
-ruta_archivo = '/home/mau/mi_archivo.ods'
-p = app.paths(ruta_archivo)
-app.debug(p.dict)
-15/08/2022 14:43:01 - DEBUG - {'path': '/home/mau', 'file_name': 'mi_archivo.ods', 'name': 'mi_archivo', 'ext': 'ods', 'size': 7011, 'url': 'file:///home/mau/mi_archivo.ods'}
-home
-Obtener la carpeta de inicio del usuario.
-p = app.paths
-app.debug(p.home)
-documents
-Obtener la carpeta Documentos del usuario.
-p = app.paths
-app.debug(p.documents)
-user_profile
-Obtener la ruta del perfil de usuario.
-p = app.paths
-app.debug(p.user_profile)
-user_config
-Obtener la ruta de la carpeta config en el perfil de usuario.
p = app.paths
-app.debug(p.user_config)
-python
-Obtener la ruta del ejecutable python
p = app.paths
-app.debug(p.python)
-to_system
-Pasar una ruta en formato URL al formato del sistema de archivos del SO.
-p = app.paths
-ruta_url = 'file:///home/mau/mi_archivo.ods'
-ruta = p.to_system(ruta_url)
-app.debug(ruta)
-to_url
-Pasar una ruta del sistema de archivos del SO al formato URL.
-p = app.paths
-ruta = '/home/mau/mi_archivo.ods'
-ruta_url = p.to_url(ruta)
-app.debug(ruta_url)
-config
-Obtener rutas de la configuración de LibreOffice. Por default obtiene la ruta de Documentos, para otras ruta mire Api XPathSettings
p = app.paths
-ruta = p.config()
-app.debug(ruta)
-
-ruta = p.config('UserConfig')
-app.debug(ruta)
-Algunas rutas pueden ser más de una, separados por ;, en este caso, el resultado es una lista con las rutas.
join
-Concatenar rutas.
-p = app.paths
-ruta = p.join('/home/mau', 'pruebas', 'archivo.ods')
-app.debug(ruta)
-exists
-Verificar si una ruta existe.
-p = app.paths
-resultado = p.exists('/home/mau/test/archivo.ods')
-app.debug(resultado)
-exists_app
-Verificar si una aplicación existe.
-p = app.paths
-
-resultado = p.exists_app('noexiste')
-app.debug(resultado)
-
-resultado = p.exists_app('soffice')
-app.debug(resultado)
-is_dir
-Verificar si la ruta es un directorio.
-p = app.paths
-resultado = p.is_dir('/home/mau')
-app.debug(resultado)
-is_file
-Verificar si la ruta es un archivo.
-p = app.paths
-resultado = p.is_file('/home/mau/mi_archivo.ods')
-app.debug(resultado)
-temp_file
-Crear un archivo temporal, es borrado automáticamente al cerrarse.
-p = app.paths
-
-f = p.temp_file()
-f.write(app.INFO_DEBUG)
-f.close()
-Usado en contexto, se cierra automáticamente.
with p.temp_file() as f:
- app.debug(f.name)
- f.write('test')
-temp_dir
-Crear un directorio temporal, al salir del contexto, es eliminado junto con todo su contenido del sistema de archivos.
-p = app.paths
-
-with p.temp_dir() as d:
- app.debug(p.exists(d))
- app.debug(d)
-
-app.debug(p.exists(d))
-get
-Permitir al usuario seleccionar archivos, devuelve solo la ruta. De forma predeterminada abre en la carpeta Documentos.
p = app.paths
-ruta = p.get()
-app.debug(ruta)
-Establecer que abra en otro directorio.
-ruta = p.get('/tmp')
-app.debug(ruta)
-Agregar un filtro.
-ruta = p.get(filters='ods')
-app.debug(ruta)
-Agregar multiples filtros.
-ruta = p.get(filters='xml,txt')
-app.debug(ruta)
-Permitir selecciones multiples.
-ruta = p.get(filters='xml,txt', multiple=True)
-app.debug(ruta)
-get_dir
-Permitir al usuario seleccionar un directorio, devuelve solo la ruta. De forma predeterminada abre en la carpeta Documentos.
p = app.paths
-ruta = p.get_dir()
-app.debug(ruta)
-Establecer que abra en otro directorio.
-ruta = p.get_dir('/tmp')
-app.debug(ruta)
-get_for_save
-Permitir seleccionar un directorio y capturar el nombre del archivo, devuelve la ruta completa.
-p = app.paths
-ruta = p.get_for_save()
-app.debug(ruta)
-Establecer que inicie en otro directorio.
-ruta = p.get_for_save('/tmp')
-app.debug(ruta)
-Si se establece un filtro, automáticamente se agrega la extensión.
-ruta = p.get_for_save(filters='txt')
-app.debug(ruta)
-files
-Obtener archivos de una ruta, no recursivamente. De forma predeterminada regresa todos, incluyendo archivos ocultos.
-ruta = '/home/mau'
-
-p = app.paths
-archivos = p.files(ruta)
-for a in archivos:
- app.debug(a)
-Filtrar por tipo de archivo.
-p = app.paths
-archivos = p.files(ruta, '*.pdf')
-Obtener archivos de forma recursiva.
-p = app.paths
-archivos = p.files(ruta, '**/*.xml')
-walk
-Obtener archivos de forma recursiva.
-p = app.paths
-ruta = '/home/mau/Documents'
-archivos = p.walk(ruta)
-for a in archivos:
- app.debug(a)
-Con filtro.
-archivos = p.walk(ruta, 'ods')
-Con filtros.
-archivos = p.walk(ruta, 'ods|odt')
-dirs
-Obtener los directorios de una ruta, no recursivamente.
-p = app.paths
-ruta = '/home/mau/Documents'
-folders = p.dirs(ruta)
-for f in folders:
- app.debug(f)
-walk_dirs
-Obtener los directorios de una ruta, no recursivamente.
-p = app.paths
-ruta = '/home/mau/Documents'
-folders = p.walk_dirs(ruta)
-for f in folders:
- app.debug(f)
-Obtener información en una lista de tuplas: (ID_FOLDER, ID_PADRE, NOMBRE)
-folders = p.walk_dirs(ruta, True)
-extension
-Obtener la ruta de instalación de una extensión a partir de su ID.
-p = app.paths
-id_ext = 'net.elmau.zaz.talk'
-ruta = p.extension(id_ext)
-app.debug(ruta)
-replace_ext
-Reemplazar extensión de un archivo.
-p = app.paths
-ruta = '/home/mau/mi_archivo.ods'
-ruta_nueva = p.replace_ext(ruta, 'pdf')
-app.debug(ruta_nueva)
-open
-Abrir cualquier archivo con el programas predeterminado del SO.
-p = app.paths
-ruta = '/home/mau/archivo.pdf'
-p.open(ruta)
-
-ruta = '/home/mau/index.html'
-p.open(ruta)
-save y read
-Guardar y leer datos, el encoding predeterminado es UTF8.
-p = app.paths
-datos = """¿Quieres saber quién eres? No preguntes. Actúa.
-La acción te delineará y definirá.
-
-Thomas Jefferson
-"""
-
-ruta = '/home/mau/temp.txt'
-p.save(ruta, datos)
-
-datos = p.read(ruta)
-app.msgbox(datos)
-Cambiar el encoding.
-app.paths.save(ruta, datos, 'iso-8859-1')
-save_bin y read_bin
-Guardar y leer datos binarios.
-p = app.paths
-datos = b'Datos binarios'
-
-ruta = '/home/mau/temp.bin'
-p.save_bin(ruta, datos)
-
-datos = p.read_bin(ruta)
-app.msgbox(datos)
-save_json y read_json
-Guardar y leer en formato json.
-p = app.paths
-
-ruta = '/home/mau/datos.json'
-datos = {
- 'tipo': 'calc',
- 'nombre': 'miarchivo.ods',
-}
-p.save_json(ruta, datos)
-
-datos = p.read_json(ruta)
-app.msgbox(datos)
-save_csv y read_csv
-Exportar e importar datos en formato CSV. Vea la documentación CSV para los argumentos que puede usar.
-p = app.paths
-
-ruta = '/home/mau/datos.csv'
-ahora = app.dates.now
-datos = (
- (1, 'uno', ahora),
- (2, 'dos', ahora),
- (3, 'tres', ahora),
-)
-p.save_csv(ruta, datos)
-
-datos = p.read_csv(ruta)
-app.msgbox(datos)
-kill
-Borra archivos o directorios con todo su contenido. Devuelve verdadero (True) en caso de exito y falso (Falso) en cualquier otro caso.
- -Este proceso es destructivo, es buena practica siempre solicitar confirmación al usuario.
-p = app.paths
-
-ruta = '/home/mau/temp.bin'
-resultado = p.kill(ruta)
-app.msgbox(resultado)
-copy
-Copiar archivos. Devuelve la ruta completa final destino.
-De un origen a una carpeta destino
-p = app.paths
-
-ruta_origen = '/home/mau/temp.txt'
-ruta_destino = '/home/mau/Desktop'
-ruta = p.copy(ruta_origen, ruta_destino)
-app.debug(ruta)
-Cambiar el nombre destino.
-ruta_origen = '/home/mau/temp.txt'
-ruta_destino = '/home/mau/Desktop'
-nuevo_nombre = 'datos.csv'
-ruta = p.copy(ruta_origen, ruta_destino, nuevo_nombre)
-app.debug(ruta)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/paths/index.xml b/doc/public/es/tools/paths/index.xml
deleted file mode 100644
index 75f6ead..0000000
--- a/doc/public/es/tools/paths/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Hilos -
- - - - - - -Ejecutar macros en otros hilos.
-Las macros se ejecutan en un hilo que bloquea cualquier otro proceso dentro de la aplicación.
-Si ejecutas la siguiente macro main, nota que no puedes hacer algo más dentro de LibreOffice durante los 5 segundos que dura el proceso.
import easymacro as app
-
-
-def hacer_pausa(segundos):
- app.sleep(segundos)
- app.debug('He terminado')
- return
-
-def main():
- hacer_pausa(5)
- app.msgbox('Fin...')
- return
-Hasta que aparece el cuadro de mensaje con la palabra Fin y lo cierras, el usuario puede seguir usando la aplicación.
run_in_thread
-Ahora ejecutamos la macro en otro hilo, “decorando” cualquier macro con run_in_thread
@app.run_in_thread
-def hacer_pausa(segundos):
- app.sleep(segundos)
- app.debug('He terminado')
- return
-
-def main():
- hacer_pausa(5)
- app.msgbox('Fin...')
- return
-Nota que ahora el mensaje aparece inmediatamente y no tras los 5 segundos.
- -Ponga mucha atención en no ejecutar macros en otros hilo que dependen de algo suceptible de ser cambiado o interceptado por el usuario, por ejemplo, la celda activa.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/threads/index.xml b/doc/public/es/tools/threads/index.xml
deleted file mode 100644
index 33bffd1..0000000
--- a/doc/public/es/tools/threads/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Timer -
- - - - - - -El timer siempre se ejecuta en otro hilo.
once
-Ejecutar macro una sola vez en X segundos.
-import easymacro as app
-
-
-NOMBRE = 'reloj'
-
-
-def mostrar_hora():
- app.debug(app.dates.now_time)
- return
-
-
-def iniciar_conteo():
- segundos = 5
- macro = {
- 'library': 'test',
- 'name': 'mostrar_hora',
- }
- app.timer.once(NOMBRE, segundos, macro)
- return
-
-
-def main(args=None):
- iniciar_conteo()
- return
-cancel
-Cancelar ejecución, antes del tiempo establecido.
-def main(args=None):
- iniciar_conteo()
- app.sleep(3)
- detener_conteo()
- return
-
-def detener_conteo():
- app.timer.cancel(NOMBRE)
- return
-16/08/2022 21:18:50 - INFO - Event: "reloj", started... execute in 60 seconds
-16/08/2022 21:18:55 - INFO - Cancel event: "reloj", ok...
-start
-Ejecutar macro cada X segundos.
-NOMBRE = 'reloj'
-
-
-def mostrar_hora():
- app.debug(app.dates.now_time)
- return
-
-
-def iniciar_reloj():
- segundos = 1
- macro = {
- 'library': 'test',
- 'name': 'mostrar_hora',
- }
- app.timer.start(NOMBRE, segundos, macro)
- return
-
-def main(args=None):
- iniciar_reloj()
- return
-stop
-Detener timer.
-def detener_reloj():
- app.timer.stop(NOMBRE)
- return
-16/08/2022 21:25:37 - INFO - Timer 'reloj' started, execute macro: 'mostrar_hora'
-16/08/2022 21:25:38 - DEBUG - 21:25:38
-16/08/2022 21:25:39 - DEBUG - 21:25:39
-...
-16/08/2022 21:25:47 - DEBUG - 21:25:47
-16/08/2022 21:25:48 - DEBUG - 21:25:48
-16/08/2022 21:25:48 - INFO - Timer stopped...
-Asegurese siempre de establecer un nombre único para cada timer.
-Asegurese siempre de ejecutar macros que NO bloqueen la interfaz del usuario.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/timer/index.xml b/doc/public/es/tools/timer/index.xml
deleted file mode 100644
index da632cc..0000000
--- a/doc/public/es/tools/timer/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - URL -
- - - - - - -get
-Método get.
def prueba_get():
-
- url = 'https://api.ipify.org'
- respuesta = app.url.get(url)
- if respuesta.status_code == 200:
- mi_ip = respuesta.body.decode()
- app.debug(f'IP: {mi_ip}')
- else:
- app.debug(respuesta.status_code)
-
- return
-16/08/2022 22:14:13 - DEBUG - IP: 199.203.174.159
-Respuestas en formato json.
-def prueba_get():
-
- url = 'https://api.ipify.org/?format=json'
- respuesta = app.url.get(url)
- if respuesta.status_code == 200:
- datos = respuesta.json()
- app.debug(f'IP: {datos["ip"]}')
- else:
- app.debug(respuesta.status_code)
-
- return
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/url/index.xml b/doc/public/es/tools/url/index.xml
deleted file mode 100644
index 09585f0..0000000
--- a/doc/public/es/tools/url/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Utilidades -
- - - - - - -dict_to_property
-Convertir diccionarios en PropertyValue
-datos = {
- 'Hidden': True,
- 'Password': 'letmein',
-}
-propiedades = app.dict_to_property(datos)
-
-app.msgbox(propiedades)
-data_to_dict
-Convertir PropertyValue en diccionarios
datos = app.data_to_dict(propiedades)
-app.msgbox(datos)
-Convertir tuplas a diccionario.
tupla_de_tuplas = (
- ('Hidden', True),
- ('Password', 'letmein'),
-)
-datos = app.data_to_dict(tupla_de_tuplas)
-app.msgbox(datos)
-Convertir listas a diccionario.
lista_de_listas = [
- ['Hidden', True],
- ['Password', 'letmein'],
-]
-datos = app.data_to_dict(lista_de_listas)
-app.msgbox(datos)
-sleep
-Hacer una pausa de X segundos.
-app.sleep(5)
-render
-Reemplazar variables en cadenas de texto.
-plantilla = """Hola $nombre
-
-Te envío este archivo: $archivo
-
-Saludos cordiales
-"""
-
-datos = {
- 'nombre': 'Ingrid Bergman',
- 'archivo': 'carta_de_amor.odt'
-}
-
-resultado = app.render(plantilla, datos)
-
-app.msgbox(resultado)
-run
-Ejecutar un programa.
-nombre_aplicacion = 'gnome-calculator'
-app.shell.run(nombre_aplicacion)
-Ejecutar comandos shell y capturar la salida.
-comandos = 'ls -lh ~'
-resultado = app.shell.run(comandos, True)
-app.debug(resultado)
-drwxr-xr-x 4 mau mau 4.0K Aug 15 23:36 Desktop
-drwxr-xr-x 6 mau mau 4.0K Jun 9 23:32 Documents
-drwxr-xr-x 5 mau mau 4.0K Aug 16 13:09 Downloads
-drwxr-xr-x 3 mau mau 4.0K Aug 14 15:19 Pictures
-drwxr-xr-x 10 mau mau 4.0K Jun 19 19:36 Projects
-drwxr-xr-x 2 mau mau 4.0K May 11 22:36 Templates
-drwxr-xr-x 2 mau mau 4.0K Jul 19 13:37 Videos
-Ejectuar comandos y capturar la salida línea a línea.
-comandos = 'ls -lh /home/mau'
-for line in app.shell.popen(comandos):
- app.debug(line)
-digest
-Obtener hash. Por default se regresa en hexadecimal.
- datos = 'LibreOffice con Python'
-
- digest = app.hash.digest('md5', datos)
- app.debug('MD5 = ', digest)
-
- digest = app.hash.digest('sha1', datos)
- app.debug('SHA1 = ', digest)
-
- digest = app.hash.digest('sha256', datos)
- app.debug('SHA256 = ', digest)
-
- digest = app.hash.digest('sha512', datos)
- app.debug('SHA512 = ', digest)
-16/08/2022 18:48:07 - DEBUG - MD5 = 3801759ead20abc3ce0d0095289bdcfd
-16/08/2022 18:48:07 - DEBUG - SHA1 = 1df74aaae9658c21074aa5a2d4c2055dcf79f0db
-16/08/2022 18:48:07 - DEBUG - SHA256 = 228e90b15b6259307e580677939b1f2f45e9317461e98f603af8fcac0f9a598f
-16/08/2022 18:48:07 - DEBUG - SHA512 = 3ef45f79f3bfd2b251d250489c91b631306456405510397fb1a7ee37005d196376b7d6ca86a9895f4eb97eb74813965c24d6564a383f4bdb1360665c8fbb192a
-Para obtener bytes.
-digest = app.hash.digest('md5', datos, False)
-app.debug('MD5 = ', digest)
-16/08/2022 18:48:07 - DEBUG - MD5 = b'8\x01u\x9e\xad \xab\xc3\xce\r\x00\x95(\x9b\xdc\xfd'
-config
-Puede guardar datos de configuración de su macro o extensión dentro del perfil de usuario.
-nombre = 'mi_extension'
-datos = {
- 'ruta': '/home/mau/pruebas',
- 'guardar': True,
-}
-
-if app.config.set(nombre, datos):
- app.debug('Configuración guardada...')
-Y recuperarlos en cualquier momento.
-datos = app.config.get(nombre)
-app.debug(datos)
-color
-Puede ver los colores que puede usar en Wikipedia Colores Web
-color_nombre = 'darkblue'
-color = app.color(color_nombre)
-app.debug(color)
-
-color_rgb = (125, 200, 10)
-color = app.color(color_rgb)
-app.debug(color)
-
-color_html = '#008080'
-color = app.color(color_html)
-app.debug(color)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools/utils/index.xml b/doc/public/es/tools/utils/index.xml
deleted file mode 100644
index 144e8a6..0000000
--- a/doc/public/es/tools/utils/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Herramientas para depurar -
- - - - - - -INFO_DEBUG
-Mostrar información de depuración en un cuadro de mensaje.
-Si tiene cualquier problema en su código durante el desarrollo de sus macros, puede abrir un ticket de soporte en el sistema de ticket de este proyecto. Siempre copie la información de depuración mostrada en este mensaje.
-import easymacro as app
-
-def info():
- app.msgbox(app.INFO_DEBUG)
- return
-
debug
-Mostrar información en la terminal.
-import easymacro as app
-
-def test_debug():
- msg = 'Verificar esta información...'
- app.debug(msg)
- return
-11/08/2022 18:15:45 - DEBUG - Verificar esta información...
-info
-Mostrar mensajes informativos en la terminal.
-import easymacro as app
-
-def test_info():
- msg = 'Iniciando proceso...'
- app.info(msg)
- return
-11/08/2022 18:23:53 - INFO - Iniciando proceso...
-error
-Mostrar mensajes de error en la terminal.
-import easymacro as app
-
-def test_error():
- msg = 'Error 505'
- app.error(msg)
- return
-11/08/2022 18:27:34 - ERROR - Error 505
-save_log
-Guardar registro en un archivo, automáticamente se agrega la fecha y hora.
-import easymacro as app
-
-def test_save_log():
-
- app.save_log('/home/mau/log.txt', 'PyUNO')
- app.save_log('/home/mau/log.txt', 'Maldito Mundo')
-
- return
-cat ~/log.txt
-2022-08-11 18:30:11 - 'PyUNO'
-2022-08-11 18:30:11 - 'Maldito Mundo'
-msgbox
-Mostrar cualquier información en un cuadro de mensaje.
-def message():
-
- msg = 'Por favor, consume menos.'
- app.msgbox(msg)
-
- msg = ('uno', 2, 'tres')
- app.msgbox(msg)
-
- msg = {'nombre': 'Teresa'}
- app.msgbox(msg)
-
- app.msgbox(app)
-
- return
-catch_exception
-Capturar cualquier error que se produzca al ejecutar una macro.
-@app.catch_exception
-def test_capturar_error():
- r = 1 / 0
- return
-11/08/2022 18:44:36 - ERROR - test_capturar_error
-Traceback (most recent call last):
- File "/home/mau/.config/libreoffice/4/user/Scripts/python/pythonpath/easymacro/easytools.py", line 115, in func
- return f(*args, **kwargs)
- File "/home/mau/.config/libreoffice/4/user/Scripts/python/test.py", line 18, in test_capturar_error
- r = 1 / 0
-ZeroDivisionError: division by zero
-Usa este método solo en tiempo de desarrollo. No la uses en producción.
-mri
-MRI es la mejor extensión para inspeccionar cualquier objeto UNO de LibreOffice. Necesita instalarla primero para poder llamarla.
-def inspeccionar_objeto():
- obj = app.active
- app.mri(obj)
- return
-inspect
-Inspeccionar un objeto.
-def inspeccionar_objeto():
- doc = app.active
- data = app.inspect(doc)
- for p in data.properties:
- app.debug(p)
- for m in data.methods:
- app.debug(m)
- return
-Vaciar en una hoja de calculo.
-def inspeccionar_objeto():
- doc = app.active
- app.inspect(doc, True)
- return
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/es/tools_debug/index.xml b/doc/public/es/tools_debug/index.xml
deleted file mode 100644
index c71f78b..0000000
--- a/doc/public/es/tools_debug/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - category :: - - Categories -
- - - - - - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/fr/categories/index.xml b/doc/public/fr/categories/index.xml
deleted file mode 100644
index 098fc42..0000000
--- a/doc/public/fr/categories/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Bienvenue dans la documentation easymacro!
-easymacro est une bibliothèque permettant de développer facilement des macros LibreOffice avec Python. Il s’agit d’une couche d’abstraction entre l’API étendue et complexe de LibreOffice UNO et votre code.
-Vous serez probablement plus heureux si vous l’utilisez :)
-Vous pouvez utiliser easymacro avec n’importe quelle extension ou directement dans vos macros.
- - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/fr/index.json b/doc/public/fr/index.json
deleted file mode 100644
index eea1b78..0000000
--- a/doc/public/fr/index.json
+++ /dev/null
@@ -1,22 +0,0 @@
-[
-{
- "uri": "https://doc.cuates.net/easymacro/fr/",
- "title": "",
- "tags": [],
- "description": "",
- "content": "Bienvenue dans la documentation easymacro! easymacro est une bibliothèque permettant de développer facilement des macros LibreOffice avec Python. Il s\u0026rsquo;agit d\u0026rsquo;une couche d\u0026rsquo;abstraction entre l\u0026rsquo;API étendue et complexe de LibreOffice UNO et votre code.\nVous serez probablement plus heureux si vous l\u0026rsquo;utilisez :)\nVous pouvez utiliser easymacro avec n\u0026rsquo;importe quelle extension ou directement dans vos macros.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/fr/categories/",
- "title": "Categories",
- "tags": [],
- "description": "",
- "content": ""
-},
-{
- "uri": "https://doc.cuates.net/easymacro/fr/tags/",
- "title": "Tags",
- "tags": [],
- "description": "",
- "content": ""
-}]
\ No newline at end of file
diff --git a/doc/public/fr/index.xml b/doc/public/fr/index.xml
deleted file mode 100644
index 6f04026..0000000
--- a/doc/public/fr/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - tag :: - - Tags -
- - - - - - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/fr/tags/index.xml b/doc/public/fr/tags/index.xml
deleted file mode 100644
index 91879a4..0000000
--- a/doc/public/fr/tags/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Welcome to easymacro’s documentation!
-Free Software, not gratis software
-easymacro it’s a library for easily develop macros en LibreOffice con Python. It is an abstraction layer between the extensive and complex LibreOffice API UNO and your code.
-Probably, you will be more happy if used it. :)
-You can used easymacro with any extension or directly in your macros.
- -This project is in continuous development.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/index.json b/doc/public/index.json
deleted file mode 100644
index 9df935e..0000000
--- a/doc/public/index.json
+++ /dev/null
@@ -1,36 +0,0 @@
-[
-{
- "uri": "https://doc.cuates.net/easymacro/installation/",
- "title": "Installation",
- "tags": [],
- "description": "",
- "content": "Clone repository Clone repository in your favorite folder projects.\ngit clone https://git.cuates.net/elmau/easymacro and copy library into pythonpath in your macros.\n/home/USER/.config/libreoffice/4/user/Scripts/python/pythonpath/easymacro.py or used hard link. Replace ABSOLUTE_PATH for absolute path in your system and USER for your real name user.\nln ABSOLUTE_PATH/easymacro/source/easymacro.py /home/USER/.config/libreoffice/4/user/Scripts/python/pythonpath/ Test In your favorite macros file, for example mymacros.py:\nvim /home/USER/.config/libreoffice/4/user/Scripts/python/mymacros.py copy this code:\nimport easymacro as app def main(): app.msgbox(app.INFO_DEBUG) return and execute from LibreOffice, if you see similar next info, great!\nyou are ready for develop with easymacro.\nHappy develop!\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/tools_debug/",
- "title": "Tools for debug",
- "tags": [],
- "description": "",
- "content": "INFO_DEBUG "
-},
-{
- "uri": "https://doc.cuates.net/easymacro/",
- "title": "",
- "tags": [],
- "description": "",
- "content": "Welcome to easymacro’s documentation! Free Software, not gratis software easymacro it’s a library for easily develop macros en LibreOffice con Python. It is an abstraction layer between the extensive and complex LibreOffice API UNO and your code.\nProbably, you will be more happy if used it. :)\nYou can used easymacro with any extension or directly in your macros.\nThis project is in continuous development.\n"
-},
-{
- "uri": "https://doc.cuates.net/easymacro/categories/",
- "title": "Categories",
- "tags": [],
- "description": "",
- "content": ""
-},
-{
- "uri": "https://doc.cuates.net/easymacro/tags/",
- "title": "Tags",
- "tags": [],
- "description": "",
- "content": ""
-}]
\ No newline at end of file
diff --git a/doc/public/index.xml b/doc/public/index.xml
deleted file mode 100644
index dd86904..0000000
--- a/doc/public/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - Installation -
- - - - - - -Clone repository
-Clone repository in your favorite folder projects.
-git clone https://git.cuates.net/elmau/easymacro
-and copy library into pythonpath in your macros.
-/home/USER/.config/libreoffice/4/user/Scripts/python/pythonpath/easymacro.py
-or used hard link. Replace ABSOLUTE_PATH for absolute path in your system and USER for your real name user.
ln ABSOLUTE_PATH/easymacro/source/easymacro.py /home/USER/.config/libreoffice/4/user/Scripts/python/pythonpath/
-Test
-In your favorite macros file, for example mymacros.py:
vim /home/USER/.config/libreoffice/4/user/Scripts/python/mymacros.py
-copy this code:
-import easymacro as app
-
-def main():
- app.msgbox(app.INFO_DEBUG)
- return
-and execute from LibreOffice, if you see similar next info, great!
-
you are ready for develop with easymacro.
-Happy develop!
- - - - - - - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/doc/public/installation/index.xml b/doc/public/installation/index.xml
deleted file mode 100644
index e7a6b97..0000000
--- a/doc/public/installation/index.xml
+++ /dev/null
@@ -1,10 +0,0 @@
-
-'+e.replace(o,"$1")+"
"},onSelect:function(){}};for(var c in e)e.hasOwnProperty(c)&&(l[c]=e[c]);for(var a="object"==typeof l.selector?[l.selector]:document.querySelectorAll(l.selector),u=0;u','",'
",""].join("")),o="."+n.namespace+"-close"+(n.otherClose?","+n.otherClose:"");return n.$instance=i.clone().addClass(n.variant),n.$instance.on(n.closeTrigger+"."+n.namespace,function(e){if(!e.isDefaultPrevented()){var t=u(e.target);("background"===n.closeOnClick&&t.is("."+n.namespace)||"anywhere"===n.closeOnClick||t.closest(o).length)&&(n.close(e),e.preventDefault())}}),this},getContent:function(){if(!1!==this.persist&&this.$content)return this.$content;var t=this,e=this.constructor.contentFilters,n=function(e){return t.$currentTarget&&t.$currentTarget.attr(e)},r=n(t.targetAttr),i=t.target||r||"",o=e[t.type];if(!o&&i in e&&(o=e[i],i=t.target&&r),i=i||n("href")||"",!o)for(var a in e)t[a]&&(o=e[a],i=t[a]);if(!o){var s=i;if(i=null,u.each(t.contentFilters,function(){return(o=e[this]).test&&(i=o.test(s)),!i&&o.regex&&s.match&&s.match(o.regex)&&(i=s),!i}),!i)return"console"in window&&window.console.error("Featherlight: no content filter found "+(s?' for "'+s+'"':" (no target specified)")),!1}return o.process.call(t,i)},setContent:function(e){return this.$instance.removeClass(this.namespace+"-loading"),this.$instance.toggleClass(this.namespace+"-iframe",e.is("iframe")),this.$instance.find("."+this.namespace+"-inner").not(e).slice(1).remove().end().replaceWith(u.contains(this.$instance[0],e[0])?"":e),this.$content=e.addClass(this.namespace+"-inner"),this},open:function(t){var n=this;if(n.$instance.hide().appendTo(n.root),!(t&&t.isDefaultPrevented()||!1===n.beforeOpen(t))){t&&t.preventDefault();var e=n.getContent();if(e)return r.push(n),s(!0),n.$instance.fadeIn(n.openSpeed),n.beforeContent(t),u.when(e).always(function(e){n.setContent(e),n.afterContent(t)}).then(n.$instance.promise()).done(function(){n.afterOpen(t)})}return n.$instance.detach(),u.Deferred().reject().promise()},close:function(e){var t=this,n=u.Deferred();return!1===t.beforeClose(e)?n.reject():(0===i(t).length&&s(!1),t.$instance.fadeOut(t.closeSpeed,function(){t.$instance.detach(),t.afterClose(e),n.resolve()})),n.promise()},resize:function(e,t){if(e&&t&&(this.$content.css("width","").css("height",""),this.$content.parent().width()'+n.loading+"
","",{text:e})}}},functionAttributes:["beforeOpen","afterOpen","beforeContent","afterContent","beforeClose","afterClose"],readElementConfig:function(e,t){var r=this,i=new RegExp("^data-"+t+"-(.*)"),o={};return e&&e.attributes&&u.each(e.attributes,function(){var e=this.name.match(i);if(e){var t=this.value,n=u.camelCase(e[1]);if(0<=u.inArray(n,r.functionAttributes))t=new Function(t);else try{t=JSON.parse(t)}catch(e){}o[n]=t}}),o},extend:function(e,t){var n=function(){this.constructor=e};return n.prototype=this.prototype,e.prototype=new n,e.__super__=this.prototype,u.extend(e,this,t),e.defaults=e.prototype,e},attach:function(i,o,a){var s=this;"object"!=typeof o||o instanceof u!=!1||a||(a=o,o=void 0);var c,e=(a=u.extend({},a)).namespace||s.defaults.namespace,l=u.extend({},s.defaults,s.readElementConfig(i[0],e),a),t=function(e){var t=u(e.currentTarget),n=u.extend({$source:i,$currentTarget:t},s.readElementConfig(i[0],l.namespace),s.readElementConfig(e.currentTarget,l.namespace),a),r=c||t.data("featherlight-persisted")||new s(o,n);"shared"===r.persist?c=r:!1!==r.persist&&t.data("featherlight-persisted",r),n.$currentTarget.blur&&n.$currentTarget.blur(),r.open(e)};return i.on(l.openTrigger+"."+l.namespace,l.filter,t),{filter:l.filter,handler:t}},current:function(){var e=this.opened();return e[e.length-1]||null},opened:function(){var t=this;return i(),u.grep(r,function(e){return e instanceof t})},close:function(e){var t=this.current();if(t)return t.close(e)},_onReady:function(){var r=this;if(r.autoBind){var i=u(r.autoBind);i.each(function(){r.attach(u(this))}),u(document).on("click",r.autoBind,function(e){if(!e.isDefaultPrevented()){var t=u(e.currentTarget);if(i.length!==(i=i.add(t)).length){var n=r.attach(t);(!n.filter||0"}function u(e){s+=""}function d(e){("start"===e.event?c:u)(e.node)}for(;e.length||t.length;){var g=l();if(s+=n(a.substring(i,g[0].offset)),i=g[0].offset,g===e){o.reverse().forEach(u);do{d(g.splice(0,1)[0]),g=l()}while(g===e&&g.length&&g[0].offset===i);o.reverse().forEach(c)}else"start"===g[0].event?o.push(g[0].node):o.pop(),d(g.splice(0,1)[0])}return s+n(a.substr(i))}});const i="",s=e=>!!e.kind;class o{constructor(e,n){this.buffer="",this.classPrefix=n.classPrefix,e.walk(this)}addText(e){this.buffer+=n(e)}openNode(e){if(!s(e))return;let n=e.kind;e.sublanguage||(n=`${this.classPrefix}${n}`),this.span(n)}closeNode(e){s(e)&&(this.buffer+=i)}span(e){this.buffer+=``}value(){return this.buffer}}class l{constructor(){this.rootNode={children:[]},this.stack=[this.rootNode]}get top(){return this.stack[this.stack.length-1]}get root(){return this.rootNode}add(e){this.top.children.push(e)}openNode(e){let n={kind:e,children:[]};this.add(n),this.stack.push(n)}closeNode(){if(this.stack.length>1)return this.stack.pop()}closeAllNodes(){for(;this.closeNode(););}toJSON(){return JSON.stringify(this.rootNode,null,4)}walk(e){return this.constructor._walk(e,this.rootNode)}static _walk(e,n){return"string"==typeof n?e.addText(n):n.children&&(e.openNode(n),n.children.forEach(n=>this._walk(e,n)),e.closeNode(n)),e}static _collapse(e){e.children&&(e.children.every(e=>"string"==typeof e)?(e.text=e.children.join(""),delete e.children):e.children.forEach(e=>{"string"!=typeof e&&l._collapse(e)}))}}class c extends l{constructor(e){super(),this.options=e}addKeyword(e,n){""!==e&&(this.openNode(n),this.addText(e),this.closeNode())}addText(e){""!==e&&this.add(e)}addSublanguage(e,n){let t=e.root;t.kind=n,t.sublanguage=!0,this.add(t)}toHTML(){return new o(this,this.options).value()}finalize(){}}function u(e){return e&&e.source||e}const d="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",g={begin:"\\\\[\\s\\S]",relevance:0},h={className:"string",begin:"'",end:"'",illegal:"\\n",contains:[g]},f={className:"string",begin:'"',end:'"',illegal:"\\n",contains:[g]},p={begin:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/},m=function(e,n,r){var a=t({className:"comment",begin:e,end:n,contains:[]},r||{});return a.contains.push(p),a.contains.push({className:"doctag",begin:"(?:TODO|FIXME|NOTE|BUG|XXX):",relevance:0}),a},b=m("//","$"),v=m("/\\*","\\*/"),x=m("#","$");var _=Object.freeze({__proto__:null,IDENT_RE:"[a-zA-Z]\\w*",UNDERSCORE_IDENT_RE:"[a-zA-Z_]\\w*",NUMBER_RE:"\\b\\d+(\\.\\d+)?",C_NUMBER_RE:d,BINARY_NUMBER_RE:"\\b(0b[01]+)",RE_STARTERS_RE:"!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",BACKSLASH_ESCAPE:g,APOS_STRING_MODE:h,QUOTE_STRING_MODE:f,PHRASAL_WORDS_MODE:p,COMMENT:m,C_LINE_COMMENT_MODE:b,C_BLOCK_COMMENT_MODE:v,HASH_COMMENT_MODE:x,NUMBER_MODE:{className:"number",begin:"\\b\\d+(\\.\\d+)?",relevance:0},C_NUMBER_MODE:{className:"number",begin:d,relevance:0},BINARY_NUMBER_MODE:{className:"number",begin:"\\b(0b[01]+)",relevance:0},CSS_NUMBER_MODE:{className:"number",begin:"\\b\\d+(\\.\\d+)?(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",relevance:0},REGEXP_MODE:{begin:/(?=\/[^\/\n]*\/)/,contains:[{className:"regexp",begin:/\//,end:/\/[gimuy]*/,illegal:/\n/,contains:[g,{begin:/\[/,end:/\]/,relevance:0,contains:[g]}]}]},TITLE_MODE:{className:"title",begin:"[a-zA-Z]\\w*",relevance:0},UNDERSCORE_TITLE_MODE:{className:"title",begin:"[a-zA-Z_]\\w*",relevance:0},METHOD_GUARD:{begin:"\\.\\s*[a-zA-Z_]\\w*",relevance:0}}),E="of and for in not or if then".split(" ");function R(e,n){return n?+n:(t=e,E.includes(t.toLowerCase())?0:1);var t}const N=n,w=t,{nodeStream:y,mergeStreams:O}=a;return function(n){var r=[],a={},i={},s=[],o=!0,l=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,d="Could not find the language '{}', did you forget to load/include a language module?",g={noHighlightRe:/^(no-?highlight)$/i,languageDetectRe:/\blang(?:uage)?-([\w-]+)\b/i,classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0,__emitter:c};function h(e){return g.noHighlightRe.test(e)}function f(e,n,t,r){var a={code:n,language:e};T("before:highlight",a);var i=a.result?a.result:p(a.language,a.code,t,r);return i.code=a.code,T("after:highlight",i),i}function p(e,n,r,i){var s=n;function l(e,n){var t=v.case_insensitive?n[0].toLowerCase():n[0];return e.keywords.hasOwnProperty(t)&&e.keywords[t]}function c(){null!=_.subLanguage?function(){if(""!==k){var e="string"==typeof _.subLanguage;if(!e||a[_.subLanguage]){var n=e?p(_.subLanguage,k,!0,E[_.subLanguage]):m(k,_.subLanguage.length?_.subLanguage:void 0);_.relevance>0&&(T+=n.relevance),e&&(E[_.subLanguage]=n.top),w.addSublanguage(n.emitter,n.language)}else w.addText(k)}}():function(){var e,n,t,r;if(_.keywords){for(n=0,_.lexemesRe.lastIndex=0,t=_.lexemesRe.exec(k),r="";t;){r+=k.substring(n,t.index);var a=null;(e=l(_,t))?(w.addText(r),r="",T+=e[1],a=e[0],w.addKeyword(t[0],a)):r+=t[0],n=_.lexemesRe.lastIndex,t=_.lexemesRe.exec(k)}r+=k.substr(n),w.addText(r)}else w.addText(k)}(),k=""}function h(e){e.className&&w.openNode(e.className),_=Object.create(e,{parent:{value:_}})}var f={};function b(n,t){var a,i=t&&t[0];if(k+=n,null==i)return c(),0;if("begin"==f.type&&"end"==t.type&&f.index==t.index&&""===i){if(k+=s.slice(t.index,t.index+1),!o)throw(a=Error("0 width match regex")).languageName=e,a.badRule=f.rule,a;return 1}if(f=t,"begin"===t.type)return function(e){var n=e[0],t=e.rule;return t.__onBegin&&(t.__onBegin(e)||{}).ignoreMatch?function(e){return 0===_.matcher.regexIndex?(k+=e[0],1):(B=!0,0)}(n):(t&&t.endSameAsBegin&&(t.endRe=RegExp(n.replace(/[-\/\\^$*+?.()|[\]{}]/g,"\\$&"),"m")),t.skip?k+=n:(t.excludeBegin&&(k+=n),c(),t.returnBegin||t.excludeBegin||(k=n)),h(t),t.returnBegin?0:n.length)}(t);if("illegal"===t.type&&!r)throw(a=Error('Illegal lexeme "'+i+'" for mode "'+(_.className||"")+'"')).mode=_,a;if("end"===t.type){var l=function(e){var n=e[0],t=s.substr(e.index),r=function e(n,t){if(function(e,n){var t=e&&e.exec(n);return t&&0===t.index}(n.endRe,t)){for(;n.endsParent&&n.parent;)n=n.parent;return n}if(n.endsWithParent)return e(n.parent,t)}(_,t);if(r){var a=_;a.skip?k+=n:(a.returnEnd||a.excludeEnd||(k+=n),c(),a.excludeEnd&&(k=n));do{_.className&&w.closeNode(),_.skip||_.subLanguage||(T+=_.relevance),_=_.parent}while(_!==r.parent);return r.starts&&(r.endSameAsBegin&&(r.starts.endRe=r.endRe),h(r.starts)),a.returnEnd?0:n.length}}(t);if(null!=l)return l}if("illegal"===t.type&&""===i)return 1;if(A>1e5&&A>3*t.index)throw Error("potential infinite loop, way more iterations than matches");return k+=i,i.length}var v=M(e);if(!v)throw console.error(d.replace("{}",e)),Error('Unknown language: "'+e+'"');!function(e){function n(n,t){return RegExp(u(n),"m"+(e.case_insensitive?"i":"")+(t?"g":""))}class r{constructor(){this.matchIndexes={},this.regexes=[],this.matchAt=1,this.position=0}addRule(e,n){n.position=this.position++,this.matchIndexes[this.matchAt]=n,this.regexes.push([n,e]),this.matchAt+=function(e){return RegExp(e.toString()+"|").exec("").length-1}(e)+1}compile(){0===this.regexes.length&&(this.exec=()=>null);let e=this.regexes.map(e=>e[1]);this.matcherRe=n(function(e,n){for(var t=/\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./,r=0,a="",i=0;i0&&(a+="|"),a+="(";o.length>0;){var l=t.exec(o);if(null==l){a+=o;break}a+=o.substring(0,l.index),o=o.substring(l.index+l[0].length),"\\"==l[0][0]&&l[1]?a+="\\"+(+l[1]+s):(a+=l[0],"("==l[0]&&r++)}a+=")"}return a}(e),!0),this.lastIndex=0}exec(e){this.matcherRe.lastIndex=this.lastIndex;let n=this.matcherRe.exec(e);if(!n)return null;let t=n.findIndex((e,n)=>n>0&&null!=e),r=this.matchIndexes[t];return Object.assign(n,r)}}class a{constructor(){this.rules=[],this.multiRegexes=[],this.count=0,this.lastIndex=0,this.regexIndex=0}getMatcher(e){if(this.multiRegexes[e])return this.multiRegexes[e];let n=new r;return this.rules.slice(e).forEach(([e,t])=>n.addRule(e,t)),n.compile(),this.multiRegexes[e]=n,n}considerAll(){this.regexIndex=0}addRule(e,n){this.rules.push([e,n]),"begin"===n.type&&this.count++}exec(e){let n=this.getMatcher(this.regexIndex);n.lastIndex=this.lastIndex;let t=n.exec(e);return t&&(this.regexIndex+=t.position+1,this.regexIndex===this.count&&(this.regexIndex=0)),t}}function i(e){let n=e.input[e.index-1],t=e.input[e.index+e[0].length];if("."===n||"."===t)return{ignoreMatch:!0}}if(e.contains&&e.contains.includes("self"))throw Error("ERR: contains `self` is not supported at the top-level of a language. See documentation.");!function r(s,o){s.compiled||(s.compiled=!0,s.__onBegin=null,s.keywords=s.keywords||s.beginKeywords,s.keywords&&(s.keywords=function(e,n){var t={};return"string"==typeof e?r("keyword",e):Object.keys(e).forEach((function(n){r(n,e[n])})),t;function r(e,r){n&&(r=r.toLowerCase()),r.split(" ").forEach((function(n){var r=n.split("|");t[r[0]]=[e,R(r[0],r[1])]}))}}(s.keywords,e.case_insensitive)),s.lexemesRe=n(s.lexemes||/\w+/,!0),o&&(s.beginKeywords&&(s.begin="\\b("+s.beginKeywords.split(" ").join("|")+")(?=\\b|\\s)",s.__onBegin=i),s.begin||(s.begin=/\B|\b/),s.beginRe=n(s.begin),s.endSameAsBegin&&(s.end=s.begin),s.end||s.endsWithParent||(s.end=/\B|\b/),s.end&&(s.endRe=n(s.end)),s.terminator_end=u(s.end)||"",s.endsWithParent&&o.terminator_end&&(s.terminator_end+=(s.end?"|":"")+o.terminator_end)),s.illegal&&(s.illegalRe=n(s.illegal)),null==s.relevance&&(s.relevance=1),s.contains||(s.contains=[]),s.contains=[].concat(...s.contains.map((function(e){return function(e){return e.variants&&!e.cached_variants&&(e.cached_variants=e.variants.map((function(n){return t(e,{variants:null},n)}))),e.cached_variants?e.cached_variants:function e(n){return!!n&&(n.endsWithParent||e(n.starts))}(e)?t(e,{starts:e.starts?t(e.starts):null}):Object.isFrozen(e)?t(e):e}("self"===e?s:e)}))),s.contains.forEach((function(e){r(e,s)})),s.starts&&r(s.starts,o),s.matcher=function(e){let n=new a;return e.contains.forEach(e=>n.addRule(e.begin,{rule:e,type:"begin"})),e.terminator_end&&n.addRule(e.terminator_end,{type:"end"}),e.illegal&&n.addRule(e.illegal,{type:"illegal"}),n}(s))}(e)}(v);var x,_=i||v,E={},w=new g.__emitter(g);!function(){for(var e=[],n=_;n!==v;n=n.parent)n.className&&e.unshift(n.className);e.forEach(e=>w.openNode(e))}();var y,O,k="",T=0,L=0,A=0,B=!1;try{for(_.matcher.considerAll();A++,B?B=!1:(_.matcher.lastIndex=L,_.matcher.considerAll()),y=_.matcher.exec(s);)O=b(s.substring(L,y.index),y),L=y.index+O;return b(s.substr(L)),w.closeAllNodes(),w.finalize(),x=w.toHTML(),{relevance:T,value:x,language:e,illegal:!1,emitter:w,top:_}}catch(n){if(n.message&&n.message.includes("Illegal"))return{illegal:!0,illegalBy:{msg:n.message,context:s.slice(L-100,L+100),mode:n.mode},sofar:x,relevance:0,value:N(s),emitter:w};if(o)return{relevance:0,value:N(s),emitter:w,language:e,top:_,errorRaised:n};throw n}}function m(e,n){n=n||g.languages||Object.keys(a);var t=function(e){const n={relevance:0,emitter:new g.__emitter(g),value:N(e),illegal:!1,top:E};return n.emitter.addText(e),n}(e),r=t;return n.filter(M).filter(k).forEach((function(n){var a=p(n,e,!1);a.language=n,a.relevance>r.relevance&&(r=a),a.relevance>t.relevance&&(r=t,t=a)})),r.language&&(t.second_best=r),t}function b(e){return g.tabReplace||g.useBR?e.replace(l,(function(e,n){return g.useBR&&"\n"===e?"
":g.tabReplace?n.replace(/\t/g,g.tabReplace):""})):e}function v(e){var n,t,r,a,s,o=function(e){var n,t=e.className+" ";if(t+=e.parentNode?e.parentNode.className:"",n=g.languageDetectRe.exec(t)){var r=M(n[1]);return r||(console.warn(d.replace("{}",n[1])),console.warn("Falling back to no-highlight mode for this block.",e)),r?n[1]:"no-highlight"}return t.split(/\s+/).find(e=>h(e)||M(e))}(e);h(o)||(T("before:highlightBlock",{block:e,language:o}),g.useBR?(n=document.createElement("div")).innerHTML=e.innerHTML.replace(/\n/g,"").replace(//g,"\n"):n=e,s=n.textContent,r=o?f(o,s,!0):m(s),(t=y(n)).length&&((a=document.createElement("div")).innerHTML=r.value,r.value=O(t,y(a),s)),r.value=b(r.value),T("after:highlightBlock",{block:e,result:r}),e.innerHTML=r.value,e.className=function(e,n,t){var r=n?i[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),e.includes(r)||a.push(r),a.join(" ").trim()}(e.className,o,r.language),e.result={language:r.language,re:r.relevance},r.second_best&&(e.second_best={language:r.second_best.language,re:r.second_best.relevance}))}function x(){if(!x.called){x.called=!0;var e=document.querySelectorAll("pre code");r.forEach.call(e,v)}}const E={disableAutodetect:!0,name:"Plain text"};function M(e){return e=(e||"").toLowerCase(),a[e]||a[i[e]]}function k(e){var n=M(e);return n&&!n.disableAutodetect}function T(e,n){var t=e;s.forEach((function(e){e[t]&&e[t](n)}))}Object.assign(n,{highlight:f,highlightAuto:m,fixMarkup:b,highlightBlock:v,configure:function(e){g=w(g,e)},initHighlighting:x,initHighlightingOnLoad:function(){window.addEventListener("DOMContentLoaded",x,!1)},registerLanguage:function(e,t){var r;try{r=t(n)}catch(n){if(console.error("Language definition for '{}' could not be registered.".replace("{}",e)),!o)throw n;console.error(n),r=E}r.name||(r.name=e),a[e]=r,r.rawDefinition=t.bind(null,n),r.aliases&&r.aliases.forEach((function(n){i[n]=e}))},listLanguages:function(){return Object.keys(a)},getLanguage:M,requireLanguage:function(e){var n=M(e);if(n)return n;throw Error("The '{}' language is required, but not loaded.".replace("{}",e))},autoDetection:k,inherit:w,addPlugin:function(e,n){s.push(e)}}),n.debugMode=function(){o=!1},n.safeMode=function(){o=!0},n.versionString="10.0.3";for(const n in _)"object"==typeof _[n]&&e(_[n]);return Object.assign(n,_),n}({})}();"object"==typeof exports&&"undefined"!=typeof module&&(module.exports=hljs);hljs.registerLanguage("ruby",function(){"use strict";return function(e){var n="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",a={keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor",literal:"true false nil"},s={className:"doctag",begin:"@[A-Za-z]+"},i={begin:"#<",end:">"},r=[e.COMMENT("#","$",{contains:[s]}),e.COMMENT("^\\=begin","^\\=end",{contains:[s],relevance:10}),e.COMMENT("^__END__","\\n$")],c={className:"subst",begin:"#\\{",end:"}",keywords:a},t={className:"string",contains:[e.BACKSLASH_ESCAPE,c],variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/`/,end:/`/},{begin:"%[qQwWx]?\\(",end:"\\)"},{begin:"%[qQwWx]?\\[",end:"\\]"},{begin:"%[qQwWx]?{",end:"}"},{begin:"%[qQwWx]?<",end:">"},{begin:"%[qQwWx]?/",end:"/"},{begin:"%[qQwWx]?%",end:"%"},{begin:"%[qQwWx]?-",end:"-"},{begin:"%[qQwWx]?\\|",end:"\\|"},{begin:/\B\?(\\\d{1,3}|\\x[A-Fa-f0-9]{1,2}|\\u[A-Fa-f0-9]{4}|\\?\S)\b/},{begin:/<<[-~]?'?(\w+)(?:.|\n)*?\n\s*\1\b/,returnBegin:!0,contains:[{begin:/<<[-~]?'?/},{begin:/\w+/,endSameAsBegin:!0,contains:[e.BACKSLASH_ESCAPE,c]}]}]},b={className:"params",begin:"\\(",end:"\\)",endsParent:!0,keywords:a},d=[t,i,{className:"class",beginKeywords:"class module",end:"$|;",illegal:/=/,contains:[e.inherit(e.TITLE_MODE,{begin:"[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?"}),{begin:"<\\s*",contains:[{begin:"("+e.IDENT_RE+"::)?"+e.IDENT_RE}]}].concat(r)},{className:"function",beginKeywords:"def",end:"$|;",contains:[e.inherit(e.TITLE_MODE,{begin:n}),b].concat(r)},{begin:e.IDENT_RE+"::"},{className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"(\\!|\\?)?:",relevance:0},{className:"symbol",begin:":(?!\\s)",contains:[t,{begin:n}],relevance:0},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},{begin:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{className:"params",begin:/\|/,end:/\|/,keywords:a},{begin:"("+e.RE_STARTERS_RE+"|unless)\\s*",keywords:"unless",contains:[i,{className:"regexp",contains:[e.BACKSLASH_ESCAPE,c],illegal:/\n/,variants:[{begin:"/",end:"/[a-z]*"},{begin:"%r{",end:"}[a-z]*"},{begin:"%r\\(",end:"\\)[a-z]*"},{begin:"%r!",end:"![a-z]*"},{begin:"%r\\[",end:"\\][a-z]*"}]}].concat(r),relevance:0}].concat(r);c.contains=d,b.contains=d;var g=[{begin:/^\s*=>/,starts:{end:"$",contains:d}},{className:"meta",begin:"^([>?]>|[\\w#]+\\(\\w+\\):\\d+:\\d+>|(\\w+-)?\\d+\\.\\d+\\.\\d(p\\d+)?[^>]+>)",starts:{end:"$",contains:d}}];return{name:"Ruby",aliases:["rb","gemspec","podspec","thor","irb"],keywords:a,illegal:/\/\*/,contains:r.concat(g).concat(d)}}}());hljs.registerLanguage("yaml",function(){"use strict";return function(e){var n={className:"string",relevance:0,variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/\S+/}],contains:[e.BACKSLASH_ESCAPE,{className:"template-variable",variants:[{begin:"{{",end:"}}"},{begin:"%{",end:"}"}]}]};return{name:"YAML",case_insensitive:!0,aliases:["yml","YAML"],contains:[{className:"attr",variants:[{begin:"\\w[\\w :\\/.-]*:(?=[ \t]|$)"},{begin:'"\\w[\\w :\\/.-]*":(?=[ \t]|$)'},{begin:"'\\w[\\w :\\/.-]*':(?=[ \t]|$)"}]},{className:"meta",begin:"^---s*$",relevance:10},{className:"string",begin:"[\\|>]([0-9]?[+-])?[ ]*\\n( *)[\\S ]+\\n(\\2[\\S ]+\\n?)*"},{begin:"<%[%=-]?",end:"[%-]?%>",subLanguage:"ruby",excludeBegin:!0,excludeEnd:!0,relevance:0},{className:"type",begin:"!"+e.UNDERSCORE_IDENT_RE},{className:"type",begin:"!!"+e.UNDERSCORE_IDENT_RE},{className:"meta",begin:"&"+e.UNDERSCORE_IDENT_RE+"$"},{className:"meta",begin:"\\*"+e.UNDERSCORE_IDENT_RE+"$"},{className:"bullet",begin:"\\-(?=[ ]|$)",relevance:0},e.HASH_COMMENT_MODE,{beginKeywords:"true false yes no null",keywords:{literal:"true false yes no null"}},{className:"number",begin:"\\b[0-9]{4}(-[0-9][0-9]){0,2}([Tt \\t][0-9][0-9]?(:[0-9][0-9]){2})?(\\.[0-9]*)?([ \\t])*(Z|[-+][0-9][0-9]?(:[0-9][0-9])?)?\\b"},{className:"number",begin:e.C_NUMBER_RE+"\\b"},n]}}}());hljs.registerLanguage("nginx",function(){"use strict";return function(e){var n={className:"variable",variants:[{begin:/\$\d+/},{begin:/\$\{/,end:/}/},{begin:"[\\$\\@]"+e.UNDERSCORE_IDENT_RE}]},a={endsWithParent:!0,lexemes:"[a-z/_]+",keywords:{literal:"on off yes no true false none blocked debug info notice warn error crit select break last permanent redirect kqueue rtsig epoll poll /dev/poll"},relevance:0,illegal:"=>",contains:[e.HASH_COMMENT_MODE,{className:"string",contains:[e.BACKSLASH_ESCAPE,n],variants:[{begin:/"/,end:/"/},{begin:/'/,end:/'/}]},{begin:"([a-z]+):/",end:"\\s",endsWithParent:!0,excludeEnd:!0,contains:[n]},{className:"regexp",contains:[e.BACKSLASH_ESCAPE,n],variants:[{begin:"\\s\\^",end:"\\s|{|;",returnEnd:!0},{begin:"~\\*?\\s+",end:"\\s|{|;",returnEnd:!0},{begin:"\\*(\\.[a-z\\-]+)+"},{begin:"([a-z\\-]+\\.)+\\*"}]},{className:"number",begin:"\\b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?\\b"},{className:"number",begin:"\\b\\d+[kKmMgGdshdwy]*\\b",relevance:0},n]};return{name:"Nginx config",aliases:["nginxconf"],contains:[e.HASH_COMMENT_MODE,{begin:e.UNDERSCORE_IDENT_RE+"\\s+{",returnBegin:!0,end:"{",contains:[{className:"section",begin:e.UNDERSCORE_IDENT_RE}],relevance:0},{begin:e.UNDERSCORE_IDENT_RE+"\\s",end:";|{",returnBegin:!0,contains:[{className:"attribute",begin:e.UNDERSCORE_IDENT_RE,starts:a}],relevance:0}],illegal:"[^\\s\\}]"}}}());hljs.registerLanguage("makefile",function(){"use strict";return function(e){var i={className:"variable",variants:[{begin:"\\$\\("+e.UNDERSCORE_IDENT_RE+"\\)",contains:[e.BACKSLASH_ESCAPE]},{begin:/\$[@%|\/>/},a="[A-Za-z$_][0-9A-Za-z$_]*",s={keyword:"in of if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const export super debugger as async await static import from as",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document Symbol Set Map WeakSet WeakMap Proxy Reflect Promise"},r={className:"number",variants:[{begin:"\\b(0[bB][01]+)n?"},{begin:"\\b(0[oO][0-7]+)n?"},{begin:e.C_NUMBER_RE+"n?"}],relevance:0},i={className:"subst",begin:"\\$\\{",end:"\\}",keywords:s,contains:[]},t={begin:"html`",end:"",starts:{end:"`",returnEnd:!1,contains:[e.BACKSLASH_ESCAPE,i],subLanguage:"xml"}},c={begin:"css`",end:"",starts:{end:"`",returnEnd:!1,contains:[e.BACKSLASH_ESCAPE,i],subLanguage:"css"}},o={className:"string",begin:"`",end:"`",contains:[e.BACKSLASH_ESCAPE,i]};i.contains=[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,t,c,o,r,e.REGEXP_MODE];var l=i.contains.concat([e.C_BLOCK_COMMENT_MODE,e.C_LINE_COMMENT_MODE]),d={className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,contains:l};return{name:"JavaScript",aliases:["js","jsx","mjs","cjs"],keywords:s,contains:[{className:"meta",relevance:10,begin:/^\s*['"]use (strict|asm)['"]/},{className:"meta",begin:/^#!/,end:/$/},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,t,c,o,e.C_LINE_COMMENT_MODE,e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag",begin:"@[A-Za-z]+",contains:[{className:"type",begin:"\\{",end:"\\}",relevance:0},{className:"variable",begin:a+"(?=\\s*(-)|$)",endsParent:!0,relevance:0},{begin:/(?=[^\n])\s/,relevance:0}]}]}),e.C_BLOCK_COMMENT_MODE,r,{begin:/[{,\n]\s*/,relevance:0,contains:[{begin:a+"\\s*:",returnBegin:!0,relevance:0,contains:[{className:"attr",begin:a,relevance:0}]}]},{begin:"("+e.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*",keywords:"return throw case",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.REGEXP_MODE,{className:"function",begin:"(\\(.*?\\)|"+a+")\\s*=>",returnBegin:!0,end:"\\s*=>",contains:[{className:"params",variants:[{begin:a},{begin:/\(\s*\)/},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:s,contains:l}]}]},{begin:/,/,relevance:0},{className:"",begin:/\s/,end:/\s*/,skip:!0},{variants:[{begin:"<>",end:""},{begin:n.begin,end:n.end}],subLanguage:"xml",contains:[{begin:n.begin,end:n.end,skip:!0,contains:["self"]}]}],relevance:0},{className:"function",beginKeywords:"function",end:/\{/,excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:a}),d],illegal:/\[|%/},{begin:/\$[(.]/},e.METHOD_GUARD,{className:"class",beginKeywords:"class",end:/[{;=]/,excludeEnd:!0,illegal:/[:"\[\]]/,contains:[{beginKeywords:"extends"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"constructor",end:/\{/,excludeEnd:!0},{begin:"(get|set)\\s+(?="+a+"\\()",end:/{/,keywords:"get set",contains:[e.inherit(e.TITLE_MODE,{begin:a}),{begin:/\(\)/},d]}],illegal:/#(?!!)/}}}());hljs.registerLanguage("xml",function(){"use strict";return function(e){var n={className:"symbol",begin:"&[a-z]+;|&#[0-9]+;|&#x[a-f0-9]+;"},a={begin:"\\s",contains:[{className:"meta-keyword",begin:"#?[a-z_][a-z1-9_-]+",illegal:"\\n"}]},s=e.inherit(a,{begin:"\\(",end:"\\)"}),t=e.inherit(e.APOS_STRING_MODE,{className:"meta-string"}),i=e.inherit(e.QUOTE_STRING_MODE,{className:"meta-string"}),c={endsWithParent:!0,illegal:/`]+/}]}]}]};return{name:"HTML, XML",aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist","wsf","svg"],case_insensitive:!0,contains:[{className:"meta",begin:"",relevance:10,contains:[a,i,t,s,{begin:"\\[",end:"\\]",contains:[{className:"meta",begin:"",contains:[a,s,i,t]}]}]},e.COMMENT("\x3c!--","--\x3e",{relevance:10}),{begin:"<\\!\\[CDATA\\[",end:"\\]\\]>",relevance:10},n,{className:"meta",begin:/<\?xml/,end:/\?>/,relevance:10},{className:"tag",begin:")",end:">",keywords:{name:"style"},contains:[c],starts:{end:"",returnEnd:!0,subLanguage:["css","xml"]}},{className:"tag",begin:")",end:">",keywords:{name:"script"},contains:[c],starts:{end:"<\/script>",returnEnd:!0,subLanguage:["javascript","handlebars","xml"]}},{className:"tag",begin:"",contains:[{className:"name",begin:/[^\/><\s]+/,relevance:0},c]}]}}}());hljs.registerLanguage("markdown",function(){"use strict";return function(n){const e={begin:"<",end:">",subLanguage:"xml",relevance:0},a={begin:"\\[.+?\\][\\(\\[].*?[\\)\\]]",returnBegin:!0,contains:[{className:"string",begin:"\\[",end:"\\]",excludeBegin:!0,returnEnd:!0,relevance:0},{className:"link",begin:"\\]\\(",end:"\\)",excludeBegin:!0,excludeEnd:!0},{className:"symbol",begin:"\\]\\[",end:"\\]",excludeBegin:!0,excludeEnd:!0}],relevance:10},i={className:"strong",contains:[],variants:[{begin:/_{2}/,end:/_{2}/},{begin:/\*{2}/,end:/\*{2}/}]},s={className:"emphasis",contains:[],variants:[{begin:/\*(?!\*)/,end:/\*/},{begin:/_(?!_)/,end:/_/,relevance:0}]};i.contains.push(s),s.contains.push(i);var c=[e,a];return i.contains=i.contains.concat(c),s.contains=s.contains.concat(c),{name:"Markdown",aliases:["md","mkdown","mkd"],contains:[{className:"section",variants:[{begin:"^#{1,6}",end:"$",contains:c=c.concat(i,s)},{begin:"(?=^.+?\\n[=-]{2,}$)",contains:[{begin:"^[=-]*$"},{begin:"^",end:"\\n",contains:c}]}]},e,{className:"bullet",begin:"^[ \t]*([*+-]|(\\d+\\.))(?=\\s+)",end:"\\s+",excludeEnd:!0},i,s,{className:"quote",begin:"^>\\s+",contains:c,end:"$"},{className:"code",variants:[{begin:"(`{3,})(.|\\n)*?\\1`*[ ]*"},{begin:"(~{3,})(.|\\n)*?\\1~*[ ]*"},{begin:"```",end:"```+[ ]*$"},{begin:"~~~",end:"~~~+[ ]*$"},{begin:"`.+?`"},{begin:"(?=^( {4}|\\t))",contains:[{begin:"^( {4}|\\t)",end:"(\\n)$"}],relevance:0}]},{begin:"^[-\\*]{3,}",end:"$"},a,{begin:/^\[[^\n]+\]:/,returnBegin:!0,contains:[{className:"symbol",begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0},{className:"link",begin:/:\s*/,end:/$/,excludeBegin:!0}]}]}}}());hljs.registerLanguage("scss",function(){"use strict";return function(e){var t={className:"variable",begin:"(\\$[a-zA-Z-][a-zA-Z0-9_-]*)\\b"},i={className:"number",begin:"#[0-9A-Fa-f]+"};return e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,e.C_BLOCK_COMMENT_MODE,{name:"SCSS",case_insensitive:!0,illegal:"[=/|']",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"selector-id",begin:"\\#[A-Za-z0-9_-]+",relevance:0},{className:"selector-class",begin:"\\.[A-Za-z0-9_-]+",relevance:0},{className:"selector-attr",begin:"\\[",end:"\\]",illegal:"$"},{className:"selector-tag",begin:"\\b(a|abbr|acronym|address|area|article|aside|audio|b|base|big|blockquote|body|br|button|canvas|caption|cite|code|col|colgroup|command|datalist|dd|del|details|dfn|div|dl|dt|em|embed|fieldset|figcaption|figure|footer|form|frame|frameset|(h[1-6])|head|header|hgroup|hr|html|i|iframe|img|input|ins|kbd|keygen|label|legend|li|link|map|mark|meta|meter|nav|noframes|noscript|object|ol|optgroup|option|output|p|param|pre|progress|q|rp|rt|ruby|samp|script|section|select|small|span|strike|strong|style|sub|sup|table|tbody|td|textarea|tfoot|th|thead|time|title|tr|tt|ul|var|video)\\b",relevance:0},{className:"selector-pseudo",begin:":(visited|valid|root|right|required|read-write|read-only|out-range|optional|only-of-type|only-child|nth-of-type|nth-last-of-type|nth-last-child|nth-child|not|link|left|last-of-type|last-child|lang|invalid|indeterminate|in-range|hover|focus|first-of-type|first-line|first-letter|first-child|first|enabled|empty|disabled|default|checked|before|after|active)"},{className:"selector-pseudo",begin:"::(after|before|choices|first-letter|first-line|repeat-index|repeat-item|selection|value)"},t,{className:"attribute",begin:"\\b(src|z-index|word-wrap|word-spacing|word-break|width|widows|white-space|visibility|vertical-align|unicode-bidi|transition-timing-function|transition-property|transition-duration|transition-delay|transition|transform-style|transform-origin|transform|top|text-underline-position|text-transform|text-shadow|text-rendering|text-overflow|text-indent|text-decoration-style|text-decoration-line|text-decoration-color|text-decoration|text-align-last|text-align|tab-size|table-layout|right|resize|quotes|position|pointer-events|perspective-origin|perspective|page-break-inside|page-break-before|page-break-after|padding-top|padding-right|padding-left|padding-bottom|padding|overflow-y|overflow-x|overflow-wrap|overflow|outline-width|outline-style|outline-offset|outline-color|outline|orphans|order|opacity|object-position|object-fit|normal|none|nav-up|nav-right|nav-left|nav-index|nav-down|min-width|min-height|max-width|max-height|mask|marks|margin-top|margin-right|margin-left|margin-bottom|margin|list-style-type|list-style-position|list-style-image|list-style|line-height|letter-spacing|left|justify-content|initial|inherit|ime-mode|image-orientation|image-resolution|image-rendering|icon|hyphens|height|font-weight|font-variant-ligatures|font-variant|font-style|font-stretch|font-size-adjust|font-size|font-language-override|font-kerning|font-feature-settings|font-family|font|float|flex-wrap|flex-shrink|flex-grow|flex-flow|flex-direction|flex-basis|flex|filter|empty-cells|display|direction|cursor|counter-reset|counter-increment|content|column-width|column-span|column-rule-width|column-rule-style|column-rule-color|column-rule|column-gap|column-fill|column-count|columns|color|clip-path|clip|clear|caption-side|break-inside|break-before|break-after|box-sizing|box-shadow|box-decoration-break|bottom|border-width|border-top-width|border-top-style|border-top-right-radius|border-top-left-radius|border-top-color|border-top|border-style|border-spacing|border-right-width|border-right-style|border-right-color|border-right|border-radius|border-left-width|border-left-style|border-left-color|border-left|border-image-width|border-image-source|border-image-slice|border-image-repeat|border-image-outset|border-image|border-color|border-collapse|border-bottom-width|border-bottom-style|border-bottom-right-radius|border-bottom-left-radius|border-bottom-color|border-bottom|border|background-size|background-repeat|background-position|background-origin|background-image|background-color|background-clip|background-attachment|background-blend-mode|background|backface-visibility|auto|animation-timing-function|animation-play-state|animation-name|animation-iteration-count|animation-fill-mode|animation-duration|animation-direction|animation-delay|animation|align-self|align-items|align-content)\\b",illegal:"[^\\s]"},{begin:"\\b(whitespace|wait|w-resize|visible|vertical-text|vertical-ideographic|uppercase|upper-roman|upper-alpha|underline|transparent|top|thin|thick|text|text-top|text-bottom|tb-rl|table-header-group|table-footer-group|sw-resize|super|strict|static|square|solid|small-caps|separate|se-resize|scroll|s-resize|rtl|row-resize|ridge|right|repeat|repeat-y|repeat-x|relative|progress|pointer|overline|outside|outset|oblique|nowrap|not-allowed|normal|none|nw-resize|no-repeat|no-drop|newspaper|ne-resize|n-resize|move|middle|medium|ltr|lr-tb|lowercase|lower-roman|lower-alpha|loose|list-item|line|line-through|line-edge|lighter|left|keep-all|justify|italic|inter-word|inter-ideograph|inside|inset|inline|inline-block|inherit|inactive|ideograph-space|ideograph-parenthesis|ideograph-numeric|ideograph-alpha|horizontal|hidden|help|hand|groove|fixed|ellipsis|e-resize|double|dotted|distribute|distribute-space|distribute-letter|distribute-all-lines|disc|disabled|default|decimal|dashed|crosshair|collapse|col-resize|circle|char|center|capitalize|break-word|break-all|bottom|both|bolder|bold|block|bidi-override|below|baseline|auto|always|all-scroll|absolute|table|table-cell)\\b"},{begin:":",end:";",contains:[t,i,e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,{className:"meta",begin:"!important"}]},{begin:"@(page|font-face)",lexemes:"@[a-z-]+",keywords:"@page @font-face"},{begin:"@",end:"[{;]",returnBegin:!0,keywords:"and or not only",contains:[{begin:"@[a-z-]+",className:"keyword"},t,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,i,e.CSS_NUMBER_MODE]}]}}}());hljs.registerLanguage("lua",function(){"use strict";return function(e){var t={begin:"\\[=*\\[",end:"\\]=*\\]",contains:["self"]},a=[e.COMMENT("--(?!\\[=*\\[)","$"),e.COMMENT("--\\[=*\\[","\\]=*\\]",{contains:[t],relevance:10})];return{name:"Lua",lexemes:e.UNDERSCORE_IDENT_RE,keywords:{literal:"true false nil",keyword:"and break do else elseif end for goto if in local not or repeat return then until while",built_in:"_G _ENV _VERSION __index __newindex __mode __call __metatable __tostring __len __gc __add __sub __mul __div __mod __pow __concat __unm __eq __lt __le assert collectgarbage dofile error getfenv getmetatable ipairs load loadfile loadstring module next pairs pcall print rawequal rawget rawset require select setfenv setmetatable tonumber tostring type unpack xpcall arg self coroutine resume yield status wrap create running debug getupvalue debug sethook getmetatable gethook setmetatable setlocal traceback setfenv getinfo setupvalue getlocal getregistry getfenv io lines write close flush open output type read stderr stdin input stdout popen tmpfile math log max acos huge ldexp pi cos tanh pow deg tan cosh sinh random randomseed frexp ceil floor rad abs sqrt modf asin min mod fmod log10 atan2 exp sin atan os exit setlocale date getenv difftime remove time clock tmpname rename execute package preload loadlib loaded loaders cpath config path seeall string sub upper len gfind rep find match char dump gmatch reverse byte format gsub lower table setn insert getn foreachi maxn foreach concat sort remove"},contains:a.concat([{className:"function",beginKeywords:"function",end:"\\)",contains:[e.inherit(e.TITLE_MODE,{begin:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),{className:"params",begin:"\\(",endsWithParent:!0,contains:a}].concat(a)},e.C_NUMBER_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"string",begin:"\\[=*\\[",end:"\\]=*\\]",contains:[t],relevance:5}])}}}());hljs.registerLanguage("coffeescript",function(){"use strict";return function(e){var n={keyword:"in if for while finally new do return else break catch instanceof throw try this switch continue typeof delete debugger super yield import export from as default await then unless until loop of by when and or is isnt not",literal:"true false null undefined yes no on off",built_in:"npm require console print module global window document"},i="[A-Za-z$_][0-9A-Za-z$_]*",s={className:"subst",begin:/#\{/,end:/}/,keywords:n},a=[e.BINARY_NUMBER_MODE,e.inherit(e.C_NUMBER_MODE,{starts:{end:"(\\s*/)?",relevance:0}}),{className:"string",variants:[{begin:/'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE]},{begin:/'/,end:/'/,contains:[e.BACKSLASH_ESCAPE]},{begin:/"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,s]},{begin:/"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,s]}]},{className:"regexp",variants:[{begin:"///",end:"///",contains:[s,e.HASH_COMMENT_MODE]},{begin:"//[gim]{0,3}(?=\\W)",relevance:0},{begin:/\/(?![ *]).*?(?![\\]).\/[gim]{0,3}(?=\W)/}]},{begin:"@"+i},{subLanguage:"javascript",excludeBegin:!0,excludeEnd:!0,variants:[{begin:"```",end:"```"},{begin:"`",end:"`"}]}];s.contains=a;var t=e.inherit(e.TITLE_MODE,{begin:i}),r={className:"params",begin:"\\([^\\(]",returnBegin:!0,contains:[{begin:/\(/,end:/\)/,keywords:n,contains:["self"].concat(a)}]};return{name:"CoffeeScript",aliases:["coffee","cson","iced"],keywords:n,illegal:/\/\*/,contains:a.concat([e.COMMENT("###","###"),e.HASH_COMMENT_MODE,{className:"function",begin:"^\\s*"+i+"\\s*=\\s*(\\(.*\\))?\\s*\\B[-=]>",end:"[-=]>",returnBegin:!0,contains:[t,r]},{begin:/[:\(,=]\s*/,relevance:0,contains:[{className:"function",begin:"(\\(.*\\))?\\s*\\B[-=]>",end:"[-=]>",returnBegin:!0,contains:[r]}]},{className:"class",beginKeywords:"class",end:"$",illegal:/[:="\[\]]/,contains:[{beginKeywords:"extends",endsWithParent:!0,illegal:/[:="\[\]]/,contains:[t]},t]},{begin:i+":",end:":",returnBegin:!0,returnEnd:!0,relevance:0}])}}}());hljs.registerLanguage("sql",function(){"use strict";return function(e){var t=e.COMMENT("--","$");return{name:"SQL",case_insensitive:!0,illegal:/[<>{}*]/,contains:[{beginKeywords:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment values with",end:/;/,endsWithParent:!0,lexemes:/[\w\.]+/,keywords:{keyword:"as abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias all allocate allow alter always analyze ancillary and anti any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound bucket buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain explode export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force foreign form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour hours http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lateral lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minutes minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notnull notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second seconds section securefile security seed segment select self semi sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tablesample tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unnest unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace window with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null unknown",built_in:"array bigint binary bit blob bool boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text time timestamp tinyint varchar varchar2 varying void"},contains:[{className:"string",begin:"'",end:"'",contains:[{begin:"''"}]},{className:"string",begin:'"',end:'"',contains:[{begin:'""'}]},{className:"string",begin:"`",end:"`"},e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE,t,e.HASH_COMMENT_MODE]},e.C_BLOCK_COMMENT_MODE,t,e.HASH_COMMENT_MODE]}}}());hljs.registerLanguage("less",function(){"use strict";return function(e){var n="([\\w-]+|@{[\\w-]+})",a=[],s=[],t=function(e){return{className:"string",begin:"~?"+e+".*?"+e}},r=function(e,n,a){return{className:e,begin:n,relevance:a}},i={begin:"\\(",end:"\\)",contains:s,relevance:0};s.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,t("'"),t('"'),e.CSS_NUMBER_MODE,{begin:"(url|data-uri)\\(",starts:{className:"string",end:"[\\)\\n]",excludeEnd:!0}},r("number","#[0-9A-Fa-f]+\\b"),i,r("variable","@@?[\\w-]+",10),r("variable","@{[\\w-]+}"),r("built_in","~?`[^`]*?`"),{className:"attribute",begin:"[\\w-]+\\s*:",end:":",returnBegin:!0,excludeEnd:!0},{className:"meta",begin:"!important"});var c=s.concat({begin:"{",end:"}",contains:a}),l={beginKeywords:"when",endsWithParent:!0,contains:[{beginKeywords:"and not"}].concat(s)},o={begin:n+"\\s*:",returnBegin:!0,end:"[;}]",relevance:0,contains:[{className:"attribute",begin:n,end:":",excludeEnd:!0,starts:{endsWithParent:!0,illegal:"[<=$]",relevance:0,contains:s}}]},g={className:"keyword",begin:"@(import|media|charset|font-face|(-[a-z]+-)?keyframes|supports|document|namespace|page|viewport|host)\\b",starts:{end:"[;{}]",returnEnd:!0,contains:s,relevance:0}},d={className:"variable",variants:[{begin:"@[\\w-]+\\s*:",relevance:15},{begin:"@[\\w-]+"}],starts:{end:"[;}]",returnEnd:!0,contains:c}},b={variants:[{begin:"[\\.#:&\\[>]",end:"[;{}]"},{begin:n,end:"{"}],returnBegin:!0,returnEnd:!0,illegal:"[<='$\"]",relevance:0,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,l,r("keyword","all\\b"),r("variable","@{[\\w-]+}"),r("selector-tag",n+"%?",0),r("selector-id","#"+n),r("selector-class","\\."+n,0),r("selector-tag","&",0),{className:"selector-attr",begin:"\\[",end:"\\]"},{className:"selector-pseudo",begin:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{begin:"\\(",end:"\\)",contains:c},{begin:"!important"}]};return a.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,g,d,o,b),{name:"Less",case_insensitive:!0,illegal:"[=>'/<($\"]",contains:a}}}());hljs.registerLanguage("go",function(){"use strict";return function(e){var n={keyword:"break default func interface select case map struct chan else goto package switch const fallthrough if range type continue for import return var go defer bool byte complex64 complex128 float32 float64 int8 int16 int32 int64 string uint8 uint16 uint32 uint64 int uint uintptr rune",literal:"true false iota nil",built_in:"append cap close complex copy imag len make new panic print println real recover delete"};return{name:"Go",aliases:["golang"],keywords:n,illegal:"/},{className:"params",begin:/\(/,end:/\)/,endsParent:!0,keywords:i,contains:["self",r,a,e.C_BLOCK_COMMENT_MODE,{begin:":"}],illegal:/["']/}],illegal:/\[|%/},{className:"class",beginKeywords:"struct protocol class extension enum",keywords:i,end:"\\{",excludeEnd:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/[A-Za-z$_][\u00C0-\u02B80-9A-Za-z$_]*/})]},{className:"meta",begin:"(@discardableResult|@warn_unused_result|@exported|@lazy|@noescape|@NSCopying|@NSManaged|@objc|@objcMembers|@convention|@required|@noreturn|@IBAction|@IBDesignable|@IBInspectable|@IBOutlet|@infix|@prefix|@postfix|@autoclosure|@testable|@available|@nonobjc|@NSApplicationMain|@UIApplicationMain|@dynamicMemberLookup|@propertyWrapper)"},{beginKeywords:"import",end:/$/,contains:[e.C_LINE_COMMENT_MODE,n]}]}}}());hljs.registerLanguage("php",function(){"use strict";return function(e){var r={begin:"\\$+[a-zA-Z_-ÿ][a-zA-Z0-9_-ÿ]*"},t={className:"meta",variants:[{begin:/<\?php/,relevance:10},{begin:/<\?[=]?/},{begin:/\?>/}]},a={className:"string",contains:[e.BACKSLASH_ESCAPE,t],variants:[{begin:'b"',end:'"'},{begin:"b'",end:"'"},e.inherit(e.APOS_STRING_MODE,{illegal:null}),e.inherit(e.QUOTE_STRING_MODE,{illegal:null})]},n={variants:[e.BINARY_NUMBER_MODE,e.C_NUMBER_MODE]},i={keyword:"__CLASS__ __DIR__ __FILE__ __FUNCTION__ __LINE__ __METHOD__ __NAMESPACE__ __TRAIT__ die echo exit include include_once print require require_once array abstract and as binary bool boolean break callable case catch class clone const continue declare default do double else elseif empty enddeclare endfor endforeach endif endswitch endwhile eval extends final finally float for foreach from global goto if implements instanceof insteadof int integer interface isset iterable list new object or private protected public real return string switch throw trait try unset use var void while xor yield",literal:"false null true",built_in:"Error|0 AppendIterator ArgumentCountError ArithmeticError ArrayIterator ArrayObject AssertionError BadFunctionCallException BadMethodCallException CachingIterator CallbackFilterIterator CompileError Countable DirectoryIterator DivisionByZeroError DomainException EmptyIterator ErrorException Exception FilesystemIterator FilterIterator GlobIterator InfiniteIterator InvalidArgumentException IteratorIterator LengthException LimitIterator LogicException MultipleIterator NoRewindIterator OutOfBoundsException OutOfRangeException OuterIterator OverflowException ParentIterator ParseError RangeException RecursiveArrayIterator RecursiveCachingIterator RecursiveCallbackFilterIterator RecursiveDirectoryIterator RecursiveFilterIterator RecursiveIterator RecursiveIteratorIterator RecursiveRegexIterator RecursiveTreeIterator RegexIterator RuntimeException SeekableIterator SplDoublyLinkedList SplFileInfo SplFileObject SplFixedArray SplHeap SplMaxHeap SplMinHeap SplObjectStorage SplObserver SplObserver SplPriorityQueue SplQueue SplStack SplSubject SplSubject SplTempFileObject TypeError UnderflowException UnexpectedValueException ArrayAccess Closure Generator Iterator IteratorAggregate Serializable Throwable Traversable WeakReference Directory __PHP_Incomplete_Class parent php_user_filter self static stdClass"};return{aliases:["php","php3","php4","php5","php6","php7"],case_insensitive:!0,keywords:i,contains:[e.HASH_COMMENT_MODE,e.COMMENT("//","$",{contains:[t]}),e.COMMENT("/\\*","\\*/",{contains:[{className:"doctag",begin:"@[A-Za-z]+"}]}),e.COMMENT("__halt_compiler.+?;",!1,{endsWithParent:!0,keywords:"__halt_compiler",lexemes:e.UNDERSCORE_IDENT_RE}),{className:"string",begin:/<<<['"]?\w+['"]?$/,end:/^\w+;?$/,contains:[e.BACKSLASH_ESCAPE,{className:"subst",variants:[{begin:/\$\w+/},{begin:/\{\$/,end:/\}/}]}]},t,{className:"keyword",begin:/\$this\b/},r,{begin:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{className:"function",beginKeywords:"fn function",end:/[;{]/,excludeEnd:!0,illegal:"[$%\\[]",contains:[e.UNDERSCORE_TITLE_MODE,{className:"params",begin:"\\(",end:"\\)",excludeBegin:!0,excludeEnd:!0,keywords:i,contains:["self",r,e.C_BLOCK_COMMENT_MODE,a,n]}]},{className:"class",beginKeywords:"class interface",end:"{",excludeEnd:!0,illegal:/[:\(\$"]/,contains:[{beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"namespace",end:";",illegal:/[\.']/,contains:[e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"use",end:";",contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"=>"},a,n]}}}());hljs.registerLanguage("php-template",function(){"use strict";return function(n){return{name:"PHP template",subLanguage:"xml",contains:[{begin:/<\?(php|=)?/,end:/\?>/,subLanguage:"php",contains:[{begin:"/\\*",end:"\\*/",skip:!0},{begin:'b"',end:'"',skip:!0},{begin:"b'",end:"'",skip:!0},n.inherit(n.APOS_STRING_MODE,{illegal:null,className:null,contains:null,skip:!0}),n.inherit(n.QUOTE_STRING_MODE,{illegal:null,className:null,contains:null,skip:!0})]}]}}}());hljs.registerLanguage("diff",function(){"use strict";return function(e){return{name:"Diff",aliases:["patch"],contains:[{className:"meta",relevance:10,variants:[{begin:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{begin:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{begin:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{className:"comment",variants:[{begin:/Index: /,end:/$/},{begin:/={3,}/,end:/$/},{begin:/^\-{3}/,end:/$/},{begin:/^\*{3} /,end:/$/},{begin:/^\+{3}/,end:/$/},{begin:/^\*{15}$/}]},{className:"addition",begin:"^\\+",end:"$"},{className:"deletion",begin:"^\\-",end:"$"},{className:"addition",begin:"^\\!",end:"$"}]}}}());hljs.registerLanguage("c-like",function(){"use strict";return function(e){function t(e){return"(?:"+e+")?"}var n="(decltype\\(auto\\)|"+t("[a-zA-Z_]\\w*::")+"[a-zA-Z_]\\w*"+t("<.*?>")+")",r={className:"keyword",begin:"\\b[a-z\\d_]*_t\\b"},a={className:"string",variants:[{begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)",end:"'",illegal:"."},{begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\((?:.|\n)*?\)\1"/}]},s={className:"number",variants:[{begin:"\\b(0b[01']+)"},{begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],relevance:0},i={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{"meta-keyword":"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include"},contains:[{begin:/\\\n/,relevance:0},e.inherit(a,{className:"meta-string"}),{className:"meta-string",begin:/<.*?>/,end:/$/,illegal:"\\n"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},c={className:"title",begin:t("[a-zA-Z_]\\w*::")+e.IDENT_RE,relevance:0},o=t("[a-zA-Z_]\\w*::")+e.IDENT_RE+"\\s*\\(",l={keyword:"int float while private char char8_t char16_t char32_t catch import module export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const for static_cast|10 union namespace unsigned long volatile static protected bool template mutable if public friend do goto auto void enum else break extern using asm case typeid wchar_t short reinterpret_cast|10 default double register explicit signed typename try this switch continue inline delete alignas alignof constexpr consteval constinit decltype concept co_await co_return co_yield requires noexcept static_assert thread_local restrict final override atomic_bool atomic_char atomic_schar atomic_uchar atomic_short atomic_ushort atomic_int atomic_uint atomic_long atomic_ulong atomic_llong atomic_ullong new throw return and and_eq bitand bitor compl not not_eq or or_eq xor xor_eq",built_in:"std string wstring cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap array shared_ptr abort terminate abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf future isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr _Bool complex _Complex imaginary _Imaginary",literal:"true false nullptr NULL"},d=[r,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s,a],_={variants:[{begin:/=/,end:/;/},{begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}],keywords:l,contains:d.concat([{begin:/\(/,end:/\)/,keywords:l,contains:d.concat(["self"]),relevance:0}]),relevance:0},u={className:"function",begin:"("+n+"[\\*&\\s]+)+"+o,returnBegin:!0,end:/[{;=]/,excludeEnd:!0,keywords:l,illegal:/[^\w\s\*&:<>]/,contains:[{begin:"decltype\\(auto\\)",keywords:l,relevance:0},{begin:o,returnBegin:!0,contains:[c],relevance:0},{className:"params",begin:/\(/,end:/\)/,keywords:l,relevance:0,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,s,r,{begin:/\(/,end:/\)/,keywords:l,relevance:0,contains:["self",e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,s,r]}]},r,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,i]};return{aliases:["c","cc","h","c++","h++","hpp","hh","hxx","cxx"],keywords:l,disableAutodetect:!0,illegal:"",keywords:l,contains:["self",r]},{begin:e.IDENT_RE+"::",keywords:l},{className:"class",beginKeywords:"class struct",end:/[{;:]/,contains:[{begin://,contains:["self"]},e.TITLE_MODE]}]),exports:{preprocessor:i,strings:a,keywords:l}}}}());hljs.registerLanguage("c",function(){"use strict";return function(e){var n=e.getLanguage("c-like").rawDefinition();return n.name="C",n.aliases=["c","h"],n}}());hljs.registerLanguage("http",function(){"use strict";return function(e){var n="HTTP/[0-9\\.]+";return{name:"HTTP",aliases:["https"],illegal:"\\S",contains:[{begin:"^"+n,end:"$",contains:[{className:"number",begin:"\\b\\d{3}\\b"}]},{begin:"^[A-Z]+ (.*?) "+n+"$",returnBegin:!0,end:"$",contains:[{className:"string",begin:" ",end:" ",excludeBegin:!0,excludeEnd:!0},{begin:n},{className:"keyword",begin:"[A-Z]+"}]},{className:"attribute",begin:"^\\w",end:": ",excludeEnd:!0,illegal:"\\n|\\s|=",starts:{end:"$",relevance:0}},{begin:"\\n\\n",starts:{subLanguage:[],endsWithParent:!0}}]}}}());hljs.registerLanguage("python",function(){"use strict";return function(e){var n={keyword:"and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda async await nonlocal|10",built_in:"Ellipsis NotImplemented",literal:"False None True"},a={className:"meta",begin:/^(>>>|\.\.\.) /},i={className:"subst",begin:/\{/,end:/\}/,keywords:n,illegal:/#/},s={begin:/\{\{/,relevance:0},r={className:"string",contains:[e.BACKSLASH_ESCAPE],variants:[{begin:/(u|b)?r?'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE,a],relevance:10},{begin:/(u|b)?r?"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,a],relevance:10},{begin:/(fr|rf|f)'''/,end:/'''/,contains:[e.BACKSLASH_ESCAPE,a,s,i]},{begin:/(fr|rf|f)"""/,end:/"""/,contains:[e.BACKSLASH_ESCAPE,a,s,i]},{begin:/(u|r|ur)'/,end:/'/,relevance:10},{begin:/(u|r|ur)"/,end:/"/,relevance:10},{begin:/(b|br)'/,end:/'/},{begin:/(b|br)"/,end:/"/},{begin:/(fr|rf|f)'/,end:/'/,contains:[e.BACKSLASH_ESCAPE,s,i]},{begin:/(fr|rf|f)"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,s,i]},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},l={className:"number",relevance:0,variants:[{begin:e.BINARY_NUMBER_RE+"[lLjJ]?"},{begin:"\\b(0o[0-7]+)[lLjJ]?"},{begin:e.C_NUMBER_RE+"[lLjJ]?"}]},t={className:"params",variants:[{begin:/\(\s*\)/,skip:!0,className:null},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,contains:["self",a,l,r,e.HASH_COMMENT_MODE]}]};return i.contains=[r,l,a],{name:"Python",aliases:["py","gyp","ipython"],keywords:n,illegal:/(<\/|->|\?)|=>/,contains:[a,l,{beginKeywords:"if",relevance:0},r,e.HASH_COMMENT_MODE,{variants:[{className:"function",beginKeywords:"def"},{className:"class",beginKeywords:"class"}],end:/:/,illegal:/[${=;\n,]/,contains:[e.UNDERSCORE_TITLE_MODE,t,{begin:/->/,endsWithParent:!0,keywords:"None"}]},{className:"meta",begin:/^[\t ]*@/,end:/$/},{begin:/\b(print|exec)\(/}]}}}());hljs.registerLanguage("bash",function(){"use strict";return function(e){const s={};Object.assign(s,{className:"variable",variants:[{begin:/\$[\w\d#@][\w\d_]*/},{begin:/\$\{/,end:/\}/,contains:[{begin:/:-/,contains:[s]}]}]});const n={className:"subst",begin:/\$\(/,end:/\)/,contains:[e.BACKSLASH_ESCAPE]},t={className:"string",begin:/"/,end:/"/,contains:[e.BACKSLASH_ESCAPE,s,n]};n.contains.push(t);const a={begin:/\$\(\(/,end:/\)\)/,contains:[{begin:/\d+#[0-9a-f]+/,className:"number"},e.NUMBER_MODE,s]};return{name:"Bash",aliases:["sh","zsh"],lexemes:/\b-?[a-z\._]+\b/,keywords:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},contains:[{className:"meta",begin:/^#![^\n]+sh\s*$/,relevance:10},{className:"function",begin:/\w[\w\d_]*\s*\(\s*\)\s*\{/,returnBegin:!0,contains:[e.inherit(e.TITLE_MODE,{begin:/\w[\w\d_]*/})],relevance:0},a,e.HASH_COMMENT_MODE,t,{className:"",begin:/\\"/},{className:"string",begin:/'/,end:/'/},s]}}}());hljs.registerLanguage("css",function(){"use strict";return function(e){var n={begin:/(?:[A-Z\_\.\-]+|--[a-zA-Z0-9_-]+)\s*:/,returnBegin:!0,end:";",endsWithParent:!0,contains:[{className:"attribute",begin:/\S/,end:":",excludeEnd:!0,starts:{endsWithParent:!0,excludeEnd:!0,contains:[{begin:/[\w-]+\(/,returnBegin:!0,contains:[{className:"built_in",begin:/[\w-]+/},{begin:/\(/,end:/\)/,contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.CSS_NUMBER_MODE]}]},e.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,e.C_BLOCK_COMMENT_MODE,{className:"number",begin:"#[0-9A-Fa-f]+"},{className:"meta",begin:"!important"}]}}]};return{name:"CSS",case_insensitive:!0,illegal:/[=\/|'\$]/,contains:[e.C_BLOCK_COMMENT_MODE,{className:"selector-id",begin:/#[A-Za-z0-9_-]+/},{className:"selector-class",begin:/\.[A-Za-z0-9_-]+/},{className:"selector-attr",begin:/\[/,end:/\]/,illegal:"$",contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},{className:"selector-pseudo",begin:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{begin:"@(page|font-face)",lexemes:"@[a-z-]+",keywords:"@page @font-face"},{begin:"@",end:"[{;]",illegal:/:/,returnBegin:!0,contains:[{className:"keyword",begin:/@\-?\w[\w]*(\-\w+)*/},{begin:/\s/,endsWithParent:!0,excludeEnd:!0,relevance:0,keywords:"and or not only",contains:[{begin:/[a-z-]+:/,className:"attribute"},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.CSS_NUMBER_MODE]}]},{className:"selector-tag",begin:"[a-zA-Z-][a-zA-Z0-9_-]*",relevance:0},{begin:"{",end:"}",illegal:/\S/,contains:[e.C_BLOCK_COMMENT_MODE,n]}]}}}());hljs.registerLanguage("csharp",function(){"use strict";return function(e){var n={keyword:"abstract as base bool break byte case catch char checked const continue decimal default delegate do double enum event explicit extern finally fixed float for foreach goto if implicit in int interface internal is lock long object operator out override params private protected public readonly ref sbyte sealed short sizeof stackalloc static string struct switch this try typeof uint ulong unchecked unsafe ushort using virtual void volatile while add alias ascending async await by descending dynamic equals from get global group into join let nameof on orderby partial remove select set value var when where yield",literal:"null false true"},i=e.inherit(e.TITLE_MODE,{begin:"[a-zA-Z](\\.?\\w)*"}),a={className:"number",variants:[{begin:"\\b(0b[01']+)"},{begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],relevance:0},s={className:"string",begin:'@"',end:'"',contains:[{begin:'""'}]},t=e.inherit(s,{illegal:/\n/}),l={className:"subst",begin:"{",end:"}",keywords:n},r=e.inherit(l,{illegal:/\n/}),c={className:"string",begin:/\$"/,end:'"',illegal:/\n/,contains:[{begin:"{{"},{begin:"}}"},e.BACKSLASH_ESCAPE,r]},o={className:"string",begin:/\$@"/,end:'"',contains:[{begin:"{{"},{begin:"}}"},{begin:'""'},l]},g=e.inherit(o,{illegal:/\n/,contains:[{begin:"{{"},{begin:"}}"},{begin:'""'},r]});l.contains=[o,c,s,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.C_BLOCK_COMMENT_MODE],r.contains=[g,c,t,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.inherit(e.C_BLOCK_COMMENT_MODE,{illegal:/\n/})];var d={variants:[o,c,s,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},E=e.IDENT_RE+"(<"+e.IDENT_RE+"(\\s*,\\s*"+e.IDENT_RE+")*>)?(\\[\\])?",_={begin:"@"+e.IDENT_RE,relevance:0};return{name:"C#",aliases:["cs","c#"],keywords:n,illegal:/::/,contains:[e.COMMENT("///","$",{returnBegin:!0,contains:[{className:"doctag",variants:[{begin:"///",relevance:0},{begin:"\x3c!--|--\x3e"},{begin:""}]}]}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"meta",begin:"#",end:"$",keywords:{"meta-keyword":"if else elif endif define undef warning error line region endregion pragma checksum"}},d,a,{beginKeywords:"class interface",end:/[{;=]/,illegal:/[^\s:,]/,contains:[{beginKeywords:"where class"},i,{begin:"<",end:">",keywords:"in out"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{beginKeywords:"namespace",end:/[{;=]/,illegal:/[^\s:]/,contains:[i,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"meta",begin:"^\\s*\\[",excludeBegin:!0,end:"\\]",excludeEnd:!0,contains:[{className:"meta-string",begin:/"/,end:/"/}]},{beginKeywords:"new return throw await else",relevance:0},{className:"function",begin:"("+E+"\\s+)+"+e.IDENT_RE+"\\s*\\(",returnBegin:!0,end:/\s*[{;=]/,excludeEnd:!0,keywords:n,contains:[{begin:e.IDENT_RE+"\\s*\\(",returnBegin:!0,contains:[e.TITLE_MODE],relevance:0},{className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n,relevance:0,contains:[d,a,e.C_BLOCK_COMMENT_MODE]},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},_]}}}());hljs.registerLanguage("objectivec",function(){"use strict";return function(e){var n=/[a-zA-Z@][a-zA-Z0-9_]*/,_="@interface @class @protocol @implementation";return{name:"Objective-C",aliases:["mm","objc","obj-c"],keywords:{keyword:"int float while char export sizeof typedef const struct for union unsigned long volatile static bool mutable if do return goto void enum else break extern asm case short default double register explicit signed typename this switch continue wchar_t inline readonly assign readwrite self @synchronized id typeof nonatomic super unichar IBOutlet IBAction strong weak copy in out inout bycopy byref oneway __strong __weak __block __autoreleasing @private @protected @public @try @property @end @throw @catch @finally @autoreleasepool @synthesize @dynamic @selector @optional @required @encode @package @import @defs @compatibility_alias __bridge __bridge_transfer __bridge_retained __bridge_retain __covariant __contravariant __kindof _Nonnull _Nullable _Null_unspecified __FUNCTION__ __PRETTY_FUNCTION__ __attribute__ getter setter retain unsafe_unretained nonnull nullable null_unspecified null_resettable class instancetype NS_DESIGNATED_INITIALIZER NS_UNAVAILABLE NS_REQUIRES_SUPER NS_RETURNS_INNER_POINTER NS_INLINE NS_AVAILABLE NS_DEPRECATED NS_ENUM NS_OPTIONS NS_SWIFT_UNAVAILABLE NS_ASSUME_NONNULL_BEGIN NS_ASSUME_NONNULL_END NS_REFINED_FOR_SWIFT NS_SWIFT_NAME NS_SWIFT_NOTHROW NS_DURING NS_HANDLER NS_ENDHANDLER NS_VALUERETURN NS_VOIDRETURN",literal:"false true FALSE TRUE nil YES NO NULL",built_in:"BOOL dispatch_once_t dispatch_queue_t dispatch_sync dispatch_async dispatch_once"},lexemes:n,illegal:"/,end:/$/,illegal:"\\n"},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"class",begin:"("+_.split(" ").join("|")+")\\b",end:"({|$)",excludeEnd:!0,keywords:_,lexemes:n,contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"\\."+e.UNDERSCORE_IDENT_RE,relevance:0}]}}}());hljs.registerLanguage("rust",function(){"use strict";return function(e){var n="([ui](8|16|32|64|128|size)|f(32|64))?",t="drop i8 i16 i32 i64 i128 isize u8 u16 u32 u64 u128 usize f32 f64 str char bool Box Option Result String Vec Copy Send Sized Sync Drop Fn FnMut FnOnce ToOwned Clone Debug PartialEq PartialOrd Eq Ord AsRef AsMut Into From Default Iterator Extend IntoIterator DoubleEndedIterator ExactSizeIterator SliceConcatExt ToString assert! assert_eq! bitflags! bytes! cfg! col! concat! concat_idents! debug_assert! debug_assert_eq! env! panic! file! format! format_args! include_bin! include_str! line! local_data_key! module_path! option_env! print! println! select! stringify! try! unimplemented! unreachable! vec! write! writeln! macro_rules! assert_ne! debug_assert_ne!";return{name:"Rust",aliases:["rs"],keywords:{keyword:"abstract as async await become box break const continue crate do dyn else enum extern false final fn for if impl in let loop macro match mod move mut override priv pub ref return self Self static struct super trait true try type typeof unsafe unsized use virtual where while yield",literal:"true false Some None Ok Err",built_in:t},lexemes:e.IDENT_RE+"!?",illegal:""}]}}}());hljs.registerLanguage("properties",function(){"use strict";return function(e){var n="[ \\t\\f]*",t="("+n+"[:=]"+n+"|[ \\t\\f]+)",a="([^\\\\:= \\t\\f\\n]|\\\\.)+",s={end:t,relevance:0,starts:{className:"string",end:/$/,relevance:0,contains:[{begin:"\\\\\\n"}]}};return{name:".properties",case_insensitive:!0,illegal:/\S/,contains:[e.COMMENT("^\\s*[!#]","$"),{begin:"([^\\\\\\W:= \\t\\f\\n]|\\\\.)+"+t,returnBegin:!0,contains:[{className:"attr",begin:"([^\\\\\\W:= \\t\\f\\n]|\\\\.)+",endsParent:!0,relevance:0}],starts:s},{begin:a+t,returnBegin:!0,relevance:0,contains:[{className:"meta",begin:a,endsParent:!0,relevance:0}],starts:s},{className:"attr",relevance:0,begin:a+n+"$"}]}}}());hljs.registerLanguage("json",function(){"use strict";return function(n){var e={literal:"true false null"},i=[n.C_LINE_COMMENT_MODE,n.C_BLOCK_COMMENT_MODE],t=[n.QUOTE_STRING_MODE,n.C_NUMBER_MODE],a={end:",",endsWithParent:!0,excludeEnd:!0,contains:t,keywords:e},l={begin:"{",end:"}",contains:[{className:"attr",begin:/"/,end:/"/,contains:[n.BACKSLASH_ESCAPE],illegal:"\\n"},n.inherit(a,{begin:/:/})].concat(i),illegal:"\\S"},s={begin:"\\[",end:"\\]",contains:[n.inherit(a)],illegal:"\\S"};return t.push(l,s),i.forEach((function(n){t.push(n)})),{name:"JSON",contains:t,keywords:e,illegal:"\\S"}}}());hljs.registerLanguage("perl",function(){"use strict";return function(e){var n="getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qq fileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmget sub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedir ioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when",t={className:"subst",begin:"[$@]\\{",end:"\\}",keywords:n},s={begin:"->{",end:"}"},r={variants:[{begin:/\$\d/},{begin:/[\$%@](\^\w\b|#\w+(::\w+)*|{\w+}|\w+(::\w*)*)/},{begin:/[\$%@][^\s\w{]/,relevance:0}]},i=[e.BACKSLASH_ESCAPE,t,r],a=[r,e.HASH_COMMENT_MODE,e.COMMENT("^\\=\\w","\\=cut",{endsWithParent:!0}),s,{className:"string",contains:i,variants:[{begin:"q[qwxr]?\\s*\\(",end:"\\)",relevance:5},{begin:"q[qwxr]?\\s*\\[",end:"\\]",relevance:5},{begin:"q[qwxr]?\\s*\\{",end:"\\}",relevance:5},{begin:"q[qwxr]?\\s*\\|",end:"\\|",relevance:5},{begin:"q[qwxr]?\\s*\\<",end:"\\>",relevance:5},{begin:"qw\\s+q",end:"q",relevance:5},{begin:"'",end:"'",contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"'},{begin:"`",end:"`",contains:[e.BACKSLASH_ESCAPE]},{begin:"{\\w+}",contains:[],relevance:0},{begin:"-?\\w+\\s*\\=\\>",contains:[],relevance:0}]},{className:"number",begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",relevance:0},{begin:"(\\/\\/|"+e.RE_STARTERS_RE+"|\\b(split|return|print|reverse|grep)\\b)\\s*",keywords:"split return print reverse grep",relevance:0,contains:[e.HASH_COMMENT_MODE,{className:"regexp",begin:"(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*",relevance:10},{className:"regexp",begin:"(m|qr)?/",end:"/[a-z]*",contains:[e.BACKSLASH_ESCAPE],relevance:0}]},{className:"function",beginKeywords:"sub",end:"(\\s*\\(.*?\\))?[;{]",excludeEnd:!0,relevance:5,contains:[e.TITLE_MODE]},{begin:"-\\w\\b",relevance:0},{begin:"^__DATA__$",end:"^__END__$",subLanguage:"mojolicious",contains:[{begin:"^@@.*",end:"$",className:"comment"}]}];return t.contains=a,s.contains=a,{name:"Perl",aliases:["pl","pm"],lexemes:/[\w\.]+/,keywords:n,contains:a}}}());hljs.registerLanguage("typescript",function(){"use strict";return function(e){var n={keyword:"in if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const class public private protected get set super static implements enum export import declare type namespace abstract as from extends async await",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document any number boolean string void Promise"},r={className:"meta",begin:"@[A-Za-z$_][0-9A-Za-z$_]*"},a={begin:"\\(",end:/\)/,keywords:n,contains:["self",e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,e.NUMBER_MODE]},t={className:"params",begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n,contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,r,a]},s={className:"number",variants:[{begin:"\\b(0[bB][01]+)n?"},{begin:"\\b(0[oO][0-7]+)n?"},{begin:e.C_NUMBER_RE+"n?"}],relevance:0},i={className:"subst",begin:"\\$\\{",end:"\\}",keywords:n,contains:[]},o={begin:"html`",end:"",starts:{end:"`",returnEnd:!1,contains:[e.BACKSLASH_ESCAPE,i],subLanguage:"xml"}},c={begin:"css`",end:"",starts:{end:"`",returnEnd:!1,contains:[e.BACKSLASH_ESCAPE,i],subLanguage:"css"}},E={className:"string",begin:"`",end:"`",contains:[e.BACKSLASH_ESCAPE,i]};return i.contains=[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,o,c,E,s,e.REGEXP_MODE],{name:"TypeScript",aliases:["ts"],keywords:n,contains:[{className:"meta",begin:/^\s*['"]use strict['"]/},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,o,c,E,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s,{begin:"("+e.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*",keywords:"return throw case",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.REGEXP_MODE,{className:"function",begin:"(\\(.*?\\)|"+e.IDENT_RE+")\\s*=>",returnBegin:!0,end:"\\s*=>",contains:[{className:"params",variants:[{begin:e.IDENT_RE},{begin:/\(\s*\)/},{begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n,contains:["self",e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]}]}]}],relevance:0},{className:"function",beginKeywords:"function",end:/[\{;]/,excludeEnd:!0,keywords:n,contains:["self",e.inherit(e.TITLE_MODE,{begin:"[A-Za-z$_][0-9A-Za-z$_]*"}),t],illegal:/%/,relevance:0},{beginKeywords:"constructor",end:/[\{;]/,excludeEnd:!0,contains:["self",t]},{begin:/module\./,keywords:{built_in:"module"},relevance:0},{beginKeywords:"module",end:/\{/,excludeEnd:!0},{beginKeywords:"interface",end:/\{/,excludeEnd:!0,keywords:"interface extends"},{begin:/\$[(.]/},{begin:"\\."+e.IDENT_RE,relevance:0},r,a]}}}());hljs.registerLanguage("shell",function(){"use strict";return function(s){return{name:"Shell Session",aliases:["console"],contains:[{className:"meta",begin:"^\\s{0,3}[/\\w\\d\\[\\]()@-]*[>%$#]",starts:{end:"$",subLanguage:"bash"}}]}}}());hljs.registerLanguage("plaintext",function(){"use strict";return function(t){return{name:"Plain text",aliases:["text","txt"],disableAutodetect:!0}}}());hljs.registerLanguage("python-repl",function(){"use strict";return function(n){return{aliases:["pycon"],contains:[{className:"meta",starts:{end:/ |$/,starts:{end:"$",subLanguage:"python"}},variants:[{begin:/^>>>(?=[ ]|$)/},{begin:/^\.\.\.(?=[ ]|$)/}]}]}}}());hljs.registerLanguage("apache",function(){"use strict";return function(e){var n={className:"number",begin:"\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?"};return{name:"Apache config",aliases:["apacheconf"],case_insensitive:!0,contains:[e.HASH_COMMENT_MODE,{className:"section",begin:"",contains:[n,{className:"number",begin:":\\d{1,5}"},e.inherit(e.QUOTE_STRING_MODE,{relevance:0})]},{className:"attribute",begin:/\w+/,relevance:0,keywords:{nomarkup:"order deny allow setenv rewriterule rewriteengine rewritecond documentroot sethandler errordocument loadmodule options header listen serverroot servername"},starts:{end:/$/,relevance:0,keywords:{literal:"on off all deny allow"},contains:[{className:"meta",begin:"\\s\\[",end:"\\]$"},{className:"variable",begin:"[\\$%]\\{",end:"\\}",contains:["self",{className:"number",begin:"[\\$%]\\d+"}]},n,{className:"number",begin:"\\d+"},e.QUOTE_STRING_MODE]}}],illegal:/\S/}}}());hljs.registerLanguage("kotlin",function(){"use strict";return function(e){var n={keyword:"abstract as val var vararg get set class object open private protected public noinline crossinline dynamic final enum if else do while for when throw try catch finally import package is in fun override companion reified inline lateinit init interface annotation data sealed internal infix operator out by constructor super tailrec where const inner suspend typealias external expect actual trait volatile transient native default",built_in:"Byte Short Char Int Long Boolean Float Double Void Unit Nothing",literal:"true false null"},a={className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"@"},i={className:"subst",begin:"\\${",end:"}",contains:[e.C_NUMBER_MODE]},s={className:"variable",begin:"\\$"+e.UNDERSCORE_IDENT_RE},t={className:"string",variants:[{begin:'"""',end:'"""(?=[^"])',contains:[s,i]},{begin:"'",end:"'",illegal:/\n/,contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"',illegal:/\n/,contains:[e.BACKSLASH_ESCAPE,s,i]}]};i.contains.push(t);var r={className:"meta",begin:"@(?:file|property|field|get|set|receiver|param|setparam|delegate)\\s*:(?:\\s*"+e.UNDERSCORE_IDENT_RE+")?"},l={className:"meta",begin:"@"+e.UNDERSCORE_IDENT_RE,contains:[{begin:/\(/,end:/\)/,contains:[e.inherit(t,{className:"meta-string"})]}]},c=e.COMMENT("/\\*","\\*/",{contains:[e.C_BLOCK_COMMENT_MODE]}),o={variants:[{className:"type",begin:e.UNDERSCORE_IDENT_RE},{begin:/\(/,end:/\)/,contains:[]}]},d=o;return d.variants[1].contains=[o],o.variants[1].contains=[d],{name:"Kotlin",aliases:["kt"],keywords:n,contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag",begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,c,{className:"keyword",begin:/\b(break|continue|return|this)\b/,starts:{contains:[{className:"symbol",begin:/@\w+/}]}},a,r,l,{className:"function",beginKeywords:"fun",end:"[(]|$",returnBegin:!0,excludeEnd:!0,keywords:n,illegal:/fun\s+(<.*>)?[^\s\(]+(\s+[^\s\(]+)\s*=/,relevance:5,contains:[{begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0,contains:[e.UNDERSCORE_TITLE_MODE]},{className:"type",begin://,keywords:"reified",relevance:0},{className:"params",begin:/\(/,end:/\)/,endsParent:!0,keywords:n,relevance:0,contains:[{begin:/:/,end:/[=,\/]/,endsWithParent:!0,contains:[o,e.C_LINE_COMMENT_MODE,c],relevance:0},e.C_LINE_COMMENT_MODE,c,r,l,t,e.C_NUMBER_MODE]},c]},{className:"class",beginKeywords:"class interface trait",end:/[:\{(]|$/,excludeEnd:!0,illegal:"extends implements",contains:[{beginKeywords:"public protected internal private constructor"},e.UNDERSCORE_TITLE_MODE,{className:"type",begin://,excludeBegin:!0,excludeEnd:!0,relevance:0},{className:"type",begin:/[,:]\s*/,end:/[<\(,]|$/,excludeBegin:!0,returnEnd:!0},r,l]},t,{className:"meta",begin:"^#!/usr/bin/env",end:"$",illegal:"\n"},{className:"number",begin:"\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",relevance:0}]}}}());hljs.registerLanguage("java",function(){"use strict";return function(e){var a="false synchronized int abstract float private char boolean var static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports do",n={className:"meta",begin:"@[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*",contains:[{begin:/\(/,end:/\)/,contains:["self"]}]};return{name:"Java",aliases:["jsp"],keywords:a,illegal:/<\/|#/,contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{begin:/\w+@/,relevance:0},{className:"doctag",begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"class",beginKeywords:"class interface",end:/[{;=]/,excludeEnd:!0,keywords:"class interface",illegal:/[:"\[\]]/,contains:[{beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"new throw return else",relevance:0},{className:"function",begin:"([À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*(<[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*(\\s*,\\s*[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*)*>)?\\s+)+"+e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,end:/[{;=]/,excludeEnd:!0,keywords:a,contains:[{begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0,contains:[e.UNDERSCORE_TITLE_MODE]},{className:"params",begin:/\(/,end:/\)/,keywords:a,relevance:0,contains:[n,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE]},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"number",begin:"\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",relevance:0},n]}}}());hljs.registerLanguage("cpp",function(){"use strict";return function(e){var t=e.getLanguage("c-like").rawDefinition();return t.disableAutodetect=!1,t.name="C++",t.aliases=["cc","c++","h++","hpp","hh","hxx","cxx"],t}}());
\ No newline at end of file
diff --git a/doc/public/js/hugo-learn.js b/doc/public/js/hugo-learn.js
deleted file mode 100644
index 9fab8de..0000000
--- a/doc/public/js/hugo-learn.js
+++ /dev/null
@@ -1,94 +0,0 @@
-// Get Parameters from some url
-var getUrlParameter = function getUrlParameter(sPageURL) {
- var url = sPageURL.split('?');
- var obj = {};
- if (url.length == 2) {
- var sURLVariables = url[1].split('&'),
- sParameterName,
- i;
- for (i = 0; i < sURLVariables.length; i++) {
- sParameterName = sURLVariables[i].split('=');
- obj[sParameterName[0]] = sParameterName[1];
- }
- }
- return obj;
-};
-
-// Execute actions on images generated from Markdown pages
-var images = $("div#body-inner img").not(".inline");
-// Wrap image inside a featherlight (to get a full size view in a popup)
-images.wrap(function(){
- var image =$(this);
- var o = getUrlParameter(image[0].src);
- var f = o['featherlight'];
- // IF featherlight is false, do not use feather light
- if (f != 'false') {
- if (!image.parent("a").length) {
- return "";
- }
- }
-});
-
-// Change styles, depending on parameters set to the image
-images.each(function(index){
- var image = $(this)
- var o = getUrlParameter(image[0].src);
- if (typeof o !== "undefined") {
- var h = o["height"];
- var w = o["width"];
- var c = o["classes"];
- image.css("width", function() {
- if (typeof w !== "undefined") {
- return w;
- } else {
- return "auto";
- }
- });
- image.css("height", function() {
- if (typeof h !== "undefined") {
- return h;
- } else {
- return "auto";
- }
- });
- if (typeof c !== "undefined") {
- var classes = c.split(',');
- for (i = 0; i < classes.length; i++) {
- image.addClass(classes[i]);
- }
- }
- }
-});
-
-// Stick the top to the top of the screen when scrolling
-$(document).ready(function(){
- $("#top-bar").sticky({topSpacing:0, zIndex: 1000});
-});
-
-
-jQuery(document).ready(function() {
- // Add link button for every
- var text, clip = new ClipboardJS('.anchor');
- $("h1~h2,h1~h3,h1~h4,h1~h5,h1~h6").append(function(index, html){
- var element = $(this);
- var url = encodeURI(document.location.origin + document.location.pathname);
- var link = url + "#"+element[0].id;
- return " " +
- "" +
- ""
- ;
- });
-
- $(".anchor").on('mouseleave', function(e) {
- $(this).attr('aria-label', null).removeClass('tooltipped tooltipped-s tooltipped-w');
- });
-
- clip.on('success', function(e) {
- e.clearSelection();
- $(e.trigger).attr('aria-label', 'Link copied to clipboard!').addClass('tooltipped tooltipped-s');
- });
- $('code.language-mermaid').each(function(index, element) {
- var content = $(element).html().replace(/&/g, '&');
- $(element).parent().replaceWith('0&&t-1 in e)}var E=function(e){var t,n,r,i,o,a,s,u,l,c,f,p,d,h,g,y,v,m,x,b="sizzle"+1*new Date,w=e.document,T=0,C=0,E=ae(),k=ae(),S=ae(),D=function(e,t){return e===t&&(f=!0),0},N={}.hasOwnProperty,A=[],j=A.pop,q=A.push,L=A.push,H=A.slice,O=function(e,t){for(var n=0,r=e.length;n+~]|"+M+")"+M+"*"),z=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),X=new RegExp(W),U=new RegExp("^"+R+"$"),V={ID:new RegExp("^#("+R+")"),CLASS:new RegExp("^\\.("+R+")"),TAG:new RegExp("^("+R+"|[*])"),ATTR:new RegExp("^"+I),PSEUDO:new RegExp("^"+W),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+P+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},G=/^(?:input|select|textarea|button)$/i,Y=/^h\d$/i,Q=/^[^{]+\{\s*\[native \w/,J=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,K=/[+~]/,Z=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),ee=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},te=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ne=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},re=function(){p()},ie=me(function(e){return!0===e.disabled&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{L.apply(A=H.call(w.childNodes),w.childNodes),A[w.childNodes.length].nodeType}catch(e){L={apply:A.length?function(e,t){q.apply(e,H.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function oe(e,t,r,i){var o,s,l,c,f,h,v,m=t&&t.ownerDocument,T=t?t.nodeType:9;if(r=r||[],"string"!=typeof e||!e||1!==T&&9!==T&&11!==T)return r;if(!i&&((t?t.ownerDocument||t:w)!==d&&p(t),t=t||d,g)){if(11!==T&&(f=J.exec(e)))if(o=f[1]){if(9===T){if(!(l=t.getElementById(o)))return r;if(l.id===o)return r.push(l),r}else if(m&&(l=m.getElementById(o))&&x(t,l)&&l.id===o)return r.push(l),r}else{if(f[2])return L.apply(r,t.getElementsByTagName(e)),r;if((o=f[3])&&n.getElementsByClassName&&t.getElementsByClassName)return L.apply(r,t.getElementsByClassName(o)),r}if(n.qsa&&!S[e+" "]&&(!y||!y.test(e))){if(1!==T)m=t,v=e;else if("object"!==t.nodeName.toLowerCase()){(c=t.getAttribute("id"))?c=c.replace(te,ne):t.setAttribute("id",c=b),s=(h=a(e)).length;while(s--)h[s]="#"+c+" "+ve(h[s]);v=h.join(","),m=K.test(e)&&ge(t.parentNode)||t}if(v)try{return L.apply(r,m.querySelectorAll(v)),r}catch(e){}finally{c===b&&t.removeAttribute("id")}}}return u(e.replace(B,"$1"),t,r,i)}function ae(){var e=[];function t(n,i){return e.push(n+" ")>r.cacheLength&&delete t[e.shift()],t[n+" "]=i}return t}function se(e){return e[b]=!0,e}function ue(e){var t=d.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function le(e,t){var n=e.split("|"),i=n.length;while(i--)r.attrHandle[n[i]]=t}function ce(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function fe(e){return function(t){return"input"===t.nodeName.toLowerCase()&&t.type===e}}function pe(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function de(e){return function(t){return"form"in t?t.parentNode&&!1===t.disabled?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ie(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function he(e){return se(function(t){return t=+t,se(function(n,r){var i,o=e([],n.length,t),a=o.length;while(a--)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}function ge(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}n=oe.support={},o=oe.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},p=oe.setDocument=function(e){var t,i,a=e?e.ownerDocument||e:w;return a!==d&&9===a.nodeType&&a.documentElement?(d=a,h=d.documentElement,g=!o(d),w!==d&&(i=d.defaultView)&&i.top!==i&&(i.addEventListener?i.addEventListener("unload",re,!1):i.attachEvent&&i.attachEvent("onunload",re)),n.attributes=ue(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=ue(function(e){return e.appendChild(d.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=Q.test(d.getElementsByClassName),n.getById=ue(function(e){return h.appendChild(e).id=b,!d.getElementsByName||!d.getElementsByName(b).length}),n.getById?(r.filter.ID=function(e){var t=e.replace(Z,ee);return function(e){return e.getAttribute("id")===t}},r.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&g){var n=t.getElementById(e);return n?[n]:[]}}):(r.filter.ID=function(e){var t=e.replace(Z,ee);return function(e){var n="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},r.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&g){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),r.find.TAG=n.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):n.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},r.find.CLASS=n.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&g)return t.getElementsByClassName(e)},v=[],y=[],(n.qsa=Q.test(d.querySelectorAll))&&(ue(function(e){h.appendChild(e).innerHTML="",e.querySelectorAll("[msallowcapture^='']").length&&y.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||y.push("\\["+M+"*(?:value|"+P+")"),e.querySelectorAll("[id~="+b+"-]").length||y.push("~="),e.querySelectorAll(":checked").length||y.push(":checked"),e.querySelectorAll("a#"+b+"+*").length||y.push(".#.+[+~]")}),ue(function(e){e.innerHTML="";var t=d.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&y.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&y.push(":enabled",":disabled"),h.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&y.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),y.push(",.*:")})),(n.matchesSelector=Q.test(m=h.matches||h.webkitMatchesSelector||h.mozMatchesSelector||h.oMatchesSelector||h.msMatchesSelector))&&ue(function(e){n.disconnectedMatch=m.call(e,"*"),m.call(e,"[s!='']:x"),v.push("!=",W)}),y=y.length&&new RegExp(y.join("|")),v=v.length&&new RegExp(v.join("|")),t=Q.test(h.compareDocumentPosition),x=t||Q.test(h.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},D=t?function(e,t){if(e===t)return f=!0,0;var r=!e.compareDocumentPosition-!t.compareDocumentPosition;return r||(1&(r=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!n.sortDetached&&t.compareDocumentPosition(e)===r?e===d||e.ownerDocument===w&&x(w,e)?-1:t===d||t.ownerDocument===w&&x(w,t)?1:c?O(c,e)-O(c,t):0:4&r?-1:1)}:function(e,t){if(e===t)return f=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e===d?-1:t===d?1:i?-1:o?1:c?O(c,e)-O(c,t):0;if(i===o)return ce(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?ce(a[r],s[r]):a[r]===w?-1:s[r]===w?1:0},d):d},oe.matches=function(e,t){return oe(e,null,null,t)},oe.matchesSelector=function(e,t){if((e.ownerDocument||e)!==d&&p(e),t=t.replace(z,"='$1']"),n.matchesSelector&&g&&!S[t+" "]&&(!v||!v.test(t))&&(!y||!y.test(t)))try{var r=m.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return oe(t,d,null,[e]).length>0},oe.contains=function(e,t){return(e.ownerDocument||e)!==d&&p(e),x(e,t)},oe.attr=function(e,t){(e.ownerDocument||e)!==d&&p(e);var i=r.attrHandle[t.toLowerCase()],o=i&&N.call(r.attrHandle,t.toLowerCase())?i(e,t,!g):void 0;return void 0!==o?o:n.attributes||!g?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null},oe.escape=function(e){return(e+"").replace(te,ne)},oe.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},oe.uniqueSort=function(e){var t,r=[],i=0,o=0;if(f=!n.detectDuplicates,c=!n.sortStable&&e.slice(0),e.sort(D),f){while(t=e[o++])t===e[o]&&(i=r.push(o));while(i--)e.splice(r[i],1)}return c=null,e},i=oe.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=i(e)}else if(3===o||4===o)return e.nodeValue}else while(t=e[r++])n+=i(t);return n},(r=oe.selectors={cacheLength:50,createPseudo:se,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(Z,ee),e[3]=(e[3]||e[4]||e[5]||"").replace(Z,ee),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||oe.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&oe.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return V.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=a(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(Z,ee).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=E[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&E(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=oe.attr(r,e);return null==i?"!="===t:!t||(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i.replace($," ")+" ").indexOf(n)>-1:"|="===t&&(i===n||i.slice(0,n.length+1)===n+"-"))}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,u){var l,c,f,p,d,h,g=o!==a?"nextSibling":"previousSibling",y=t.parentNode,v=s&&t.nodeName.toLowerCase(),m=!u&&!s,x=!1;if(y){if(o){while(g){p=t;while(p=p[g])if(s?p.nodeName.toLowerCase()===v:1===p.nodeType)return!1;h=g="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?y.firstChild:y.lastChild],a&&m){x=(d=(l=(c=(f=(p=y)[b]||(p[b]={}))[p.uniqueID]||(f[p.uniqueID]={}))[e]||[])[0]===T&&l[1])&&l[2],p=d&&y.childNodes[d];while(p=++d&&p&&p[g]||(x=d=0)||h.pop())if(1===p.nodeType&&++x&&p===t){c[e]=[T,d,x];break}}else if(m&&(x=d=(l=(c=(f=(p=t)[b]||(p[b]={}))[p.uniqueID]||(f[p.uniqueID]={}))[e]||[])[0]===T&&l[1]),!1===x)while(p=++d&&p&&p[g]||(x=d=0)||h.pop())if((s?p.nodeName.toLowerCase()===v:1===p.nodeType)&&++x&&(m&&((c=(f=p[b]||(p[b]={}))[p.uniqueID]||(f[p.uniqueID]={}))[e]=[T,x]),p===t))break;return(x-=i)===r||x%r==0&&x/r>=0}}},PSEUDO:function(e,t){var n,i=r.pseudos[e]||r.setFilters[e.toLowerCase()]||oe.error("unsupported pseudo: "+e);return i[b]?i(t):i.length>1?(n=[e,e,"",t],r.setFilters.hasOwnProperty(e.toLowerCase())?se(function(e,n){var r,o=i(e,t),a=o.length;while(a--)e[r=O(e,o[a])]=!(n[r]=o[a])}):function(e){return i(e,0,n)}):i}},pseudos:{not:se(function(e){var t=[],n=[],r=s(e.replace(B,"$1"));return r[b]?se(function(e,t,n,i){var o,a=r(e,null,i,[]),s=e.length;while(s--)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),t[0]=null,!n.pop()}}),has:se(function(e){return function(t){return oe(e,t).length>0}}),contains:se(function(e){return e=e.replace(Z,ee),function(t){return(t.textContent||t.innerText||i(t)).indexOf(e)>-1}}),lang:se(function(e){return U.test(e||"")||oe.error("unsupported lang: "+e),e=e.replace(Z,ee).toLowerCase(),function(t){var n;do{if(n=g?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return(n=n.toLowerCase())===e||0===n.indexOf(e+"-")}while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===h},focus:function(e){return e===d.activeElement&&(!d.hasFocus||d.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:de(!1),disabled:de(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!r.pseudos.empty(e)},header:function(e){return Y.test(e.nodeName)},input:function(e){return G.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:he(function(){return[0]}),last:he(function(e,t){return[t-1]}),eq:he(function(e,t,n){return[n<0?n+t:n]}),even:he(function(e,t){for(var n=0;n=0;)e.push(r);return e}),gt:he(function(e,t,n){for(var r=n<0?n+t:n;++r1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function be(e,t,n){for(var r=0,i=t.length;r-1&&(o[l]=!(a[l]=f))}}else v=we(v===a?v.splice(h,v.length):v),i?i(null,a,v,u):L.apply(a,v)})}function Ce(e){for(var t,n,i,o=e.length,a=r.relative[e[0].type],s=a||r.relative[" "],u=a?1:0,c=me(function(e){return e===t},s,!0),f=me(function(e){return O(t,e)>-1},s,!0),p=[function(e,n,r){var i=!a&&(r||n!==l)||((t=n).nodeType?c(e,n,r):f(e,n,r));return t=null,i}];u1&&xe(p),u>1&&ve(e.slice(0,u-1).concat({value:" "===e[u-2].type?"*":""})).replace(B,"$1"),n,u0,i=e.length>0,o=function(o,a,s,u,c){var f,h,y,v=0,m="0",x=o&&[],b=[],w=l,C=o||i&&r.find.TAG("*",c),E=T+=null==w?1:Math.random()||.1,k=C.length;for(c&&(l=a===d||a||c);m!==k&&null!=(f=C[m]);m++){if(i&&f){h=0,a||f.ownerDocument===d||(p(f),s=!g);while(y=e[h++])if(y(f,a||d,s)){u.push(f);break}c&&(T=E)}n&&((f=!y&&f)&&v--,o&&x.push(f))}if(v+=m,n&&m!==v){h=0;while(y=t[h++])y(x,b,a,s);if(o){if(v>0)while(m--)x[m]||b[m]||(b[m]=j.call(u));b=we(b)}L.apply(u,b),c&&!o&&b.length>0&&v+t.length>1&&oe.uniqueSort(u)}return c&&(T=E,l=w),x};return n?se(o):o}return s=oe.compile=function(e,t){var n,r=[],i=[],o=S[e+" "];if(!o){t||(t=a(e)),n=t.length;while(n--)(o=Ce(t[n]))[b]?r.push(o):i.push(o);(o=S(e,Ee(i,r))).selector=e}return o},u=oe.select=function(e,t,n,i){var o,u,l,c,f,p="function"==typeof e&&e,d=!i&&a(e=p.selector||e);if(n=n||[],1===d.length){if((u=d[0]=d[0].slice(0)).length>2&&"ID"===(l=u[0]).type&&9===t.nodeType&&g&&r.relative[u[1].type]){if(!(t=(r.find.ID(l.matches[0].replace(Z,ee),t)||[])[0]))return n;p&&(t=t.parentNode),e=e.slice(u.shift().value.length)}o=V.needsContext.test(e)?0:u.length;while(o--){if(l=u[o],r.relative[c=l.type])break;if((f=r.find[c])&&(i=f(l.matches[0].replace(Z,ee),K.test(u[0].type)&&ge(t.parentNode)||t))){if(u.splice(o,1),!(e=i.length&&ve(u)))return L.apply(n,i),n;break}}}return(p||s(e,d))(i,t,!g,n,!t||K.test(e)&&ge(t.parentNode)||t),n},n.sortStable=b.split("").sort(D).join("")===b,n.detectDuplicates=!!f,p(),n.sortDetached=ue(function(e){return 1&e.compareDocumentPosition(d.createElement("fieldset"))}),ue(function(e){return e.innerHTML="","#"===e.firstChild.getAttribute("href")})||le("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&ue(function(e){return e.innerHTML="",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||le("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ue(function(e){return null==e.getAttribute("disabled")})||le(P,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),oe}(e);w.find=E,w.expr=E.selectors,w.expr[":"]=w.expr.pseudos,w.uniqueSort=w.unique=E.uniqueSort,w.text=E.getText,w.isXMLDoc=E.isXML,w.contains=E.contains,w.escapeSelector=E.escape;var k=function(e,t,n){var r=[],i=void 0!==n;while((e=e[t])&&9!==e.nodeType)if(1===e.nodeType){if(i&&w(e).is(n))break;r.push(e)}return r},S=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},D=w.expr.match.needsContext;function N(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var A=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,t,n){return g(t)?w.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?w.grep(e,function(e){return e===t!==n}):"string"!=typeof t?w.grep(e,function(e){return u.call(t,e)>-1!==n}):w.filter(t,e,n)}w.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?w.find.matchesSelector(r,e)?[r]:[]:w.find.matches(e,w.grep(t,function(e){return 1===e.nodeType}))},w.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(w(e).filter(function(){for(t=0;t1?w.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&D.test(e)?w(e):e||[],!1).length}});var q,L=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(w.fn.init=function(e,t,n){var i,o;if(!e)return this;if(n=n||q,"string"==typeof e){if(!(i="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:L.exec(e))||!i[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(i[1]){if(t=t instanceof w?t[0]:t,w.merge(this,w.parseHTML(i[1],t&&t.nodeType?t.ownerDocument||t:r,!0)),A.test(i[1])&&w.isPlainObject(t))for(i in t)g(this[i])?this[i](t[i]):this.attr(i,t[i]);return this}return(o=r.getElementById(i[2]))&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):g(e)?void 0!==n.ready?n.ready(e):e(w):w.makeArray(e,this)}).prototype=w.fn,q=w(r);var H=/^(?:parents|prev(?:Until|All))/,O={children:!0,contents:!0,next:!0,prev:!0};w.fn.extend({has:function(e){var t=w(e,this),n=t.length;return this.filter(function(){for(var e=0;e-1:1===n.nodeType&&w.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(o.length>1?w.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?u.call(w(e),this[0]):u.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(w.uniqueSort(w.merge(this.get(),w(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}});function P(e,t){while((e=e[t])&&1!==e.nodeType);return e}w.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return k(e,"parentNode")},parentsUntil:function(e,t,n){return k(e,"parentNode",n)},next:function(e){return P(e,"nextSibling")},prev:function(e){return P(e,"previousSibling")},nextAll:function(e){return k(e,"nextSibling")},prevAll:function(e){return k(e,"previousSibling")},nextUntil:function(e,t,n){return k(e,"nextSibling",n)},prevUntil:function(e,t,n){return k(e,"previousSibling",n)},siblings:function(e){return S((e.parentNode||{}).firstChild,e)},children:function(e){return S(e.firstChild)},contents:function(e){return N(e,"iframe")?e.contentDocument:(N(e,"template")&&(e=e.content||e),w.merge([],e.childNodes))}},function(e,t){w.fn[e]=function(n,r){var i=w.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=w.filter(r,i)),this.length>1&&(O[e]||w.uniqueSort(i),H.test(e)&&i.reverse()),this.pushStack(i)}});var M=/[^\x20\t\r\n\f]+/g;function R(e){var t={};return w.each(e.match(M)||[],function(e,n){t[n]=!0}),t}w.Callbacks=function(e){e="string"==typeof e?R(e):w.extend({},e);var t,n,r,i,o=[],a=[],s=-1,u=function(){for(i=i||e.once,r=t=!0;a.length;s=-1){n=a.shift();while(++s-1)o.splice(n,1),n<=s&&s--}),this},has:function(e){return e?w.inArray(e,o)>-1:o.length>0},empty:function(){return o&&(o=[]),this},disable:function(){return i=a=[],o=n="",this},disabled:function(){return!o},lock:function(){return i=a=[],n||t||(o=n=""),this},locked:function(){return!!i},fireWith:function(e,n){return i||(n=[e,(n=n||[]).slice?n.slice():n],a.push(n),t||u()),this},fire:function(){return l.fireWith(this,arguments),this},fired:function(){return!!r}};return l};function I(e){return e}function W(e){throw e}function $(e,t,n,r){var i;try{e&&g(i=e.promise)?i.call(e).done(t).fail(n):e&&g(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}w.extend({Deferred:function(t){var n=[["notify","progress",w.Callbacks("memory"),w.Callbacks("memory"),2],["resolve","done",w.Callbacks("once memory"),w.Callbacks("once memory"),0,"resolved"],["reject","fail",w.Callbacks("once memory"),w.Callbacks("once memory"),1,"rejected"]],r="pending",i={state:function(){return r},always:function(){return o.done(arguments).fail(arguments),this},"catch":function(e){return i.then(null,e)},pipe:function(){var e=arguments;return w.Deferred(function(t){w.each(n,function(n,r){var i=g(e[r[4]])&&e[r[4]];o[r[1]](function(){var e=i&&i.apply(this,arguments);e&&g(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,i?[e]:arguments)})}),e=null}).promise()},then:function(t,r,i){var o=0;function a(t,n,r,i){return function(){var s=this,u=arguments,l=function(){var e,l;if(!(t=o&&(r!==W&&(s=void 0,u=[e]),n.rejectWith(s,u))}};t?c():(w.Deferred.getStackHook&&(c.stackTrace=w.Deferred.getStackHook()),e.setTimeout(c))}}return w.Deferred(function(e){n[0][3].add(a(0,e,g(i)?i:I,e.notifyWith)),n[1][3].add(a(0,e,g(t)?t:I)),n[2][3].add(a(0,e,g(r)?r:W))}).promise()},promise:function(e){return null!=e?w.extend(e,i):i}},o={};return w.each(n,function(e,t){var a=t[2],s=t[5];i[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[3-e][3].disable,n[0][2].lock,n[0][3].lock),a.add(t[3].fire),o[t[0]]=function(){return o[t[0]+"With"](this===o?void 0:this,arguments),this},o[t[0]+"With"]=a.fireWith}),i.promise(o),t&&t.call(o,o),o},when:function(e){var t=arguments.length,n=t,r=Array(n),i=o.call(arguments),a=w.Deferred(),s=function(e){return function(n){r[e]=this,i[e]=arguments.length>1?o.call(arguments):n,--t||a.resolveWith(r,i)}};if(t<=1&&($(e,a.done(s(n)).resolve,a.reject,!t),"pending"===a.state()||g(i[n]&&i[n].then)))return a.then();while(n--)$(i[n],s(n),a.reject);return a.promise()}});var B=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;w.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&B.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},w.readyException=function(t){e.setTimeout(function(){throw t})};var F=w.Deferred();w.fn.ready=function(e){return F.then(e)["catch"](function(e){w.readyException(e)}),this},w.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--w.readyWait:w.isReady)||(w.isReady=!0,!0!==e&&--w.readyWait>0||F.resolveWith(r,[w]))}}),w.ready.then=F.then;function _(){r.removeEventListener("DOMContentLoaded",_),e.removeEventListener("load",_),w.ready()}"complete"===r.readyState||"loading"!==r.readyState&&!r.documentElement.doScroll?e.setTimeout(w.ready):(r.addEventListener("DOMContentLoaded",_),e.addEventListener("load",_));var z=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===x(n)){i=!0;for(s in n)z(e,t,s,n[s],!0,o,a)}else if(void 0!==r&&(i=!0,g(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(w(e),n)})),t))for(;s1,null,!0)},removeData:function(e){return this.each(function(){K.remove(this,e)})}}),w.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=J.get(e,t),n&&(!r||Array.isArray(n)?r=J.access(e,t,w.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=w.queue(e,t),r=n.length,i=n.shift(),o=w._queueHooks(e,t),a=function(){w.dequeue(e,t)};"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,a,o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return J.get(e,n)||J.access(e,n,{empty:w.Callbacks("once memory").add(function(){J.remove(e,[t+"queue",n])})})}}),w.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length\x20\t\r\n\f]+)/i,he=/^$|^module$|\/(?:java|ecma)script/i,ge={option:[1,""],thead:[1,"","
"],col:[2,"
"],tr:[2,"","
"],td:[3,"
"],_default:[0,"",""]};ge.optgroup=ge.option,ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td;function ye(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&N(e,t)?w.merge([e],n):n}function ve(e,t){for(var n=0,r=e.length;n-1)i&&i.push(o);else if(l=w.contains(o.ownerDocument,o),a=ye(f.appendChild(o),"script"),l&&ve(a),n){c=0;while(o=a[c++])he.test(o.type||"")&&n.push(o)}return f}!function(){var e=r.createDocumentFragment().appendChild(r.createElement("div")),t=r.createElement("input");t.setAttribute("type","radio"),t.setAttribute("checked","checked"),t.setAttribute("name","t"),e.appendChild(t),h.checkClone=e.cloneNode(!0).cloneNode(!0).lastChild.checked,e.innerHTML="",h.noCloneChecked=!!e.cloneNode(!0).lastChild.defaultValue}();var be=r.documentElement,we=/^key/,Te=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,Ce=/^([^.]*)(?:\.(.+)|)/;function Ee(){return!0}function ke(){return!1}function Se(){try{return r.activeElement}catch(e){}}function De(e,t,n,r,i,o){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)De(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=ke;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return w().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=w.guid++)),e.each(function(){w.event.add(this,t,i,r,n)})}w.event={global:{},add:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,y=J.get(e);if(y){n.handler&&(n=(o=n).handler,i=o.selector),i&&w.find.matchesSelector(be,i),n.guid||(n.guid=w.guid++),(u=y.events)||(u=y.events={}),(a=y.handle)||(a=y.handle=function(t){return"undefined"!=typeof w&&w.event.triggered!==t.type?w.event.dispatch.apply(e,arguments):void 0}),l=(t=(t||"").match(M)||[""]).length;while(l--)d=g=(s=Ce.exec(t[l])||[])[1],h=(s[2]||"").split(".").sort(),d&&(f=w.event.special[d]||{},d=(i?f.delegateType:f.bindType)||d,f=w.event.special[d]||{},c=w.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&w.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=u[d])||((p=u[d]=[]).delegateCount=0,f.setup&&!1!==f.setup.call(e,r,h,a)||e.addEventListener&&e.addEventListener(d,a)),f.add&&(f.add.call(e,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),w.event.global[d]=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,y=J.hasData(e)&&J.get(e);if(y&&(u=y.events)){l=(t=(t||"").match(M)||[""]).length;while(l--)if(s=Ce.exec(t[l])||[],d=g=s[1],h=(s[2]||"").split(".").sort(),d){f=w.event.special[d]||{},p=u[d=(r?f.delegateType:f.bindType)||d]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=p[o],!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,y.handle)||w.removeEvent(e,d,y.handle),delete u[d])}else for(d in u)w.event.remove(e,d+t[l],n,r,!0);w.isEmptyObject(u)&&J.remove(e,"handle events")}},dispatch:function(e){var t=w.event.fix(e),n,r,i,o,a,s,u=new Array(arguments.length),l=(J.get(this,"events")||{})[t.type]||[],c=w.event.special[t.type]||{};for(u[0]=t,n=1;n=1))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=[],a={},n=0;n-1:w.find(i,this,null,[l]).length),a[i]&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u\x20\t\r\n\f]*)[^>]*)\/>/gi,Ae=/\s*$/g;function Le(e,t){return N(e,"table")&&N(11!==t.nodeType?t:t.firstChild,"tr")?w(e).children("tbody")[0]||e:e}function He(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function Oe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Pe(e,t){var n,r,i,o,a,s,u,l;if(1===t.nodeType){if(J.hasData(e)&&(o=J.access(e),a=J.set(t,o),l=o.events)){delete a.handle,a.events={};for(i in l)for(n=0,r=l[i].length;n1&&"string"==typeof y&&!h.checkClone&&je.test(y))return e.each(function(i){var o=e.eq(i);v&&(t[0]=y.call(this,i,o.html())),Re(o,t,n,r)});if(p&&(i=xe(t,e[0].ownerDocument,!1,e,r),o=i.firstChild,1===i.childNodes.length&&(i=o),o||r)){for(u=(s=w.map(ye(i,"script"),He)).length;f")},clone:function(e,t,n){var r,i,o,a,s=e.cloneNode(!0),u=w.contains(e.ownerDocument,e);if(!(h.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||w.isXMLDoc(e)))for(a=ye(s),r=0,i=(o=ye(e)).length;r0&&ve(a,!u&&ye(e,"script")),s},cleanData:function(e){for(var t,n,r,i=w.event.special,o=0;void 0!==(n=e[o]);o++)if(Y(n)){if(t=n[J.expando]){if(t.events)for(r in t.events)i[r]?w.event.remove(n,r):w.removeEvent(n,r,t.handle);n[J.expando]=void 0}n[K.expando]&&(n[K.expando]=void 0)}}}),w.fn.extend({detach:function(e){return Ie(this,e,!0)},remove:function(e){return Ie(this,e)},text:function(e){return z(this,function(e){return void 0===e?w.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Re(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||Le(this,e).appendChild(e)})},prepend:function(){return Re(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=Le(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Re(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(w.cleanData(ye(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return w.clone(this,e,t)})},html:function(e){return z(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Ae.test(e)&&!ge[(de.exec(e)||["",""])[1].toLowerCase()]){e=w.htmlPrefilter(e);try{for(;n=0&&(u+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-u-s-.5))),u}function et(e,t,n){var r=$e(e),i=Fe(e,t,r),o="border-box"===w.css(e,"boxSizing",!1,r),a=o;if(We.test(i)){if(!n)return i;i="auto"}return a=a&&(h.boxSizingReliable()||i===e.style[t]),("auto"===i||!parseFloat(i)&&"inline"===w.css(e,"display",!1,r))&&(i=e["offset"+t[0].toUpperCase()+t.slice(1)],a=!0),(i=parseFloat(i)||0)+Ze(e,t,n||(o?"border":"content"),a,r,i)+"px"}w.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Fe(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=G(t),u=Xe.test(t),l=e.style;if(u||(t=Je(s)),a=w.cssHooks[t]||w.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:l[t];"string"==(o=typeof n)&&(i=ie.exec(n))&&i[1]&&(n=ue(e,t,i),o="number"),null!=n&&n===n&&("number"===o&&(n+=i&&i[3]||(w.cssNumber[s]?"":"px")),h.clearCloneStyle||""!==n||0!==t.indexOf("background")||(l[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):l[t]=n))}},css:function(e,t,n,r){var i,o,a,s=G(t);return Xe.test(t)||(t=Je(s)),(a=w.cssHooks[t]||w.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=Fe(e,t,r)),"normal"===i&&t in Ve&&(i=Ve[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),w.each(["height","width"],function(e,t){w.cssHooks[t]={get:function(e,n,r){if(n)return!ze.test(w.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?et(e,t,r):se(e,Ue,function(){return et(e,t,r)})},set:function(e,n,r){var i,o=$e(e),a="border-box"===w.css(e,"boxSizing",!1,o),s=r&&Ze(e,t,r,a,o);return a&&h.scrollboxSize()===o.position&&(s-=Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-parseFloat(o[t])-Ze(e,t,"border",!1,o)-.5)),s&&(i=ie.exec(n))&&"px"!==(i[3]||"px")&&(e.style[t]=n,n=w.css(e,t)),Ke(e,n,s)}}}),w.cssHooks.marginLeft=_e(h.reliableMarginLeft,function(e,t){if(t)return(parseFloat(Fe(e,"marginLeft"))||e.getBoundingClientRect().left-se(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),w.each({margin:"",padding:"",border:"Width"},function(e,t){w.cssHooks[e+t]={expand:function(n){for(var r=0,i={},o="string"==typeof n?n.split(" "):[n];r<4;r++)i[e+oe[r]+t]=o[r]||o[r-2]||o[0];return i}},"margin"!==e&&(w.cssHooks[e+t].set=Ke)}),w.fn.extend({css:function(e,t){return z(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=$e(e),i=t.length;a1)}});function tt(e,t,n,r,i){return new tt.prototype.init(e,t,n,r,i)}w.Tween=tt,tt.prototype={constructor:tt,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||w.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(w.cssNumber[n]?"":"px")},cur:function(){var e=tt.propHooks[this.prop];return e&&e.get?e.get(this):tt.propHooks._default.get(this)},run:function(e){var t,n=tt.propHooks[this.prop];return this.options.duration?this.pos=t=w.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):tt.propHooks._default.set(this),this}},tt.prototype.init.prototype=tt.prototype,tt.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=w.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){w.fx.step[e.prop]?w.fx.step[e.prop](e):1!==e.elem.nodeType||null==e.elem.style[w.cssProps[e.prop]]&&!w.cssHooks[e.prop]?e.elem[e.prop]=e.now:w.style(e.elem,e.prop,e.now+e.unit)}}},tt.propHooks.scrollTop=tt.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},w.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},w.fx=tt.prototype.init,w.fx.step={};var nt,rt,it=/^(?:toggle|show|hide)$/,ot=/queueHooks$/;function at(){rt&&(!1===r.hidden&&e.requestAnimationFrame?e.requestAnimationFrame(at):e.setTimeout(at,w.fx.interval),w.fx.tick())}function st(){return e.setTimeout(function(){nt=void 0}),nt=Date.now()}function ut(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i["margin"+(n=oe[r])]=i["padding"+n]=e;return t&&(i.opacity=i.width=e),i}function lt(e,t,n){for(var r,i=(pt.tweeners[t]||[]).concat(pt.tweeners["*"]),o=0,a=i.length;o1)},removeAttr:function(e){return this.each(function(){w.removeAttr(this,e)})}}),w.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?w.prop(e,t,n):(1===o&&w.isXMLDoc(e)||(i=w.attrHooks[t.toLowerCase()]||(w.expr.match.bool.test(t)?dt:void 0)),void 0!==n?null===n?void w.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=w.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!h.radioValue&&"radio"===t&&N(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(M);if(i&&1===e.nodeType)while(n=i[r++])e.removeAttribute(n)}}),dt={set:function(e,t,n){return!1===t?w.removeAttr(e,n):e.setAttribute(n,n),n}},w.each(w.expr.match.bool.source.match(/\w+/g),function(e,t){var n=ht[t]||w.find.attr;ht[t]=function(e,t,r){var i,o,a=t.toLowerCase();return r||(o=ht[a],ht[a]=i,i=null!=n(e,t,r)?a:null,ht[a]=o),i}});var gt=/^(?:input|select|textarea|button)$/i,yt=/^(?:a|area)$/i;w.fn.extend({prop:function(e,t){return z(this,w.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[w.propFix[e]||e]})}}),w.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&w.isXMLDoc(e)||(t=w.propFix[t]||t,i=w.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=w.find.attr(e,"tabindex");return t?parseInt(t,10):gt.test(e.nodeName)||yt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),h.optSelected||(w.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),w.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){w.propFix[this.toLowerCase()]=this});function vt(e){return(e.match(M)||[]).join(" ")}function mt(e){return e.getAttribute&&e.getAttribute("class")||""}function xt(e){return Array.isArray(e)?e:"string"==typeof e?e.match(M)||[]:[]}w.fn.extend({addClass:function(e){var t,n,r,i,o,a,s,u=0;if(g(e))return this.each(function(t){w(this).addClass(e.call(this,t,mt(this)))});if((t=xt(e)).length)while(n=this[u++])if(i=mt(n),r=1===n.nodeType&&" "+vt(i)+" "){a=0;while(o=t[a++])r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=vt(r))&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,i,o,a,s,u=0;if(g(e))return this.each(function(t){w(this).removeClass(e.call(this,t,mt(this)))});if(!arguments.length)return this.attr("class","");if((t=xt(e)).length)while(n=this[u++])if(i=mt(n),r=1===n.nodeType&&" "+vt(i)+" "){a=0;while(o=t[a++])while(r.indexOf(" "+o+" ")>-1)r=r.replace(" "+o+" "," ");i!==(s=vt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e,r="string"===n||Array.isArray(e);return"boolean"==typeof t&&r?t?this.addClass(e):this.removeClass(e):g(e)?this.each(function(n){w(this).toggleClass(e.call(this,n,mt(this),t),t)}):this.each(function(){var t,i,o,a;if(r){i=0,o=w(this),a=xt(e);while(t=a[i++])o.hasClass(t)?o.removeClass(t):o.addClass(t)}else void 0!==e&&"boolean"!==n||((t=mt(this))&&J.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||!1===e?"":J.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=this[r++])if(1===n.nodeType&&(" "+vt(mt(n))+" ").indexOf(t)>-1)return!0;return!1}});var bt=/\r/g;w.fn.extend({val:function(e){var t,n,r,i=this[0];{if(arguments.length)return r=g(e),this.each(function(n){var i;1===this.nodeType&&(null==(i=r?e.call(this,n,w(this).val()):e)?i="":"number"==typeof i?i+="":Array.isArray(i)&&(i=w.map(i,function(e){return null==e?"":e+""})),(t=w.valHooks[this.type]||w.valHooks[this.nodeName.toLowerCase()])&&"set"in t&&void 0!==t.set(this,i,"value")||(this.value=i))});if(i)return(t=w.valHooks[i.type]||w.valHooks[i.nodeName.toLowerCase()])&&"get"in t&&void 0!==(n=t.get(i,"value"))?n:"string"==typeof(n=i.value)?n.replace(bt,""):null==n?"":n}}}),w.extend({valHooks:{option:{get:function(e){var t=w.find.attr(e,"value");return null!=t?t:vt(w.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],u=a?o+1:i.length;for(r=o<0?u:a?o:0;r-1)&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),w.each(["radio","checkbox"],function(){w.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=w.inArray(w(e).val(),t)>-1}},h.checkOn||(w.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),h.focusin="onfocusin"in e;var wt=/^(?:focusinfocus|focusoutblur)$/,Tt=function(e){e.stopPropagation()};w.extend(w.event,{trigger:function(t,n,i,o){var a,s,u,l,c,p,d,h,v=[i||r],m=f.call(t,"type")?t.type:t,x=f.call(t,"namespace")?t.namespace.split("."):[];if(s=h=u=i=i||r,3!==i.nodeType&&8!==i.nodeType&&!wt.test(m+w.event.triggered)&&(m.indexOf(".")>-1&&(m=(x=m.split(".")).shift(),x.sort()),c=m.indexOf(":")<0&&"on"+m,t=t[w.expando]?t:new w.Event(m,"object"==typeof t&&t),t.isTrigger=o?2:3,t.namespace=x.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+x.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=i),n=null==n?[t]:w.makeArray(n,[t]),d=w.event.special[m]||{},o||!d.trigger||!1!==d.trigger.apply(i,n))){if(!o&&!d.noBubble&&!y(i)){for(l=d.delegateType||m,wt.test(l+m)||(s=s.parentNode);s;s=s.parentNode)v.push(s),u=s;u===(i.ownerDocument||r)&&v.push(u.defaultView||u.parentWindow||e)}a=0;while((s=v[a++])&&!t.isPropagationStopped())h=s,t.type=a>1?l:d.bindType||m,(p=(J.get(s,"events")||{})[t.type]&&J.get(s,"handle"))&&p.apply(s,n),(p=c&&s[c])&&p.apply&&Y(s)&&(t.result=p.apply(s,n),!1===t.result&&t.preventDefault());return t.type=m,o||t.isDefaultPrevented()||d._default&&!1!==d._default.apply(v.pop(),n)||!Y(i)||c&&g(i[m])&&!y(i)&&((u=i[c])&&(i[c]=null),w.event.triggered=m,t.isPropagationStopped()&&h.addEventListener(m,Tt),i[m](),t.isPropagationStopped()&&h.removeEventListener(m,Tt),w.event.triggered=void 0,u&&(i[c]=u)),t.result}},simulate:function(e,t,n){var r=w.extend(new w.Event,n,{type:e,isSimulated:!0});w.event.trigger(r,null,t)}}),w.fn.extend({trigger:function(e,t){return this.each(function(){w.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return w.event.trigger(e,t,n,!0)}}),h.focusin||w.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){w.event.simulate(t,e.target,w.event.fix(e))};w.event.special[t]={setup:function(){var r=this.ownerDocument||this,i=J.access(r,t);i||r.addEventListener(e,n,!0),J.access(r,t,(i||0)+1)},teardown:function(){var r=this.ownerDocument||this,i=J.access(r,t)-1;i?J.access(r,t,i):(r.removeEventListener(e,n,!0),J.remove(r,t))}}});var Ct=e.location,Et=Date.now(),kt=/\?/;w.parseXML=function(t){var n;if(!t||"string"!=typeof t)return null;try{n=(new e.DOMParser).parseFromString(t,"text/xml")}catch(e){n=void 0}return n&&!n.getElementsByTagName("parsererror").length||w.error("Invalid XML: "+t),n};var St=/\[\]$/,Dt=/\r?\n/g,Nt=/^(?:submit|button|image|reset|file)$/i,At=/^(?:input|select|textarea|keygen)/i;function jt(e,t,n,r){var i;if(Array.isArray(t))w.each(t,function(t,i){n||St.test(e)?r(e,i):jt(e+"["+("object"==typeof i&&null!=i?t:"")+"]",i,n,r)});else if(n||"object"!==x(t))r(e,t);else for(i in t)jt(e+"["+i+"]",t[i],n,r)}w.param=function(e,t){var n,r=[],i=function(e,t){var n=g(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(Array.isArray(e)||e.jquery&&!w.isPlainObject(e))w.each(e,function(){i(this.name,this.value)});else for(n in e)jt(n,e[n],t,i);return r.join("&")},w.fn.extend({serialize:function(){return w.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=w.prop(this,"elements");return e?w.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!w(this).is(":disabled")&&At.test(this.nodeName)&&!Nt.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=w(this).val();return null==n?null:Array.isArray(n)?w.map(n,function(e){return{name:t.name,value:e.replace(Dt,"\r\n")}}):{name:t.name,value:n.replace(Dt,"\r\n")}}).get()}});var qt=/%20/g,Lt=/#.*$/,Ht=/([?&])_=[^&]*/,Ot=/^(.*?):[ \t]*([^\r\n]*)$/gm,Pt=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Mt=/^(?:GET|HEAD)$/,Rt=/^\/\//,It={},Wt={},$t="*/".concat("*"),Bt=r.createElement("a");Bt.href=Ct.href;function Ft(e){return function(t,n){"string"!=typeof t&&(n=t,t="*");var r,i=0,o=t.toLowerCase().match(M)||[];if(g(n))while(r=o[i++])"+"===r[0]?(r=r.slice(1)||"*",(e[r]=e[r]||[]).unshift(n)):(e[r]=e[r]||[]).push(n)}}function _t(e,t,n,r){var i={},o=e===Wt;function a(s){var u;return i[s]=!0,w.each(e[s]||[],function(e,s){var l=s(t,n,r);return"string"!=typeof l||o||i[l]?o?!(u=l):void 0:(t.dataTypes.unshift(l),a(l),!1)}),u}return a(t.dataTypes[0])||!i["*"]&&a("*")}function zt(e,t){var n,r,i=w.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((i[n]?e:r||(r={}))[n]=t[n]);return r&&w.extend(!0,e,r),e}function Xt(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u[0])u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(s[i]&&s[i].test(r)){u.unshift(i);break}if(u[0]in n)o=u[0];else{for(i in n){if(!u[0]||e.converters[i+" "+u[0]]){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u[0]&&u.unshift(o),n[o]}function Ut(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)l[a.toLowerCase()]=e.converters[a];o=c.shift();while(o)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=l[u+" "+o]||l["* "+o]))for(i in l)if((s=i.split(" "))[1]===o&&(a=l[u+" "+s[0]]||l["* "+s[0]])){!0===a?a=l[i]:!0!==l[i]&&(o=s[0],c.unshift(s[1]));break}if(!0!==a)if(a&&e["throws"])t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}w.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Ct.href,type:"GET",isLocal:Pt.test(Ct.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":$t,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":w.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?zt(zt(e,w.ajaxSettings),t):zt(w.ajaxSettings,e)},ajaxPrefilter:Ft(It),ajaxTransport:Ft(Wt),ajax:function(t,n){"object"==typeof t&&(n=t,t=void 0),n=n||{};var i,o,a,s,u,l,c,f,p,d,h=w.ajaxSetup({},n),g=h.context||h,y=h.context&&(g.nodeType||g.jquery)?w(g):w.event,v=w.Deferred(),m=w.Callbacks("once memory"),x=h.statusCode||{},b={},T={},C="canceled",E={readyState:0,getResponseHeader:function(e){var t;if(c){if(!s){s={};while(t=Ot.exec(a))s[t[1].toLowerCase()]=t[2]}t=s[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return c?a:null},setRequestHeader:function(e,t){return null==c&&(e=T[e.toLowerCase()]=T[e.toLowerCase()]||e,b[e]=t),this},overrideMimeType:function(e){return null==c&&(h.mimeType=e),this},statusCode:function(e){var t;if(e)if(c)E.always(e[E.status]);else for(t in e)x[t]=[x[t],e[t]];return this},abort:function(e){var t=e||C;return i&&i.abort(t),k(0,t),this}};if(v.promise(E),h.url=((t||h.url||Ct.href)+"").replace(Rt,Ct.protocol+"//"),h.type=n.method||n.type||h.method||h.type,h.dataTypes=(h.dataType||"*").toLowerCase().match(M)||[""],null==h.crossDomain){l=r.createElement("a");try{l.href=h.url,l.href=l.href,h.crossDomain=Bt.protocol+"//"+Bt.host!=l.protocol+"//"+l.host}catch(e){h.crossDomain=!0}}if(h.data&&h.processData&&"string"!=typeof h.data&&(h.data=w.param(h.data,h.traditional)),_t(It,h,n,E),c)return E;(f=w.event&&h.global)&&0==w.active++&&w.event.trigger("ajaxStart"),h.type=h.type.toUpperCase(),h.hasContent=!Mt.test(h.type),o=h.url.replace(Lt,""),h.hasContent?h.data&&h.processData&&0===(h.contentType||"").indexOf("application/x-www-form-urlencoded")&&(h.data=h.data.replace(qt,"+")):(d=h.url.slice(o.length),h.data&&(h.processData||"string"==typeof h.data)&&(o+=(kt.test(o)?"&":"?")+h.data,delete h.data),!1===h.cache&&(o=o.replace(Ht,"$1"),d=(kt.test(o)?"&":"?")+"_="+Et+++d),h.url=o+d),h.ifModified&&(w.lastModified[o]&&E.setRequestHeader("If-Modified-Since",w.lastModified[o]),w.etag[o]&&E.setRequestHeader("If-None-Match",w.etag[o])),(h.data&&h.hasContent&&!1!==h.contentType||n.contentType)&&E.setRequestHeader("Content-Type",h.contentType),E.setRequestHeader("Accept",h.dataTypes[0]&&h.accepts[h.dataTypes[0]]?h.accepts[h.dataTypes[0]]+("*"!==h.dataTypes[0]?", "+$t+"; q=0.01":""):h.accepts["*"]);for(p in h.headers)E.setRequestHeader(p,h.headers[p]);if(h.beforeSend&&(!1===h.beforeSend.call(g,E,h)||c))return E.abort();if(C="abort",m.add(h.complete),E.done(h.success),E.fail(h.error),i=_t(Wt,h,n,E)){if(E.readyState=1,f&&y.trigger("ajaxSend",[E,h]),c)return E;h.async&&h.timeout>0&&(u=e.setTimeout(function(){E.abort("timeout")},h.timeout));try{c=!1,i.send(b,k)}catch(e){if(c)throw e;k(-1,e)}}else k(-1,"No Transport");function k(t,n,r,s){var l,p,d,b,T,C=n;c||(c=!0,u&&e.clearTimeout(u),i=void 0,a=s||"",E.readyState=t>0?4:0,l=t>=200&&t<300||304===t,r&&(b=Xt(h,E,r)),b=Ut(h,b,E,l),l?(h.ifModified&&((T=E.getResponseHeader("Last-Modified"))&&(w.lastModified[o]=T),(T=E.getResponseHeader("etag"))&&(w.etag[o]=T)),204===t||"HEAD"===h.type?C="nocontent":304===t?C="notmodified":(C=b.state,p=b.data,l=!(d=b.error))):(d=C,!t&&C||(C="error",t<0&&(t=0))),E.status=t,E.statusText=(n||C)+"",l?v.resolveWith(g,[p,C,E]):v.rejectWith(g,[E,C,d]),E.statusCode(x),x=void 0,f&&y.trigger(l?"ajaxSuccess":"ajaxError",[E,h,l?p:d]),m.fireWith(g,[E,C]),f&&(y.trigger("ajaxComplete",[E,h]),--w.active||w.event.trigger("ajaxStop")))}return E},getJSON:function(e,t,n){return w.get(e,t,n,"json")},getScript:function(e,t){return w.get(e,void 0,t,"script")}}),w.each(["get","post"],function(e,t){w[t]=function(e,n,r,i){return g(n)&&(i=i||r,r=n,n=void 0),w.ajax(w.extend({url:e,type:t,dataType:i,data:n,success:r},w.isPlainObject(e)&&e))}}),w._evalUrl=function(e){return w.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,"throws":!0})},w.fn.extend({wrapAll:function(e){var t;return this[0]&&(g(e)&&(e=e.call(this[0])),t=w(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return g(e)?this.each(function(t){w(this).wrapInner(e.call(this,t))}):this.each(function(){var t=w(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=g(e);return this.each(function(n){w(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){w(this).replaceWith(this.childNodes)}),this}}),w.expr.pseudos.hidden=function(e){return!w.expr.pseudos.visible(e)},w.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},w.ajaxSettings.xhr=function(){try{return new e.XMLHttpRequest}catch(e){}};var Vt={0:200,1223:204},Gt=w.ajaxSettings.xhr();h.cors=!!Gt&&"withCredentials"in Gt,h.ajax=Gt=!!Gt,w.ajaxTransport(function(t){var n,r;if(h.cors||Gt&&!t.crossDomain)return{send:function(i,o){var a,s=t.xhr();if(s.open(t.type,t.url,t.async,t.username,t.password),t.xhrFields)for(a in t.xhrFields)s[a]=t.xhrFields[a];t.mimeType&&s.overrideMimeType&&s.overrideMimeType(t.mimeType),t.crossDomain||i["X-Requested-With"]||(i["X-Requested-With"]="XMLHttpRequest");for(a in i)s.setRequestHeader(a,i[a]);n=function(e){return function(){n&&(n=r=s.onload=s.onerror=s.onabort=s.ontimeout=s.onreadystatechange=null,"abort"===e?s.abort():"error"===e?"number"!=typeof s.status?o(0,"error"):o(s.status,s.statusText):o(Vt[s.status]||s.status,s.statusText,"text"!==(s.responseType||"text")||"string"!=typeof s.responseText?{binary:s.response}:{text:s.responseText},s.getAllResponseHeaders()))}},s.onload=n(),r=s.onerror=s.ontimeout=n("error"),void 0!==s.onabort?s.onabort=r:s.onreadystatechange=function(){4===s.readyState&&e.setTimeout(function(){n&&r()})},n=n("abort");try{s.send(t.hasContent&&t.data||null)}catch(e){if(n)throw e}},abort:function(){n&&n()}}}),w.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),w.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return w.globalEval(e),e}}}),w.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),w.ajaxTransport("script",function(e){if(e.crossDomain){var t,n;return{send:function(i,o){t=w("
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
":g.tabReplace?n.replace(/\t/g,g.tabReplace):""})):e}function v(e){var n,t,r,a,s,o=function(e){var n,t=e.className+" ";if(t+=e.parentNode?e.parentNode.className:"",n=g.languageDetectRe.exec(t)){var r=M(n[1]);return r||(console.warn(d.replace("{}",n[1])),console.warn("Falling back to no-highlight mode for this block.",e)),r?n[1]:"no-highlight"}return t.split(/\s+/).find(e=>h(e)||M(e))}(e);h(o)||(T("before:highlightBlock",{block:e,language:o}),g.useBR?(n=document.createElement("div")).innerHTML=e.innerHTML.replace(/\n/g,"").replace(/
' + content + '
');
- });
-});
diff --git a/doc/public/js/jquery-3.3.1.min.js b/doc/public/js/jquery-3.3.1.min.js
deleted file mode 100644
index 4d9b3a2..0000000
--- a/doc/public/js/jquery-3.3.1.min.js
+++ /dev/null
@@ -1,2 +0,0 @@
-/*! jQuery v3.3.1 | (c) JS Foundation and other contributors | jquery.org/license */
-!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(e,t){"use strict";var n=[],r=e.document,i=Object.getPrototypeOf,o=n.slice,a=n.concat,s=n.push,u=n.indexOf,l={},c=l.toString,f=l.hasOwnProperty,p=f.toString,d=p.call(Object),h={},g=function e(t){return"function"==typeof t&&"number"!=typeof t.nodeType},y=function e(t){return null!=t&&t===t.window},v={type:!0,src:!0,noModule:!0};function m(e,t,n){var i,o=(t=t||r).createElement("script");if(o.text=e,n)for(i in v)n[i]&&(o[i]=n[i]);t.head.appendChild(o).parentNode.removeChild(o)}function x(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?l[c.call(e)]||"object":typeof e}var b="3.3.1",w=function(e,t){return new w.fn.init(e,t)},T=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;w.fn=w.prototype={jquery:"3.3.1",constructor:w,length:0,toArray:function(){return o.call(this)},get:function(e){return null==e?o.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=w.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return w.each(this,e)},map:function(e){return this.pushStack(w.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(o.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - category :: - - Categories -
- - - - - - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-