Add a requirements section to the readme

master
Jonathan Hodgson 4 years ago
parent 4731545df5
commit 18cd642ce3
  1. 40
      README.md

@ -6,6 +6,42 @@ find a tool that fits my requirements / desires so I decided to build one.
This is still in early stages of development so expect braking changes to come This is still in early stages of development so expect braking changes to come
if you use it. if you use it.
## Requirements
I don't want to re-invent the wheel. The following tools are used within this
project:
### FZF
https://github.com/junegunn/fzf
This is used for the fuzzy searching
### Git
https://git-scm.com/
Git is used for version controlling the knowledge base. If you don't want to use
git, you can use the --nogit option
### Git-LFS
https://github.com/git-lfs/git-lfs
Vanilla git is not very good at version controlling binary files. Git LFS allows
assets to be stored separately from the main repository but referenced.
### Bat
https://github.com/sharkdp/bat
This is used to provide syntax highlighting in previews
### Sqlite3
This is used to index the documents in the knowledge base, making it fast to
search by tag etc.
## Setup ## Setup
After cloning the repository, you can run After cloning the repository, you can run
@ -14,6 +50,7 @@ After cloning the repository, you can run
sudo make install sudo make install
``` ```
To initialise, run To initialise, run
``` ```
@ -21,7 +58,8 @@ kb init
``` ```
This will create the necessary folders and create an sqlite database to store This will create the necessary folders and create an sqlite database to store
the index in the index in.
## Usage ## Usage

Loading…
Cancel
Save