Clean up our html a little bit. Add generation of non-plugin config vars.

Make sure we use .help() instead of ._help since .help() can be overridden.
This commit is contained in:
James Vega 2004-12-09 20:17:13 +00:00
parent 7862d8d5d2
commit d253a8714a
1 changed files with 63 additions and 2 deletions

View File

@ -35,7 +35,6 @@ import imp
import sys import sys
import os.path import os.path
import textwrap import textwrap
import traceback
import supybot import supybot
import supybot.world as world import supybot.world as world
@ -57,8 +56,10 @@ fd.close()
import supybot.registry as registry import supybot.registry as registry
registry.open(registryFilename) registry.open(registryFilename)
import supybot.log as log
import supybot.conf as conf import supybot.conf as conf
import supybot.utils as utils import supybot.utils as utils
import supybot.irclib as irclib
import supybot.callbacks as callbacks import supybot.callbacks as callbacks
commandDict = {} commandDict = {}
@ -75,6 +76,7 @@ def genHeader(title, meta=''):
<link rel="stylesheet" type="text/css" <link rel="stylesheet" type="text/css"
href="http://supybot.sourceforge.net/css/supybot.css"> href="http://supybot.sourceforge.net/css/supybot.css">
%s %s
</head>
<body><div> <body><div>
''' % (title, meta) ''' % (title, meta)
@ -149,6 +151,63 @@ def prepIndex():
''' % (genHeader('Supybot Plugin Documentation'), genNavbar('../')))) ''' % (genHeader('Supybot Plugin Documentation'), genNavbar('../'))))
fd.close() fd.close()
def genConfigSection(fd, item, toplevel=False):
confVars = item.getValues(getChildren=False, fullNames=False)
if not confVars:
return
fd.write('''<ul>''')
for (c, v) in confVars:
if not toplevel:
name = '.%s' % c
else:
name = 'supybot.%s' % c
fd.write(textwrap.dedent('''
<li id="%s"><strong>%s</strong>
''' % (v._name, name)))
try:
default = str(v)
if isinstance(v._default, basestring):
default = utils.dqrepr(default)
help = v.help()
except registry.NonExistentRegistryEntry:
pass
else:
help = cgi.escape(help)
default = cgi.escape(default)
fd.write(textwrap.dedent('''
<ul>
<li class="nonPlugin">Default: %s</li>
<li class="nonPlugin">Channel Specific: %s</li>
<li class="nonPlugin">Help: %s</li></ul>
''' % (default, v.channelValue, help)))
genConfigSection(fd, v)
fd.write(textwrap.dedent('''</li>'''))
fd.write('''</ul>''')
def makeNonPluginDocumentation():
fd = file(os.path.join('docs', 'config.html'), 'w')
title = 'Non-plugin configuration variables for Supybot'
meta = '''
<link rel="home" title="Supybot Homepage" href="../index.html">
'''
fd.write(textwrap.dedent('''
%s
<div class="mainbody" style="padding: 0;">
%s
<div style="margin: 1em;">
Configuration variables under conf.supybot:
''' % (genHeader(title, meta), genNavbar('../'))))
genConfigSection(fd, conf.supybot, toplevel=True)
fd.write(textwrap.dedent('''
</div>
</div>
</div>
<div style="text-align: center;">
<br />
%s
''' % (genFooter(),)))
fd.close()
def makePluginDocumentation(pluginWindow): def makePluginDocumentation(pluginWindow):
global commandDict global commandDict
global firstChars global firstChars
@ -253,8 +312,9 @@ def makePluginDocumentation(pluginWindow):
default = str(config[1]) default = str(config[1])
if isinstance(config[1]._default, basestring): if isinstance(config[1]._default, basestring):
default = utils.dqrepr(default) default = utils.dqrepr(default)
help = config[1]._help help = config[1].help()
help = cgi.escape(help) help = cgi.escape(help)
default = cgi.escape(default)
trClass = trClasses[trClass] trClass = trClasses[trClass]
fd.write(textwrap.dedent(''' fd.write(textwrap.dedent('''
<tr class="%s"><td>%s</td><td>%s</td><td>%s</td> <tr class="%s"><td>%s</td><td>%s</td><td>%s</td>
@ -364,6 +424,7 @@ if __name__ == '__main__':
os.mkdir(conf.supybot.directories.conf()) os.mkdir(conf.supybot.directories.conf())
if not os.path.exists(conf.supybot.directories.log()): if not os.path.exists(conf.supybot.directories.log()):
os.mkdir(conf.supybot.directories.log()) os.mkdir(conf.supybot.directories.log())
makeNonPluginDocumentation()
prepIndex() prepIndex()
plugins = [p for p in genPlugins()] plugins = [p for p in genPlugins()]
plugins.sort() plugins.sort()