Soulbits

Instalación

Para Arch Linux (y derivadas) está disponible un paquete en AUR, por lo que podemos instalarlo fácilmente con yaourt o cualquier otro wrapper de pacman de nuestro gusto.

$ yaourt -S zeal-git

Para otras distribuciones o sistemas podemos encontrar más información en su página de descarga .

Configuración y uso

Una vez instalado, utilizarlo es muy sencillo.

Primero de todo, hemos de descargar la documentación que queremos tener disponible.

Descargamos la documentación desde Edit → Options → Docsets → Download…

Tras esto, ya podemos usar el cuadro de búsqueda para buscar entre toda la documentación. Y, si queremos afinar más, podemos emplear filtros para restringir nuestra búsqueda a determinada documentación. Así, doc:consulta buscará consulta dentro de aquella documentación cuyo nombre se corresponda o contenga la palabra clave doc .

Búsqueda restringida a la documentación de CSS.

Plugins para editores

Zeal es algo limitado en cuanto a plugins y sólo cuenta con tres por ahora:

1. Plugin para Emacs .

2. Plugin para Sublime Text .

   El plugin está disponible en el gestor de paquetes de ST , por lo que su instalación es trivial. Una vez instalado, podemos invocarlo de dos formas:

   • F1.

     Abre la documentación de Zeal para la palabra seleccionada en el editor. Para esto tenemos que emparejar previamente el lenguaje que estamos usando con su documentación en Zeal , o no funcionará.

   • Shift + F1.

     Despliega una barra para buscar en Zeal.

     

   Para emparejar un lenguaje con su correspondiente documentación hemos de editar la configuración de usuario del plugin en ST (Preferences → Package Settings → Zeal → Settings - User). Para ello, copiamos en dicho archivo la configuración por defecto del plugin (Preferences → Package Settings → Zeal → Settings - Default) y añadimos una linea para nuestro lenguaje.

   {
     /**
      *  Zeal executable path.
      *  For Linux: /usr/bin/zeal
      *  For Windows: c:\\Program Files\\Zeal\\zeal.exe
      */
     "zeal_command": "/usr/bin/zeal",
   
     /**
      *  Sort maaping results.
      */
     "mapping_sort" : true,
   
     /**
      * Language mapping.
      */
     "language_mapping": {
       "HTML": {"lang": "html", "zeal_lang": "html"},
       "JavaScript": {"lang": "javascript", "zeal_lang": "javascript"},
       "CSS": {"lang": "css", "zeal_lang": "css"},
       "PHP": {"lang": "php", "zeal_lang": "php"},
       "Python": {"lang": "python", "zeal_lang": "python"}
     }
   }
   

3. Plugin para Vim .

   Deberíamos añadir a nuestro archivo .vimrc algo como esto:

   let g:investigate_command_for_python = '/usr/bin/zeal --query ^s'
   

No se puede decir que estos plugins ofrezcan mucha integración, ya que lo único que hacen es darnos una opción para lanzar Zeal directamente con una determinada consulta, pero tienen su utilidad.