A CLI tool to read pages from the ArchWiki
Currently, you can only install this tool from crates.io or build it from source
sh
cargo install archwiki-rs
sh
git clone https://github.com/jackboxx/archwiki-rs
cd archwiki-rs
cargo build --release
cp ./target/release/archwiki-rs $SOME_DIRECTORY_IN_YOUR_PATH # e.g. $HOME/.cargo/bin
sh
archwiki-rs read-page Neovim
sh
archwiki-rs read-page Neovim --format markdown
By default, pages are cached in the file system after they are fetched and subsequent request for that page then use that cache. The cache is invalidated if the cached file hasn't been modified in the last 14 days.
If the page you are searching for doesn't exist, a list of the pages that are most similar (in name) to the page you asked for will be output instead of the page content
```sh archwiki-rs read-page Neovi
Neovim ... ```
Unlike the output when the page name does exist, this output is written to stderr instead of stdout. If you want to, you can create a program that checks if no page was found and uses stderr to give the user suggestions on what they might have wanted to type.
An example shell script to do something like this is available in the repository
under the name example.sh.
sh
archwiki-rs search "Emacs"
This returns a table of pages with a similar title and their URLs
sh
archwiki-rs search "shell" -t
This returns a table of pages which contain the search term and the snippet of text that the search term is in
Page names are stored locally to prevent having to scrape the entire table of contents of the ArchWiki with every command
sh
archwiki-rs update-all
Be warned, since this scrapes multiple thousand links, this is very slow (-, - )…zzzZZ
sh
archwiki-rs update-category Xorg_commands
sh
archwiki-rs list-pages
This is output a styled tree of categories and pages but if you need an easily parseable
list for a different program to use, you can use the -f flag to flatten the output into a
newline separated list that only contains the names of all pages
sh
archwiki-rs list-pages -f
To do the same for categories you can run
sh
archwiki-rs list-categories
And the same for available languages
sh
archwiki-rs list-languages
Other information such as the value/location of the cache directory can be obtained
using the info command
sh
archwiki-rs info
To only get the value of an entry and not the name and description that belong to it you
can use the -o flag
sh
archwiki-rs info -o
Here's a list of programs that have plugins for archwiki-rs to make your life easier