Project

drumknott

0.0
No commit activity in last 3 years
No release in over 3 years
Takes each of your compiled Jekyll pages and uploads them to Drumknott.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
~> 0.79.0

Runtime

>= 3.0
>= 0
 Project Readme

Drumknott CLI

Command line tool for the Drumknott search service. When invoked, it takes each of your compiled Jekyll pages and uploads them to Drumknott.

Installation

$ gem install drumknott

Usage

From within the local Jekyll site directory, using the credentials provided by Drumknott:

$ drumknott keys SITE_NAME SITE_KEY INCLUDE_PAGES
$ drumknott refresh

The 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 DRUMKNOTT_NAME and DRUMKNOTT_KEY respectively.

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 'true'.

Development

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.

Contributing

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:

  1. Fork it ( https://github.com/pat/drumknott/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Licence

Copyright (c) 2016-2020, Drumknott is developed and maintained by Pat Allan, and is released under the open MIT Licence.