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
  11 import langdefs
  12
  13 def read_pipe (command):
  14     print command
  15     pipe = os.popen (command)
  16     output = pipe.read ()
  17     if pipe.close ():
  18         print "pipe failed: %(command)s" % locals ()
  19     return output
  20
  21
  22 optlist, texi_files = getopt.getopt(sys.argv[1:],'no:d:b:i:l:',['skeleton', 'gettext'])
  23 process_includes = not ('-n', '') in optlist # -n   don't process @include's in texinfo files
  24
  25 make_gettext = ('--gettext', '') in optlist   # --gettext    generate a node list from a Texinfo source
  26 make_skeleton = ('--skeleton', '') in optlist # --skeleton   extract the node tree from a Texinfo source
  27
  28 output_file = 'doc.pot'
  29
  30 # @untranslated should be defined as a macro in Texinfo source
  31 node_blurb = '''@untranslated
  32 '''
  33 doclang = ''
  34 head_committish = read_pipe ('git-rev-parse HEAD')
  35 intro_blurb = '''@c -*- coding: utf-8; mode: texinfo%(doclang)s -*-
  36 @c This file is part of %(topfile)s
  37 @ignore
  38     Translation of GIT committish: %(head_committish)s
  39     When revising a translation, copy the HEAD committish of the
  40     version that you are working on.  See TRANSLATION for details.
  41 @end ignore
  42 '''
  43
  44 end_blurb = """
  45 @c -- SKELETON FILE --
  46 """
  47
  48 for x in optlist:
  49     if x[0] == '-o': # -o NAME   set PO output file name to NAME
  50         output_file = x[1]
  51     elif x[0] == '-d': # -d DIR    set working directory to DIR
  52         os.chdir (x[1])
  53     elif x[0] == '-b': # -b BLURB  set blurb written at each node to BLURB
  54         node_blurb = x[1]
  55     elif x[0] == '-i': # -i BLURB  set blurb written at beginning of each file to BLURB
  56         intro_blurb = x[1]
  57     elif x[0] == '-l': # -l ISOLANG  set documentlanguage to ISOLANG
  58         doclang = '; documentlanguage: ' + x[1]
  59
  60 texinfo_with_menus_re = re.compile (r"^(\*) +([^:\n]+)::.*?$|^@(include|menu|end menu|node|(?:unnumbered|appendix)(?:(?:sub){0,2}sec)?|top|chapter|(?:sub){0,2}section|(?:major|chap|(?:sub){0,2})heading) *(.*?)$|@(rglos){(.+?)}", re.M)
  61
  62 texinfo_re = re.compile (r"^@(include|node|(?:unnumbered|appendix)(?:(?:sub){0,2}sec)?|top|chapter|(?:sub){0,2}section|(?:major|chap|(?:sub){0,2})heading) *(.+?)$|@(rglos){(.+?)}", re.M)
  63
  64 ly_string_re = re.compile (r'^([a-zA-Z]+)[\t ]*=|%+[\t ]*(.*)$')
  65 verbatim_ly_re = re.compile (r'@lilypond\[.*?verbatim')
  66
  67 def process_texi (texifilename, i_blurb, n_blurb, write_skeleton, topfile, output_file=None, scan_ly=False):
  68     try:
  69         f = open (texifilename, 'r')
  70         texifile = f.read ()
  71         f.close ()
  72         printedfilename = texifilename.replace ('../','')
  73         includes = []
  74
  75         # process ly var names and comments
  76         if output_file and scan_ly:
  77             lines = texifile.splitlines ()
  78             i = 0
  79             in_verb_ly_block = False
  80             for i in range (len (lines)):
  81                 if verbatim_ly_re.match (lines[i]):
  82                     in_verb_ly_block = True
  83                 elif lines[i].startswith ('@end lilypond'):
  84                     in_verb_ly_block = False
  85                 elif in_verb_ly_block:
  86                     for (var, comment) in ly_string_re.findall (lines[i]):
  87                         if var:
  88                             output_file.write ('# ' + printedfilename + ':' + \
  89                                                str (i + 1) + ' (variable)\n_(r"' + var + '")\n')
  90                         elif comment:
  91                             output_file.write ('# ' + printedfilename + ':' + \
  92                                                str (i + 1) + ' (comment)\n_(r"' + \
  93                                                comment.replace ('"', '\\"') + '")\n')
  94
  95         # process Texinfo node names and section titles
  96         if write_skeleton:
  97             g = open (os.path.basename (texifilename), 'w')
  98             subst = globals ()
  99             subst.update (locals ())
 100             g.write (i_blurb % subst)
 101             tutu = texinfo_with_menus_re.findall (texifile)
 102             node_trigger = False
 103             for item in tutu:
 104                 if item[0] == '*':
 105                     g.write ('* ' + item[1] + '::\n')
 106                 elif output_file and item[4] == 'rglos':
 107                     output_file.write ('_(r"' + item[5] + '") # @rglos in ' + printedfilename + '\n')
 108                 elif item[2] == 'menu':
 109                     g.write ('@menu\n')
 110                 elif item[2] == 'end menu':
 111                     g.write ('@end menu\n\n')
 112                 else:
 113                     g.write ('@' + item[2] + ' ' + item[3] + '\n')
 114                     if node_trigger:
 115                         g.write (n_blurb)
 116                         node_trigger = False
 117                     elif item[2] == 'include':
 118                         includes.append (item[3])
 119                     else:
 120                         if output_file:
 121                             output_file.write ('# @' + item[2] + ' in ' + \
 122                                 printedfilename + '\n_(r"' + item[3].strip () + '")\n')
 123                         if item[2] == 'node':
 124                             node_trigger = True
 125             g.write (end_blurb)
 126             g.close ()
 127
 128         elif output_file:
 129             toto = texinfo_re.findall (texifile)
 130             for item in toto:
 131                 if item[0] == 'include':
 132                     includes.append(item[1])
 133                 elif item[2] == 'rglos':
 134                     output_file.write ('# @rglos in ' + printedfilename + '\n_(r"' + item[3] + '")\n')
 135                 else:
 136                     output_file.write ('# @' + item[0] + ' in ' + printedfilename + '\n_(r"' + item[1].strip () + '")\n')
 137
 138         if process_includes:
 139             dir = os.path.dirname (texifilename)
 140             for item in includes:
 141                 process_texi (os.path.join (dir, item.strip ()), i_blurb, n_blurb, write_skeleton, topfile, output_file, scan_ly)
 142     except IOError, (errno, strerror):
 143         sys.stderr.write ("I/O error(%s): %s: %s\n" % (errno, texifilename, strerror))
 144
 145
 146 if intro_blurb != '':
 147     intro_blurb += '\n\n'
 148 if node_blurb != '':
 149     node_blurb = '\n' + node_blurb + '\n\n'
 150 if make_gettext:
 151     node_list_filename = 'node_list'
 152     node_list = open (node_list_filename, 'w')
 153     node_list.write ('# -*- coding: utf-8 -*-\n')
 154     for texi_file in texi_files:
 155         # Urgly: scan ly comments and variable names only in English doco
 156         is_english_doc = 'Documentation/user' in texi_file
 157         process_texi (texi_file, intro_blurb, node_blurb, make_skeleton,
 158                       os.path.basename (texi_file), node_list,
 159                       scan_ly=is_english_doc)
 160     for word in ('Up:', 'Next:', 'Previous:', 'Appendix ', 'Footnotes', 'Table of Contents'):
 161         node_list.write ('_(r"' + word + '")\n')
 162     node_list.close ()
 163     os.system ('xgettext -c -L Python --no-location -o ' + output_file + ' ' + node_list_filename)
 164 else:
 165     for texi_file in texi_files:
 166         process_texi (texi_file, intro_blurb, node_blurb, make_skeleton,
 167                       os.path.basename (texi_file))