WikiTerm-rs

This project's goal is to create a terminal app (using mainly vim motions) to allow you to quickly search through an offline copy of wikipedia.

Installation / Setup

This app expects a config file to be present at ~/.config/wikiterm/config.json

With the following format:

{
    "wiki_bzip_path": "~/Documents/wiki/simple/base.bz2",
    "meta_directory": "~/Documents/wiki/simple/meta"
}

The meta_directory will be created from the above config if it does not already exist.

The wiki_bzip_path is the path to the bzip2 (xml) archive file that is downloaded. It's expected that this is a multistream version.

'https://dumps.wikimedia.org/mirrors.html`

The meta_directory is the place you want any indexing / file produced by this project to go.

Usage

You should be able to navigate with (currently a subset of vim bindings)

j, k
up, down

:q to quit or Ctrl-c

Esc to exit back to normal mode
Aswell as / to search

Limitations / Room for improvement

This is currently a work in progress so many features will be missing / not perfect.

[] Search isn't super great right now, will need to be improved [] Not currently parsing wiki text so no formatting on the output [] Some results simply 'redirect' you to other pages (with no redirect logic

Contributing

If you want to make significant changes please first open an issue to avoid any wasted time. This is my first OS project and one of my first proper rust projects which I'm using to learn rust so this might not be properly idiomatic rust and there may be some shortcuts here.