| 1 | #!/usr/bin/env python
|
|---|
| 2 |
|
|---|
| 3 | #-----------------------------------------------------------
|
|---|
| 4 | # Copyright Christian Arnault LAL-Orsay CNRS
|
|---|
| 5 | # author: arnault@lal.in2p3.fr
|
|---|
| 6 | # modified by: garonne@lal.in2p3.fr
|
|---|
| 7 | # See the complete license in cmt_license.txt "http://www.cecill.info".
|
|---|
| 8 | #-----------------------------------------------------------
|
|---|
| 9 |
|
|---|
| 10 | import sys, os, string, getopt, types
|
|---|
| 11 | import xml.parsers.expat
|
|---|
| 12 | import commands, glob
|
|---|
| 13 | from datetime import date
|
|---|
| 14 |
|
|---|
| 15 |
|
|---|
| 16 | #------------------------------------------------------------
|
|---|
| 17 | def checkPythonVersion (major=1,minor=5):
|
|---|
| 18 | version = float(str(major) +'.'+ str(minor))
|
|---|
| 19 | thisversion = float(str(sys.version_info[0]) + '.' + str(sys.version_info[1]))
|
|---|
| 20 | if version > thisversion:
|
|---|
| 21 | # try to find the good python version >= 2.3
|
|---|
| 22 | paths = string.split(os.environ['PATH'],':')
|
|---|
| 23 | print 'hmmm look for the appropriate python version, this one is',\
|
|---|
| 24 | thisversion,'and the required version is python >=', version
|
|---|
| 25 | pythons = list()
|
|---|
| 26 | for path in paths:
|
|---|
| 27 | pythons = glob.glob1(path, 'python*')
|
|---|
| 28 | for python in pythons:
|
|---|
| 29 | cmd = python +' -c "import sys; print sys.version_info"'
|
|---|
| 30 | status, thisversion = commands.getstatusoutput(cmd)
|
|---|
| 31 | thisversion = eval (thisversion)
|
|---|
| 32 | thisversion = float(str(thisversion[0]) +'.'+ str(thisversion[1]))
|
|---|
| 33 | if (thisversion >= version):
|
|---|
| 34 | print 'found and load', python
|
|---|
| 35 | sys.argv.insert (0, python)
|
|---|
| 36 | os.execvp (python, sys.argv)
|
|---|
| 37 | print 'The appropriate version of python >=' + version + ' is not here, check your PATH variable or install it'
|
|---|
| 38 | sys.exit(-1)
|
|---|
| 39 |
|
|---|
| 40 |
|
|---|
| 41 | #------------------------------------------------------------
|
|---|
| 42 | # A Section holds
|
|---|
| 43 | # an id of the form n.m.p
|
|---|
| 44 | # a title
|
|---|
| 45 | # the level
|
|---|
| 46 | #
|
|---|
| 47 | class Section :
|
|---|
| 48 | def __init__ (self, id, title, level) :
|
|---|
| 49 | self.id = id
|
|---|
| 50 | self.title = title
|
|---|
| 51 | self.level = level
|
|---|
| 52 | # end def
|
|---|
| 53 |
|
|---|
| 54 | # Format the index entry for this section
|
|---|
| 55 | def show_index_entry (self) :
|
|---|
| 56 | tab = string.rjust ("", 4*self.level)
|
|---|
| 57 | tab = tab.replace (" ", " ")
|
|---|
| 58 | print '<tr>'
|
|---|
| 59 | print '<td width="100">' + self.id + '</td>'
|
|---|
| 60 | print '<td>' + tab + '<a href="#' + self.title + '">' + self.title + '</a></td>'
|
|---|
| 61 | print '</tr>'
|
|---|
| 62 | # end def
|
|---|
| 63 |
|
|---|
| 64 | #------------------------------------------------------------
|
|---|
| 65 | # A Book
|
|---|
| 66 | # It holds the history of sections and the definitions of internal entities
|
|---|
| 67 | #
|
|---|
| 68 | class Book :
|
|---|
| 69 | # Format one level of a section id as %2.2d
|
|---|
| 70 | def format_id (self, id) :
|
|---|
| 71 | r = repr (id)
|
|---|
| 72 | if id < 10 :
|
|---|
| 73 | r = ' ' + r
|
|---|
| 74 | return r
|
|---|
| 75 | # end def
|
|---|
| 76 |
|
|---|
| 77 | # Format a complete section id, with all individual level ids
|
|---|
| 78 | # Currently the implementation is somewhat ugly. This is due
|
|---|
| 79 | # to the strange behaviour of the ideal form (using a for-loop
|
|---|
| 80 | # over the elements of self.level_ids). Once we can understand
|
|---|
| 81 | # the reason of this unexpected behaviour we can improve it.
|
|---|
| 82 | def build_id (self) :
|
|---|
| 83 | id = '<tt>'
|
|---|
| 84 | n = len (self.level_ids)
|
|---|
| 85 | if n >= 1 :
|
|---|
| 86 | id += self.format_id (self.level_ids[0])
|
|---|
| 87 | if n >= 2 :
|
|---|
| 88 | id += '.' + self.format_id (self.level_ids[1])
|
|---|
| 89 | if n >= 3 :
|
|---|
| 90 | id += '.' + self.format_id (self.level_ids[2])
|
|---|
| 91 | if n >= 4 :
|
|---|
| 92 | id += '.' + self.format_id (self.level_ids[3])
|
|---|
| 93 | id += '</tt>'
|
|---|
| 94 | return id
|
|---|
| 95 | # end def
|
|---|
| 96 |
|
|---|
| 97 | # Create a new Section object
|
|---|
| 98 | # Register the history of sections (with level hierarchy)
|
|---|
| 99 | def open_section (self, name) :
|
|---|
| 100 | self.level_ids [self.level] += 1
|
|---|
| 101 | i = self.level_ids [self.level]
|
|---|
| 102 | id = self.build_id ()
|
|---|
| 103 | self.sections.append (Section (id, name, self.level))
|
|---|
| 104 | self.level += 1
|
|---|
| 105 | self.level_ids.append (0)
|
|---|
| 106 | return id
|
|---|
| 107 | # end def
|
|---|
| 108 |
|
|---|
| 109 | # Pop one level in the level hierarchy
|
|---|
| 110 | def close_section (self) :
|
|---|
| 111 | self.level_ids.pop ()
|
|---|
| 112 | self.level -= 1
|
|---|
| 113 | # end def
|
|---|
| 114 |
|
|---|
| 115 | # Register the definition of an internal entity in the entity dictionary
|
|---|
| 116 | def entity_decl (self, name, is_parameter, value, base, systemId, publicId, notation) :
|
|---|
| 117 | if value :
|
|---|
| 118 | self.entities['&' + name + ';'] = value
|
|---|
| 119 | # end def
|
|---|
| 120 |
|
|---|
| 121 | # Generic parser
|
|---|
| 122 | def generic_parse (self, p, name) :
|
|---|
| 123 | p.StartElementHandler = self.start_element
|
|---|
| 124 | p.EndElementHandler = self.end_element
|
|---|
| 125 | p.CharacterDataHandler = self.char_data
|
|---|
| 126 | p.ExternalEntityRefHandler = self.external_entity
|
|---|
| 127 | p.DefaultHandler = self.dummy
|
|---|
| 128 | p.EntityDeclHandler = self.entity_decl
|
|---|
| 129 | #file_name = os.path.join (sys.path[0], name)
|
|---|
| 130 | f = open (name)
|
|---|
| 131 | p.ParseFile (f)
|
|---|
| 132 | f.close ()
|
|---|
| 133 | # end def
|
|---|
| 134 |
|
|---|
| 135 | # Top level parser
|
|---|
| 136 | def parse (self, name) :
|
|---|
| 137 | self.p = xml.parsers.expat.ParserCreate ()
|
|---|
| 138 | self.generic_parse (self.p, name)
|
|---|
| 139 | # end def
|
|---|
| 140 |
|
|---|
| 141 | # Sub-parser for external entities
|
|---|
| 142 | def external_entity (self, context, base, system_id, public_id):
|
|---|
| 143 | #print "external entity " + repr(context) + " " + repr(system_id) + ' ' + sys.path[0]
|
|---|
| 144 | ep = self.p.ExternalEntityParserCreate (context)
|
|---|
| 145 | self.generic_parse (ep, system_id)
|
|---|
| 146 | # end def
|
|---|
| 147 |
|
|---|
| 148 | # Format a tabulation according to the stored tabulation level
|
|---|
| 149 | def tab (self) :
|
|---|
| 150 | return (string.rjust ("", self.tabulation))
|
|---|
| 151 | # end def
|
|---|
| 152 |
|
|---|
| 153 | # Flush the internal line buffer and display it using the tabulation
|
|---|
| 154 | def purge (self) :
|
|---|
| 155 | if self.line != '':
|
|---|
| 156 | if self.in_code == 0 :
|
|---|
| 157 | print self.tab () + self.line
|
|---|
| 158 | self.line = ''
|
|---|
| 159 | # end def
|
|---|
| 160 |
|
|---|
| 161 |
|
|---|
| 162 | #----------------------------------------------------------
|
|---|
| 163 | #
|
|---|
| 164 | # All XML element handlers
|
|---|
| 165 | #
|
|---|
| 166 | #----------------------------------------------------------
|
|---|
| 167 |
|
|---|
| 168 |
|
|---|
| 169 | # any element : simply reproduce the element with its attributes
|
|---|
| 170 | # (ie assume it is a true HTML element)
|
|---|
| 171 | def default_start (self, name, attrs) :
|
|---|
| 172 | self.line += '<' + name
|
|---|
| 173 | if len (attrs) > 0 :
|
|---|
| 174 | i = len (attrs)
|
|---|
| 175 | for k, v in attrs.items() :
|
|---|
| 176 | self.line += ' ' + k + '="' + v + '"'
|
|---|
| 177 | i -= 1
|
|---|
| 178 | if i <= 0 : break
|
|---|
| 179 | self.line += '>'
|
|---|
| 180 | ##### self.purge ()
|
|---|
| 181 | self.tabulation += 2
|
|---|
| 182 | # end def
|
|---|
| 183 |
|
|---|
| 184 |
|
|---|
| 185 | def default_end (self, name) :
|
|---|
| 186 | self.tabulation -= 2
|
|---|
| 187 | self.line += '</' + name + '>'
|
|---|
| 188 | self.purge ()
|
|---|
| 189 | # end def
|
|---|
| 190 |
|
|---|
| 191 |
|
|---|
| 192 | # <book>
|
|---|
| 193 | def book_start (self, attrs) :
|
|---|
| 194 | self.name = attrs['name']
|
|---|
| 195 | self.title = attrs['title']
|
|---|
| 196 | self.version = attrs['version']
|
|---|
| 197 | self.author = attrs['author']
|
|---|
| 198 | print '<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> '
|
|---|
| 199 | print '<html>'
|
|---|
| 200 | print '<title>' + self.name + '</title>'
|
|---|
| 201 | print '<head>'
|
|---|
| 202 | print ' <style type="text/css">'
|
|---|
| 203 | print ' body {font-face: Arial, Helvetica, Comic Sans MS, Times; color: #000000}'
|
|---|
| 204 | ##print ' tt {color:#006600; font-weight: normal; background-color: #eeffee}'
|
|---|
| 205 | print ' tt {color:#00AA00; font-weight: normal; background-color: #eeeeee}'
|
|---|
| 206 | print ' pre {color:#FF0000; background-color: #eeeeee; border-style: solid; border-width: 1; border-color: black; padding: 4}'
|
|---|
| 207 | print ' pre.cmt {font-family: courier; color:#00AA00; background-color: #eeeeee; border-style: solid; border-width: 1; border-color: black; padding: 4}'
|
|---|
| 208 | print ' h2 {color:#0000FF}'
|
|---|
| 209 | print ' h3 {color:#00AA00}'
|
|---|
| 210 | print ' h4 {color:#997700}'
|
|---|
| 211 | print ' a {color:#0000FF; background-color: LightGoldenRodYellow; text-decoration: none}'
|
|---|
| 212 | print ' b {font-family: courier; color:#006600; font-weight: normal; %background-color: #eeffee}'
|
|---|
| 213 | print ' td.rule {padding-top: 10}'
|
|---|
| 214 | print ' </style>'
|
|---|
| 215 | print '</head>'
|
|---|
| 216 | print '<body bgcolor="#ffffff" link="#550088" alink="#007777" alink="#007777">'
|
|---|
| 217 | ##print '<font face="Arial, Helvetica" color="#000000">'
|
|---|
| 218 | ##print '<font face="Arial, Helvetica, Comic Sans MS, Times" color="#000000">'
|
|---|
| 219 | print '<h1><center>' + self.name + '</center>'
|
|---|
| 220 | print '<center>' + self.title + '</center></h1>'
|
|---|
| 221 | print '<h2><center>Version ' + self.version + '</center>'
|
|---|
| 222 | print '<center>' + self.author + '</center>'
|
|---|
| 223 | print '<center><tt>' + attrs['email'] + '</tt></center></h2>'
|
|---|
| 224 | self.line += '<center><i>Document revision date : ' + date.today().isoformat() + '</i></center>'
|
|---|
| 225 | self.line += '<hr><h2>'
|
|---|
| 226 | self.line += '<a href="#index">General index</a>'
|
|---|
| 227 | self.line += '</h2>'
|
|---|
| 228 | self.purge ()
|
|---|
| 229 | # end def
|
|---|
| 230 |
|
|---|
| 231 | def book_end (self) :
|
|---|
| 232 | print '<hr><h1><A NAME="index"></A>Contents</h1>'
|
|---|
| 233 | print '<blockquote>'
|
|---|
| 234 | print '<table cols="2">'
|
|---|
| 235 | for k in range (len (self.sections)) :
|
|---|
| 236 | self.sections[k].show_index_entry ()
|
|---|
| 237 | print '<tr><td colspan="2"> </td></tr>'
|
|---|
| 238 | print '<tr><td colspan="2"><h2>Images</h2></td></tr>'
|
|---|
| 239 | for k in range (len (self.images)) :
|
|---|
| 240 | print '<tr>'
|
|---|
| 241 | print '<td width="100"><tt>' + repr(k+1) + '</tt></td>'
|
|---|
| 242 | print '<td><a href="#' + self.images[k] + '">' + self.images[k] + '</a></td>'
|
|---|
| 243 | print '</tr>'
|
|---|
| 244 | print '</table>'
|
|---|
| 245 | print '</blockquote>'
|
|---|
| 246 | ##print '</font>'
|
|---|
| 247 | print '<address>'
|
|---|
| 248 | print '<i>' + self.author + '</i>'
|
|---|
| 249 | print '</address>'
|
|---|
| 250 | print '</body>'
|
|---|
| 251 | print '</html>'
|
|---|
| 252 | # end def
|
|---|
| 253 |
|
|---|
| 254 |
|
|---|
| 255 | # <section>
|
|---|
| 256 | def section_start (self, attrs) :
|
|---|
| 257 | title = attrs['title']
|
|---|
| 258 | title = title.replace ('>', '>')
|
|---|
| 259 | title = title.replace ('<', '<')
|
|---|
| 260 | id = self.open_section (title)
|
|---|
| 261 | h_level = repr(self.level+1)
|
|---|
| 262 | self.line += '<hr><h' + h_level + '>'
|
|---|
| 263 | self.line += '<a name="' + title + '"></a>'
|
|---|
| 264 | self.line += '<a href="#index">' + id + '</a> - ' + title
|
|---|
| 265 | self.line += '</h' + h_level + '>'
|
|---|
| 266 | self.purge ()
|
|---|
| 267 | self.line = '<blockquote>'
|
|---|
| 268 | self.purge ()
|
|---|
| 269 | # end def
|
|---|
| 270 |
|
|---|
| 271 | def section_end (self) :
|
|---|
| 272 | self.purge ()
|
|---|
| 273 | self.line = '</blockquote>'
|
|---|
| 274 | self.purge ()
|
|---|
| 275 | self.close_section ()
|
|---|
| 276 | # end def
|
|---|
| 277 |
|
|---|
| 278 |
|
|---|
| 279 | # <code>
|
|---|
| 280 | def code_start (self, attrs) :
|
|---|
| 281 | self.purge ()
|
|---|
| 282 | self.in_code += 1
|
|---|
| 283 | self.line = '<pre>'
|
|---|
| 284 | # end def
|
|---|
| 285 |
|
|---|
| 286 | def code_end (self) :
|
|---|
| 287 | self.in_code -= 1
|
|---|
| 288 | print self.line + '</pre>'
|
|---|
| 289 | self.line = ''
|
|---|
| 290 | # end def
|
|---|
| 291 |
|
|---|
| 292 |
|
|---|
| 293 | # <cmtcode>
|
|---|
| 294 | def cmtcode_start (self, attrs) :
|
|---|
| 295 | self.purge ()
|
|---|
| 296 | self.in_code += 1
|
|---|
| 297 | self.line = '<pre class="cmt">'
|
|---|
| 298 | # end def
|
|---|
| 299 |
|
|---|
| 300 | def cmtcode_end (self) :
|
|---|
| 301 | self.in_code -= 1
|
|---|
| 302 | print self.line + '</pre>'
|
|---|
| 303 | self.line = ''
|
|---|
| 304 | # end def
|
|---|
| 305 |
|
|---|
| 306 |
|
|---|
| 307 | # <syntax>
|
|---|
| 308 | def syntax_start (self, attrs) :
|
|---|
| 309 | print '<center>'
|
|---|
| 310 | print '<table cols="3">'
|
|---|
| 311 | print '<tr>'
|
|---|
| 312 | if 'rule-width' in attrs :
|
|---|
| 313 | print '<td width="' + attrs['rule-width'] + '"></td>'
|
|---|
| 314 | else :
|
|---|
| 315 | print '<td></td>'
|
|---|
| 316 | if 'name' in attrs :
|
|---|
| 317 | self.ruleref_prefix = 'kw' + attrs['name'] + '-'
|
|---|
| 318 | else :
|
|---|
| 319 | self.ruleref_prefix = 'kw-'
|
|---|
| 320 | print '<td width="10"></td>'
|
|---|
| 321 | print '<td></td>'
|
|---|
| 322 | print '</tr>'
|
|---|
| 323 | # end def
|
|---|
| 324 |
|
|---|
| 325 | def syntax_end (self) :
|
|---|
| 326 | print '</table>'
|
|---|
| 327 | print '</center>'
|
|---|
| 328 | # end def
|
|---|
| 329 |
|
|---|
| 330 |
|
|---|
| 331 | # <rule>
|
|---|
| 332 | def rule_start (self, attrs) :
|
|---|
| 333 | self.rule_name = attrs['name']
|
|---|
| 334 | self.rule_started = 0
|
|---|
| 335 | # end def
|
|---|
| 336 |
|
|---|
| 337 | def rule_end (self) :
|
|---|
| 338 | self.rule_name = ''
|
|---|
| 339 | self.rule_started = 0
|
|---|
| 340 | # end def
|
|---|
| 341 |
|
|---|
| 342 |
|
|---|
| 343 | # <alt>
|
|---|
| 344 | def alt_start (self, attrs) :
|
|---|
| 345 | print '<tr>'
|
|---|
| 346 | if self.rule_started == 0 :
|
|---|
| 347 | self.rule_started = 1
|
|---|
| 348 | print '<td class="rule"><font face="courier new, courier" COLOR="#770000"><i><a name="' + self.ruleref_prefix + self.rule_name + '"></a>' + self.rule_name + '</i></font></td>'
|
|---|
| 349 | print '<td class="rule">:</td>'
|
|---|
| 350 | print '<td class="rule">'
|
|---|
| 351 | else :
|
|---|
| 352 | print '<td></td>'
|
|---|
| 353 | print '<td>|</td>'
|
|---|
| 354 | print '<td>'
|
|---|
| 355 | # end def
|
|---|
| 356 |
|
|---|
| 357 | def alt_end (self) :
|
|---|
| 358 | print '</td>'
|
|---|
| 359 | print '</tr>'
|
|---|
| 360 | # end def
|
|---|
| 361 |
|
|---|
| 362 |
|
|---|
| 363 | # <continuation>
|
|---|
| 364 | def continuation_start (self, attrs) :
|
|---|
| 365 | print '<tr>'
|
|---|
| 366 | print '<td></td>'
|
|---|
| 367 | print '<td></td>'
|
|---|
| 368 | print '<td> '
|
|---|
| 369 | # end def
|
|---|
| 370 |
|
|---|
| 371 | def continuation_end (self) :
|
|---|
| 372 | print '</td>'
|
|---|
| 373 | print '</tr>'
|
|---|
| 374 | # end def
|
|---|
| 375 |
|
|---|
| 376 |
|
|---|
| 377 | # <kwd>
|
|---|
| 378 | def kwd_start (self, attrs) :
|
|---|
| 379 | print '<font face="courier new, courier" COLOR="#FF0000">'
|
|---|
| 380 | if 'name' in attrs :
|
|---|
| 381 | name = attrs['name']
|
|---|
| 382 | else :
|
|---|
| 383 | name = self.rule_name
|
|---|
| 384 | if 'value' in attrs :
|
|---|
| 385 | name += '='
|
|---|
| 386 | value = '<font face="courier new, courier" COLOR="#770000"><i>'
|
|---|
| 387 | value += attrs['value']
|
|---|
| 388 | value += '</i></font>'
|
|---|
| 389 | else :
|
|---|
| 390 | value = ''
|
|---|
| 391 | print name + value
|
|---|
| 392 | # end def
|
|---|
| 393 |
|
|---|
| 394 | def kwd_end (self) :
|
|---|
| 395 | print '</font>'
|
|---|
| 396 | # end def
|
|---|
| 397 |
|
|---|
| 398 |
|
|---|
| 399 |
|
|---|
| 400 | # <term>
|
|---|
| 401 | def term_start (self, attrs) :
|
|---|
| 402 | print '<font face="courier new, courier" COLOR="#770000"><i>'
|
|---|
| 403 | print attrs['name']
|
|---|
| 404 | # end def
|
|---|
| 405 |
|
|---|
| 406 | def term_end (self) :
|
|---|
| 407 | print '</i></font>'
|
|---|
| 408 | # end def
|
|---|
| 409 |
|
|---|
| 410 |
|
|---|
| 411 |
|
|---|
| 412 | # <ruleref>
|
|---|
| 413 | def ruleref_start (self, attrs) :
|
|---|
| 414 | print '<font face="courier new, courier" COLOR="#770000"><i>'
|
|---|
| 415 | print '<a href="#' + self.ruleref_prefix + attrs['name'] + '">' + attrs['name'] + '</a>'
|
|---|
| 416 | # end def
|
|---|
| 417 |
|
|---|
| 418 | def ruleref_end (self) :
|
|---|
| 419 | print '</i></font>'
|
|---|
| 420 | # end def
|
|---|
| 421 |
|
|---|
| 422 |
|
|---|
| 423 | # <option>
|
|---|
| 424 | def option_start (self, attrs) :
|
|---|
| 425 | print '[ '
|
|---|
| 426 | # end def
|
|---|
| 427 |
|
|---|
| 428 | def option_end (self) :
|
|---|
| 429 | print ' ] '
|
|---|
| 430 | # end def
|
|---|
| 431 |
|
|---|
| 432 |
|
|---|
| 433 | # <seq>
|
|---|
| 434 | def seq_start (self, attrs) :
|
|---|
| 435 | i=0
|
|---|
| 436 | # end def
|
|---|
| 437 |
|
|---|
| 438 | def seq_end (self) :
|
|---|
| 439 | print ' ... '
|
|---|
| 440 | # end def
|
|---|
| 441 |
|
|---|
| 442 |
|
|---|
| 443 | # <optionseq>
|
|---|
| 444 | def optionseq_start (self, attrs) :
|
|---|
| 445 | print '[ '
|
|---|
| 446 | # end def
|
|---|
| 447 |
|
|---|
| 448 | def optionseq_end (self) :
|
|---|
| 449 | print ' ... '
|
|---|
| 450 | print ' ] '
|
|---|
| 451 | # end def
|
|---|
| 452 |
|
|---|
| 453 |
|
|---|
| 454 |
|
|---|
| 455 | # <image>
|
|---|
| 456 | def image_start (self, attrs) :
|
|---|
| 457 | caption = attrs['caption']
|
|---|
| 458 | self.images.append (caption)
|
|---|
| 459 | n = len (self.images)
|
|---|
| 460 | print '<center>'
|
|---|
| 461 | print '<a name="' + caption + '"></a>'
|
|---|
| 462 | print '<img src="' + attrs['src'] + '"/>'
|
|---|
| 463 | print '</center>'
|
|---|
| 464 | print '<center>'
|
|---|
| 465 | print '<tt>' + repr(n) + '</tt> - <i>' + caption + '</i>'
|
|---|
| 466 | # end def
|
|---|
| 467 |
|
|---|
| 468 | def image_end (self) :
|
|---|
| 469 | print '</center>'
|
|---|
| 470 | # end def
|
|---|
| 471 |
|
|---|
| 472 | def blockquote_start (self, attrs) :
|
|---|
| 473 | print '<blockquote><hr>'
|
|---|
| 474 | # end def
|
|---|
| 475 |
|
|---|
| 476 | def blockquote_end (self) :
|
|---|
| 477 | print '<hr></blockquote>'
|
|---|
| 478 | # end def
|
|---|
| 479 |
|
|---|
| 480 |
|
|---|
| 481 | # Basic element parsing handler
|
|---|
| 482 | def start_element (self, name, attrs):
|
|---|
| 483 | #print 'start_element: name=' + repr(name)
|
|---|
| 484 | try :
|
|---|
| 485 | if self.start_handlers.has_key (name) :
|
|---|
| 486 | self.start_handlers [name] (attrs)
|
|---|
| 487 | else :
|
|---|
| 488 | self.default_start (name, attrs)
|
|---|
| 489 | except TypeError:
|
|---|
| 490 | print 'start_element: (error) name=' + repr(name)
|
|---|
| 491 | self.default_start (name, attrs)
|
|---|
| 492 | # end def
|
|---|
| 493 |
|
|---|
| 494 | def end_element (self, name) :
|
|---|
| 495 | #print 'end_element: name=' + repr(name)
|
|---|
| 496 | try :
|
|---|
| 497 | if self.end_handlers.has_key (name) :
|
|---|
| 498 | self.end_handlers [name] ()
|
|---|
| 499 | else :
|
|---|
| 500 | self.default_end (name)
|
|---|
| 501 | except TypeError:
|
|---|
| 502 | #print 'end_element: (error) name=' + repr(name)
|
|---|
| 503 | if name == u'cmt:book' :
|
|---|
| 504 | self.book_end ()
|
|---|
| 505 | else :
|
|---|
| 506 | self.default_end (name)
|
|---|
| 507 | # end def
|
|---|
| 508 |
|
|---|
| 509 | # Unhandled elements will be trapped here
|
|---|
| 510 | def dummy (self, data) :
|
|---|
| 511 | if self.entities.has_key (data) :
|
|---|
| 512 | self.char_data (self.entities[data])
|
|---|
| 513 | #print "dummy:[" + repr (data) + "]" + repr (type(data))
|
|---|
| 514 | # end def
|
|---|
| 515 |
|
|---|
| 516 | # CDATA handling inside code sections
|
|---|
| 517 | def code_char_data (self, data) :
|
|---|
| 518 | if data == u'\n' :
|
|---|
| 519 | self.line += data
|
|---|
| 520 | else :
|
|---|
| 521 | n = len (data)
|
|---|
| 522 | #
|
|---|
| 523 | if n > 0 :
|
|---|
| 524 | if data == u'<':
|
|---|
| 525 | self.line += '<'
|
|---|
| 526 | elif data == u'>' :
|
|---|
| 527 | self.line += '>'
|
|---|
| 528 | else :
|
|---|
| 529 | self.line += data
|
|---|
| 530 | # end def
|
|---|
| 531 |
|
|---|
| 532 | # CDATA handling outside code sections
|
|---|
| 533 | def plain_char_data (self, data) :
|
|---|
| 534 | if data == u'\n' :
|
|---|
| 535 | self.purge ()
|
|---|
| 536 | else :
|
|---|
| 537 | n = len (string.strip (data))
|
|---|
| 538 | #
|
|---|
| 539 | if n > 0 :
|
|---|
| 540 | if data == u'<':
|
|---|
| 541 | self.line += '<'
|
|---|
| 542 | elif data == u'>' :
|
|---|
| 543 | self.line += '>'
|
|---|
| 544 | else :
|
|---|
| 545 | # self.line += string.strip (data)
|
|---|
| 546 | self.line += data
|
|---|
| 547 | # end def
|
|---|
| 548 |
|
|---|
| 549 | # CDATA handling
|
|---|
| 550 | def char_data (self, data) :
|
|---|
| 551 | #print '[' + repr(data) + ']' + repr (type (data)) + ' ' + repr(len (string.strip (data)))
|
|---|
| 552 | if self.in_code > 0 :
|
|---|
| 553 | self.code_char_data (data)
|
|---|
| 554 | else :
|
|---|
| 555 | self.plain_char_data (data)
|
|---|
| 556 | # end def
|
|---|
| 557 |
|
|---|
| 558 | def __init__ (self) :
|
|---|
| 559 | self.line = ''
|
|---|
| 560 | self.tabulation = 0
|
|---|
| 561 | self.in_code = 0
|
|---|
| 562 | self.sections = []
|
|---|
| 563 | self.level_ids = [0]
|
|---|
| 564 | self.level = 0
|
|---|
| 565 | self.images = []
|
|---|
| 566 | self.entities = {}
|
|---|
| 567 | #
|
|---|
| 568 | self.start_handlers = {}
|
|---|
| 569 | self.start_handlers['cmt:code'] = self.code_start
|
|---|
| 570 | self.start_handlers['cmt:cmtcode'] = self.cmtcode_start
|
|---|
| 571 | self.start_handlers['cmt:section'] = self.section_start
|
|---|
| 572 | self.start_handlers['cmt:book'] = self.book_start
|
|---|
| 573 | self.start_handlers['cmt:syntax'] = self.syntax_start
|
|---|
| 574 | self.start_handlers['cmt:rule'] = self.rule_start
|
|---|
| 575 | self.start_handlers['cmt:alt'] = self.alt_start
|
|---|
| 576 | self.start_handlers['cmt:continuation'] = self.continuation_start
|
|---|
| 577 | self.start_handlers['cmt:kwd'] = self.kwd_start
|
|---|
| 578 | self.start_handlers['cmt:term'] = self.term_start
|
|---|
| 579 | self.start_handlers['cmt:ruleref'] = self.ruleref_start
|
|---|
| 580 | self.start_handlers['cmt:option'] = self.option_start
|
|---|
| 581 | self.start_handlers['cmt:seq'] = self.seq_start
|
|---|
| 582 | self.start_handlers['cmt:optionseq'] = self.optionseq_start
|
|---|
| 583 | self.start_handlers['cmt:image'] = self.image_start
|
|---|
| 584 | self.start_handlers['cmt:blockquote'] = self.blockquote_start
|
|---|
| 585 | #
|
|---|
| 586 | self.end_handlers = {}
|
|---|
| 587 | self.end_handlers['cmt:code'] = self.code_end
|
|---|
| 588 | self.end_handlers['cmt:cmtcode'] = self.cmtcode_end
|
|---|
| 589 | self.end_handlers['cmt:section'] = self.section_end
|
|---|
| 590 | self.end_handlers['cmt:book'] = self.book_end
|
|---|
| 591 | self.end_handlers['cmt:syntax'] = self.syntax_end
|
|---|
| 592 | self.end_handlers['cmt:rule'] = self.rule_end
|
|---|
| 593 | self.end_handlers['cmt:alt'] = self.alt_end
|
|---|
| 594 | self.end_handlers['cmt:continuation'] = self.continuation_end
|
|---|
| 595 | self.end_handlers['cmt:kwd'] = self.kwd_end
|
|---|
| 596 | self.end_handlers['cmt:term'] = self.term_end
|
|---|
| 597 | self.end_handlers['cmt:ruleref'] = self.ruleref_end
|
|---|
| 598 | self.end_handlers['cmt:option'] = self.option_end
|
|---|
| 599 | self.end_handlers['cmt:seq'] = self.seq_end
|
|---|
| 600 | self.end_handlers['cmt:optionseq'] = self.optionseq_end
|
|---|
| 601 | self.end_handlers['cmt:image'] = self.image_end
|
|---|
| 602 | self.end_handlers['cmt:blockquote'] = self.blockquote_end
|
|---|
| 603 | # end def
|
|---|
| 604 |
|
|---|
| 605 |
|
|---|
| 606 |
|
|---|
| 607 | #----------------------------------------------------------------------------------
|
|---|
| 608 |
|
|---|
| 609 | #----------------------------------------------------------------------------------
|
|---|
| 610 | #
|
|---|
| 611 | # Various top level functions
|
|---|
| 612 | #
|
|---|
| 613 | #----------------------------------------------------------------------------------
|
|---|
| 614 | def usage() :
|
|---|
| 615 | print 'Usage:'
|
|---|
| 616 | print ' gendoc'
|
|---|
| 617 | print 'Try "gendoc --help" for more information.'
|
|---|
| 618 | sys.exit()
|
|---|
| 619 | # end def
|
|---|
| 620 |
|
|---|
| 621 | #----------------------------------------------------------------------------------
|
|---|
| 622 | def help() :
|
|---|
| 623 | print "Generates the HTML documentation from Xml"
|
|---|
| 624 | # end def
|
|---|
| 625 |
|
|---|
| 626 | #----------------------------------------------------------------------------------
|
|---|
| 627 | def main() :
|
|---|
| 628 | file_name = ''
|
|---|
| 629 | options = []
|
|---|
| 630 | for a in sys.argv[1:] :
|
|---|
| 631 | if a[0] == '-' :
|
|---|
| 632 | options = sys.argv[sys.argv.index(a):]
|
|---|
| 633 | break
|
|---|
| 634 | else :
|
|---|
| 635 | file_name = a
|
|---|
| 636 | try:
|
|---|
| 637 | opts, args = getopt.getopt(options, 'h', ['help'])
|
|---|
| 638 | except getopt.GetoptError:
|
|---|
| 639 | usage()
|
|---|
| 640 | sys.exit(2)
|
|---|
| 641 | for o, a in opts:
|
|---|
| 642 | if o in ('-h', '--help'):
|
|---|
| 643 | help()
|
|---|
| 644 | sys.exit()
|
|---|
| 645 | book = Book ()
|
|---|
| 646 | book.parse (file_name)
|
|---|
| 647 | # end def
|
|---|
| 648 |
|
|---|
| 649 | #---------------------------------------------------------------------
|
|---|
| 650 | #print '__name__ = ' + __name__
|
|---|
| 651 | if __name__ == "__main__":
|
|---|
| 652 | checkPythonVersion (major=2, minor=3)
|
|---|
| 653 | main()
|
|---|
| 654 | # end def
|
|---|
| 655 |
|
|---|
