pkb — Personal Knowledge Base
pkb is a small Rails application that allows you to efficiently publish a collection of Markdown files.
Configuration
- Copy the
config/settings.yml.sample
file toconfig/settings.yml
and fill in your own details - Run
bundle install
- Link the directory with your Markdown files in it. E.g.
ln -s ~/Dropbox/My\ Markdown\ Files pages
- Start the server,
rails s
and visit http://localhost:3000/pages - You should have Markdown file called
home.md
. This file will be shown as the homepage: http://localhost:3000/
Deployment
pkb is designed to be deployed behind a caching proxy such as varnish. There is
a sample varnish configuration in config/varnish.vcl
. There is a script for
building a Docker image: bin/docker-build
.
The resulting image can be run something like this:
sudo docker run -it --rm -e 'SECRET_KEY_BASE=asdfasdfasdf' -p 3000:3000/tcp -v /home/wmoore/Projects/pkb/pages:/home/pkb/pages:ro 51d800a7496b