README of 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.


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


I use following:

server.socket_host = ""
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 = ''
title = 'Homepage'
index_num_entries = 5
global_navi = [('Main', '/'), ('Memorandum', '/memo'), ('Log', '/log') ]
sidebar_top = [('Gitweb', '/gitweb'), ('oitoite', '/oitoite'), ]

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

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

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


$ PYTHONPATH=. python unguent/ 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/ unguent.conf production