search

sebastian-correa / ulauncher-rae-dle

GNU General Public License v3.0
4 stars 1 forks source link

readme

Stargazers Issues MIT License LinkedIn


Logo

Diccionario de la Lengua Española de la RAE

Permite buscar palabras en el DLE de la RAE, así como copiar facilmente las definiciones al portapapeles.

Demo · Reportar un Bug · Solicitar una Feature

Contenidos
  1. Sobre el Proyecto
  2. Empezar a Usar
  3. Uso
  4. Como contribuir
  5. Licencia
  6. Contacto

Sobre el Proyecto

Esta extensión para ulauncher permite buscar palabras en el DLE de la RAE de forma rápida.

Además, tiene una base de datos local con las definiciones de las 1000 palabras más comunes en Español, de forma de acelerar las búsquedas y para poder funcionar limitadamente sin internet.

Empezar a Usar

Requisitos

Aparte de requerir ulauncher, RAE DLE requiere

Instalación

Hay dos formas de instalar la extensión.

Automática

  1. Abrir las preferencias de ulauncher.
  2. Ir a la sección de extensiones.
  3. Clickear en "Agregar extensión".
  4. Pegar el link a este repo: https://github.com/sebastian-correa/ulauncher-rae-dle.

Manual

  1. Cerrar ulauncher.
  2. En una consola, 
    cd ~/.local/share/ulauncher/extensions
git clone https://github.com/sebastian-correa/ulauncher-rae-dle.git
  3. Abrir ulauncher.

Uso

En ulauncher, introducir la keyword (ver Opciones) seguido de un espacio y la consulta que se quiera hacer a en el DLE. Consultas con más de una palabra son válidas (por ejemplo `rae dicc).

Existen cuatro resultados posibles:

  1. Palabra Vacía: Si no se introduce una palabra tras la keyword, la extensión dará un mensaje apropiado.
  2. Resultado Exacto: Si la búsqueda tiene un resultado exacto, se mostrará una lista con, a lo sumo, Max Shown Definitions definiciones (ver Opciones).
    1. Enter: Copia la definición elegida al portapapeles.
    2. Alt + Enter: Abre el DLE en el buscador y muestra la definición seleccionada.
  3. Resultado Aproximado: Si la búsuqueda no tiene un resultado exacto, el DLE puede sugerir búsquedas alternativas, que se mostrarán como una lista de opciones.
    1. Enter: Acepta la sugerencia seleccionada y realiza otra búsqueda mediante la extensión.
    2. Alt + Enter: Abre el DLE en el buscador y muestra la página de sugerencias.
  4. Sin resultado: En ocasiones, la búqueda ni existe en el DLE ni el DLE tiene sugerencias. En ese caso, se muestra un mensaje apropiado.

Opciones

La extensión cuenta con varias opciones, como se ve en la imagen a continuación.

Opción Descripción Default
Keyword El keyword a escribir en ulauncher para activar la extensión. rae
Max Suggested Items Máxima cantidad de las sugerencias de la RAE que se muestran cuando la búsqueda no tiene resultados exactos. 10
Max Shown Definitions: Máxima cantidad de definiciones que se muestran de una palabra que está en el DLE. 10

Como contribuir

Cualquier contribución que mejore la extensión es bienvenida. Par contribuir:

  1. Forkea el proyecto.
  2. Crea una rama (branch) para desarrollar tu contribución (git checkout -b feature/TuFeature)
  3. Hacé un commit con tus cambios (git commit -m 'Add TuFeature')
  4. Hacé un push a la branch (git push origin feature/TuFeature)
  5. Abrí un Pull Request para integrar TuFeature a master.

Licencia

Distribuido bajo GPL-3.0. Ver LICENSE para más información.

Contacto

Sebastian Correa - LinkedIn