README of Unguent

Unguent

This tool is written in Python as an application of CherryPy.

In winter, I use some unguent for our children to keep their skin smooth.

My web process has been not that smooth. It was basically unmaintained, a kind of put only. For my new web, I wish to keep the process smooth enough by Unguent.

Requirement

  • Python: 2.6
  • CherryPy: 3.1
  • Genshi
  • Docutils
  • python-libxml2
  • [Optional]
    • gitweb
    • Django for 'No-Passwd.Net' OpenID service

Configuration

I use following:

[global]
server.socket_host = "0.0.0.0"
server.thread_pool = 8
siterootdir = 'site/root'
sitestaticdir = 'site/static'
gitweb = '/gitweb'

[/]
tools.caching.on = True
header_title = 'GNU wannabee and Happy Hacking'
footer_html = 'Contact: <code>gniibe at fsij dot org</code>'
logourl = '/static/gniibe-logo.png'
logotext = 'gniibe'
sitename = 'gniibe.org'
title = 'Homepage'
index_num_entries = 5
global_navi = [('Main', '/'), ('Memorandum', '/memo'), ('Log', '/log') ]
sidebar_top = [('Gitweb', '/gitweb'), ('oitoite', '/oitoite'), ]

[/git]
tools.staticdir.on = True
tools.staticdir.dir = unguent.parent_dir + '/git'
tools.staticdir.disable_cache = True

[/robots.txt]
tools.staticfile.on = True
tools.staticfile.filename = 'site/robots.txt'

[/gniibe.asc]
tools.staticfile.on = True
tools.staticfile.filename = 'site/gniibe.asc'

Create the page index.rst under ${siterootdir}, and put your logo under ${sitestaticdir}.

Running Unguent

Run

$ PYTHONPATH=. python unguent/controller.py unguent.conf

where unguent.conf is the configuration file.

If you don't want to show stack trace on error, add another argument:

$ PYTHONPATH=. python unguent/controller.py unguent.conf production