Plogbook is a console application for personal logging. It turns personal logs written in console or favorite text editor into readable html pages. The personal logs(plogs for short) are located in categories which are part of the plogbook.
Execute via executing plogbook folder i.e.:
python plogbook
or install the package via:
python setup.py install
and run the plogbook from anywhere via:
python -m plogbook
See --help for argument usage.
For examples see /examples/. For suggestions and bugs please see issues
- Create a folder that will be your plogbook.
- Cd to that folder (or use --location argument and simply execute the program via "python plogbook" answer yes when prompted.
- Write your first plog to finish initiation!
- See --help argument and FAQ below for more info.
Plogbook should run on 2.7+ and 3+ versions of Python. Please report any hicups to issues it's mostly tested on 3.4
Tested on Linux and Windows 8, should work on pretty much anything that runs python, if it doesn't please report to issues.
######So plogbook is basically a diary?
In a way yeah, though diaries are for little girls and logs just sound cool. Makes me feel like a scientist everytime I write one, even those where I complain about how rubbish the new seasons of supernatural are (and yet I still watch it...)
plogbook has no real security mechanism at the moment. Security should be kept outside of plogbook for now (i.e. see [for linux] (http://askubuntu.com/questions/104542/is-there-a-way-to-password-protect-individual-folders))
Yes, you can build out html and css templates by --build_templates. Templates will be created at plogbook/templates directory and will be used to build new plogs. To rebuild old plog files see --rebuild_<..> commands. Feel free to propose different default designs to issues (would be really nice)
You can rebuild styles but for html not yet, I'm working on this feature.
Yes, however for markdown to html conversion you need to install Markdown2 package. See --markdown
Yes, see --localize-images
Note: any templates and looks can be adjusted, see faq and examples/build_templates example.
Default output.
Main page:
Category page:
Plog:
Writting plog using console:
Writting plog using kate text editor: