From 18cd642ce34bec7336a9f239c10ae36748473c05 Mon Sep 17 00:00:00 2001 From: Jonathan Hodgson Date: Wed, 23 Dec 2020 13:14:12 +0000 Subject: [PATCH] Add a requirements section to the readme --- README.md | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f227911..66d0921 100644 --- a/README.md +++ b/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 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 After cloning the repository, you can run @@ -14,6 +50,7 @@ After cloning the repository, you can run sudo make install ``` + To initialise, run ``` @@ -21,7 +58,8 @@ kb init ``` This will create the necessary folders and create an sqlite database to store -the index in +the index in. + ## Usage