blohg

A Mercurial-based blog engine
Download

blohg Ranking & Summary

Advertisement

  • Rating:
  • License:
  • GPL
  • Publisher Name:
  • Rafael Goncalves Martins
  • Publisher web site:
  • http://rafaelmartins.eng.br

blohg Tags


blohg Description

A Mercurial-based blog engine blohg is an easy to use and simple blog engine, that uses the Mercurial SCM as backend, to store the content of the post and pages.blohg doesn't have a nice control panel nor WYSIWIG editors. All the content is written using any text editor and reStructuredText with some custom directives (undocumented yet, please read the docstrings for reference).Starting your blogWarningThe sys.prefix on the examples means the prefix value for your current environment (the current value of sys.prefix) and not the python variable itself, obviously. hg init my_blohg cd my_blohg cp -r ``sys.prefix``/share/blohg/config . $EDITOR config/remote.pyChange the configuration values as you want. The variables are pretty obvious and the sample file comes with some useful examples. mkdir -p txt/en-us/post cat txt/en-us/post/hello_world.rst.. title: Hello World!.. tags: hello_world,my_cool_tagHello, blohg!EOF blohg runMake sure that you run the blohg script from the root of your local repository.If you're lucky, you should get your blog at http://localhost:5000/ hg commit -AWarningMake sure you add the config/*.pyc files to your .hgignore fileNow copy your repository for the remote server as you want.When your repository is available on the web server, configure your push path: cat .hg/hgrcdefault = http://your_user@example.com/my_blohg/EOF hg pushWarningThis example DOESN'T cover the Mercurial server configuration!Deploying your blog (using Apache/mod_wsgi) cp ``sys.prefix``/share/blohg/blohg.wsgi /some/place/ $EDITOR /some/place/blohg.wsgiRead the file and change what you need.Edit your apache configuration and add something like this:< VirtualHost *:80 > ServerName example.com WSGIScriptAlias / /some/place/blohg.wsgi< /VirtualHost >You'll need to add 2 hooks to your remote repository, to update your working directory and reload your Apache processes every time you commit some new page/post:changegroup = hg update >&2changegroup.apache = touch /some/place/blohg.wsgiAdd this to the .hg/hgrc file from your remote repository.Important notes about writing posts/pagesMake sure that you always have a .. title: comment at the begin of your .rst file, this is your title!Static pages will not handle tags, then you don't need the .. tags: comment. Tags are comma-separated. Requirements: · Python


blohg Related Software