123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129 |
- #!/usr/bin/env python
- ############################################################################
- #
- # MODULE: mkhtml.py
- # AUTHOR(S): Markus Neteler
- # Glynn Clements
- # Martin Landa <landa.martin gmail.com>
- # PURPOSE: Create HTML manual page snippets
- # COPYRIGHT: (C) 2007, 2009, 2011 by Glynn Clements
- # and the GRASS Development Team
- #
- # This program is free software under the GNU General
- # Public License (>=v2). Read the file COPYING that
- # comes with GRASS for details.
- #
- #############################################################################
- import sys
- import os
- import string
- import re
- pgm = sys.argv[1]
- if len(sys.argv) > 1:
- year = sys.argv[2]
- else:
- year = "2011"
- src_file = "%s.html" % pgm
- tmp_file = "%s.tmp.html" % pgm
- header_base = """<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
- <html>
- <head>
- <title>GRASS GIS Manual: ${PGM}</title>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <link rel="stylesheet" href="grassdocs.css" type="text/css">
- </head>
- <body bgcolor="white">
- <img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
- """
- header_nopgm = """<h2>${PGM}</h2>
- """
- header_pgm = """<h2>NAME</h2>
- <em><b>${PGM}</b></em>
- """
- footer_index = string.Template(\
- """<hr>
- <p><a href="index.html">Main index</a> - <a href="${INDEXNAME}.html">${INDEXNAME} index</a> - <a href="full_index.html">Full index</a></p>
- <p>© 2003-${YEAR} <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
- </body>
- </html>
- """)
- footer_noindex = string.Template(\
- """<hr>
- <p><a href="index.html">Main index</a> - <a href="full_index.html">Full index</a></p>
- <p>© 2003-${YEAR} <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
- </body>
- </html>
- """)
- def read_file(name):
- try:
- f = open(name, 'rb')
- s = f.read()
- f.close()
- return s
- except IOError:
- return ""
- src_data = read_file(src_file)
- name = re.search('(<!-- meta page name:)(.*)(-->)', src_data, re.IGNORECASE)
- if name:
- pgm = name.group(2).strip().split('-', 1)[0].strip()
- desc = re.search('(<!-- meta page description:)(.*)(-->)', src_data, re.IGNORECASE)
- if desc:
- pgm = desc.group(2).strip()
- header_tmpl = string.Template(header_base + header_nopgm)
- else:
- header_tmpl = string.Template(header_base + header_pgm)
- if not re.search('<html>', src_data, re.IGNORECASE):
- tmp_data = read_file(tmp_file)
- if not re.search('<html>', tmp_data, re.IGNORECASE):
- sys.stdout.write(header_tmpl.substitute(PGM = pgm))
- if tmp_data:
- for line in tmp_data.splitlines(True):
- if not re.search('</body>|</html>', line, re.IGNORECASE):
- sys.stdout.write(line)
- sys.stdout.write(src_data)
- # if </html> is found, suppose a complete html is provided.
- # otherwise, generate module class reference:
- if re.search('</html>', src_data, re.IGNORECASE):
- sys.exit()
- index_names = {
- 'd': 'display',
- 'db': 'database',
- 'g': 'general',
- 'i': 'imagery',
- 'm': 'misc',
- 'ps': 'postscript',
- 'p': 'paint',
- 'r': 'raster',
- 'r3': 'raster3D',
- 's': 'sites',
- 'v': 'vector'
- }
- index = re.search('(<!-- meta page index:)(.*)(-->)', src_data, re.IGNORECASE)
- if index:
- index_name = index.group(2).strip()
- else:
- mod_class = pgm.split('.', 1)[0]
- index_name = index_names.get(mod_class, '')
- if index_name:
- sys.stdout.write(footer_index.substitute(INDEXNAME = index_name, YEAR = year))
- else:
- sys.stdout.write(footer_noindex.substitute(YEAR = year))
|