|
1 month ago | |
---|---|---|
bin | 1 month ago | |
exe | 1 month ago | |
lib | 1 month ago | |
spec | 1 month ago | |
.gitignore | 1 month ago | |
.rspec | 1 month ago | |
.rubocop.yml | 1 month ago | |
CHANGELOG.md | 1 month ago | |
CODE_OF_CONDUCT.md | 1 month ago | |
Gemfile | 1 month ago | |
Gemfile.lock | 1 month ago | |
LICENSE.txt | 1 month ago | |
README.md | 1 month ago | |
Rakefile | 1 month ago | |
nvcli.gemspec | 1 month ago |
FIXME: general description here
Install nvcli by running:
$ gem install nvcli
The installation may take a while, as the Xapian search library will be fetched and compiled for your machine.
The first time you run nvcli, it will create a configuration file in your platform's configuration directory (either ~/Library/Application Support/nvcli
, ~/.config/nvcli
, or $APPDATA\nvcli
). This is a YAML file containing the following keys:
notes_dir
(default: ~/Notes
): The folder containing all of your notes. Sub-folders within this folder are not supported (following the original Notational Velocity model).notes_ext
(default: .md
): The file extension for all of your notes. Files in the notes directory not containing this extension will not be parsed. This must be Markdown (as nvcli will parse the Markdown of your notes), but could be, for instance, .md
, .markdown
, .txt
, etc. This value must include the dot.language
(default: en
): The note searching is internally performed by the Xapian search server, which will correct spelling and stem words in the selected language. Set to an ISO language code.use_hash
(default: true
): If true
, nvcli will check the hash (xxHash's XXH64) of your notes in order to see if they should be re-parsed in the search database. If false
, the file's modification time will be used instead. Hashing is, in general, extremely fast, so you shouldn't need to set this to false
for normal workloads.color
(default: true
): If true, the console output will be colorized.All you need to know are the various key bindings:
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on Codeberg at https://codeberg.org/cpence/nvcli. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
Copyright (c) 2020 Charles H. Pence (charles@charlespence.net). Released under the MIT License.