summaryrefslogtreecommitdiff
path: root/sandbox/py-rest-doc/sphinx/htmlhelp.py
diff options
context:
space:
mode:
authorgbrandl <gbrandl@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2007-07-07 21:20:47 +0000
committergbrandl <gbrandl@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2007-07-07 21:20:47 +0000
commitf46ef2418216c95d0764b8907d177e3a569ddc21 (patch)
tree7ee5ae79e8e457341d091dfcccbe00db5444af08 /sandbox/py-rest-doc/sphinx/htmlhelp.py
parent2756523b3bebd4e1aa31dd18f453d284adb1ad41 (diff)
downloaddocutils-f46ef2418216c95d0764b8907d177e3a569ddc21.tar.gz
Add an HTML Help builder, untested though.
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@5323 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'sandbox/py-rest-doc/sphinx/htmlhelp.py')
-rw-r--r--sandbox/py-rest-doc/sphinx/htmlhelp.py212
1 files changed, 212 insertions, 0 deletions
diff --git a/sandbox/py-rest-doc/sphinx/htmlhelp.py b/sandbox/py-rest-doc/sphinx/htmlhelp.py
new file mode 100644
index 000000000..21ced0850
--- /dev/null
+++ b/sandbox/py-rest-doc/sphinx/htmlhelp.py
@@ -0,0 +1,212 @@
+# -*- coding: utf-8 -*-
+"""
+ sphinx.htmlhelp
+ ~~~~~~~~~~~~~~~
+
+ Build HTML help support files.
+ Adapted from the original Doc/tools/prechm.py.
+
+ :copyright: 2007 by Georg Brandl.
+ :license: Python license.
+"""
+from __future__ import with_statement
+
+import os
+from os import path
+
+from docutils import nodes
+
+from . import addnodes
+
+# Project file (*.hhp) template. 'outname' is the file basename (like
+# the pythlp in pythlp.hhp); 'version' is the doc version number (like
+# the 2.2 in Python 2.2).
+# The magical numbers in the long line under [WINDOWS] set most of the
+# user-visible features (visible buttons, tabs, etc).
+# About 0x10384e: This defines the buttons in the help viewer. The
+# following defns are taken from htmlhelp.h. Not all possibilities
+# actually work, and not all those that work are available from the Help
+# Workshop GUI. In particular, the Zoom/Font button works and is not
+# available from the GUI. The ones we're using are marked with 'x':
+#
+# 0x000002 Hide/Show x
+# 0x000004 Back x
+# 0x000008 Forward x
+# 0x000010 Stop
+# 0x000020 Refresh
+# 0x000040 Home x
+# 0x000080 Forward
+# 0x000100 Back
+# 0x000200 Notes
+# 0x000400 Contents
+# 0x000800 Locate x
+# 0x001000 Options x
+# 0x002000 Print x
+# 0x004000 Index
+# 0x008000 Search
+# 0x010000 History
+# 0x020000 Favorites
+# 0x040000 Jump 1
+# 0x080000 Jump 2
+# 0x100000 Zoom/Font x
+# 0x200000 TOC Next
+# 0x400000 TOC Prev
+
+project_template = '''\
+[OPTIONS]
+Compiled file=%(outname)s.chm
+Contents file=%(outname)s.hhc
+Default Window=%(outname)s
+Default topic=index.html
+Display compile progress=No
+Full text search stop list file=%(outname)s.stp
+Full-text search=Yes
+Index file=%(outname)s.hhk
+Language=0x409
+Title=Python %(version)s Documentation
+
+[WINDOWS]
+%(outname)s="Python %(version)s Documentation","%(outname)s.hhc","%(outname)s.hhk",\
+"index.html","index.html",,,,,0x63520,220,0x10384e,[0,0,1024,768],,,,,,,0
+
+[FILES]
+'''
+
+contents_header = '''\
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
+<HTML>
+<HEAD>
+<meta name="GENERATOR" content="Microsoft&reg; HTML Help Workshop 4.1">
+<!-- Sitemap 1.0 -->
+</HEAD><BODY>
+<OBJECT type="text/site properties">
+ <param name="Window Styles" value="0x801227">
+ <param name="ImageType" value="Folder">
+</OBJECT>
+<UL>
+'''
+
+contents_footer = '''\
+</UL></BODY></HTML>
+'''
+
+object_sitemap = '''\
+<OBJECT type="text/sitemap">
+ <param name="Name" value="%s">
+ <param name="Local" value="%s">
+</OBJECT>
+'''
+
+# List of words the full text search facility shouldn't index. This
+# becomes file outname.stp. Note that this list must be pretty small!
+# Different versions of the MS docs claim the file has a maximum size of
+# 256 or 512 bytes (including \r\n at the end of each line).
+# Note that "and", "or", "not" and "near" are operators in the search
+# language, so no point indexing them even if we wanted to.
+stopwords = """
+a and are as at
+be but by
+for
+if in into is it
+near no not
+of on or
+such
+that the their then there these they this to
+was will with
+""".split()
+
+
+# # Convenience class to hold info about "a book" in HTMLHelp terms == a doc
+# # directory in Python terms.
+# class Book:
+# def __init__(self, directory, title, firstpage, contentpage=None, indexpage=None):
+# self.directory = directory
+# self.title = title
+# #self.firstpage = addhtml(firstpage)
+# #self.contentpage = addhtml(contentpage)
+# #self.indexpage = addhtml(indexpage)
+
+# books = [
+# Book('.', 'Main page', 'index'),
+# Book('.', 'Global Module Index', 'modindex'),
+# Book('whatsnew', "What's New", 'index', 'contents'),
+# Book('tutorial', 'Tutorial', 'tut', 'node2'),
+# Book('modules', 'Library Reference', 'lib', 'contents', 'genindex'),
+# Book('reference', 'Language Reference', 'ref', 'contents', 'genindex'),
+# Book('macmodules', 'Macintosh Reference', 'mac', 'contents', 'genindex'),
+# Book('extending', 'Extending and Embedding', 'ext', 'contents'),
+# Book('c-api', 'Python/C API', 'api', 'contents', 'genindex'),
+# Book('documenting', 'Documenting Python', 'doc', 'contents'),
+# Book('install', 'Installing Python Modules', 'inst', 'index'),
+# Book('distutils', 'Distributing Python Modules', 'dist', 'index', 'genindex'),
+# ]
+
+
+def build_hhx(builder, outdir, outname):
+ builder.msg('dumping stopword list...')
+ with open(path.join(outdir, outname+'.stp'), 'w') as f:
+ for word in sorted(stopwords):
+ print >>f, word
+
+ builder.msg('writing project file...')
+ with open(path.join(outdir, outname+'.hhp'), 'w') as f:
+ f.write(project_template % {'outname': outname,
+ 'version': builder.config['version']})
+ if not outdir.endswith(os.sep):
+ outdir += os.sep
+ olen = len(outdir)
+ for root, dirs, files in os.walk(outdir):
+ for fn in files:
+ if fn.endswith(('.html', '.css', '.js')):
+ print >>f, path.join(root, fn)[olen:].replace('/', '\\')
+
+ builder.msg('writing TOC file...')
+ with open(path.join(outdir, outname+'.hhc'), 'w') as f:
+ f.write(contents_header)
+ # special books
+ f.write('<LI>\n' + object_sitemap % ('Main page', 'index.html'))
+ f.write('<LI>\n' + object_sitemap % ('Global Module Index', 'modindex.html'))
+ # the TOC
+ toc = builder.env.get_and_resolve_doctree('contents.rst', builder)
+ def write_toc(node, ullevel=0):
+ if isinstance(node, nodes.list_item):
+ f.write('<LI>\n')
+ for subnode in node:
+ write_toc(subnode, ullevel)
+ elif isinstance(node, nodes.reference):
+ f.write(object_sitemap % (node.astext(), node['refuri']))
+ elif isinstance(node, nodes.bullet_list):
+ if ullevel != 0:
+ f.write('<UL>\n')
+ for subnode in node:
+ write_toc(subnode, ullevel+1)
+ if ullevel != 0:
+ f.write('</UL>\n')
+ elif isinstance(node, addnodes.compact_paragraph):
+ for subnode in node:
+ write_toc(subnode, ullevel)
+ elif isinstance(node, nodes.section):
+ write_toc(node[1], ullevel)
+ elif isinstance(node, nodes.document):
+ write_toc(node[0], ullevel)
+ write_toc(toc)
+ f.write(contents_footer)
+
+ builder.msg('writing index file...')
+ with open(path.join(outdir, outname+'.hhk'), 'w') as f:
+ f.write('<UL>\n')
+ def write_index(title, refs, subitems):
+ if refs:
+ f.write('<LI> ')
+ f.write(object_sitemap % (title, refs[0]))
+ for ref in refs[1:]:
+ f.write(object_sitemap % ('[Link]', ref))
+ if subitems:
+ f.write('<UL> ')
+ for subitem in subitems:
+ write_index(subitem[0], subitem[1], [])
+ f.write('</UL>')
+ for (key, group) in builder.env.index:
+ for title, (refs, subitems) in group:
+ write_index(title, refs, subitems)
+ f.write('</UL>\n')
View Lorry Controller Status