2 # -*- coding: utf-8 -*-
4 # file layout2layout.py
5 # This file is part of LyX, the document processor.
6 # Licence details can be found in the file COPYING.
10 # Full author contact details are available in file CREDITS
12 # This script will update a .layout file to current format
15 import os, re, string, sys
17 # Incremented to format 4, 6 April 2007, lasgouttes
18 # Introduction of generic "Provides" declaration
20 # Incremented to format 5, 22 August 2007 by vermeer
21 # InsetLayout material
23 # Incremented to format 6, 7 January 2008 by spitz
24 # Requires tag added to layout files
26 # Incremented to format 7, 24 March 2008 by rgh
27 # AddToPreamble tag added to layout files
29 # Incremented to format 8, 25 July 2008 by rgh
30 # UseModule tag added to layout files
31 # CopyStyle added to InsetLayout
33 # Incremented to format 9, 5 October 2008 by rgh
34 # ForcePlain and CustomPars tags added to InsetLayout
36 # Incremented to format 10, 6 October 2008 by rgh
37 # Change format of counters
39 # Incremented to format 11, 14 October 2008 by rgh
40 # Add ProvidesModule, ExcludesModule tags
42 # Incremented to format 12, 10 January 2009 by gb
43 # Add I18NPreamble tag
45 # Incremented to format 13, 5 February 2009 by rgh
46 # Add InToc tag for InsetLayout
48 # Incremented to format 14, 14 February 2009 by gb
49 # Rename I18NPreamble to BabelPreamble and add LangPreamble
51 # Incremented to format 15, 28 May 2009 by lasgouttes
52 # Add new tag OutputFormat; modules can be conditioned on feature
55 # Incremented to format 16, 5 June 2009 by rgh
56 # Add new tags for Text Class:
57 # HTMLPreamble, HTMLAddToPreamble
59 # HTMLTag, HTMLAttr, HTMLLabel, HTMLLabelAttr, HTMLItem, HTMLItemAttr
60 # HTMLStyle, and HTMLPreamble
62 # HTMLTag, HTMLAttr, HTMLStyle, and HTMLPreamble
64 # HTMLType, HTMLClass, HTMLStyle
66 # Incremented to format 17, 12 August 2009 by rgh
67 # Add IfStyle and IfCounter tags for layout.
69 # Incremented to format 18, 27 October 2009 by rgh
70 # Added some new tags for HTML output.
72 # Incremented to format 19, 17 November 2009 by rgh
73 # Added InPreamble tag.
75 # Incremented to format 20, 17 December 2009 by rgh
76 # Added ContentAsLabel tag.
78 # Incremented to format 21, 12 January 2010 by rgh
79 # Added HTMLTocLayout and HTMLTitle tags.
81 # Incremented to format 22, 20 January 2010 by rgh
82 # Added HTMLFormat tag to Counters.
84 # Incremented to format 23, 13 February 2010 by spitz
85 # Added Spellcheck tag.
87 # Incremented to format 24, 5 March 2010 by rgh
88 # Changed LaTeXBuiltin tag to NeedsFloatPkg and
89 # added new tag ListCommand.
91 # Incremented to format 25, 12 March 2010 by rgh
92 # Added RefPrefix tag for layouts and floats.
94 # Incremented to format 26, 29 March 2010 by rgh
97 # Incremented to format 27, 4 June 2010 by rgh
98 # Added RequiredArgs tag.
100 # Incremented to format 28, 6 August 2010 by lasgouttes
101 # Added ParbreakIsNewline tag for Layout and InsetLayout.
103 # Incremented to format 29, 10 August 2010 by rgh
104 # Changed Custom:Style, CharStyle:Style, and Element:Style
105 # uniformly to Flex:Style.
107 # Incremented to format 30, 13 August 2010 by rgh
108 # Introduced ResetsFont tag for InsetLayout.
110 # Incremented to format 31, 12 January 2011 by rgh
111 # Introducted NoCounter tag.
113 # Incremented to format 32, 30 January 2011 by forenr
114 # Added Display tag for InsetLayout
116 # Incremented to format 33, 2 February 2011 by rgh
117 # Changed NeedsFloatPkg to UsesFloatPkg
119 # Incremented to format 34, 28 March 2011 by rgh
120 # Remove obsolete Fill_(Top|Bottom) tags
122 # Incremented to format 35, 28 March 2011 by rgh
123 # Try to add "Flex:" to any flex insets that don't have it.
125 # Incremented to format 36, 7 December 2011, by rgh
126 # Added HTMLStyles and AddToHTMLStyles tags.
128 # Incremented to format 37, 29 February 2012 by jrioux
129 # Implement the citation engine machinery in layouts.
130 # Change CiteFormat to CiteFormat (default|authoryear|numerical).
132 # Incremented to format 38, 08 April 2012 by gb
133 # Introduce LangPreamble and BabelPreamble for InsetLayout.
135 # Incremented to format 39, 15 April 2012 by sanda
136 # Introduce styling of branches via "InsetLayout Branch:".
138 # Incremented to format 40, 10 October 2012 by rgh
139 # Re-do layout names for layout categories
141 # Do not forget to document format change in Customization
142 # Manual (section "Declaring a new text class").
144 # You might also want to consider running the
145 # development/tools/updatelayouts.sh script to update all
146 # layout files to the new format.
151 def usage(prog_name):
152 return ("Usage: %s inputfile outputfile\n" % prog_name +
153 "or %s <inputfile >outputfile" % prog_name)
157 sys.stderr.write(message + '\n')
162 " Remove byte order mark."
163 if line[0:3] == "\357\273\277":
170 " Read input file and strip lineendings."
171 lines = source.read().splitlines() or ['']
172 lines[0] = trim_bom(lines[0])
176 def write(output, lines):
177 " Write output file with native lineendings."
178 output.write(os.linesep.join(lines) + os.linesep)
181 # Concatenates old and new in an intelligent way:
182 # If old is wrapped in ", they are stripped. The result is wrapped in ".
183 def concatenate_label(old, new):
184 # Don't use strip as long as we support python 1.5.2
186 return old[0:-1] + new + '"'
188 return '"' + old + new + '"'
190 # appends a string to a list unless it's already there
198 " Convert to new format."
199 re_Comment = re.compile(r'^(\s*)#')
200 re_Counter = re.compile(r'\s*Counter\s*', re.IGNORECASE)
201 re_Name = re.compile(r'\s*Name\s+(\S+)\s*', re.IGNORECASE)
202 re_UseMod = re.compile(r'^\s*UseModule\s+(.*)', re.IGNORECASE)
203 re_Empty = re.compile(r'^(\s*)$')
204 re_Format = re.compile(r'^(\s*)(Format)(\s+)(\S+)', re.IGNORECASE)
205 re_Preamble = re.compile(r'^(\s*)Preamble', re.IGNORECASE)
206 re_EndPreamble = re.compile(r'^(\s*)EndPreamble', re.IGNORECASE)
207 re_LangPreamble = re.compile(r'^(\s*)LangPreamble', re.IGNORECASE)
208 re_EndLangPreamble = re.compile(r'^(\s*)EndLangPreamble', re.IGNORECASE)
209 re_BabelPreamble = re.compile(r'^(\s*)BabelPreamble', re.IGNORECASE)
210 re_EndBabelPreamble = re.compile(r'^(\s*)EndBabelPreamble', re.IGNORECASE)
211 re_MaxCounter = re.compile(r'^(\s*)(MaxCounter)(\s+)(\S+)', re.IGNORECASE)
212 re_LabelType = re.compile(r'^(\s*)(LabelType)(\s+)(\S+)', re.IGNORECASE)
213 re_LabelString = re.compile(r'^(\s*)(LabelString)(\s+)(("[^"]+")|(\S+))', re.IGNORECASE)
214 re_LabelStringAppendix = re.compile(r'^(\s*)(LabelStringAppendix)(\s+)(("[^"]+")|(\S+))', re.IGNORECASE)
215 re_LatexType = re.compile(r'^(\s*)(LatexType)(\s+)(\S+)', re.IGNORECASE)
216 re_Style = re.compile(r'^(\s*)(Style)(\s+)(\S+)', re.IGNORECASE)
217 re_CopyStyle = re.compile(r'^(\s*)(CopyStyle)(\s+)(\S+)', re.IGNORECASE)
218 re_NoStyle = re.compile(r'^(\s*)(NoStyle)(\s+)(\S+)', re.IGNORECASE)
219 re_End = re.compile(r'^(\s*)(End)(\s*)$', re.IGNORECASE)
220 re_Provides = re.compile(r'^(\s*)Provides(\S+)(\s+)(\S+)', re.IGNORECASE)
221 re_CharStyle = re.compile(r'^(\s*)CharStyle(\s+)(\S+)$', re.IGNORECASE)
222 re_CiteFormat = re.compile(r'^(\s*)(CiteFormat)(?:(\s*)()|(\s+)(default|authoryear|numerical))', re.IGNORECASE)
223 re_AMSMaths = re.compile(r'^\s*Input ams(?:math|def)s.inc\s*')
224 re_AMSMathsPlain = re.compile(r'^\s*Input amsmaths-plain.inc\s*')
225 re_AMSMathsSeq = re.compile(r'^\s*Input amsmaths-seq.inc\s*')
226 re_TocLevel = re.compile(r'^(\s*)(TocLevel)(\s+)(\S+)', re.IGNORECASE)
227 re_I18nPreamble = re.compile(r'^(\s*)I18nPreamble', re.IGNORECASE)
228 re_EndI18nPreamble = re.compile(r'^(\s*)EndI18nPreamble', re.IGNORECASE)
229 re_Float = re.compile(r'^\s*Float\s*$', re.IGNORECASE)
230 re_Type = re.compile(r'\s*Type\s+(\w+)', re.IGNORECASE)
231 re_Builtin = re.compile(r'^(\s*)LaTeXBuiltin\s+(\w*)', re.IGNORECASE)
232 re_True = re.compile(r'^\s*(?:true|1)\s*$', re.IGNORECASE)
233 re_InsetLayout = re.compile(r'^\s*InsetLayout\s+(?:Custom|CharStyle|Element):(\S+)\s*$', re.IGNORECASE)
235 re_QInsetLayout = re.compile(r'^\s*InsetLayout\s+"(?:Custom|CharStyle|Element):([^"]+)"\s*$', re.IGNORECASE)
236 re_InsetLayout_CopyStyle = re.compile(r'^\s*CopyStyle\s+(?:Custom|CharStyle|Element):(\S+)\s*$', re.IGNORECASE)
237 re_QInsetLayout_CopyStyle = re.compile(r'^\s*CopyStyle\s+"(?:Custom|CharStyle|Element):([^"]+)"\s*$', re.IGNORECASE)
238 re_NeedsFloatPkg = re.compile(r'^(\s*)NeedsFloatPkg\s+(\w+)\s*$', re.IGNORECASE)
239 re_Fill = re.compile(r'^\s*Fill_(?:Top|Bottom).*$', re.IGNORECASE)
240 re_InsetLayout2 = re.compile(r'^\s*InsetLayout\s+(\S+)\s*$', re.IGNORECASE)
242 re_QInsetLayout2 = re.compile(r'^\s*InsetLayout\s+"([^"]+)"\s*$', re.IGNORECASE)
243 re_IsFlex = re.compile(r'\s*LyXType.*$', re.IGNORECASE)
244 re_CopyStyle2 = re.compile(r'(\s*CopyStyle\s+)"?([^"]+)"?\s*$')
246 # counters for sectioning styles (hardcoded in 1.3)
247 counters = {"part" : "\\Roman{part}",
248 "chapter" : "\\arabic{chapter}",
249 "section" : "\\arabic{section}",
250 "subsection" : "\\arabic{section}.\\arabic{subsection}",
251 "subsubsection" : "\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}",
252 "paragraph" : "\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}",
253 "subparagraph" : "\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}.\\arabic{subparagraph}"}
255 # counters for sectioning styles in appendix (hardcoded in 1.3)
256 appendixcounters = {"chapter" : "\\Alph{chapter}",
257 "section" : "\\Alph{section}",
258 "subsection" : "\\arabic{section}.\\arabic{subsection}",
259 "subsubsection" : "\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}",
260 "paragraph" : "\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}",
261 "subparagraph" : "\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}.\\arabic{subparagraph}"}
263 # Value of TocLevel for sectioning styles
264 toclevels = {"part" : 0,
278 labelstringappendix = ""
280 labelstring_line = -1
281 labelstringappendix_line = -1
292 while i < len(lines):
293 # Skip comments and empty lines
294 if re_Comment.match(lines[i]) or re_Empty.match(lines[i]):
298 # insert file format if not already there
300 match = re_Format.match(lines[i])
303 format = int(match.group(4))
304 if format > 1 and format < currentFormat:
305 lines[i] = "Format %d" % (format + 1)
307 elif format == currentFormat:
311 error('Cannot convert file format %s' % format)
313 lines.insert(i, "Format 2")
317 # Don't get confused by LaTeX code
318 if re_Preamble.match(lines[i]):
320 while i < len(lines) and not re_EndPreamble.match(lines[i]):
323 if re_LangPreamble.match(lines[i]):
325 while i < len(lines) and not re_EndLangPreamble.match(lines[i]):
328 if re_BabelPreamble.match(lines[i]):
330 while i < len(lines) and not re_EndBabelPreamble.match(lines[i]):
335 # something more substantil will be inserted here shortly
339 if format == 37 or format == 38:
344 match = re_CiteFormat.match(lines[i]);
345 if match and match.group(4) == "":
346 lines[i] = match.group(0) + " default"
355 match = re_InsetLayout2.match(lines[i])
357 match = re_QInsetLayout2.match(lines[i])
359 match = re_CopyStyle2.match(lines[i])
363 style = match.group(2)
365 if flexstyles.count(style):
366 lines[i] = match.group(1) + "\"Flex:" + style + "\""
370 name = match.group(1)
371 names = name.split(":", 1)
372 if len(names) > 1 and names[0] == "Flex":
377 for j in range(i + 1, len(lines)):
378 if re_IsFlex.match(lines[j]):
381 if re_End.match(lines[j]):
385 flexstyles.append(name)
386 lines[i] = "InsetLayout \"Flex:" + name + "\""
392 m = re_Fill.match(lines[i])
399 match = re_NeedsFloatPkg.match(lines[i])
401 space = match.group(1)
403 lines[i] = space + "UsesFloatPkg " + val
405 if val == '1' or val.lower() == 'true':
407 lines.insert(i, space + "IsPredefined " + newval)
413 if format >= 29 and format <= 31:
418 match = re_InsetLayout.match(lines[i])
420 lines[i] = "InsetLayout Flex:" + match.group(1)
422 match = re_QInsetLayout.match(lines[i])
424 lines[i] = "InsetLayout \"Flex:" + match.group(1) + "\""
426 match = re_InsetLayout_CopyStyle.match(lines[i])
428 lines[i] = "\tCopyStyle Flex:" + match.group(1)
430 match = re_QInsetLayout_CopyStyle.match(lines[i])
432 lines[i] = "\tCopyStyle \"Flex:" + match.group(1) + "\""
437 if format >= 24 and format <= 27:
442 match = re_Float.match(lines[i])
446 # we need to do two things:
447 # (i) Convert Builtin to NeedsFloatPkg
448 # (ii) Write ListCommand lines for the builtin floats table and figure
451 while True and i < len(lines):
452 m1 = re_End.match(lines[i])
455 line = " ListCommand " + cmd
456 lines.insert(i, line)
459 m2 = re_Builtin.match(lines[i])
465 if re_True.match(arg):
469 lines[i] = ws1 + "NeedsFloatPkg " + newarg
470 m3 = re_Type.match(lines[i])
473 fltype = fltype.lower()
474 if fltype == "table":
476 elif fltype == "figure":
477 cmd = "listoffigures"
478 # else unknown, which is why we're doing this
482 # This just involved new features, not any changes to old ones
483 if format >= 14 and format <= 22:
487 # Rename I18NPreamble to BabelPreamble
489 match = re_I18nPreamble.match(lines[i])
491 lines[i] = match.group(1) + "BabelPreamble"
493 match = re_EndI18nPreamble.match(lines[i])
494 while i < len(lines) and not match:
496 match = re_EndI18nPreamble.match(lines[i])
497 lines[i] = match.group(1) + "EndBabelPreamble"
501 # These just involved new features, not any changes to old ones
502 if format == 11 or format == 12:
507 match = re_UseMod.match(lines[i])
509 module = match.group(1)
510 lines[i] = "DefaultModule " + module
515 match = re_Counter.match(lines[i])
519 while i < len(lines):
520 namem = re_Name.match(lines[i])
522 name = namem.group(1)
524 lines[counterline] = "Counter %s" % name
525 # we don't need to increment i
527 endem = re_End.match(lines[i])
536 # We want to scan for ams-type includes and, if we find them,
537 # add corresponding UseModule tags to the layout.
538 match = re_AMSMaths.match(lines[i])
540 addstring("theorems-ams", usemodules)
541 addstring("theorems-ams-extended", usemodules)
542 addstring("theorems-sec", usemodules)
545 match = re_AMSMathsPlain.match(lines[i])
547 addstring("theorems-starred", usemodules)
550 match = re_AMSMathsSeq.match(lines[i])
552 addstring("theorems-ams", usemodules)
553 addstring("theorems-ams-extended", usemodules)
559 # These just involved new features, not any changes to old ones
560 if format >= 5 and format <= 7:
565 # Handle conversion to long CharStyle names
566 match = re_CharStyle.match(lines[i])
568 lines[i] = "InsetLayout CharStyle:%s" % (match.group(3))
570 lines.insert(i, "\tLyXType charstyle")
573 lines[i] = "\tLabelString %s" % (match.group(3))
578 # convert 'providesamsmath x', 'providesmakeidx x', 'providesnatbib x', 'providesurl x' to
579 # 'provides amsmath x', 'provides makeidx x', 'provides natbib x', 'provides url x'
581 match = re_Provides.match(lines[i])
583 lines[i] = "%sProvides %s%s%s" % (match.group(1), match.group(2).lower(),
584 match.group(3), match.group(4))
591 # delete caption styles
592 match = re_Style.match(lines[i])
594 style = string.lower(match.group(4))
595 if style == "caption":
597 while i < len(lines) and not re_End.match(lines[i]):
598 caption.append(lines[i])
601 error('Incomplete caption style.')
606 # delete undefinition of caption styles
607 match = re_NoStyle.match(lines[i])
609 style = string.lower(match.group(4))
610 if style == "caption":
614 # replace the CopyStyle statement with the definition of the real
615 # style. This may result in duplicate statements, but that is OK
616 # since the second one will overwrite the first one.
617 match = re_CopyStyle.match(lines[i])
619 style = string.lower(match.group(4))
620 if style == "caption":
622 lines[i:i+1] = caption
624 # FIXME: This style comes from an include file, we
625 # should replace the real style and not this default.
626 lines[i:i+1] = [' Margin First_Dynamic',
627 ' LatexType Command',
628 ' LatexName caption',
634 ' AlignPossible Center',
635 ' LabelType Sensitive',
636 ' LabelString "Senseless!"',
645 # Delete MaxCounter and remember the value of it
646 match = re_MaxCounter.match(lines[i])
648 level = match.group(4)
649 if string.lower(level) == "counter_chapter":
651 elif string.lower(level) == "counter_section":
653 elif string.lower(level) == "counter_subsection":
655 elif string.lower(level) == "counter_subsubsection":
657 elif string.lower(level) == "counter_paragraph":
659 elif string.lower(level) == "counter_subparagraph":
661 elif string.lower(level) == "counter_enumi":
663 elif string.lower(level) == "counter_enumii":
665 elif string.lower(level) == "counter_enumiii":
672 # LabelType Counter_EnumI
679 match = re_LabelType.match(lines[i])
681 label = match.group(4)
682 # Remember indenting space for later reuse in added lines
683 space1 = match.group(1)
684 # Remember the line for adding the LabelCounter later.
685 # We can't do it here because it could shift latextype_line etc.
687 if string.lower(label[:8]) == "counter_":
688 counter = string.lower(label[8:])
689 lines[i] = re_LabelType.sub(r'\1\2\3Counter', lines[i])
691 # Remember the LabelString line
692 match = re_LabelString.match(lines[i])
694 labelstring = match.group(4)
697 # Remember the LabelStringAppendix line
698 match = re_LabelStringAppendix.match(lines[i])
700 labelstringappendix = match.group(4)
701 labelstringappendix_line = i
703 # Remember the LatexType line
704 match = re_LatexType.match(lines[i])
706 latextype = string.lower(match.group(4))
709 # Remember the TocLevel line
710 match = re_TocLevel.match(lines[i])
712 toclevel = string.lower(match.group(4))
714 # Reset variables at the beginning of a style definition
715 match = re_Style.match(lines[i])
717 style = string.lower(match.group(4))
723 labelstringappendix = ""
724 labelstring_line = -1
725 labelstringappendix_line = -1
730 if re_End.match(lines[i]):
732 # Add a line "LatexType Bib_Environment" if LabelType is Bibliography
733 # (or change the existing LatexType)
734 if string.lower(label) == "bibliography":
735 if (latextype_line < 0):
736 lines.insert(i, "%sLatexType Bib_Environment" % space1)
739 lines[latextype_line] = re_LatexType.sub(r'\1\2\3Bib_Environment', lines[latextype_line])
741 # Change "LabelType Static" to "LabelType Itemize" for itemize environments
742 if latextype == "item_environment" and string.lower(label) == "static":
743 lines[labeltype_line] = re_LabelType.sub(r'\1\2\3Itemize', lines[labeltype_line])
745 # Change "LabelType Counter_EnumI" to "LabelType Enumerate" for enumerate environments
746 if latextype == "item_environment" and string.lower(label) == "counter_enumi":
747 lines[labeltype_line] = re_LabelType.sub(r'\1\2\3Enumerate', lines[labeltype_line])
748 # Don't add the LabelCounter line later
753 # LabelString "Chapter"
757 # LabelString "Chapter \arabic{chapter}"
759 # if this style has a counter. Ditto for LabelStringAppendix.
760 # This emulates the hardcoded article style numbering of 1.3
763 if style in counters:
764 if labelstring_line < 0:
765 lines.insert(i, '%sLabelString "%s"' % (space1, counters[style]))
768 new_labelstring = concatenate_label(labelstring, counters[style])
769 lines[labelstring_line] = re_LabelString.sub(
770 r'\1\2\3%s' % new_labelstring.replace("\\", "\\\\"),
771 lines[labelstring_line])
772 if style in appendixcounters:
773 if labelstringappendix_line < 0:
774 lines.insert(i, '%sLabelStringAppendix "%s"' % (space1, appendixcounters[style]))
777 new_labelstring = concatenate_label(labelstring, appendixcounters[style])
778 lines[labelstringappendix_line] = re_LabelStringAppendix.sub(
779 r'\1\2\3%s' % new_labelstring.replace("\\", "\\\\"),
780 lines[labelstringappendix_line])
782 # Now we can safely add the LabelCounter line
783 lines.insert(labeltype_line + 1, "%sLabelCounter %s" % (space1, counter))
786 # Add the TocLevel setting for sectioning styles
787 if toclevel == "" and style in toclevels and maxcounter <= toclevels[style]:
788 lines.insert(i, '%s\tTocLevel %d' % (space1, toclevels[style]))
794 lines.insert(i, "Format 2")
797 for mod in usemodules:
798 lines.insert(i, "UseModule " + mod)
811 source = open(argv[1], 'rb')
812 output = open(argv[2], 'wb')
814 error(usage(argv[0]))
819 while (format < currentFormat):
820 format = convert(lines)
831 if __name__ == "__main__":