Skip to content

Console application for personal logging, which turns logs into readable html pages.

License

Notifications You must be signed in to change notification settings

xetch/plogbook

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

plogbook

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

First time usage

  1. Create a folder that will be your plogbook.
  2. Cd to that folder (or use --location argument and simply execute the program via "python plogbook" answer yes when prompted.
  3. Write your first plog to finish initiation!
  4. See --help argument and FAQ below for more info.

FAQ

Which python version?

Plogbook should run on 2.7+ and 3+ versions of Python. Please report any hicups to issues it's mostly tested on 3.4

Which operating systems plogbook works on?

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...)

What about security ?

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))

Can I change the css and html ? Default ones are ugly

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)

Can I rebuild plogs to use new html templates?

You can rebuild styles but for html not yet, I'm working on this feature.

Writting html sucks, can I write my plogs in markdown?

Yes, however for markdown to html conversion you need to install Markdown2 package. See --markdown

Can I make plogbook download images from the plogs and store them locally?

Yes, see --localize-images

How does it look?

Note: any templates and looks can be adjusted, see faq and examples/build_templates example.
Default output.
Main page:
main page Category page:
category page for plogbook category Plog:
plog from the plogbook category
Writting plog using console:
writting plog
Writting plog using kate text editor:
writting plog via kate

About

Console application for personal logging, which turns logs into readable html pages.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 53.3%
  • Python 37.4%
  • CSS 9.3%