Tempo fa, ho scritto una guida che descriveva come sfogliare Arch Wiki dal tuo Terminale usando uno script da riga di comando chiamato arch-wiki-cli . Utilizzando questo script, chiunque può navigare facilmente nell'intero sito Web di Arch Wiki e leggerlo con un browser di testo a tua scelta. Ovviamente, per utilizzare questo script è necessaria una connessione Internet attiva. Oggi mi sono imbattuto in un'utilità simile chiamata "Arch-wiki-man" . Come dice il nome, viene utilizzato anche per leggere Arch Wiki dalla riga di comando, ma non richiede una connessione a Internet. Il programma Arch-wiki-man ti aiuta a sfogliare e leggere l'intero Arch Wiki come pagine man di Linux. Verrà visualizzato qualsiasi articolo da Arch Wiki in formato di pagine man. Inoltre, non è necessario essere online per sfogliare Arch Wiki. L'intero Arch Wiki verrà scaricato localmente e gli aggiornamenti verranno inviati automaticamente ogni due giorni. Quindi, hai sempre una copia locale aggiornata di Arch Wiki sul tuo sistema.
Installazione di Arch-wiki-man
Arch-wiki-man è disponibile in AUR , quindi puoi installarlo utilizzando qualsiasi programma di supporto AUR, ad esempio Sì .
$ yay -S arch-wiki-man
In alternativa, può essere installato utilizzando il gestore di pacchetti NPM come di seguito. Assicurati di aver installato NodeJS ed esegui il seguente comando per installarlo:
$ npm install -g arch-wiki-man
Sfoglia e leggi l'intera wiki di Arch come pagine man di Linux
La sintassi tipica di Arch-wiki-man è:
$ awman <search-query>
Lascia che ti mostri alcuni esempi.
Cerca con una o più corrispondenze
Cerchiamo una guida all'installazione di Arch Linux . Per farlo, esegui semplicemente:
$ awman Installation guide
Il comando precedente cercherà le corrispondenze che contengono il termine di ricerca "Guida all'installazione" in Arch Wiki. Se sono presenti più corrispondenze per il termine di ricerca specificato, verrà visualizzato un menu di selezione. Scegli la guida che desideri leggere utilizzando le frecce SU/GIÙ o combinazioni di tasti in stile Vim (j/k ) e premi INVIO per aprirlo. La guida risultante si aprirà nel formato delle pagine man come di seguito.
Leggi la guida all'installazione di Arch Linux dalla CLI usando Awman
Qui, awman si riferisce a a rch con iki m an.
Tutte le opzioni del comando man sono supportate, quindi puoi navigare nella guida come fai quando leggi una pagina man. Per visualizzare la sezione della guida, premi h .
Per uscire dal menu di selezione senza entrare in man , premi semplicemente Ctrl+c .
Per tornare indietro e/o uscire da man, digita q .
Cerca corrispondenze nei titoli e nelle descrizioni
Per impostazione predefinita, Awman cercherà le corrispondenze solo nei titoli. Puoi, tuttavia, indirizzarlo alla ricerca delle corrispondenze sia nei titoli che nelle descrizioni.
$ awman -d vim
Oppure,
$ awman --desc-search vim
Cerca le corrispondenze nei contenuti
Oltre a cercare corrispondenze nei titoli e nelle descrizioni, è anche possibile scansionare i contenuti per trovare una corrispondenza. Tieni presente che ciò rallenterà notevolmente il processo di ricerca.
$ awman -k emacs
Oppure,
$ awman --apropos emacs
Apri i risultati della ricerca nel browser web
Se non vuoi visualizzare le guide wiki di arch in formato pagina man, puoi aprirle in un browser web. Per farlo, esegui:
$ awman -w pacman
Oppure,
$ awman --web pacman
Questo comando aprirà la corrispondenza risultante nel browser Web predefinito anziché con comando man . Tieni presente che è necessaria una connessione a Internet per utilizzare questa opzione.
Cerca in altre lingue
Per impostazione predefinita, Awman aprirà le pagine wiki di Arch in inglese. Se desideri visualizzare i risultati in altre lingue, ad esempio spagnolo , fai semplicemente:
$ awman -l spanish codecs
Arch Wiki in spagnolo
Per visualizzare l'elenco delle opzioni di lingua disponibili, eseguire:
$ awman --list-languages
Aggiorna la copia locale di Arch Wiki
Come ho già detto, gli aggiornamenti vengono inviati automaticamente ogni due giorni. Se vuoi aggiornarlo manualmente, esegui semplicemente:
$ awman-update [email protected] /usr/lib/node_modules/arch-wiki-man └── [email protected] arch-wiki-md-repo has been successfully updated or reinstalled.
Lettura consigliata:
- Come creare e gestire le tue pagine man