]> git.lyx.org Git - lyx.git/blob - lib/configure.py
8b502c5d9bacfdd76ea22efdbe4e0af4cd2415a1
[lyx.git] / lib / configure.py
1 #! /usr/bin/env python
2 # -*- coding: utf-8 -*-
3 #
4 # file configure.py
5 # This file is part of LyX, the document processor.
6 # Licence details can be found in the file COPYING.
7
8 # \author Bo Peng
9 # Full author contact details are available in file CREDITS.
10
11 from __future__ import print_function
12 import glob, logging, os, re, shutil, subprocess, sys, stat
13
14 # set up logging
15 logging.basicConfig(level = logging.DEBUG,
16     format = '%(levelname)s: %(message)s', # ignore application name
17     filename = 'configure.log',
18     filemode = 'w')
19 #
20 # Add a handler to log to console
21 console = logging.StreamHandler()
22 console.setLevel(logging.INFO) # the console only print out general information
23 formatter = logging.Formatter('%(message)s') # only print out the message itself
24 console.setFormatter(formatter)
25 logger = logging.getLogger('LyX')
26 logger.addHandler(console)
27
28 def writeToFile(filename, lines, append = False):
29     " utility function: write or append lines to filename "
30     if append:
31         file = open(filename, 'a')
32     else:
33         file = open(filename, 'w')
34     file.write(lines)
35     file.close()
36
37
38 def addToRC(lines):
39     ''' utility function: shortcut for appending lines to outfile
40         add newline at the end of lines.
41     '''
42     if lines.strip() != '':
43         writeToFile(outfile, lines + '\n', append = True)
44         logger.debug('Add to RC:\n' + lines + '\n\n')
45
46
47 def removeFiles(filenames):
48     '''utility function: 'rm -f'
49         ignore errors when file does not exist, or is a directory.
50     '''
51     for file in filenames:
52         try:
53             os.remove(file)
54             logger.debug('Removing file %s' % file)
55         except:
56             logger.debug('Failed to remove file %s' % file)
57             pass
58
59
60 def cmdOutput(cmd, async = False):
61     '''utility function: run a command and get its output as a string
62         cmd: command to run
63         async: if False, return whole output as a string, otherwise
64                return the stdout handle from which the output can be
65                read (the caller is then responsible for closing it)
66     '''
67     if os.name == 'nt':
68         b = False
69         if sys.version_info[0] < 3:
70             cmd = 'cmd /d /c pushd ' + shortPath(os.getcwdu()) + '&' + cmd
71         else:
72             cmd = 'cmd /d /c pushd ' + shortPath(os.getcwd()) + '&' + cmd
73     else:
74         b = True
75     pipe = subprocess.Popen(cmd, shell=b, close_fds=b, stdin=subprocess.PIPE,
76                             stdout=subprocess.PIPE, universal_newlines=True)
77     pipe.stdin.close()
78     if async:
79         return pipe.stdout
80     output = pipe.stdout.read()
81     pipe.stdout.close()
82     return output.strip()
83
84
85 def shortPath(path):
86     ''' On Windows, return the short version of "path" if possible '''
87     if os.name == 'nt':
88         from ctypes import windll, create_unicode_buffer
89         GetShortPathName = windll.kernel32.GetShortPathNameW
90         shortlen = GetShortPathName(path, 0, 0)
91         shortpath = create_unicode_buffer(shortlen)
92         if GetShortPathName(path, shortpath, shortlen):
93             return shortpath.value
94     return path
95
96
97 def setEnviron():
98     ''' I do not really know why this is useful, but we might as well keep it.
99         NLS nuisances.
100         Only set these to C if already set.  These must not be set unconditionally
101         because not all systems understand e.g. LANG=C (notably SCO).
102         Fixing LC_MESSAGES prevents Solaris sh from translating var values in set!
103         Non-C LC_CTYPE values break the ctype check.
104     '''
105     os.environ['LANG'] = os.getenv('LANG', 'C')
106     os.environ['LC'] = os.getenv('LC_ALL', 'C')
107     os.environ['LC_MESSAGE'] = os.getenv('LC_MESSAGE', 'C')
108     os.environ['LC_CTYPE'] = os.getenv('LC_CTYPE', 'C')
109
110
111 def copy_tree(src, dst, preserve_symlinks=False, level=0):
112     ''' Copy an entire directory tree 'src' to a new location 'dst'.
113
114     Code inspired from distutils.copy_tree.
115          Copying ignores non-regular files and the cache directory.
116     Pipes may be present as leftovers from LyX for lyx-server.
117
118     If 'preserve_symlinks' is true, symlinks will be
119     copied as symlinks (on platforms that support them!); otherwise
120     (the default), the destination of the symlink will be copied.
121     '''
122
123     if not os.path.isdir(src):
124         raise FileError("cannot copy tree '%s': not a directory" % src)
125     try:
126         names = os.listdir(src)
127     except os.error as oserror:
128         (errno, errstr) = oserror.args
129         raise FileError("error listing files in '%s': %s" % (src, errstr))
130
131     if not os.path.isdir(dst):
132         os.makedirs(dst)
133
134     outputs = []
135
136     for name in names:
137         src_name = os.path.join(src, name)
138         dst_name = os.path.join(dst, name)
139         if preserve_symlinks and os.path.islink(src_name):
140             link_dest = os.readlink(src_name)
141             os.symlink(link_dest, dst_name)
142             outputs.append(dst_name)
143         elif level == 0 and name == 'cache':
144             logger.info("Skip cache %s", src_name)
145         elif os.path.isdir(src_name):
146             outputs.extend(
147                 copy_tree(src_name, dst_name, preserve_symlinks, level=(level + 1)))
148         elif stat.S_ISREG(os.stat(src_name).st_mode) or os.path.islink(src_name):
149             shutil.copy2(src_name, dst_name)
150             outputs.append(dst_name)
151         else:
152             logger.info("Ignore non-regular file %s", src_name)
153
154     return outputs
155
156
157 def checkUpgrade():
158     ''' Check for upgrade from previous version '''
159     cwd = os.getcwd()
160     basename = os.path.basename( cwd )
161     lyxrc = os.path.join(cwd, outfile)
162     if not os.path.isfile( lyxrc ) and basename.endswith( version_suffix ) :
163         logger.info('Checking for upgrade from previous version.')
164         parent = os.path.dirname(cwd)
165         appname = basename[:(-len(version_suffix))]
166         for version in ['-2.1', '-2.0', '-1.6' ]:
167             logger.debug('Checking for upgrade from previous version ' + version)
168             previous = os.path.join(parent, appname + version)
169             logger.debug('previous = ' + previous)
170             if os.path.isdir( previous ):
171                 logger.info('Found directory "%s".', previous)
172                 copy_tree( previous, cwd, True )
173                 logger.info('Content copied to directory "%s".', cwd)
174                 return
175
176
177 def createDirectories():
178     ''' Create the build directories if necessary '''
179     for dir in ['bind', 'clipart', 'doc', 'examples', 'images', 'kbd',
180         'layouts', 'scripts', 'templates', 'ui' ]:
181         if not os.path.isdir( dir ):
182             try:
183                 os.mkdir( dir)
184                 logger.debug('Create directory %s.' % dir)
185             except:
186                 logger.error('Failed to create directory %s.' % dir)
187                 sys.exit(1)
188
189
190 def checkTeXPaths():
191     ''' Determine the path-style needed by the TeX engine on Win32 (Cygwin) '''
192     windows_style_tex_paths = ''
193     if LATEX == '':
194         return windows_style_tex_paths
195     if os.name == 'nt' or sys.platform == 'cygwin':
196         from tempfile import mkstemp
197         fd, tmpfname = mkstemp(suffix='.ltx')
198         if os.name == 'nt':
199             from locale import getdefaultlocale
200             language, encoding = getdefaultlocale()
201             if encoding == None:
202                 encoding = 'latin1'
203             if sys.version_info[0] < 3:
204                 inpname = shortPath(unicode(tmpfname, encoding)).replace('\\', '/')
205             else:
206                 inpname = shortPath(str(tmpfname, encoding)).replace('\\', '/')
207         else:
208             inpname = cmdOutput('cygpath -m ' + tmpfname)
209         logname = os.path.basename(re.sub("(?i).ltx", ".log", inpname))
210         inpname = inpname.replace('~', '\\string~')
211         os.write(fd, r'\relax')
212         os.close(fd)
213         latex_out = cmdOutput(r'latex "\nonstopmode\input{%s}\makeatletter\@@end"'
214                               % inpname)
215         if 'Error' in latex_out:
216             latex_out = cmdOutput(r'latex "\nonstopmode\input{\"%s\"}\makeatletter\@@end"'
217                                   % inpname)
218         if 'Error' in latex_out:
219             logger.warning("configure: TeX engine needs posix-style paths in latex files")
220             windows_style_tex_paths = 'false'
221         else:
222             logger.info("configure: TeX engine needs windows-style paths in latex files")
223             windows_style_tex_paths = 'true'
224         removeFiles([tmpfname, logname, 'texput.log'])
225     return windows_style_tex_paths
226
227
228 ## Searching some useful programs
229 def checkProg(description, progs, rc_entry = [], path = [], not_found = ''):
230     '''
231         This function will search a program in $PATH plus given path
232         If found, return directory and program name (not the options).
233
234         description: description of the program
235
236         progs: check programs, for each prog, the first word is used
237             for searching but the whole string is used to replace
238             %% for a rc_entry. So, feel free to add '$$i' etc for programs.
239
240         path: additional paths (will be prepended to the program name)
241
242         rc_entry: entry to outfile, can be
243             1. emtpy: no rc entry will be added
244             2. one pattern: %% will be replaced by the first found program,
245                 or '' if no program is found.
246             3. several patterns for each prog and not_found. This is used
247                 when different programs have different usages. If you do not
248                 want not_found entry to be added to the RC file, you can specify
249                 an entry for each prog and use '' for the not_found entry.
250
251         not_found: the value that should be used instead of '' if no program
252             was found
253
254     '''
255     # one rc entry for each progs plus not_found entry
256     if len(rc_entry) > 1 and len(rc_entry) != len(progs) + 1:
257         logger.error("rc entry should have one item or item "
258                      "for each prog and not_found.")
259         sys.exit(2)
260     logger.info('checking for ' + description + '...')
261     ## print '(' + ','.join(progs) + ')',
262     additional_path = path
263     path = os.environ["PATH"].split(os.pathsep) + additional_path
264     extlist = ['']
265     if "PATHEXT" in os.environ:
266         extlist = extlist + os.environ["PATHEXT"].split(os.pathsep)
267     global java, perl
268     for idx in range(len(progs)):
269         # ac_prog may have options, ac_word is the command name
270         ac_prog = progs[idx]
271         ac_word = ac_prog.split(' ')[0]
272         if (ac_word.endswith('.class') or ac_word.endswith('.jar')) and java == '':
273             continue
274         if ac_word.endswith('.pl') and perl == '':
275             continue
276         msg = '+checking for "' + ac_word + '"... '
277         for ac_dir in path:
278             if hasattr(os, "access") and not os.access(ac_dir, os.F_OK):
279                 continue
280             for ext in extlist:
281                 if os.path.isfile( os.path.join(ac_dir, ac_word + ext) ):
282                     logger.info(msg + ' yes')
283                     # deal with java and perl
284                     if ac_word.endswith('.class'):
285                         ac_prog = ac_prog.replace(ac_word, r'%s \"%s\"'
286                                     % (java, os.path.join(ac_dir, ac_word[:-6])))
287                     elif ac_word.endswith('.jar'):
288                         ac_prog = ac_prog.replace(ac_word, r'%s -jar \"%s\"'
289                                     % (java, os.path.join(ac_dir, ac_word)))
290                     elif ac_word.endswith('.pl'):
291                         ac_prog = ac_prog.replace(ac_word, r'%s -w \"%s\"'
292                                     % (perl, os.path.join(ac_dir, ac_word)))
293                     elif ac_dir in additional_path:
294                         ac_prog = ac_prog.replace(ac_word, r'\"%s\"'
295                                     % (os.path.join(ac_dir, ac_word)))
296                     # write rc entries for this command
297                     if len(rc_entry) == 1:
298                         addToRC(rc_entry[0].replace('%%', ac_prog))
299                     elif len(rc_entry) > 1:
300                         addToRC(rc_entry[idx].replace('%%', ac_prog))
301                     return [ac_dir, ac_word]
302         # if not successful
303         logger.info(msg + ' no')
304     # write rc entries for 'not found'
305     if len(rc_entry) > 0:  # the last one.
306         addToRC(rc_entry[-1].replace('%%', not_found))
307     return ['', not_found]
308
309
310 def checkProgAlternatives(description, progs, rc_entry = [],
311                           alt_rc_entry = [], path = [], not_found = ''):
312     '''
313         The same as checkProg, but additionally, all found programs will be added
314         as alt_rc_entries
315     '''
316     # one rc entry for each progs plus not_found entry
317     if len(rc_entry) > 1 and len(rc_entry) != len(progs) + 1:
318         logger.error("rc entry should have one item or item for each prog and not_found.")
319         sys.exit(2)
320     logger.info('checking for ' + description + '...')
321     ## print '(' + ','.join(progs) + ')',
322     additional_path = path
323     path = os.environ["PATH"].split(os.pathsep) + additional_path
324     extlist = ['']
325     if "PATHEXT" in os.environ:
326         extlist = extlist + os.environ["PATHEXT"].split(os.pathsep)
327     found_prime = False
328     real_ac_dir = ''
329     real_ac_word = not_found
330     global java, perl
331     for idx in range(len(progs)):
332         # ac_prog may have options, ac_word is the command name
333         ac_prog = progs[idx]
334         ac_word = ac_prog.split(' ')[0]
335         if (ac_word.endswith('.class') or ac_word.endswith('.jar')) and java == '':
336             continue
337         if ac_word.endswith('.pl') and perl == '':
338             continue
339         msg = '+checking for "' + ac_word + '"... '
340         found_alt = False
341         for ac_dir in path:
342             if hasattr(os, "access") and not os.access(ac_dir, os.F_OK):
343                 continue
344             for ext in extlist:
345                 if os.path.isfile( os.path.join(ac_dir, ac_word + ext) ):
346                     logger.info(msg + ' yes')
347                     pr = re.compile(r'(\\\S+)(.*)$')
348                     m = None
349                     # deal with java and perl
350                     if ac_word.endswith('.class'):
351                         ac_prog = ac_prog.replace(ac_word, r'%s \"%s\"'
352                                     % (java, os.path.join(ac_dir, ac_word[:-6])))
353                     elif ac_word.endswith('.jar'):
354                         ac_prog = ac_prog.replace(ac_word, r'%s -jar \"%s\"'
355                                     % (java, os.path.join(ac_dir, ac_word)))
356                     elif ac_word.endswith('.pl'):
357                         ac_prog = ac_prog.replace(ac_word, r'%s -w \"%s\"'
358                                     % (perl, os.path.join(ac_dir, ac_word)))
359                     elif ac_dir in additional_path:
360                         ac_prog = ac_prog.replace(ac_word, r'\"%s\"'
361                                     % (os.path.join(ac_dir, ac_word)))
362                     # write rc entries for this command
363                     if found_prime == False:
364                         if len(rc_entry) == 1:
365                             addToRC(rc_entry[0].replace('%%', ac_prog))
366                         elif len(rc_entry) > 1:
367                             addToRC(rc_entry[idx].replace('%%', ac_prog))
368                         real_ac_dir = ac_dir
369                         real_ac_word = ac_word
370                         found_prime = True
371                     if len(alt_rc_entry) == 1:
372                         alt_rc = alt_rc_entry[0]
373                         if alt_rc == "":
374                             # if no explicit alt_rc is given, construct one
375                             m = pr.match(rc_entry[0])
376                             if m:
377                                 alt_rc = m.group(1) + "_alternatives" + m.group(2)
378                         addToRC(alt_rc.replace('%%', ac_prog))
379                     elif len(alt_rc_entry) > 1:
380                         alt_rc = alt_rc_entry[idx]
381                         if alt_rc == "":
382                             # if no explicit alt_rc is given, construct one
383                             m = pr.match(rc_entry[idx])
384                             if m:
385                                 alt_rc = m.group(1) + "_alternatives" + m.group(2)
386                         addToRC(alt_rc.replace('%%', ac_prog))
387                     found_alt = True
388                     break
389             if found_alt:
390                 break
391         if found_alt == False:
392             # if not successful
393             logger.info(msg + ' no')
394     if found_prime:
395         return [real_ac_dir, real_ac_word]
396     # write rc entries for 'not found'
397     if len(rc_entry) > 0:  # the last one.
398         addToRC(rc_entry[-1].replace('%%', not_found))
399     return ['', not_found]
400
401
402 def addAlternatives(rcs, alt_type):
403     '''
404         Returns a \\prog_alternatives string to be used as an alternative
405         rc entry.  alt_type can be a string or a list of strings.
406     '''
407     r = re.compile(r'\\Format (\S+).*$')
408     m = None
409     alt = ''
410     alt_token = '\\%s_alternatives '
411     if isinstance(alt_type, str):
412         alt_tokens = [alt_token % alt_type]
413     else:
414         alt_tokens = [alt_token % s for s in alt_type]
415     for idxx in range(len(rcs)):
416         if len(rcs) == 1:
417             m = r.match(rcs[0])
418             if m:
419                 alt = '\n'.join([s + m.group(1) + ' "%%"' for s in alt_tokens])
420         elif len(rcs) > 1:
421             m = r.match(rcs[idxx])
422             if m:
423                 if idxx > 0:
424                     alt += '\n'
425                 alt += '\n'.join([s + m.group(1) + ' "%%"' for s in alt_tokens])
426     return alt
427
428
429 def listAlternatives(progs, alt_type, rc_entry = []):
430     '''
431         Returns a list of \\prog_alternatives strings to be used as alternative
432         rc entries.  alt_type can be a string or a list of strings.
433     '''
434     if len(rc_entry) > 1 and len(rc_entry) != len(progs) + 1:
435         logger.error("rc entry should have one item or item for each prog and not_found.")
436         sys.exit(2)
437     alt_rc_entry = []
438     for idx in range(len(progs)):
439         if len(rc_entry) == 1:
440             rcs = rc_entry[0].split('\n')
441             alt = addAlternatives(rcs, alt_type)
442             alt_rc_entry.insert(0, alt)
443         elif len(rc_entry) > 1:
444             rcs = rc_entry[idx].split('\n')
445             alt = addAlternatives(rcs, alt_type)
446             alt_rc_entry.insert(idx, alt)
447     return alt_rc_entry
448
449
450 def checkViewer(description, progs, rc_entry = [], path = []):
451     ''' The same as checkProgAlternatives, but for viewers '''
452     alt_rc_entry = listAlternatives(progs, 'viewer', rc_entry)
453     return checkProgAlternatives(description, progs, rc_entry,
454                                  alt_rc_entry, path, not_found = 'auto')
455
456
457 def checkEditor(description, progs, rc_entry = [], path = []):
458     ''' The same as checkProgAlternatives, but for editors '''
459     alt_rc_entry = listAlternatives(progs, 'editor', rc_entry)
460     return checkProgAlternatives(description, progs, rc_entry,
461                                  alt_rc_entry, path, not_found = 'auto')
462
463
464 def checkViewerNoRC(description, progs, rc_entry = [], path = []):
465     ''' The same as checkViewer, but do not add rc entry '''
466     alt_rc_entry = listAlternatives(progs, 'viewer', rc_entry)
467     rc_entry = []
468     return checkProgAlternatives(description, progs, rc_entry,
469                                  alt_rc_entry, path, not_found = 'auto')
470
471
472 def checkEditorNoRC(description, progs, rc_entry = [], path = []):
473     ''' The same as checkViewer, but do not add rc entry '''
474     alt_rc_entry = listAlternatives(progs, 'editor', rc_entry)
475     rc_entry = []
476     return checkProgAlternatives(description, progs, rc_entry,
477                                  alt_rc_entry, path, not_found = 'auto')
478
479
480 def checkViewerEditor(description, progs, rc_entry = [], path = []):
481     ''' The same as checkProgAlternatives, but for viewers and editors '''
482     alt_rc_entry = listAlternatives(progs, ['editor', 'viewer'], rc_entry)
483     return checkProgAlternatives(description, progs, rc_entry,
484                                  alt_rc_entry, path, not_found = 'auto')
485
486
487 def checkDTLtools():
488     ''' Check whether DTL tools are available (Windows only) '''
489     # Find programs! Returned path is not used now
490     if ((os.name == 'nt' or sys.platform == 'cygwin') and
491             checkProg('DVI to DTL converter', ['dv2dt']) != ['', ''] and
492             checkProg('DTL to DVI converter', ['dt2dv']) != ['', '']):
493         dtl_tools = True
494     else:
495         dtl_tools = False
496     return dtl_tools
497
498 def checkInkscape():
499     ''' Check whether Inkscape is available and return the full path (Windows only) '''
500     if os.name != 'nt':
501         return 'inkscape'
502     if sys.version_info[0] < 3:
503         import _winreg as winreg
504     else:
505         import winreg
506     aReg = winreg.ConnectRegistry(None, winreg.HKEY_CLASSES_ROOT)
507     try:
508         aKey = winreg.OpenKey(aReg, r"inkscape.svg\DefaultIcon")
509         val = winreg.QueryValueEx(aKey, "")
510         return str(val[0]).split('"')[1].replace('.exe', '')
511     except EnvironmentError:
512         try:
513             aKey = winreg.OpenKey(aReg, r"Applications\inkscape.exe\shell\open\command")
514             val = winreg.QueryValueEx(aKey, "")
515             return str(val[0]).split('"')[1].replace('.exe', '')
516         except EnvironmentError:
517             return 'inkscape'
518
519 def checkLatex(dtl_tools):
520     ''' Check latex, return lyx_check_config '''
521     path, LATEX = checkProg('a Latex2e program', ['latex $$i', 'latex2e $$i'])
522     path, PPLATEX = checkProg('a DVI postprocessing program', ['pplatex $$i'])
523     #-----------------------------------------------------------------
524     path, PLATEX = checkProg('pLaTeX, the Japanese LaTeX', ['platex $$i'])
525     if PLATEX != '':
526         # check if PLATEX is pLaTeX2e
527         writeToFile('chklatex.ltx', r'\nonstopmode\makeatletter\@@end')
528         # run platex on chklatex.ltx and check result
529         if cmdOutput(PLATEX + ' chklatex.ltx').find('pLaTeX2e') != -1:
530             # We have the Japanese pLaTeX2e
531             addToRC(r'\converter platex   dvi       "%s"   "latex=platex"' % PLATEX)
532         else:
533             PLATEX = ''
534             removeFiles(['chklatex.ltx', 'chklatex.log'])
535     #-----------------------------------------------------------------
536     # use LATEX to convert from latex to dvi if PPLATEX is not available
537     if PPLATEX == '':
538         PPLATEX = LATEX
539     if dtl_tools:
540         # Windows only: DraftDVI
541         addToRC(r'''\converter latex      dvi2       "%s"       "latex"
542 \converter dvi2       dvi        "python -tt $$s/scripts/clean_dvi.py $$i $$o"  ""''' % PPLATEX)
543     else:
544         addToRC(r'\converter latex      dvi        "%s" "latex"' % PPLATEX)
545     # no latex
546     if LATEX != '':
547         # Check if latex is usable
548         writeToFile('chklatex.ltx', r'''
549 \nonstopmode
550 \ifx\undefined\documentclass\else
551   \message{ThisIsLaTeX2e}
552 \fi
553 \makeatletter
554 \@@end
555 ''')
556         # run latex on chklatex.ltx and check result
557         if cmdOutput(LATEX + ' chklatex.ltx').find('ThisIsLaTeX2e') != -1:
558             # valid latex2e
559             return LATEX
560         else:
561             logger.warning("Latex not usable (not LaTeX2e) ")
562         # remove temporary files
563         removeFiles(['chklatex.ltx', 'chklatex.log'])
564     return ''
565
566
567 def checkLuatex():
568     ''' Check if luatex is there '''
569     path, LUATEX = checkProg('LuaTeX', ['lualatex $$i'])
570     path, DVILUATEX = checkProg('LuaTeX (DVI)', ['dvilualatex $$i'])
571     if LUATEX != '':
572         addToRC(r'\converter luatex      pdf5       "%s"        "latex=lualatex"' % LUATEX)
573     if DVILUATEX != '':
574         addToRC(r'\converter dviluatex   dvi3        "%s"       "latex=dvilualatex"' % DVILUATEX)
575
576
577 def checkModule(module):
578     ''' Check for a Python module, return the status '''
579     msg = 'checking for "' + module + ' module"... '
580     try:
581       __import__(module)
582       logger.info(msg + ' yes')
583       return True
584     except ImportError:
585       logger.info(msg + ' no')
586       return False
587
588
589 def checkFormatEntries(dtl_tools):
590     ''' Check all formats (\Format entries) '''
591     checkViewerEditor('a Tgif viewer and editor', ['tgif'],
592         rc_entry = [r'\Format tgif      "obj, tgo" Tgif                 "" "%%" "%%"    "vector"        "application/x-tgif"'])
593     #
594     checkViewerEditor('a FIG viewer and editor', ['xfig', 'jfig3-itext.jar', 'jfig3.jar'],
595         rc_entry = [r'\Format fig        fig     FIG                    "" "%%" "%%"    "vector"        "application/x-xfig"'])
596     #
597     checkViewerEditor('a Dia viewer and editor', ['dia'],
598         rc_entry = [r'\Format dia        dia     DIA                    "" "%%" "%%"    "vector,zipped=native", "application/x-dia-diagram"'])
599     #
600     checkViewerEditor('an OpenDocument drawing viewer and editor', ['libreoffice', 'lodraw', 'ooffice', 'oodraw', 'soffice'],
601         rc_entry = [r'\Format odg        "odg, sxd" "OpenDocument drawing"   "" "%%"    "%%"    "vector,zipped=native"  "application/vnd.oasis.opendocument.graphics"'])
602     #
603     checkViewerEditor('a Grace viewer and editor', ['xmgrace'],
604         rc_entry = [r'\Format agr        agr     Grace                  "" "%%" "%%"    "vector"        ""'])
605     #
606     checkViewerEditor('a FEN viewer and editor', ['xboard -lpf $$i -mode EditPosition'],
607         rc_entry = [r'\Format fen        fen     FEN                    "" "%%" "%%"    ""      ""'])
608     #
609     checkViewerEditor('a SVG viewer and editor', [inkscape_name],
610         rc_entry = [r'''\Format svg        "svg" SVG                "" "%%" "%%"        "vector"        "image/svg+xml"
611 \Format svgz       "svgz" "SVG (compressed)" "" "%%" "%%"       "vector,zipped=native"  ""'''],
612         path = [inkscape_path])
613     #
614     imageformats = r'''\Format bmp        bmp     BMP                    "" "%s"        "%s"    ""      "image/x-bmp"
615 \Format gif        gif     GIF                    "" "%s"       "%s"    ""      "image/gif"
616 \Format jpg       "jpg, jpeg" JPEG                "" "%s"       "%s"    ""      "image/jpeg"
617 \Format pbm        pbm     PBM                    "" "%s"       "%s"    ""      "image/x-portable-bitmap"
618 \Format pgm        pgm     PGM                    "" "%s"       "%s"    ""      "image/x-portable-graymap"
619 \Format png        png     PNG                    "" "%s"       "%s"    ""      "image/x-png"
620 \Format ppm        ppm     PPM                    "" "%s"       "%s"    ""      "image/x-portable-pixmap"
621 \Format tiff       tif     TIFF                   "" "%s"       "%s"    ""      "image/tiff"
622 \Format xbm        xbm     XBM                    "" "%s"       "%s"    ""      "image/x-xbitmap"
623 \Format xpm        xpm     XPM                    "" "%s"       "%s"    ""      "image/x-xpixmap"'''
624     path, iv = checkViewerNoRC('a raster image viewer', ['xv', 'kview', 'gimp-remote', 'gimp'], rc_entry = [imageformats])
625     path, ie = checkEditorNoRC('a raster image editor', ['gimp-remote', 'gimp'], rc_entry = [imageformats])
626     addToRC(imageformats %
627         (iv, ie, iv, ie, iv, ie, iv, ie, iv, ie, iv, ie, iv, ie, iv, ie, iv, ie, iv, ie) )
628     #
629     checkViewerEditor('a text editor',
630         ['xemacs', 'gvim', 'kedit', 'kwrite', 'kate',
631          'nedit', 'gedit', 'geany', 'leafpad', 'mousepad', 'xed', 'notepad'],
632         rc_entry = [r'''\Format asciichess asc    "Plain text (chess output)"  "" ""    "%%"    ""      ""
633 \Format docbook    sgml    DocBook                B  "" "%%"    "document,menu=export"  ""
634 \Format docbook-xml xml   "DocBook (XML)"         "" "" "%%"    "document,menu=export"  "application/docbook+xml"
635 \Format dot        dot    "Graphviz Dot"          "" "" "%%"    "vector"        "text/vnd.graphviz"
636 \Format dviluatex  tex    "LaTeX (dviluatex)"     "" "" "%%"    "document,menu=export"  ""
637 \Format platex     tex    "LaTeX (pLaTeX)"        "" "" "%%"    "document,menu=export"  ""
638 \Format literate   nw      NoWeb                  N  "" "%%"    "document,menu=export"  ""
639 \Format sweave     Rnw    "Sweave"                S  "" "%%"    "document,menu=export"  ""
640 \Format r          R      "R/S code"              "" "" "%%"    "document,menu=export"  ""
641 \Format knitr      Rnw    "Rnw (knitr)"           "" "" "%%"    "document,menu=export"  ""
642 \Format lilypond   ly     "LilyPond music"        "" "" "%%"    "vector"        "text/x-lilypond"
643 \Format lilypond-book    lytex "LilyPond book (LaTeX)"   "" ""  "%%"    "document,menu=export"  ""
644 \Format latex      tex    "LaTeX (plain)"         L  "" "%%"    "document,menu=export"  "text/x-tex"
645 \Format luatex     tex    "LaTeX (LuaTeX)"        "" "" "%%"    "document,menu=export"  ""
646 \Format pdflatex   tex    "LaTeX (pdflatex)"      "" "" "%%"    "document,menu=export"  ""
647 \Format xetex      tex    "LaTeX (XeTeX)"         "" "" "%%"    "document,menu=export"  ""
648 \Format latexclipboard tex "LaTeX (clipboard)"    "" "" "%%"    ""      ""
649 \Format text       txt    "Plain text"            a  "" "%%"    "document,menu=export"  "text/plain"
650 \Format text2      txt    "Plain text (pstotext)" "" "" "%%"    "document"      ""
651 \Format text3      txt    "Plain text (ps2ascii)" "" "" "%%"    "document"      ""
652 \Format text4      txt    "Plain text (catdvi)"   "" "" "%%"    "document"      ""
653 \Format textparagraph txt "Plain Text, Join Lines" "" ""        "%%"    "document"      ""
654 \Format beamer.info pdf.info   "Info (Beamer)"         "" ""   "%%"    "document,menu=export"   ""''' ])
655    #Spreadsheets using ssconvert from gnumeric
656     checkViewer('gnumeric spreadsheet software', ['gnumeric'],
657       rc_entry = [r'''\Format gnumeric gnumeric "Gnumeric spreadsheet" "" ""    "%%"   "document"       "application/x-gnumeric"
658 \Format excel      xls    "Excel spreadsheet"      "" "" "%%"    "document"     "application/vnd.ms-excel"
659 \Format excel2     xlsx   "MS Excel Office Open XML" "" "" "%%" "document"      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
660 \Format html_table html   "HTML Table (for spreadsheets)"      "" "" "%%"    "document" "text/html"
661 \Format oocalc     ods    "OpenDocument spreadsheet" "" "" "%%"    "document"   "application/vnd.oasis.opendocument.spreadsheet"'''])
662  #
663     checkViewer('an HTML previewer', ['firefox', 'mozilla file://$$p$$i', 'netscape'],
664         rc_entry = [r'\Format xhtml      xhtml   "LyXHTML"              y "%%" ""    "document,menu=export"     "application/xhtml+xml"'])
665  #
666     checkEditor('a BibTeX editor', ['jabref', 'JabRef',
667         'pybliographic', 'bibdesk', 'gbib', 'kbib',
668         'kbibtex', 'sixpack', 'bibedit', 'tkbibtex'
669         'xemacs', 'gvim', 'kedit', 'kwrite', 'kate',
670         'jedit', 'TeXnicCenter', 'WinEdt', 'WinShell', 'PSPad',
671         'nedit', 'gedit', 'notepad', 'geany', 'leafpad', 'mousepad'],
672         rc_entry = [r'''\Format bibtex bib    "BibTeX"         "" ""    "%%"    ""      "text/x-bibtex"''' ])
673     #
674     #checkProg('a Postscript interpreter', ['gs'],
675     #  rc_entry = [ r'\ps_command "%%"' ])
676     checkViewer('a Postscript previewer',
677                 ['kghostview', 'okular', 'qpdfview --unique',
678                  'evince', 'xreader',
679                  'gv', 'ghostview -swap', 'gsview64', 'gsview32'],
680         rc_entry = [r'''\Format eps        eps     EPS                    "" "%%"       ""      "vector"        "image/x-eps"
681 \Format eps2       eps    "EPS (uncropped)"       "" "%%"       ""      "vector"        ""
682 \Format eps3       eps    "EPS (cropped)"         "" "%%"       ""      "document"      ""
683 \Format ps         ps      Postscript             t  "%%"       ""      "document,vector,menu=export"   "application/postscript"'''])
684     # for xdg-open issues look here: http://www.mail-archive.com/lyx-devel@lists.lyx.org/msg151818.html
685     # the MIME type is set for pdf6, because that one needs to be autodetectable by libmime
686     checkViewer('a PDF previewer',
687                 ['pdfview', 'kpdf', 'okular', 'qpdfview --unique',
688                  'evince', 'xreader', 'kghostview', 'xpdf', 'SumatraPDF',
689                  'acrobat', 'acroread', 'mupdf',
690                  'gv', 'ghostview', 'AcroRd32', 'gsview64', 'gsview32'],
691         rc_entry = [r'''\Format pdf        pdf    "PDF (ps2pdf)"          P  "%%"       ""      "document,vector,menu=export"   ""
692 \Format pdf2       pdf    "PDF (pdflatex)"        F  "%%"       ""      "document,vector,menu=export"   ""
693 \Format pdf3       pdf    "PDF (dvipdfm)"         m  "%%"       ""      "document,vector,menu=export"   ""
694 \Format pdf4       pdf    "PDF (XeTeX)"           X  "%%"       ""      "document,vector,menu=export"   ""
695 \Format pdf5       pdf    "PDF (LuaTeX)"          u  "%%"       ""      "document,vector,menu=export"   ""
696 \Format pdf6       pdf    "PDF (graphics)"        "" "%%"       ""      "vector"        "application/pdf"
697 \Format pdf7       pdf    "PDF (cropped)"         "" "%%"       ""      "document,vector"       ""
698 \Format pdf8       pdf    "PDF (lower resolution)"         "" "%%"      ""      "document,vector"       ""'''])
699     #
700     checkViewer('a DVI previewer', ['xdvi', 'kdvi', 'okular',
701                                     'evince', 'xreader',
702                                     'yap', 'dviout -Set=!m'],
703         rc_entry = [r'''\Format dvi        dvi     DVI                    D  "%%"       ""      "document,vector,menu=export"   "application/x-dvi"
704 \Format dvi3       dvi     "DVI (LuaTeX)"          V  "%%"      ""      "document,vector,menu=export"   ""'''])
705     if dtl_tools:
706         # Windows only: DraftDVI
707         addToRC(r'\Format dvi2       dvi     DraftDVI               ""  ""      ""      "vector"        ""')
708     #
709     checkViewer('an HTML previewer', ['firefox', 'mozilla file://$$p$$i', 'netscape'],
710         rc_entry = [r'\Format html      "html, htm" HTML                H  "%%" ""      "document,menu=export"  "text/html"'])
711     #
712     checkViewerEditor('Noteedit', ['noteedit'],
713         rc_entry = [r'\Format noteedit   not     Noteedit               "" "%%" "%%"    "vector"        ""'])
714     #
715     checkViewerEditor('an OpenDocument viewer', ['libreoffice', 'lwriter', 'lowriter', 'oowriter', 'swriter', 'abiword'],
716         rc_entry = [r'''\Format odt        odt     "OpenDocument (tex4ht)"  "" "%%"     "%%"    "document,vector,menu=export"   "application/vnd.oasis.opendocument.text"
717 \Format odt2       odt    "OpenDocument (eLyXer)"  "" "%%"      "%%"    "document,vector,menu=export"   "application/vnd.oasis.opendocument.text"
718 \Format odt3       odt    "OpenDocument (Pandoc)"  "" "%%"      "%%"    "document,vector,menu=export"   "application/vnd.oasis.opendocument.text"
719 \Format sxw        sxw    "OpenOffice.Org (sxw)"  "" "" ""      "document,vector"       "application/vnd.sun.xml.writer"'''])
720     #
721     checkViewerEditor('a Rich Text and Word viewer', ['libreoffice', 'lwriter', 'lowriter', 'oowriter', 'swriter', 'abiword'],
722         rc_entry = [r'''\Format rtf        rtf    "Rich Text Format"      "" "%%"       "%%"    "document,vector,menu=export"   "application/rtf"
723 \Format word       doc    "MS Word"               W  "%%"       "%%"    "document,vector,menu=export"   "application/msword"
724 \Format word2      docx    "MS Word Office Open XML"               O  "%%"      "%%"    "document,vector,menu=export"   "application/vnd.openxmlformats-officedocument.wordprocessingml.document"'''])
725     #
726     # entries that do not need checkProg
727     addToRC(r'''\Format csv        csv    "Table (CSV)"           "" "" ""      "document"      "text/csv"
728 \Format fax        ""      Fax                    "" "" ""      "document"      ""
729 \Format lyx        lyx     LyX                    "" "" ""      ""      "application/x-lyx"
730 \Format lyx13x     13.lyx "LyX 1.3.x"             "" "" ""      "document"      ""
731 \Format lyx14x     14.lyx "LyX 1.4.x"             "" "" ""      "document"      ""
732 \Format lyx15x     15.lyx "LyX 1.5.x"             "" "" ""      "document"      ""
733 \Format lyx16x     16.lyx "LyX 1.6.x"             "" "" ""      "document"      ""
734 \Format lyx20x     20.lyx "LyX 2.0.x"             "" "" ""      "document"      ""
735 \Format lyx21x     21.lyx "LyX 2.1.x"             "" "" ""      "document"      ""
736 \Format lyx22x     22.lyx "LyX 2.2.x"             "" "" ""      "document,menu=export"  ""
737 \Format clyx       cjklyx "CJK LyX 1.4.x (big5)"  "" "" ""      "document"      ""
738 \Format jlyx       cjklyx "CJK LyX 1.4.x (euc-jp)" "" ""        ""      "document"      ""
739 \Format klyx       cjklyx "CJK LyX 1.4.x (euc-kr)" "" ""        ""      "document"      ""
740 \Format lyxpreview lyxpreview "LyX Preview"       "" "" ""      ""      ""
741 \Format pdftex     "pdftex_t, pdf_tex" PDFTEX                "" ""      ""      ""      ""
742 \Format program    ""      Program                "" "" ""      ""      ""
743 \Format pstex      "pstex_t, ps_tex" PSTEX                  "" ""       ""      ""      ""
744 \Format wmf        wmf    "Windows Metafile"      "" "" ""      "vector"        "image/x-wmf"
745 \Format emf        emf    "Enhanced Metafile"     "" "" ""      "vector"        "image/x-emf"
746 \Format wordhtml  "html, htm" "HTML (MS Word)"    "" "" ""      "document"      ""
747 ''')
748
749
750 def checkConverterEntries():
751     ''' Check all converters (\converter entries) '''
752     checkProg('the pdflatex program', ['pdflatex $$i'],
753         rc_entry = [ r'\converter pdflatex   pdf2       "%%"    "latex=pdflatex"' ])
754
755     checkProg('XeTeX', ['xelatex $$i'],
756         rc_entry = [ r'\converter xetex      pdf4       "%%"    "latex=xelatex"' ])
757
758     checkLuatex()
759
760     # Look for tex2lyx in this order (see bugs #3308 and #6986):
761     #   1)  If we're building LyX with autotools then tex2lyx is found
762     #       in the subdirectory tex2lyx with respect to the binary dir.
763     #   2)  If we're building LyX with cmake then tex2lyx is found
764     #       in the binary dir.
765     #   3)  If LyX was configured with a version suffix then tex2lyx
766     #       will also have this version suffix.
767     #   4)  Otherwise always use tex2lyx.
768     in_binary_subdir = os.path.join(lyx_binary_dir, 'tex2lyx', 'tex2lyx')
769     in_binary_subdir = os.path.abspath(in_binary_subdir).replace('\\', '/')
770
771     in_binary_dir = os.path.join(lyx_binary_dir, 'tex2lyx')
772     in_binary_dir = os.path.abspath(in_binary_dir).replace('\\', '/')
773
774     path, t2l = checkProg('a LaTeX/Noweb -> LyX converter', [in_binary_subdir, in_binary_subdir + version_suffix, in_binary_dir, in_binary_dir + version_suffix, 'tex2lyx' + version_suffix, 'tex2lyx'],
775         rc_entry = [r'''\converter latex      lyx        "%% -f $$i $$o"        ""
776 \converter latexclipboard lyx        "%% -fixedenc utf8 -f $$i $$o"     ""
777 \converter literate   lyx        "%% -n -m noweb -f $$i $$o"    ""
778 \converter sweave   lyx        "%% -n -m sweave -f $$i $$o"     "needauth"
779 \converter knitr   lyx        "%% -n -m knitr -f $$i $$o"       "needauth"'''], not_found = 'tex2lyx')
780     if path == '':
781         logger.warning("Failed to find tex2lyx on your system.")
782
783     #
784     checkProg('a Noweb -> LaTeX converter', ['noweave -delay -index $$i > $$o'],
785         rc_entry = [r'''\converter literate   latex      "%%"   ""
786 \converter literate   pdflatex      "%%"        ""
787 \converter literate   xetex         "%%"        ""
788 \converter literate   luatex        "%%"        ""
789 \converter literate   dviluatex     "%%"        ""'''])
790     #
791     checkProg('a Sweave -> LaTeX converter', ['Rscript --verbose --no-save --no-restore $$s/scripts/lyxsweave.R $$p$$i $$p$$o $$e $$r'],
792         rc_entry = [r'''\converter sweave   latex      "%%"     "needauth"
793 \converter sweave   pdflatex   "%%"     "needauth"
794 \converter sweave   xetex      "%%"     "needauth"
795 \converter sweave   luatex     "%%"     "needauth"
796 \converter sweave   dviluatex  "%%"     "needauth"'''])
797     #
798     checkProg('a knitr -> LaTeX converter', ['Rscript --verbose --no-save --no-restore $$s/scripts/lyxknitr.R $$p$$i $$p$$o $$e $$r'],
799         rc_entry = [r'''\converter knitr   latex      "%%"      "needauth"
800 \converter knitr   pdflatex   "%%"      "needauth"
801 \converter knitr   xetex      "%%"      "needauth"
802 \converter knitr   luatex     "%%"      "needauth"
803 \converter knitr   dviluatex  "%%"      "needauth"'''])
804     #
805     checkProg('a Sweave -> R/S code converter', ['Rscript --verbose --no-save --no-restore $$s/scripts/lyxstangle.R $$i $$e $$r'],
806         rc_entry = [ r'\converter sweave      r      "%%"    "needauth"' ])
807     #
808     checkProg('a knitr -> R/S code converter', ['Rscript --verbose --no-save --no-restore $$s/scripts/lyxknitr.R $$p$$i $$p$$o $$e $$r tangle'],
809         rc_entry = [ r'\converter knitr      r      "%%"    "needauth"' ])
810     #
811     checkProg('an HTML -> LaTeX converter', ['html2latex $$i', 'gnuhtml2latex',
812         'htmltolatex -input $$i -output $$o', 'htmltolatex.jar -input $$i -output $$o'],
813         rc_entry = [ r'\converter html       latex      "%%"    ""',
814                      r'\converter html       latex      "python -tt $$s/scripts/html2latexwrapper.py %% $$i $$o"        ""',
815                      r'\converter html       latex      "%%"    ""',
816                      r'\converter html       latex      "%%"    ""', '' ])
817     #
818     checkProg('an MS Word -> LaTeX converter', ['wvCleanLatex $$i $$o'],
819         rc_entry = [ r'\converter word       latex      "%%"    ""' ])
820
821     # eLyXer: search as an executable (elyxer.py, elyxer)
822     path, elyxer = checkProg('a LyX -> HTML converter',
823         ['elyxer.py --nofooter --directory $$r $$i $$o', 'elyxer --nofooter --directory $$r $$i $$o'],
824         rc_entry = [ r'\converter lyx      html       "%%"      ""' ])
825     path, elyxer = checkProg('a LyX -> HTML (MS Word) converter',
826         ['elyxer.py --nofooter --html --directory $$r $$i $$o', 'elyxer --nofooter --html --directory $$r $$i $$o'],
827         rc_entry = [ r'\converter lyx      wordhtml       "%%"  ""' ])
828     path, elyxer = checkProg('a LyX -> OpenDocument (eLyXer) converter',
829         ['elyxer.py --html --nofooter --unicode --directory $$r $$i $$o', 'elyxer --html --nofooter --unicode --directory $$r $$i $$o'],
830         rc_entry = [ r'\converter lyx      odt2       "%%"      ""' ])
831     path, elyxer = checkProg('a LyX -> Word converter',
832         ['elyxer.py --html --nofooter --unicode --directory $$r $$i $$o', 'elyxer --html --nofooter --unicode --directory $$r $$i $$o'],
833         rc_entry = [ r'\converter lyx      word      "%%"       ""' ])
834     if elyxer.find('elyxer') >= 0:
835       addToRC(r'''\copier    html       "python -tt $$s/scripts/ext_copy.py -e html,png,jpg,jpeg,css $$i $$o"''')
836       addToRC(r'''\copier    wordhtml       "python -tt $$s/scripts/ext_copy.py -e html,png,jpg,jpeg,css $$i $$o"''')
837     else:
838       # search for HTML converters other than eLyXer
839       # On SuSE the scripts have a .sh suffix, and on debian they are in /usr/share/tex4ht/
840       path, htmlconv = checkProg('a LaTeX -> HTML converter', ['htlatex $$i', 'htlatex.sh $$i',
841           '/usr/share/tex4ht/htlatex $$i', 'tth  -t -e2 -L$$b < $$i > $$o',
842           'latex2html -no_subdir -split 0 -show_section_numbers $$i', 'hevea -s $$i'],
843           rc_entry = [ r'\converter latex      html       "%%"  "needaux"' ])
844       if htmlconv.find('htlatex') >= 0 or htmlconv == 'latex2html':
845         addToRC(r'''\copier    html       "python -tt $$s/scripts/ext_copy.py -e html,png,css $$i $$o"''')
846       else:
847         addToRC(r'''\copier    html       "python -tt $$s/scripts/ext_copy.py $$i $$o"''')
848       path, htmlconv = checkProg('a LaTeX -> HTML (MS Word) converter', ["htlatex $$i 'html,word' 'symbol/!' '-cvalidate'",
849           "htlatex.sh $$i 'html,word' 'symbol/!' '-cvalidate'",
850           "/usr/share/tex4ht/htlatex $$i 'html,word' 'symbol/!' '-cvalidate'"],
851           rc_entry = [ r'\converter latex      wordhtml   "%%"  "needaux"' ])
852       if htmlconv.find('htlatex') >= 0:
853         addToRC(r'''\copier    wordhtml       "python -tt $$s/scripts/ext_copy.py -e html,png,css $$i $$o"''')
854       else:
855         addToRC(r'''\copier    wordhtml       "python -tt $$s/scripts/ext_copy.py $$i $$o"''')
856
857
858     # Check if LyXBlogger is installed
859     lyxblogger_found = checkModule('lyxblogger')
860     if lyxblogger_found:
861       addToRC(r'\Format    blog       blog       "LyXBlogger"           "" "" ""  "document"  ""')
862       addToRC(r'\converter xhtml      blog       "python -m lyxblogger $$i"       ""')
863
864     #
865     checkProg('an OpenOffice.org -> LaTeX converter', ['w2l -clean $$i'],
866         rc_entry = [ r'\converter sxw        latex      "%%"    ""' ])
867     #
868     checkProg('an OpenDocument -> LaTeX converter', ['w2l -clean $$i'],
869         rc_entry = [ r'\converter odt        latex      "%%"    ""' ])
870     #
871     checkProg('an Open Document (Pandoc) -> LaTeX converter', ['pandoc -s -f odt -o $$o -t latex $$i'],
872         rc_entry = [ r'\converter odt3        latex      "%%"   ""' ])
873     #
874     checkProg('a MS Word Office Open XML converter -> LaTeX', ['pandoc -s -f docx -o $$o -t latex $$i'],
875         rc_entry = [ r'\converter word2      latex      "%%"    ""' ])
876     # Only define a converter to pdf6, otherwise the odt format could be
877     # used as an intermediate step for export to pdf, which is not wanted.
878     checkProg('an OpenDocument -> PDF converter', ['unoconv -f pdf --stdout $$i > $$o'],
879         rc_entry = [ r'\converter odt        pdf6       "%%"    ""' ])
880     # According to http://www.tug.org/applications/tex4ht/mn-commands.html
881     # the command mk4ht oolatex $$i has to be used as default,
882     # but as this would require to have Perl installed, in MiKTeX oolatex is
883     # directly available as application.
884     # On SuSE the scripts have a .sh suffix, and on debian they are in /usr/share/tex4ht/
885     # Both SuSE and debian have oolatex
886     checkProg('a LaTeX -> Open Document (tex4ht) converter', [
887         'oolatex $$i', 'mk4ht oolatex $$i', 'oolatex.sh $$i', '/usr/share/tex4ht/oolatex $$i',
888         'htlatex $$i \'xhtml,ooffice\' \'ooffice/! -cmozhtf\' \'-coo\' \'-cvalidate\''],
889         rc_entry = [ r'\converter latex      odt        "%%"    "needaux"' ])
890     # On windows it is called latex2rt.exe
891     checkProg('a LaTeX -> RTF converter', ['latex2rtf -p -S -o $$o $$i', 'latex2rt -p -S -o $$o $$i'],
892         rc_entry = [ r'\converter latex      rtf        "%%"    "needaux"' ])
893     #
894     checkProg('a LaTeX -> Open Document (Pandoc) converter', ['pandoc -s -f latex -o $$o -t odt $$i'],
895         rc_entry = [ r'\converter latex      odt3        "%%"   ""' ])
896     #
897     checkProg('a LaTeX -> MS Word Office Open XML converter', ['pandoc -s -f latex -o $$o -t docx $$i'],
898         rc_entry = [ r'\converter latex      word2       "%%"   ""' ])
899     #
900     checkProg('a RTF -> HTML converter', ['unrtf --html  $$i > $$o'],
901         rc_entry = [ r'\converter rtf      html        "%%"     ""' ])
902     # Do not define a converter to pdf6, ps is a pure export format
903     checkProg('a PS to PDF converter', ['ps2pdf $$i $$o'],
904         rc_entry = [ r'\converter ps         pdf        "%%"    ""' ])
905     #
906     checkProg('a PS to TXT converter', ['pstotext $$i > $$o'],
907         rc_entry = [ r'\converter ps         text2      "%%"    ""' ])
908     #
909     checkProg('a PS to TXT converter', ['ps2ascii $$i $$o'],
910         rc_entry = [ r'\converter ps         text3      "%%"    ""' ])
911     # Need to call ps2eps in a pipe, otherwise it would name the output file
912     # depending on the extension of the input file. We do not know the input
913     # file extension in general, so the resultfile= flag would not help.
914     # Since ps2eps crops the image, we do not use it to convert from ps->eps.
915     # This would create additional paths in the converter graph with unwanted
916     # side effects (e.g. ps->pdf via ps2pdf would create a different result
917     # than ps->eps->pdf via ps2eps and epstopdf).
918     checkProg('a PS to EPS converter', ['ps2eps -- < $$i > $$o'],
919         rc_entry = [ r'\converter eps2       eps      "%%"      ""' ])
920     #
921     checkProg('a PDF to PS converter', ['pdftops $$i $$o', 'pdf2ps $$i $$o'],
922         rc_entry = [ r'\converter pdf         ps        "%%"    ""' ])
923     # Only define a converter from pdf6 for graphics
924     checkProg('a PDF to EPS converter', ['pdftops -eps -f 1 -l 1 $$i $$o'],
925         rc_entry = [ r'\converter pdf6        eps        "%%"   ""' ])
926     # Create one converter for a PDF produced using TeX fonts and one for a
927     # PDF produced using non-TeX fonts. This does not produce non-unique
928     # conversion paths, since a given document either uses TeX fonts or not.
929     checkProg('a PDF cropping tool', ['pdfcrop $$i $$o'],
930         rc_entry = [ r'''\converter pdf2   pdf7       "%%"      ""
931 \converter pdf4   pdf7       "%%"       ""''' ])
932     # Create one converter for a PDF produced using TeX fonts and one for a
933     # PDF produced using non-TeX fonts. This does not produce non-unique
934     # conversion paths, since a given document either uses TeX fonts or not.
935     checkProg('Ghostscript', ["gswin32c", "gswin64c", "gs"],
936         rc_entry = [ r'''\converter pdf2   pdf8       "python -tt $$s/scripts/convert_pdf.py $$i $$o ebook"     ""
937 \converter pdf4   pdf8       "python -tt $$s/scripts/convert_pdf.py $$i $$o ebook"      ""''' ])
938     #
939     checkProg('a Beamer info extractor', ['makebeamerinfo -p $$i'],
940         rc_entry = [ r'\converter pdf2         beamer.info        "%%"  ""' ])
941     #
942     checkProg('a DVI to TXT converter', ['catdvi $$i > $$o'],
943         rc_entry = [ r'\converter dvi        text4      "%%"    ""' ])
944     #
945     checkProg('a DVI to PS converter', ['dvips -o $$o $$i'],
946         rc_entry = [ r'\converter dvi        ps         "%%"    ""' ])
947     #
948     checkProg('a DVI to cropped EPS converter', ['dvips -E -o $$o $$i'],
949         rc_entry = [ r'\converter dvi        eps3         "%%"  ""' ])
950     #
951     checkProg('a DVI to PDF converter', ['dvipdfmx -o $$o $$i', 'dvipdfm -o $$o $$i'],
952         rc_entry = [ r'\converter dvi        pdf3       "%%"    ""' ])
953     #
954     checkProg('a fax program', ['kdeprintfax $$i', 'ksendfax $$i', 'hylapex $$i'],
955         rc_entry = [ r'\converter ps         fax        "%%"    ""'])
956     #
957     path, fig2dev = checkProg('a FIG -> Image converter', ['fig2dev'])
958     if fig2dev == "fig2dev":
959         addToRC(r'''\converter fig        eps        "fig2dev -L eps $$i $$o"   ""
960 \converter fig        ppm        "fig2dev -L ppm $$i $$o"       ""
961 \converter fig        svg        "fig2dev -L svg $$i $$o"       ""
962 \converter fig        png        "fig2dev -L png $$i $$o"       ""
963 \converter svg        pdftex     "python -tt $$s/scripts/svg2pdftex.py $$i $$o" ""
964 \converter svg        pstex      "python -tt $$s/scripts/svg2pstex.py $$i $$o" ""
965 \converter fig        pdftex     "python -tt $$s/scripts/fig2pdftex.py $$i $$o" ""
966 \converter fig        pstex      "python -tt $$s/scripts/fig2pstex.py $$i $$o"  ""''')
967     #
968     checkProg('a TIFF -> PS converter', ['tiff2ps $$i > $$o'],
969         rc_entry = [ r'\converter tiff       eps        "%%"    ""'])
970     #
971     checkProg('a TGIF -> EPS/PPM converter', ['tgif'],
972         rc_entry = [
973             r'''\converter tgif       eps        "tgif -print -color -eps -stdout $$i > $$o"    ""
974 \converter tgif       png        "tgif -print -color -png -o $$d $$i"   ""
975 \converter tgif       pdf6       "tgif -print -color -pdf -stdout $$i > $$o"    ""'''])
976     #
977     checkProg('a WMF -> EPS converter', ['metafile2eps $$i $$o', 'wmf2eps -o $$o $$i', inkscape_name + ' --file=$$i --export-area-drawing --without-gui --export-eps=$$o'],
978         rc_entry = [ r'\converter wmf        eps        "%%"    ""'])
979     #
980     checkProg('an EMF -> EPS converter', ['metafile2eps $$i $$o', 'wmf2eps -o $$o $$i', inkscape_name + ' --file=$$i --export-area-drawing --without-gui --export-eps=$$o'],
981         rc_entry = [ r'\converter emf        eps        "%%"    ""'])
982     #
983     checkProg('a WMF -> PDF converter', [inkscape_name + ' --file=$$i --export-area-drawing --without-gui --export-pdf=$$o'],
984         rc_entry = [ r'\converter wmf        pdf6        "%%"   ""'])
985     #
986     checkProg('an EMF -> PDF converter', [inkscape_name + ' --file=$$i --export-area-drawing --without-gui --export-pdf=$$o'],
987         rc_entry = [ r'\converter emf        pdf6        "%%"   ""'])
988     # Only define a converter to pdf6 for graphics
989     checkProg('an EPS -> PDF converter', ['epstopdf'],
990         rc_entry = [ r'\converter eps        pdf6       "epstopdf --outfile=$$o $$i"    ""'])
991     #
992     checkProg('an EPS -> PNG converter', ['magick $$i $$o', 'convert $$i $$o'],
993         rc_entry = [ r'\converter eps        png        "%%"    ""'])
994     #
995     # no agr -> pdf6 converter, since the pdf library used by gracebat is not
996     # free software and therefore not compiled in in many installations.
997     # Fortunately, this is not a big problem, because we will use epstopdf to
998     # convert from agr to pdf6 via eps without loss of quality.
999     checkProg('a Grace -> Image converter', ['gracebat'],
1000         rc_entry = [
1001             r'''\converter agr        eps        "gracebat -hardcopy -printfile $$o -hdevice EPS $$i 2>/dev/null"       ""
1002 \converter agr        png        "gracebat -hardcopy -printfile $$o -hdevice PNG $$i 2>/dev/null"       ""
1003 \converter agr        jpg        "gracebat -hardcopy -printfile $$o -hdevice JPEG $$i 2>/dev/null"      ""
1004 \converter agr        ppm        "gracebat -hardcopy -printfile $$o -hdevice PNM $$i 2>/dev/null"       ""'''])
1005     #
1006     checkProg('a Dot -> Image converter', ['dot'],
1007         rc_entry = [
1008             r'''\converter dot        eps        "dot -Teps $$i -o $$o" ""
1009 \converter dot        png        "dot -Tpng $$i -o $$o" ""'''])
1010     #
1011     path, dia = checkProg('a Dia -> Image converter', ['dia'])
1012     if dia == 'dia':
1013         addToRC(r'''\converter dia        png        "dia -e $$o -t png $$i"    ""
1014 \converter dia        eps        "dia -e $$o -t eps $$i"        ""
1015 \converter dia        svg        "dia -e $$o -t svg $$i"        ""''')
1016
1017     #
1018     # Actually, this produces EPS, but with a wrong bounding box (usually A4 or letter).
1019     # The eps2->eps converter then fixes the bounding box by cropping.
1020     # Although unoconv can convert to png and pdf as well, do not define
1021     # odg->png and odg->pdf converters, since the bb would be too large as well.
1022     checkProg('an OpenDocument -> EPS converter', ['libreoffice -headless -nologo -convert-to eps $$i', 'unoconv -f eps --stdout $$i > $$o'],
1023         rc_entry = [ r'\converter odg        eps2       "%%"    ""'])
1024     #
1025     checkProg('a SVG (compressed) -> SVG converter', ['gunzip -c $$i > $$o'],
1026         rc_entry = [ r'\converter svgz       svg        "%%"    ""'])
1027     #
1028     checkProg('a SVG -> SVG (compressed) converter', ['gzip -c $$i > $$o'],
1029         rc_entry = [ r'\converter svg        svgz       "%%"    ""'])
1030     # Only define a converter to pdf6 for graphics
1031     # Prefer rsvg-convert over inkscape since it is faster (see http://www.lyx.org/trac/ticket/9891)
1032     checkProg('a SVG -> PDF converter', ['rsvg-convert -f pdf -o $$o $$i', inkscape_name + ' --file=$$i --export-area-drawing --without-gui --export-pdf=$$o'],
1033         rc_entry = [ r'''\converter svg        pdf6       "%%"    ""
1034 \converter svgz       pdf6       "%%"    ""'''],
1035         path = ['', inkscape_path])
1036     #
1037     checkProg('a SVG -> EPS converter', ['rsvg-convert -f ps -o $$o $$i', inkscape_name + ' --file=$$i --export-area-drawing --without-gui --export-eps=$$o'],
1038         rc_entry = [ r'''\converter svg        eps        "%%"    ""
1039 \converter svgz       eps        "%%"    ""'''],
1040         path = ['', inkscape_path])
1041     #
1042     checkProg('a SVG -> PNG converter', ['rsvg-convert -f png -o $$o $$i', inkscape_name + ' --without-gui --file=$$i --export-png=$$o'],
1043         rc_entry = [ r'''\converter svg        png        "%%"    "",
1044 \converter svgz       png        "%%"    ""'''],
1045         path = ['', inkscape_path])
1046
1047     #
1048     # gnumeric/xls/ods to tex
1049     checkProg('a spreadsheet -> latex converter', ['ssconvert'],
1050        rc_entry = [ r'''\converter gnumeric latex "ssconvert --export-type=Gnumeric_html:latex $$i $$o" ""
1051 \converter oocalc latex "ssconvert --export-type=Gnumeric_html:latex $$i $$o" ""
1052 \converter excel  latex "ssconvert --export-type=Gnumeric_html:latex $$i $$o" ""
1053 \converter excel2 latex "ssconvert --export-type=Gnumeric_html:latex $$i $$o" ""
1054 \converter gnumeric html_table "ssconvert --export-type=Gnumeric_html:html40frag $$i $$o" ""
1055 \converter oocalc html_table "ssconvert --export-type=Gnumeric_html:html40frag $$i $$o" ""
1056 \converter excel  html_table "ssconvert --export-type=Gnumeric_html:html40frag $$i $$o" ""
1057 \converter excel2 html_table "ssconvert --export-type=Gnumeric_html:html40frag $$i $$o" ""
1058 '''])
1059
1060     path, lilypond = checkProg('a LilyPond -> EPS/PDF/PNG converter', ['lilypond'])
1061     if (lilypond != ''):
1062         version_string = cmdOutput("lilypond --version")
1063         match = re.match('GNU LilyPond (\S+)', version_string)
1064         if match:
1065             version_number = match.groups()[0]
1066             version = version_number.split('.')
1067             if int(version[0]) > 2 or (len(version) > 1 and int(version[0]) == 2 and int(version[1]) >= 11):
1068                 addToRC(r'''\converter lilypond   eps        "lilypond -dbackend=eps -dsafe --ps $$i"   ""
1069 \converter lilypond   png        "lilypond -dbackend=eps -dsafe --png $$i"      ""''')
1070                 addToRC(r'\converter lilypond   pdf6       "lilypond -dbackend=eps -dsafe --pdf $$i"    ""')
1071                 logger.info('+  found LilyPond version %s.' % version_number)
1072             elif int(version[0]) > 2 or (len(version) > 1 and int(version[0]) == 2 and int(version[1]) >= 6):
1073                 addToRC(r'''\converter lilypond   eps        "lilypond -b eps --ps --safe $$i"  ""
1074 \converter lilypond   png        "lilypond -b eps --png $$i"    ""''')
1075                 if int(version[0]) > 2 or (len(version) > 1 and int(version[0]) == 2 and int(version[1]) >= 9):
1076                     addToRC(r'\converter lilypond   pdf6       "lilypond -b eps --pdf --safe $$i"       ""')
1077                 logger.info('+  found LilyPond version %s.' % version_number)
1078             else:
1079                 logger.info('+  found LilyPond, but version %s is too old.' % version_number)
1080         else:
1081             logger.info('+  found LilyPond, but could not extract version number.')
1082     #
1083     path, lilypond_book = checkProg('a LilyPond book (LaTeX) -> LaTeX converter', ['lilypond-book'])
1084     if (lilypond_book != ''):
1085         version_string = cmdOutput("lilypond-book --version")
1086         match = re.match('^(\S+)$', version_string)
1087         if match:
1088             version_number = match.groups()[0]
1089             version = version_number.split('.')
1090             if int(version[0]) > 2 or (len(version) > 1 and int(version[0]) == 2 and int(version[1]) >= 13):
1091                 # Note: The --lily-output-dir flag is required because lilypond-book
1092                 #       does not process input again unless the input has changed,
1093                 #       even if the output format being requested is different. So
1094                 #       once a .eps file exists, lilypond-book won't create a .pdf
1095                 #       even when requested with --pdf. This is a problem if a user
1096                 #       clicks View PDF after having done a View DVI. To circumvent
1097                 #       this, use different output folders for eps and pdf outputs.
1098                 addToRC(r'\converter lilypond-book latex    "lilypond-book --safe --lily-output-dir=ly-eps $$i"                                ""')
1099                 addToRC(r'\converter lilypond-book pdflatex "lilypond-book --safe --pdf --latex-program=pdflatex --lily-output-dir=ly-pdf $$i" ""')
1100                 addToRC(r'\converter lilypond-book xetex    "lilypond-book --safe --pdf --latex-program=xelatex --lily-output-dir=ly-pdf $$i"  ""')
1101                 addToRC(r'\converter lilypond-book luatex   "lilypond-book --safe --pdf --latex-program=lualatex --lily-output-dir=ly-pdf $$i" ""')
1102                 addToRC(r'\converter lilypond-book dviluatex "lilypond-book --safe --latex-program=dvilualatex --lily-output-dir=ly-eps $$i" ""')
1103                 logger.info('+  found LilyPond-book version %s.' % version_number)
1104             else:
1105                 logger.info('+  found LilyPond-book, but version %s is too old.' % version_number)
1106         else:
1107             logger.info('+  found LilyPond-book, but could not extract version number.')
1108     #
1109     checkProg('a Noteedit -> LilyPond converter', ['noteedit --export-lilypond $$i'],
1110         rc_entry = [ r'\converter noteedit   lilypond   "%%"    ""' ])
1111     #
1112     # Currently, lyxpak outputs a gzip compressed tar archive on *nix
1113     # and a zip archive on Windows.
1114     # So, we configure the appropriate version according to the platform.
1115     cmd = r'\converter lyx %s "python -tt $$s/scripts/lyxpak.py $$r/$$f" ""'
1116     if os.name == 'nt':
1117         addToRC(r'\Format lyxzip     zip    "LyX Archive (zip)"     "" "" ""  "document,menu=export"    ""')
1118         addToRC(cmd % "lyxzip")
1119     else:
1120         addToRC(r'\Format lyxgz      gz     "LyX Archive (tar.gz)"  "" "" ""  "document,menu=export"    ""')
1121         addToRC(cmd % "lyxgz")
1122
1123     #
1124     # FIXME: no rc_entry? comment it out
1125     # checkProg('Image converter', ['convert $$i $$o'])
1126     #
1127     # Entries that do not need checkProg
1128     addToRC(r'''
1129 \converter csv        lyx        "python -tt $$s/scripts/csv2lyx.py $$i $$o"    ""
1130 \converter docbook    docbook-xml "cp $$i $$o"  "xml"
1131 \converter fen        asciichess "python -tt $$s/scripts/fen2ascii.py $$i $$o"  ""
1132 \converter lyx        lyx13x     "python -tt $$s/lyx2lyx/lyx2lyx -V 1.3 -o $$o $$i"     ""
1133 \converter lyx        lyx14x     "python -tt $$s/lyx2lyx/lyx2lyx -V 1.4 -o $$o $$i"     ""
1134 \converter lyx        lyx15x     "python -tt $$s/lyx2lyx/lyx2lyx -V 1.5 -o $$o $$i"     ""
1135 \converter lyx        lyx16x     "python -tt $$s/lyx2lyx/lyx2lyx -V 1.6 -o $$o $$i"     ""
1136 \converter lyx        lyx20x     "python -tt $$s/lyx2lyx/lyx2lyx -V 2.0 -o $$o $$i"     ""
1137 \converter lyx        lyx21x     "python -tt $$s/lyx2lyx/lyx2lyx -V 2.1 -o $$o $$i"     ""
1138 \converter lyx        lyx22x     "python -tt $$s/lyx2lyx/lyx2lyx -V 2.2 -o $$o $$i"     ""
1139 \converter lyx        clyx       "python -tt $$s/lyx2lyx/lyx2lyx -V 1.4 -o $$o -c big5   $$i"   ""
1140 \converter lyx        jlyx       "python -tt $$s/lyx2lyx/lyx2lyx -V 1.4 -o $$o -c euc_jp $$i"   ""
1141 \converter lyx        klyx       "python -tt $$s/lyx2lyx/lyx2lyx -V 1.4 -o $$o -c euc_kr $$i"   ""
1142 \converter clyx       lyx        "python -tt $$s/lyx2lyx/lyx2lyx -c big5   -o $$o $$i"  ""
1143 \converter jlyx       lyx        "python -tt $$s/lyx2lyx/lyx2lyx -c euc_jp -o $$o $$i"  ""
1144 \converter klyx       lyx        "python -tt $$s/lyx2lyx/lyx2lyx -c euc_kr -o $$o $$i"  ""
1145 \converter lyxpreview png        "python -tt $$s/scripts/lyxpreview2bitmap.py --png"    ""
1146 \converter lyxpreview ppm        "python -tt $$s/scripts/lyxpreview2bitmap.py --ppm"    ""
1147 ''')
1148
1149
1150 def checkDocBook():
1151     ''' Check docbook '''
1152     path, DOCBOOK = checkProg('SGML-tools 2.x (DocBook), db2x scripts or xsltproc', ['sgmltools', 'db2dvi', 'xsltproc'],
1153         rc_entry = [
1154             r'''\converter docbook    dvi        "sgmltools -b dvi $$i" ""
1155 \converter docbook    html       "sgmltools -b html $$i"        ""
1156 \converter docbook    ps         "sgmltools -b ps $$i"  ""''',
1157             r'''\converter docbook    dvi        "db2dvi $$i"   ""
1158 \converter docbook    html       "db2html $$i"  ""''',
1159             r'''\converter docbook    dvi        ""     ""
1160 \converter docbook    html       "" ""''',
1161             r'''\converter docbook    dvi        ""     ""
1162 \converter docbook    html       ""     ""'''])
1163     #
1164     if DOCBOOK != '':
1165         return ('yes', 'true', '\\def\\hasdocbook{yes}')
1166     else:
1167         return ('no', 'false', '')
1168
1169
1170 def checkOtherEntries():
1171     ''' entries other than Format and Converter '''
1172     checkProg('ChkTeX', ['chktex -n1 -n3 -n6 -n9 -n22 -n25 -n30 -n38'],
1173         rc_entry = [ r'\chktex_command "%%"' ])
1174     checkProgAlternatives('BibTeX or alternative programs',
1175         ['bibtex', 'bibtex8', 'biber'],
1176         rc_entry = [ r'\bibtex_command "%%"' ],
1177         alt_rc_entry = [ r'\bibtex_alternatives "%%"' ])
1178     checkProg('a specific Japanese BibTeX variant',
1179         ['pbibtex', 'jbibtex', 'bibtex'],
1180         rc_entry = [ r'\jbibtex_command "%%"' ])
1181     checkProgAlternatives('available index processors',
1182         ['texindy', 'makeindex -c -q', 'xindy'],
1183         rc_entry = [ r'\index_command "%%"' ],
1184         alt_rc_entry = [ r'\index_alternatives "%%"' ])
1185     checkProg('an index processor appropriate to Japanese',
1186         ['mendex -c -q', 'jmakeindex -c -q', 'makeindex -c -q'],
1187         rc_entry = [ r'\jindex_command "%%"' ])
1188     checkProg('the splitindex processor', ['splitindex.pl', 'splitindex',
1189         'splitindex.class'], rc_entry = [ r'\splitindex_command "%%"' ])
1190     checkProg('a nomenclature processor', ['makeindex'],
1191         rc_entry = [ r'\nomencl_command "makeindex -s nomencl.ist"' ])
1192     ## FIXME: OCTAVE is not used anywhere
1193     # path, OCTAVE = checkProg('Octave', ['octave'])
1194     ## FIXME: MAPLE is not used anywhere
1195     # path, MAPLE = checkProg('Maple', ['maple'])
1196     # Add the rest of the entries (no checkProg is required)
1197     addToRC(r'''\copier    fig        "python -tt $$s/scripts/fig_copy.py $$i $$o"
1198 \copier    pstex      "python -tt $$s/scripts/tex_copy.py $$i $$o $$l"
1199 \copier    pdftex     "python -tt $$s/scripts/tex_copy.py $$i $$o $$l"
1200 \copier    program    "python -tt $$s/scripts/ext_copy.py $$i $$o"
1201 ''')
1202
1203
1204 def processLayoutFile(file, bool_docbook):
1205     ''' process layout file and get a line of result
1206
1207         Declare lines look like this:
1208
1209         \DeclareLaTeXClass[<requirements>]{<description>}
1210
1211         Optionally, a \DeclareCategory line follows:
1212
1213         \DeclareCategory{<category>}
1214
1215         So for example (article.layout, scrbook.layout, svjog.layout)
1216
1217         \DeclareLaTeXClass{article}
1218         \DeclareCategory{Articles}
1219
1220         \DeclareLaTeXClass[scrbook]{book (koma-script)}
1221         \DeclareCategory{Books}
1222
1223         \DeclareLaTeXClass[svjour,svjog.clo]{article (Springer - svjour/jog)}
1224
1225         we'd expect this output:
1226
1227         "article" "article" "article" "false" "article.cls" "Articles"
1228         "scrbook" "scrbook" "book (koma-script)" "false" "scrbook.cls" "Books"
1229         "svjog" "svjour" "article (Springer - svjour/jog)" "false" "svjour.cls,svjog.clo" ""
1230     '''
1231     def checkForClassExtension(x):
1232         '''if the extension for a latex class is not
1233            provided, add .cls to the classname'''
1234         if not '.' in x:
1235             return x.strip() + '.cls'
1236         else:
1237             return x.strip()
1238     classname = file.split(os.sep)[-1].split('.')[0]
1239     # return ('LaTeX', '[a,b]', 'a', ',b,c', 'article') for \DeclareLaTeXClass[a,b,c]{article}
1240     p = re.compile(r'^\s*#\s*\\Declare(LaTeX|DocBook)Class\s*(\[([^,]*)(,.*)*\])*\s*{(.*)}\s*$')
1241     q = re.compile(r'^\s*#\s*\\DeclareCategory{(.*)}\s*$')
1242     classdeclaration = ""
1243     categorydeclaration = '""'
1244     for line in open(file).readlines():
1245         res = p.search(line)
1246         qres = q.search(line)
1247         if res != None:
1248             (classtype, optAll, opt, opt1, desc) = res.groups()
1249             avai = {'LaTeX':'false', 'DocBook':bool_docbook}[classtype]
1250             if opt == None:
1251                 opt = classname
1252                 prereq_latex = checkForClassExtension(classname)
1253             else:
1254                 prereq_list = optAll[1:-1].split(',')
1255                 prereq_list = list(map(checkForClassExtension, prereq_list))
1256                 prereq_latex = ','.join(prereq_list)
1257             prereq_docbook = {'true':'', 'false':'docbook'}[bool_docbook]
1258             prereq = {'LaTeX':prereq_latex, 'DocBook':prereq_docbook}[classtype]
1259             classdeclaration = ('"%s" "%s" "%s" "%s" "%s"'
1260                                % (classname, opt, desc, avai, prereq))
1261             if categorydeclaration != '""':
1262                 return classdeclaration + " " + categorydeclaration
1263         if qres != None:
1264              categorydeclaration = '"%s"' % (qres.groups()[0])
1265              if classdeclaration != "":
1266                  return classdeclaration + " " + categorydeclaration
1267     if classdeclaration != "":
1268         return classdeclaration + " " + categorydeclaration
1269     logger.warning("Layout file " + file + " has no \DeclareXXClass line. ")
1270     return ""
1271
1272
1273 def checkLatexConfig(check_config, bool_docbook):
1274     ''' Explore the LaTeX configuration
1275         Return None (will be passed to sys.exit()) for success.
1276     '''
1277     msg = 'checking LaTeX configuration... '
1278     # if --without-latex-config is forced, or if there is no previous
1279     # version of textclass.lst, re-generate a default file.
1280     if not os.path.isfile('textclass.lst') or not check_config:
1281         # remove the files only if we want to regenerate
1282         removeFiles(['textclass.lst', 'packages.lst'])
1283         #
1284         # Then, generate a default textclass.lst. In case configure.py
1285         # fails, we still have something to start lyx.
1286         logger.info(msg + ' default values')
1287         logger.info('+checking list of textclasses... ')
1288         tx = open('textclass.lst', 'w')
1289         tx.write('''
1290 # This file declares layouts and their associated definition files
1291 # (include dir. relative to the place where this file is).
1292 # It contains only default values, since chkconfig.ltx could not be run
1293 # for some reason. Run ./configure.py if you need to update it after a
1294 # configuration change.
1295 ''')
1296         # build the list of available layout files and convert it to commands
1297         # for chkconfig.ltx
1298         foundClasses = []
1299         for file in (glob.glob(os.path.join('layouts', '*.layout'))
1300                      + glob.glob(os.path.join(srcdir, 'layouts', '*.layout'))):
1301             # valid file?
1302             if not os.path.isfile(file):
1303                 continue
1304             # get stuff between /xxxx.layout .
1305             classname = file.split(os.sep)[-1].split('.')[0]
1306             #  tr ' -' '__'`
1307             cleanclass = classname.replace(' ', '_')
1308             cleanclass = cleanclass.replace('-', '_')
1309             # make sure the same class is not considered twice
1310             if foundClasses.count(cleanclass) == 0: # not found before
1311                 foundClasses.append(cleanclass)
1312                 retval = processLayoutFile(file, bool_docbook)
1313                 if retval != "":
1314                     tx.write(retval)
1315         tx.close()
1316         logger.info('\tdone')
1317     if not os.path.isfile('packages.lst') or not check_config:
1318         logger.info('+generating default list of packages... ')
1319         removeFiles(['packages.lst'])
1320         tx = open('packages.lst', 'w')
1321         tx.close()
1322         logger.info('\tdone')
1323     if not check_config:
1324         return None
1325     # the following will generate textclass.lst.tmp, and packages.lst.tmp
1326     logger.info(msg + '\tauto')
1327     removeFiles(['chkconfig.classes', 'chkconfig.vars', 'chklayouts.tex',
1328         'wrap_chkconfig.ltx'])
1329     rmcopy = False
1330     if not os.path.isfile( 'chkconfig.ltx' ):
1331         shutil.copyfile( os.path.join(srcdir, 'chkconfig.ltx'), 'chkconfig.ltx' )
1332         rmcopy = True
1333     writeToFile('wrap_chkconfig.ltx', '%s\n\\input{chkconfig.ltx}\n' % docbook_cmd)
1334     # Construct the list of classes to test for.
1335     # build the list of available layout files and convert it to commands
1336     # for chkconfig.ltx
1337     declare = re.compile(r'^\s*#\s*\\Declare(LaTeX|DocBook)Class\s*(\[([^,]*)(,.*)*\])*\s*{(.*)}\s*$')
1338     category = re.compile(r'^\s*#\s*\\DeclareCategory{(.*)}\s*$')
1339     empty = re.compile(r'^\s*$')
1340     testclasses = list()
1341     for file in (glob.glob( os.path.join('layouts', '*.layout') )
1342                  + glob.glob( os.path.join(srcdir, 'layouts', '*.layout' ) ) ):
1343         nodeclaration = False
1344         if not os.path.isfile(file):
1345             continue
1346         classname = file.split(os.sep)[-1].split('.')[0]
1347         decline = ""
1348         catline = ""
1349         for line in open(file).readlines():
1350             if not empty.match(line) and line[0] != '#':
1351                 if decline == "":
1352                     logger.warning("Failed to find valid \Declare line "
1353                         "for layout file `%s'.\n\t=> Skipping this file!" % file)
1354                     nodeclaration = True
1355                 # A class, but no category declaration. Just break.
1356                 break
1357             if declare.search(line) != None:
1358                 decline = "\\TestDocClass{%s}{%s}" % (classname, line[1:].strip())
1359                 testclasses.append(decline)
1360             elif category.search(line) != None:
1361                 catline = ("\\DeclareCategory{%s}{%s}"
1362                            % (classname, category.search(line).groups()[0]))
1363                 testclasses.append(catline)
1364             if catline == "" or decline == "":
1365                 continue
1366             break
1367         if nodeclaration:
1368             continue
1369     testclasses.sort()
1370     cl = open('chklayouts.tex', 'w')
1371     for line in testclasses:
1372         cl.write(line + '\n')
1373     cl.close()
1374     #
1375     # we have chklayouts.tex, then process it
1376     latex_out = cmdOutput(LATEX + ' wrap_chkconfig.ltx', True)
1377     while True:
1378         line = latex_out.readline()
1379         if not line:
1380             break;
1381         if re.match('^\+', line):
1382             logger.info(line.strip())
1383     # if the command succeeds, None will be returned
1384     ret = latex_out.close()
1385     #
1386     # remove the copied file
1387     if rmcopy:
1388         removeFiles( [ 'chkconfig.ltx' ] )
1389     #
1390     # currently, values in chkconfig are only used to set
1391     # \font_encoding
1392     values = {}
1393     for line in open('chkconfig.vars').readlines():
1394         key, val = re.sub('-', '_', line).split('=')
1395         val = val.strip()
1396         values[key] = val.strip("'")
1397     # chk_fontenc may not exist
1398     try:
1399         addToRC(r'\font_encoding "%s"' % values["chk_fontenc"])
1400     except:
1401         pass
1402     # if configure successed, move textclass.lst.tmp to textclass.lst
1403     # and packages.lst.tmp to packages.lst
1404     if (os.path.isfile('textclass.lst.tmp')
1405           and len(open('textclass.lst.tmp').read()) > 0
1406         and os.path.isfile('packages.lst.tmp')
1407           and len(open('packages.lst.tmp').read()) > 0):
1408         shutil.move('textclass.lst.tmp', 'textclass.lst')
1409         shutil.move('packages.lst.tmp', 'packages.lst')
1410     return ret
1411
1412
1413 def checkModulesConfig():
1414   removeFiles(['lyxmodules.lst', 'chkmodules.tex'])
1415
1416   logger.info('+checking list of modules... ')
1417   tx = open('lyxmodules.lst', 'w')
1418   tx.write('''## This file declares modules and their associated definition files.
1419 ## It has been automatically generated by configure
1420 ## Use "Options/Reconfigure" if you need to update it after a
1421 ## configuration change.
1422 ## "ModuleName" "filename" "Description" "Packages" "Requires" "Excludes" "Category"
1423 ''')
1424
1425   # build the list of available modules
1426   seen = []
1427   # note that this searches the local directory first, then the
1428   # system directory. that way, we pick up the user's version first.
1429   for file in (glob.glob( os.path.join('layouts', '*.module') )
1430                + glob.glob( os.path.join(srcdir, 'layouts', '*.module' ) ) ):
1431       # valid file?
1432       logger.info(file)
1433       if not os.path.isfile(file):
1434           continue
1435
1436       filename = file.split(os.sep)[-1]
1437       filename = filename[:-7]
1438       if seen.count(filename):
1439           continue
1440
1441       seen.append(filename)
1442       retval = processModuleFile(file, filename, bool_docbook)
1443       if retval != "":
1444           tx.write(retval)
1445   tx.close()
1446   logger.info('\tdone')
1447
1448
1449 def processModuleFile(file, filename, bool_docbook):
1450     ''' process module file and get a line of result
1451
1452         The top of a module file should look like this:
1453           #\DeclareLyXModule[LaTeX Packages]{ModuleName}
1454           #DescriptionBegin
1455           #...body of description...
1456           #DescriptionEnd
1457           #Requires: [list of required modules]
1458           #Excludes: [list of excluded modules]
1459           #Category: [category name]
1460         The last three lines are optional (though do give a category).
1461         We expect output:
1462           "ModuleName" "filename" "Description" "Packages" "Requires" "Excludes" "Category"
1463     '''
1464     remods = re.compile(r'\DeclareLyXModule\s*(?:\[([^]]*?)\])?{(.*)}')
1465     rereqs = re.compile(r'#+\s*Requires: (.*)')
1466     reexcs = re.compile(r'#+\s*Excludes: (.*)')
1467     recaty = re.compile(r'#+\s*Category: (.*)')
1468     redbeg = re.compile(r'#+\s*DescriptionBegin\s*$')
1469     redend = re.compile(r'#+\s*DescriptionEnd\s*$')
1470
1471     modname = desc = pkgs = req = excl = catgy = ""
1472     readingDescription = False
1473     descLines = []
1474
1475     for line in open(file).readlines():
1476       if readingDescription:
1477         res = redend.search(line)
1478         if res != None:
1479           readingDescription = False
1480           desc = " ".join(descLines)
1481           # Escape quotes.
1482           desc = desc.replace('"', '\\"')
1483           continue
1484         descLines.append(line[1:].strip())
1485         continue
1486       res = redbeg.search(line)
1487       if res != None:
1488         readingDescription = True
1489         continue
1490       res = remods.search(line)
1491       if res != None:
1492           (pkgs, modname) = res.groups()
1493           if pkgs == None:
1494             pkgs = ""
1495           else:
1496             tmp = [s.strip() for s in pkgs.split(",")]
1497             pkgs = ",".join(tmp)
1498           continue
1499       res = rereqs.search(line)
1500       if res != None:
1501         req = res.group(1)
1502         tmp = [s.strip() for s in req.split("|")]
1503         req = "|".join(tmp)
1504         continue
1505       res = reexcs.search(line)
1506       if res != None:
1507         excl = res.group(1)
1508         tmp = [s.strip() for s in excl.split("|")]
1509         excl = "|".join(tmp)
1510         continue
1511       res = recaty.search(line)
1512       if res != None:
1513         catgy = res.group(1)
1514         continue
1515
1516     if modname == "":
1517       logger.warning("Module file without \DeclareLyXModule line. ")
1518       return ""
1519
1520     if pkgs != "":
1521         # this module has some latex dependencies:
1522         # append the dependencies to chkmodules.tex,
1523         # which is \input'ed by chkconfig.ltx
1524         testpackages = list()
1525         for pkg in pkgs.split(","):
1526             if "->" in pkg:
1527                 # this is a converter dependency: skip
1528                 continue
1529             if pkg.endswith(".sty"):
1530                 pkg = pkg[:-4]
1531             testpackages.append("\\TestPackage{%s}" % (pkg,))
1532         cm = open('chkmodules.tex', 'a')
1533         for line in testpackages:
1534             cm.write(line + '\n')
1535         cm.close()
1536
1537     return ('"%s" "%s" "%s" "%s" "%s" "%s" "%s"\n'
1538             % (modname, filename, desc, pkgs, req, excl, catgy))
1539
1540
1541 def checkTeXAllowSpaces():
1542     ''' Let's check whether spaces are allowed in TeX file names '''
1543     tex_allows_spaces = 'false'
1544     if lyx_check_config:
1545         msg = "Checking whether TeX allows spaces in file names... "
1546         writeToFile('a b.tex', r'\message{working^^J}' )
1547         if LATEX != '':
1548             if os.name == 'nt' or sys.platform == 'cygwin':
1549                 latex_out = cmdOutput(LATEX + r""" "\nonstopmode\input{\"a b\"}\makeatletter\@@end" """)
1550             else:
1551                 latex_out = cmdOutput(LATEX + r""" '\nonstopmode\input{"a b"}\makeatletter\@@end' """)
1552         else:
1553             latex_out = ''
1554         if 'working' in latex_out:
1555             logger.info(msg + 'yes')
1556             tex_allows_spaces = 'true'
1557         else:
1558             logger.info(msg + 'no')
1559             tex_allows_spaces = 'false'
1560         addToRC(r'\tex_allows_spaces ' + tex_allows_spaces)
1561         removeFiles( [ 'a b.tex', 'a b.log', 'texput.log' ])
1562
1563
1564 def rescanTeXFiles():
1565     ''' Run kpsewhich to update information about TeX files '''
1566     logger.info("+Indexing TeX files... ")
1567     if not os.path.isfile( os.path.join(srcdir, 'scripts', 'TeXFiles.py') ):
1568         logger.error("configure: error: cannot find TeXFiles.py script")
1569         sys.exit(1)
1570     interpreter = sys.executable
1571     if interpreter == '':
1572         interpreter = "python"
1573     tfp = cmdOutput(interpreter + " -tt " + '"'
1574                     + os.path.join(srcdir, 'scripts', 'TeXFiles.py') + '"')
1575     logger.info(tfp)
1576     logger.info("\tdone")
1577
1578
1579 def removeTempFiles():
1580     # Final clean-up
1581     if not lyx_keep_temps:
1582         removeFiles(['chkconfig.vars', 'chklatex.ltx', 'chklatex.log',
1583             'chklayouts.tex', 'chkmodules.tex', 'missfont.log',
1584             'wrap_chkconfig.ltx', 'wrap_chkconfig.log'])
1585
1586
1587 if __name__ == '__main__':
1588     lyx_check_config = True
1589     lyx_kpsewhich = True
1590     outfile = 'lyxrc.defaults'
1591     lyxrc_fileformat = 20
1592     rc_entries = ''
1593     lyx_keep_temps = False
1594     version_suffix = ''
1595     lyx_binary_dir = ''
1596     ## Parse the command line
1597     for op in sys.argv[1:]:   # default shell/for list is $*, the options
1598         if op in [ '-help', '--help', '-h' ]:
1599             print('''Usage: configure [options]
1600 Options:
1601     --help                   show this help lines
1602     --keep-temps             keep temporary files (for debug. purposes)
1603     --without-kpsewhich      do not update TeX files information via kpsewhich
1604     --without-latex-config   do not run LaTeX to determine configuration
1605     --with-version-suffix=suffix suffix of binary installed files
1606     --binary-dir=directory   directory of binary installed files
1607 ''')
1608             sys.exit(0)
1609         elif op == '--without-kpsewhich':
1610             lyx_kpsewhich = False
1611         elif op == '--without-latex-config':
1612             lyx_check_config = False
1613         elif op == '--keep-temps':
1614             lyx_keep_temps = True
1615         elif op[0:22] == '--with-version-suffix=':  # never mind if op is not long enough
1616             version_suffix = op[22:]
1617         elif op[0:13] == '--binary-dir=':
1618             lyx_binary_dir = op[13:]
1619         else:
1620             print("Unknown option %s" % op)
1621             sys.exit(1)
1622     #
1623     # check if we run from the right directory
1624     srcdir = os.path.dirname(sys.argv[0])
1625     if srcdir == '':
1626         srcdir = '.'
1627     if not os.path.isfile( os.path.join(srcdir, 'chkconfig.ltx') ):
1628         logger.error("configure: error: cannot find chkconfig.ltx script")
1629         sys.exit(1)
1630     setEnviron()
1631     if sys.platform == 'darwin' and len(version_suffix) > 0:
1632         checkUpgrade()
1633     createDirectories()
1634     dtl_tools = checkDTLtools()
1635     ## Write the first part of outfile
1636     writeToFile(outfile, '''# This file has been automatically generated by LyX' lib/configure.py
1637 # script. It contains default settings that have been determined by
1638 # examining your system. PLEASE DO NOT MODIFY ANYTHING HERE! If you
1639 # want to customize LyX, use LyX' Preferences dialog or modify directly
1640 # the "preferences" file instead. Any setting in that file will
1641 # override the values given here.
1642
1643 Format %i
1644
1645 ''' % lyxrc_fileformat)
1646     # check latex
1647     LATEX = checkLatex(dtl_tools)
1648     # check java and perl before any checkProg that may require them
1649     java = checkProg('a java interpreter', ['java'])[1]
1650     perl = checkProg('a perl interpreter', ['perl'])[1]
1651     (inkscape_path, inkscape_name) = os.path.split(checkInkscape())
1652     checkFormatEntries(dtl_tools)
1653     checkConverterEntries()
1654     (chk_docbook, bool_docbook, docbook_cmd) = checkDocBook()
1655     checkTeXAllowSpaces()
1656     windows_style_tex_paths = checkTeXPaths()
1657     if windows_style_tex_paths != '':
1658         addToRC(r'\tex_expects_windows_paths %s' % windows_style_tex_paths)
1659     checkOtherEntries()
1660     if lyx_kpsewhich:
1661         rescanTeXFiles()
1662     checkModulesConfig()
1663     # --without-latex-config can disable lyx_check_config
1664     ret = checkLatexConfig(lyx_check_config and LATEX != '', bool_docbook)
1665     removeTempFiles()
1666     # The return error code can be 256. Because most systems expect an error code
1667     # in the range 0-127, 256 can be interpretted as 'success'. Because we expect
1668     # a None for success, 'ret is not None' is used to exit.
1669     sys.exit(ret is not None)