#!/usr/bin/env python # -*- coding: utf-8 -*- # utilities for generating HTML indices # (c) The GRASS Development Team, Markus Neteler, Glynn Clements 2003, 2004, 2005, 2006, 2009, 2010 import sys import os import string ## TODO: better fix this in include/Make/Html.make, see bug RT #5361 # exclude following list of modules from help index: exclude_mods = [ "i.find", "r.watershed.ram", "r.watershed.seg", "v.topo.check", "helptext.html"] # these modules don't use G_parser() desc_override = { "g.parser": "Provides automated parser, GUI, and help support for GRASS scipts.", "r.li.daemon": "Support module for r.li landscape index calculations." } ############################################################################ header1_tmpl = string.Template(\ r""" ${title} """) macosx_tmpl = string.Template(\ r""" """) header2_tmpl = string.Template(\ r""" GRASS logo

GRASS GIS ${grass_version} Reference Manual

Geographic Resources Analysis Support System, commonly referred to as GRASS, is a Geographic Information System (GIS) used for geospatial data management and analysis, image processing, graphics/maps production, spatial modeling, and visualization. GRASS is currently used in academic and commercial settings around the world, as well as by many governmental agencies and environmental consulting companies.

This reference manual details the use of modules distributed with Geographic Resources Analysis Support System (GRASS), an open source (GNU GPLed), image processing and geographic information system (GIS).

""") #" overview_tmpl = string.Template(\ r"""

 Quick Introduction

 Display/Graphical User Interfaces

  • wxGUI wxPython-based GUI frontend
  • nviz 3D visualization and animation tool
  • xganim tool for animating a raster map series

 Raster and voxel processing

 Image processing

 Vector processing

 Database

 General

 Miscellaneous

 Variables

 Printing
""") #" footer_tmpl = string.Template(\ r"""

Help Index | Full Index
© 2003-2010 GRASS Development Team

""") #" cmd1_tmpl = string.Template(\ r"""${cmd}.*""") #" cmd2_tmpl = string.Template(\ r"""

${cmd}.* commands:

""") #" desc1_tmpl = string.Template(\ r""" """) #" sections = \ r""" ]

${basename} ${desc}
  d.* display commands
  db.* database commands
  g.* general commands
  i.* imagery commands
  m.* miscellaneous commands
  ps.* postscript commands
  r.* raster commands
  r3.* raster3D commands
  v.* vector commands
  nviz visualization suite
  wxGUI wxPython-based GUI frontend
  xganim raster map slideshow
""" #" modclass_tmpl = string.Template(\ r"""Go back to help overview


${modclass} commands: """) #" desc2_tmpl = string.Template(\ r""" """) #" full_index_header = \ r"""Go back to help overview

Full command index:

[ """ #" message_tmpl = string.Template(\ r"""Generated HTML docs in ${html_dir}/index.html ---------------------------------------------------------------------- Following modules are missing the 'description.html' file in src code: """) #" ############################################################################ def check_for_desc_override(basename): return desc_override.get(basename) def read_file(name): f = open(name, 'rb') s = f.read() f.close() return s def write_file(name, contents): f = open(name, 'wb') f.write(contents) f.close() def try_mkdir(path): try: os.mkdir(path) except OSError, e: pass def replace_file(name): temp = name + ".tmp" if os.path.exists(name) and os.path.exists(temp) and read_file(name) == read_file(temp): os.remove(temp) else: try: os.remove(name) except OSError, e: pass os.rename(temp, name) def copy_file(src, dst): write_file(dst, read_file(src)) def html_files(cls = None): for cmd in sorted(os.listdir(html_dir)): if cmd.endswith(".html") and \ (cls in [None, '*'] or cmd.startswith(cls + ".")) and \ (cls != '*' or len(cmd.split('.')) >= 3) and \ cmd not in ["full_index.html", "index.html"] and \ cmd not in exclude_mods and \ not cmd.startswith("wxGUI."): yield cmd def write_html_header(f, title, ismain = False): f.write(header1_tmpl.substitute(title = title)) if ismain and macosx: f.write(macosx_tmpl.substitute(grass_version = grass_version, grass_mmver = grass_mmver)) f.write(header2_tmpl.substitute(grass_version = grass_version)) def write_html_cmd_overview(f): box_color = "#e1ecd0" f.write(overview_tmpl.substitute(box_color = box_color)) def write_html_footer(f, index_url): f.write(footer_tmpl.substitute(index_url = index_url)) def get_desc(cmd): f = open(cmd, 'r') while True: line = f.readline() if not line: return "" if "NAME" in line: break while True: line = f.readline() if not line: return "" if "SYNOPSIS" in line: break if "" in line: sp = line.split('-',1) if len(sp) > 1: return sp[1].strip() else: return None return "" ############################################################################ arch_dist_dir = os.environ['ARCH_DISTDIR'] html_dir = os.path.join(arch_dist_dir, "docs", "html") gisbase = os.environ['GISBASE'] ver = read_file(os.path.join(gisbase, "etc", "VERSIONNUMBER")) try: grass_version = ver.split()[0].strip() except IndexError: grass_version = ver.split().strip() grass_mmver = '.'.join(ver.split('.')[0:2]) macosx = "darwin" in os.environ['ARCH'].lower() ############################################################################
${basename} ${desc}