buildscripts/texi-langutils.py

   1 #!@PYTHON@
   2 # texi-langutils.py
   3
   4 # WARNING: this script can't find files included in a different directory
   5
   6 import sys
   7 import re
   8 import getopt
   9 import os
  10 import string
  11
  12 optlist, texi_files = getopt.getopt(sys.argv[1:],'no:d:b:i:',['skeleton', 'gettext'])
  13 process_includes = not ('-n', '') in optlist # -n   don't process @include's in texinfo files
  14
  15 make_gettext = ('--gettext', '') in optlist   # --gettext    generate a node list from a Texinfo source
  16 make_skeleton = ('--skeleton', '') in optlist # --skeleton   extract the node tree from a Texinfo source
  17
  18 output_file = 'doc.pot'
  19 node_blurb = ''
  20 intro_blurb = ''
  21
  22 for x in optlist:
  23         if x[0] == '-o': # -o NAME   set PO output file name to NAME
  24                 output_file = x[1]
  25         elif x[0] == '-d': # -d DIR    set working directory to DIR
  26                 os.chdir (x[1])
  27         elif x[0] == '-b': # -b BLURB  set blurb written at each node to BLURB
  28                 node_blurb = x[1]
  29         elif x[0] == '-i': # -i BLURB  set blurb written at beginning of each file to BLURB
  30                 intro_blurb = x[1]
  31
  32 def process_texi (texifilename, i_blurb, n_blurb, write_skeleton, output_file=None):
  33         try:
  34                 f = open (texifilename, 'r')
  35                 texifile = f.read ()
  36                 f.close ()
  37                 includes = []
  38                 if write_skeleton:
  39                         g = open (os.path.basename (texifilename), 'w')
  40                         g.write (i_blurb)
  41                         tutu = re.findall (r"""^(\*) +([^:
  42                         ]+)::[^
  43                         ]*?$|^@(include|menu|end menu|node|(?:unnumbered|appendix)(?:(?:sub){0,2}sec)?|top|chapter|(?:sub){0,2}section|(?:major|chap|(?:sub){0,2})heading) *([^@
  44                         ]*)[^
  45                         ]*?$|@(rglos){(.+?)}""", texifile, re.M)
  46                         node_trigger = False
  47                         for item in tutu:
  48                                 if item[0] == '*':
  49                                         g.write ('* ' + item[1] + '::\n')
  50                                 elif output_file and item[4] == 'rglos':
  51                                         output_file.write ('_("' + item[5] + '") # @rglos in ' + texifilename + '\n')
  52                                 else:
  53                                         g.write ('@' + item[2] + ' ' + item[3] + '\n')
  54                                         if node_trigger:
  55                                                 g.write (n_blurb)
  56                                                 node_trigger = False
  57                                         if not item[2] in ('include', 'menu', 'end menu'):
  58                                                 if output_file:
  59                                                         output_file.write ('_("' + item[3].strip () + '") # @' + item[2] + \
  60                                                                            ' in ' + texifilename + '\n')
  61                                                 node_trigger = True
  62                                         elif item[2] == 'include':
  63                                                 includes.append(item[3])
  64                         g.close ()
  65                 elif output_file:
  66                         toto = re.findall (r"""^@(include|node|(?:unnumbered|appendix)(?:(?:sub){0,2}sec)?|top|chapter|(?:sub){0,2}section|(?:major|chap|(?:sub){0,2})heading) *([^@
  67                         ]*)[^
  68                         ]*?$|@(rglos){(.+?)}""", texifile, re.M)
  69                         for item in toto:
  70                                 if item[0] == 'include':
  71                                         includes.append(item[1])
  72                                 elif item[2] == 'rglos':
  73                                         output_file.write ('# @rglos in ' + texifilename + '\n_("' + item[3] + '")\n')
  74                                 else:
  75                                         output_file.write ('# @' + item[0] + ' in ' + texifilename + '\n_("' + item[1].strip () + '")\n')
  76                 if process_includes:
  77                         dir = os.path.dirname (texifilename)
  78                         for item in includes:
  79                                 process_texi (os.path.join (dir, item.strip ()), i_blurb, n_blurb, write_skeleton, output_file)
  80         except IOError, (errno, strerror):
  81                 print "I/O error(%s): %s: %s" % (errno, texifilename, strerror)
  82
  83
  84 if intro_blurb != '':
  85         intro_blurb += '\n\n'
  86 if node_blurb != '':
  87         node_blurb = '\n' + node_blurb + '\n\n'
  88 if make_gettext:
  89         node_list_filename = 'node_list'
  90         node_list = open (node_list_filename, 'w')
  91         for texi_file in texi_files:
  92                 process_texi (texi_file, intro_blurb, node_blurb, make_skeleton, node_list)
  93         for word in ('Up:', 'Next:', 'Previous:', 'Appendix', 'Footnotes'):
  94                 node_list.write ('_("' + word + '")\n')
  95         node_list.close ()
  96         os.system ('xgettext -c -L Python --no-location -o ' + output_file + ' ' + node_list_filename)
  97 else:
  98         for texi_file in texi_files:
  99                 process_texi (texi_file, intro_blurb, node_blurb, make_skeleton)