Command line tool for the Drumknott search service. When invoked, it takes each of your compiled Jekyll pages and uploads them to Drumknott.
$ gem install drumknott
From within the local Jekyll site directory, using the credentials provided by Drumknott:
$ drumknott keys SITE_NAME SITE_KEY INCLUDE_PAGES $ drumknott refresh
keys command will save your credentials to a
.drumknott file in your site's directory. Do not commit this file to git! If you don't want to have that file saved, you can alternatively use the environment variables
By default, both posts and normal pages will be uploaded to Drumknott. If you only wish to include posts, the INCLUDE_PAGES argument in the
keys command should be
'no'. This can also be managed via the
DRUMKNOTT_PAGES environment variable.
You can have visual output of the refresh if you also include the
ruby-progressbar gem in your Gemfile (or, if you're not using a Gemfile, just have that gem installed). However, if you prefer quiet even though the gem's installed, set the
DRUMKNOTT_SILENT environment variable to be
After checking out the repo, run
bin/setup to install dependencies. Then, run
bin/console for an interactive prompt that will allow you to experiment.
Firstly, please note the Code of Conduct for all contributions to this project. If you accept that, then the steps for contributing are probably something along the lines of:
- Fork it ( https://github.com/pat/drumknott/fork )
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create a new Pull Request
Copyright (c) 2016-2020, Drumknott is developed and maintained by Pat Allan, and is released under the open MIT Licence.