Hace un tiempo, escribí una guía que describía cómo navegar por Arch Wiki desde tu Terminal usando un script de línea de comando llamado arch-wiki-cli . Con este script, cualquiera puede navegar fácilmente por todo el sitio web de Arch Wiki y leerlo con el navegador de texto de su elección. Obviamente, se requiere una conexión a Internet activa para usar este script. Hoy me topé con una utilidad similar llamada "Arch-wiki-man" . Como su nombre lo dice, también se usa para leer Arch Wiki desde la línea de comandos, pero no requiere conexión a Internet. El programa Arch-wiki-man lo ayuda a navegar y leer Arch Wiki completo como páginas man de Linux. Mostrará cualquier artículo de Arch Wiki en formato de páginas man. Además, no necesita estar en línea para navegar Arch Wiki. Todo Arch Wiki se descargará localmente y las actualizaciones se envían automáticamente cada dos días. Por lo tanto, siempre tendrá una copia local actualizada de Arch Wiki en su sistema.
Instalando Arch-wiki-man
Arch-wiki-man está disponible en AUR , para que pueda instalarlo usando cualquier programa auxiliar de AUR, por ejemplo Yay .
$ yay -S arch-wiki-man
Alternativamente, se puede instalar usando el administrador de paquetes NPM como se muestra a continuación. Asegúrate de tener NodeJS instalado y ejecuta el siguiente comando para instalarlo:
$ npm install -g arch-wiki-man
Navega y lee todo Arch Wiki como páginas man de Linux
La sintaxis típica de Arch-wiki-man es:
$ awman <search-query>
Déjame mostrarte algunos ejemplos.
Buscar con una o más coincidencias
Busquemos una guía de instalación de Arch Linux . Para hacerlo, simplemente ejecute:
$ awman Installation guide
El comando anterior buscará las coincidencias que contengan el término de búsqueda "Guía de instalación" en Arch Wiki. Si hay varias coincidencias para el término de búsqueda dado, aparecerá un menú de selección. Elija la guía que desea leer usando las flechas ARRIBA/ABAJO o combinaciones de teclas estilo Vim (j/k ) y presione ENTER para abrirlo. La guía resultante se abrirá en formato de páginas de manual como se muestra a continuación.
Lea la Guía de instalación de Arch Linux desde CLI usando Awman
Aquí, awman se refiere a a rch w iki m una.
Se admiten todas las opciones de comando man, por lo que puede navegar por la guía como lo hace cuando lee una página man. Para ver la sección de ayuda, presione h .
Para salir del menú de selección sin entrar en hombre , simplemente presione Ctrl+c .
Para regresar y/o salir man, escriba q .
Busca coincidencias en títulos y descripciones
De forma predeterminada, Awman buscará las coincidencias solo en los títulos. Sin embargo, puede indicarle que busque las coincidencias tanto en los títulos como en las descripciones.
$ awman -d vim
O,
$ awman --desc-search vim
Busca coincidencias en contenidos
Además de buscar coincidencias en títulos y descripciones, también es posible escanear el contenido en busca de una coincidencia. Tenga en cuenta que esto ralentizará significativamente el proceso de búsqueda.
$ awman -k emacs
O,
$ awman --apropos emacs
Abrir los resultados de búsqueda en el navegador web
Si no desea ver las guías arch wiki en formato de página man, puede abrirlas en un navegador web. Para hacerlo, ejecute:
$ awman -w pacman
O,
$ awman --web pacman
Este comando abrirá la coincidencia resultante en el navegador web predeterminado en lugar de con man command . Tenga en cuenta que necesita conexión a Internet para usar esta opción.
Buscar en otros idiomas
De forma predeterminada, Awman abrirá las páginas wiki de Arch en inglés. Si desea ver los resultados en otros idiomas, por ejemplo español , simplemente haz:
$ awman -l spanish codecs
Arch Wiki en Español
Para ver la lista de opciones de idioma disponibles, ejecute:
$ awman --list-languages
Actualizar la copia local de Arch Wiki
Como ya dije, las actualizaciones se envían automáticamente cada dos días. Si desea actualizarlo manualmente, simplemente ejecute:
$ awman-update [email protected] /usr/lib/node_modules/arch-wiki-man └── [email protected] arch-wiki-md-repo has been successfully updated or reinstalled.
Lectura sugerida:
- Cómo crear y mantener sus propias páginas man