Clipboard History

Por gera Kessler

Con las inestimables colaboraciónes de Héctor Benítez y Angel Alcántar

Este complemento permite gestionar un historial del portapapeles persistiéndolo en una base de datos local, lo que permite conservar los textos y archivos binarios aún cuando el sistema se reinicia. Añade comandos para la exploración del historial, funciones de búsqueda, conteo, favoritos, backup, y visualización de los elementos. A parte de la interacción a través de la capa de comandos con funciones avanzadas, se puede utilizar una versión gráfica sencilla para quienes no quieran compicaciones.

Al instalarlo por primera vez e iniciar NVDA, se crea el archivo "clipboard_history" que contiene la base de datos. Este archivo se aloja en la raíz de la carpeta nvda en los directorios de la configuración del usuario. Se crea una carpeta "clipboard_history_media" para almacenar las imágenes copiadas directamente al portapapeles. También se crea un escuchador (listener) para capturar los cambios del portapapeles, y actualizar la base de datos cuando haya contenido de texto, archivos o imágenes. El historial no guarda duplicaciones para evitar un crecimiento innecesario de la base de datos. al copiar un texto existente, este se copia en la primera posición de la lista eliminando la anterior.

Hay 2 funciones asignables desde el diálogo gestos de entrada, categoría clipboardHistory. A saber

Nota importante:
El historial del portapapeles puede conservar datos sensibles, por lo que es responsabilidad del usuario el eliminar el contenido antes de compartir una versión portable con copia de la configuración.

Capa de comandos

Una vez activa la capa de comandos con el gesto asignado previamente, tenemos los siguientes grupos de atajos. Si se pulsa alguna tecla diferente a las listadas a continuación, se desactiva la capa de comandos y las teclas vuelven a su funcionalidad por defecto.

Movimiento en la lista

Funcionalidades que afectan al elemento enfocado en la lista

Funciones de búsqueda

Otras funcionalidades

Búsqueda de elementos

Para buscar algún texto del historial por palabras, tan solo hay que pulsar la letra b con la capa de comandos activa. Esto abre el diálogo de búsqueda donde al escribir alguna palabra o frase y pulsar intro, se realizará la búsqueda. Si se encuentra un resultado se verbaliza el texto y su número de orden. Si pulsamos f3, se vuelve a realizar la búsqueda con el mismo contenido, avanzando hasta el siguiente resultado en el caso de encontrar otra coincidencia.

Favoritos

La tecla tabulador cambia el enfoque entre la lista general y la lista de favoritos. Cuando esta última está activa, la tecla de retroceso quita el estado favorito del elemento, y a este de la lista. En la lista general, la letra f conmuta el estado favorito y lo añade o quita de la lista de favoritos. Las funciones de copia, visualización, búsqueda, pegado, verbalización de orden, y cerrado de ventana cumplen la misma función en ambas listas.

Ventana de configuración

Al pulsar la letra s con la capa de comandos activa, o control + p en la versión gráfica, se muestra la interfaz de configuración. En ella puede modificarse lo siguiente:

Número de cadenas a guardar

Aquí se puede especificar hasta cuantos elementos se van a guardar en la base de datos. Cuando se supere este número, se van eliminando las entradas antiguas desde la última. Si se elimina una imagen de la caché, el archivo físico también será borrado automáticamente.

Limpiar caché de imágenes

Este botón permite eliminar todas las imágenes guardadas en la carpeta de medios y limpiar sus referencias en la base de datos.

Sonidos

Activa o desactiva los sonidos del complemento

Número de índice de los elementos

Si está activa esta casilla, al navegar por la lista de elementos se verbaliza el número de orden de los mismos.

Exportar base de datos

Este botón activa el diálogo para guardar la base de datos en su estado actual para copia de seguridad de los datos alojados en ella, permitiendo la posterior importación desde otro NVDA con este complemento.

Importar base de datos

Esta opción activa un diálogo para buscar una base de datos exportada previamente para recuperar los elementos inexistentes en la base de datos actual.

Interfaz gráfica

Una vez asignado el gesto, esta opción abre la interfaz gráfica que simplifica la navegación e interacción con el historial. Los diferentes elementos almacenados aparecen en forma de lista, la cual puede recorrerse con flechas arriba y abajo. Al tabular teniendo seleccionado algún elemento en la lista, el contenido se muestra en un cuadro de solo lectura.

La lista de elementos tiene los siguientes atajos disponibles:

Soporte de Binarios (Archivos e Imágenes)

El complemento ahora puede capturar archivos copiados desde el explorador y capturas de pantalla o imágenes. * Archivos: Se guarda la ruta del archivo. Al recuperar el elemento, el complemento intentará copiar el archivo original. Si el archivo ya no existe, NVDA anunciará "Binario no encontrado". * Imágenes: Las imágenes sin ruta (como capturas de pantalla) se guardan en una caché local.

Nota sobre Exportación/Importación: Por motivos de seguridad y portabilidad, los binarios (archivos e imágenes en caché) no se incluyen en los procesos de exportación e importación. Solo se transferirán los elementos de texto plano entre diferentes instalaciones de NVDA.

Renombrado de elementos

Cualquier elemento del historial (texto o binarios) puede ser renombrado pulsando la tecla F2 mientras la capa de comandos está activa. Esto permite asignar nombres descriptivos a las imágenes o archivos para encontrarlos fácilmente mediante la función de búsqueda (b).

Nota para textos: Al renombrar un elemento de texto, el nombre que asignes funcionará como una etiqueta visual en la lista, pero el contenido original permanecerá intacto. Al copiar o pegar el elemento, se seguirá utilizando el texto original, no el nombre personalizado.