1 # file layout2layout.py
2 # This file is part of LyX, the document processor.
3 # Licence details can be found in the file COPYING.
7 # Full author contact details are available in file CREDITS
9 # This script will update a .layout file to current format
11 # The latest layout format is also defined in src/TextClass.cpp
15 # Incremented to format 4, 6 April 2007, lasgouttes
16 # Introduction of generic "Provides" declaration
18 # Incremented to format 5, 22 August 2007 by vermeer
19 # InsetLayout material
21 # Incremented to format 6, 7 January 2008 by spitz
22 # Requires tag added to layout files
24 # Incremented to format 7, 24 March 2008 by rgh
25 # AddToPreamble tag added to layout files
27 # Incremented to format 8, 25 July 2008 by rgh
28 # UseModule tag added to layout files
29 # CopyStyle added to InsetLayout
31 # Incremented to format 9, 5 October 2008 by rgh
32 # ForcePlain and CustomPars tags added to InsetLayout
34 # Incremented to format 10, 6 October 2008 by rgh
35 # Change format of counters
37 # Incremented to format 11, 14 October 2008 by rgh
38 # Add ProvidesModule, ExcludesModule tags
40 # Incremented to format 12, 10 January 2009 by gb
41 # Add I18NPreamble tag
43 # Incremented to format 13, 5 February 2009 by rgh
44 # Add InToc tag for InsetLayout
46 # Incremented to format 14, 14 February 2009 by gb
47 # Rename I18NPreamble to BabelPreamble and add LangPreamble
49 # Incremented to format 15, 28 May 2009 by lasgouttes
50 # Add new tag OutputFormat; modules can be conditioned on feature
53 # Incremented to format 16, 5 June 2009 by rgh
54 # Add new tags for Text Class:
55 # HTMLPreamble, HTMLAddToPreamble
57 # HTMLTag, HTMLAttr, HTMLLabel, HTMLLabelAttr, HTMLItem, HTMLItemAttr
58 # HTMLStyle, and HTMLPreamble
60 # HTMLTag, HTMLAttr, HTMLStyle, and HTMLPreamble
62 # HTMLType, HTMLClass, HTMLStyle
64 # Incremented to format 17, 12 August 2009 by rgh
65 # Add IfStyle and IfCounter tags for layout.
67 # Incremented to format 18, 27 October 2009 by rgh
68 # Added some new tags for HTML output.
70 # Incremented to format 19, 17 November 2009 by rgh
71 # Added InPreamble tag.
73 # Incremented to format 20, 17 December 2009 by rgh
74 # Added ContentAsLabel tag.
76 # Incremented to format 21, 12 January 2010 by rgh
77 # Added HTMLTocLayout and HTMLTitle tags.
79 # Incremented to format 22, 20 January 2010 by rgh
80 # Added HTMLFormat tag to Counters.
82 # Incremented to format 23, 13 February 2010 by spitz
83 # Added Spellcheck tag.
85 # Incremented to format 24, 5 March 2010 by rgh
86 # Changed LaTeXBuiltin tag to NeedsFloatPkg and
87 # added new tag ListCommand.
89 # Incremented to format 25, 12 March 2010 by rgh
90 # Added RefPrefix tag for layouts and floats.
92 # Incremented to format 26, 29 March 2010 by rgh
95 # Incremented to format 27, 4 June 2010 by rgh
96 # Added RequiredArgs tag.
98 # Incremented to format 28, 6 August 2010 by lasgouttes
99 # Added ParbreakIsNewline tag for Layout and InsetLayout.
101 # Incremented to format 29, 10 August 2010 by rgh
102 # Changed Custom:Style, CharStyle:Style, and Element:Style
103 # uniformly to Flex:Style.
105 # Incremented to format 30, 13 August 2010 by rgh
106 # Introduced ResetsFont tag for InsetLayout.
108 # Incremented to format 31, 12 January 2011 by rgh
109 # Introducted NoCounter tag.
111 # Incremented to format 32, 30 January 2011 by forenr
112 # Added Display tag for InsetLayout
114 # Incremented to format 33, 2 February 2011 by rgh
115 # Changed NeedsFloatPkg to UsesFloatPkg
117 # Incremented to format 34, 28 March 2011 by rgh
118 # Remove obsolete Fill_(Top|Bottom) tags
120 # Incremented to format 35, 28 March 2011 by rgh
121 # Try to add "Flex:" to any flex insets that don't have it.
123 # Incremented to format 36, 7 December 2011, by rgh
124 # Added HTMLStyles and AddToHTMLStyles tags.
126 # Incremented to format 37, 29 February 2012 by jrioux
127 # Implement the citation engine machinery in layouts.
128 # Change CiteFormat to CiteFormat (default|authoryear|numerical).
130 # Incremented to format 38, 08 April 2012 by gb
131 # Introduce LangPreamble and BabelPreamble for InsetLayout.
133 # Incremented to format 39, 15 April 2012 by sanda
134 # Introduce styling of branches via "InsetLayout Branch:".
136 # Incremented to format 40, 10 October 2012 by rgh
137 # Re-do layout names for layout categories
139 # Incremented to format 41, 20 November 2012 by spitz
140 # New Argument syntax
142 # Incremented to format 42, 22 December 2012 by spitz
143 # New Style tag "ItemCommand"
145 # Incremented to format 43, 30 December 2012 by spitz
146 # Extended InsetCaption format
148 # Incremented to format 44, 9 February 2013 by rgh
149 # Remove COUNTER label style; rename as STATIC
150 # Rename TOP_ENVIRONMENT to ABOVE and CENTERED_TOP_ENVIRONMENT to CENTERED
152 # Incremented to format 45, 12 February 2013 by rgh
153 # New Tag "NoInsetLayout"
155 # Incremented to format 46, 15 May 2013 by gb
156 # New Tag "ForceLocal"
158 # Incremented to format 47, 23 May 2013 by rgh
159 # Add PackageOptions tag
161 # Incremented to format 48, 31 May 2013 by rgh
162 # Add InitialValue tag for counters
164 # Incremented to format 49, 10 Feb 2014 by gb
165 # Change default of "ResetsFont" tag to false
167 # Incremented to format 50, 9 May 2014 by forenr
168 # Removal of "Separator" layouts
170 # Incremented to format 51, 29 May 2014 by spitz
171 # New Style tag "ToggleIndent"
173 # Incremented to format 52, 1 December 2014 by spitz
174 # New InsetLayout tag "ForceOwnlines"
176 # Incremented to format 53, 7 December 2014 by spitz
177 # New InsetLayout tag "ObsoletedBy"
179 # Incremented to format 54, 11 Jan 2014 by gb
180 # New InsetLayout tag "FixedWidthPreambleEncoding"
182 # Incremented to format 55, 20 April 2015 by spitz
183 # New InsetLayout and Layout tags "PassThruChars"
185 # Incremented to format 56, 20 May 2015 by spitz
186 # New Float tags "AllowedPlacement", "AllowsWide", "AllowsSideways"
188 # Incremented to format 57, 30 May 2015 by spitz
189 # New Layout tag "ParagraphGroup"
191 # Incremented to format 58, 5 December 2015, by rgh
192 # New Layout tag "ProvideStyle"
193 # Change "IfStyle" to "ModifyStyle"
195 # Incremented to format 59, 22 November 2015 by gm
196 # New Tag "OutlinerName"
197 # New Layout tags "AddToToc", "IsTocCaption"
198 # New Layout argument tag "IsTocCaption"
200 # Incremented to format 60, 25 March 2016 by lasgouttes
201 # Rename caption subtype LongTableNoNumber to Unnumbered
203 # Incremented to format 61, 14 October 2016 by spitz
204 # New Layout tags "ResumeCounter", "StepMasterCounter"
206 # Incremented to format 62, 21 October 2016 by spitz
207 # New Layout argument tag "PassThru"
209 # Incremented to format 63, 7 January 2017 by spitz
210 # - New textclass tags CiteFramework, MaxCiteNames (for cite engines)
211 # - Extended InsetCite syntax.
213 # Incremented to format 64, 30 August 2017 by rgh
214 # Strip leading and trailing spaces from LabelString,
215 # LabelStringAppendix, and EndLabelString, and LabelCounter,
216 # to conform to what we used to do.
218 # Incremented to format 65, 16 October 2017 by spitz
219 # Color collapsable -> collapsible
221 # Incremented to format 66, 28 December 2017 by spitz
222 # New Layout tags "AutoNests ... EndAutoNests" and
223 # "IsAutoNestedBy ... EndIsAutoNestedBy"
225 # Incremented to format 67, 14 April 2018 by spitz
226 # New Layout tag "NeedsCProtect"
228 # Incremented to format 68, 21 May 2018 by spitz
229 # New Layout tag "AddToCiteEngine"
231 # Incremented to format 69, 16 August 2018 by spitz
232 # New argument type "listpreamble"
234 # Incremented to format 70, 5 June 2018 by rkh
235 # New InsetLayout tag EditExternal
237 # Incremented to format 71, 12 March 2019 by spitz
238 # New [Inset]Layout tag NeedMBoxProtect
240 # Incremented to format 72, 26 March 2019 by spitz
241 # New TextClass tag TableStyle
243 # Incremented to format 73, 18 April 2019 by spitz
244 # New InsetLayout tag MenuString
246 # Incremented to format 74, 18 April 2019 by spitz
247 # New InsetLayout and Argument tag NewlineCmd
249 # Incremented to format 75, 2 June 2019 by spitz
250 # New Argument tags FreeSpacing, InsertOnNewline
251 # New InsetLayout tag ParbreakIgnored
253 # Incremented to format 76, 8 July 2019 by spitz
254 # New textclass tag BibInToc
256 # Incremented to format 77, 6 August 2019 by spitz
257 # New textclass tag PageSize (= default page size)
258 # and textclass option PageSize (= list of available page sizes)
260 # Incremented to format 78, 6 August 2019 by spitz
261 # New textclass tag FontsizeFormat
263 # Incremented to format 79, 7 August 2019 by spitz
264 # New textclass tag PagesizeFormat
266 # Incremented to format 80, 12 August 2019 by spitz
267 # New float option Requires
269 # Incremented to format 81, 12 August 2019 by rikiheck
270 # New tag GuiName for counters
272 # Incremented to format 82, 4 June 2017 by tcuvelier
273 # - Add new tags for Layout:
274 # DocBookTag, DocBookAttr, DocBookInInfo,
275 # DocBookWrapperTag, DocBookWrapperAttr,
276 # DocBookItemWrapperTag, DocBookItemWrapperAttr,
277 # DocBookItemTag, DocBookItemAttr,
278 # DocBookLabelTag, DocBookLabelAttr
279 # - Removed tag Header from ClassOptionsClassOptions
280 # - Removed tag Element for flex insets
282 # Incremented to format 83, 2 August 2020 by tcuvelier
283 # New tags DocBookWrapperMergeWithPrevious and DocBookAbstract
285 # Incremented to format 84, 17 August 2020 by tcuvelier
286 # New tags DocBookTagType, DocBookWrapperTagTagType,
287 # DocBookItemWrapperTagTagType, DocBookItemTagTagType,
290 # Incremented to format 85, 7 October 2020 by tcuvelier
291 # New tags DocBookInnerTag, DocBookInnerAttr,
292 # DocBookInnerTagType
294 # Incremented to format 86, 20 October 2020 by tcuvelier
295 # New tag DocBookSection.
297 # Incremented to format 87, 2 November 2020 by rkh
299 # Incremented to format 88, 28 November 2020 by tcuvelier
300 # New tag DocBookNotInPara.
302 # Incremented to format 89, 5 December 2020 by rkh
303 # New tag LaTeXName for counters
305 # Incremented to format 90, 11 December 2020 by spitz
306 # Use semantic label colors
308 # Incremented to format 91, 25 January 2021 by spitz
311 # Incremented to format 92, 30 January 2021 by spitz
312 # Add ProvideInsetLayout and ModifyInsetLayout
314 # Incremented to format 93, 13 February 2021 by spitz
315 # Add DocBookNoFontInside
317 # Incremented to format 94, 19 September 2021 by tcuvelier
318 # Add DocBookFloatType, DocBookCaption
320 # Incremented to format 95, 27 September 2021 by tcuvelier
321 # Add DocBookRenderAsImage
323 # Incremented to format 96, 4 December 2022 by rikiheck
326 # Incremented to format 97, 4 December 2022 by rikiheck
329 # Incremented to format 98, 5 December 2022 by rikiheck
330 # Add HTMLClass for InsetLayout
332 # Incremented to format 99, 22 December 2022 by tcuvelier
333 # Add DocBookGenerateTitle for Layout
335 # Incremented to format 100, 9 May 2023 by forenr
336 # Add inset label color
338 # Incremented to format 101, 22 July 2023 by lasgouttes
339 # add InsetLayout tag InheritFont
341 # Incremented to format 102, 25 July 2023 by spitz
342 # add InsetLayout tags AllowedInInsets, EndAllowedInInsets,
343 # AllowedInLayouts, EndAllowedInLayouts, AllowedOccurrences,
344 # AllowedOccurrencesPerItem
346 # Incremented to format 103, 27 July 2023 by rikiheck
347 # Allow e.g. \roman{section} in PrettyFormat
349 # Incremented to format 104, 28 July 2023 by rikiheck
350 # RefFormat for counters and PrettyFormat for floats
352 # Incremented to format 105, 2 June 2024 by spitz
353 # ParskipFull and ParskipHalf class options
355 # Do not forget to document format change in Customization
356 # Manual (section "Declaring a new text class").
358 # You might also want to consider running the
359 # development/tools/updatelayouts.py script to update all
360 # layout files to the new format.
368 sys.stderr.write(message + '\n')
373 " Remove byte order mark."
374 if line[0:3] == b"\357\273\277":
381 " Read input file and strip lineendings."
382 lines = source.read().splitlines() or ['']
383 lines[0] = trim_bom(lines[0])
387 def write(output, lines):
388 " Write output file with native lineendings."
389 output.write(os.linesep.encode('ascii').join(lines)
390 + os.linesep.encode('ascii'))
393 # Concatenates old and new in an intelligent way:
394 # If old is wrapped in ", they are stripped. The result is wrapped in ".
395 def concatenate_label(old, new):
396 # Don't use strip as long as we support python 1.5.2
398 return old[0:-1] + new + b'"'
400 return b'"' + old + new + b'"'
403 # appends a string to a list unless it's already there
410 def convert(lines, end_format):
411 " Convert to new format."
412 re_Comment = re.compile(b'^(\\s*)#')
413 re_Counter = re.compile(b'\\s*Counter\\s*', re.IGNORECASE)
414 re_Name = re.compile(b'\\s*Name\\s+(\\S+)\\s*', re.IGNORECASE)
415 re_UseMod = re.compile(b'^\\s*UseModule\\s+(.*)', re.IGNORECASE)
416 re_Empty = re.compile(b'^(\\s*)$')
417 re_Format = re.compile(b'^(\\s*)(Format)(\\s+)(\\S+)', re.IGNORECASE)
418 re_Preamble = re.compile(b'^(\\s*)Preamble', re.IGNORECASE)
419 re_EndPreamble = re.compile(b'^(\\s*)EndPreamble', re.IGNORECASE)
420 re_LangPreamble = re.compile(b'^(\\s*)LangPreamble', re.IGNORECASE)
421 re_EndLangPreamble = re.compile(b'^(\\s*)EndLangPreamble', re.IGNORECASE)
422 re_BabelPreamble = re.compile(b'^(\\s*)BabelPreamble', re.IGNORECASE)
423 re_EndBabelPreamble = re.compile(b'^(\\s*)EndBabelPreamble', re.IGNORECASE)
424 re_MaxCounter = re.compile(b'^(\\s*)(MaxCounter)(\\s+)(\\S+)', re.IGNORECASE)
425 re_LabelType = re.compile(b'^(\\s*)(LabelType)(\\s+)(\\S+)', re.IGNORECASE)
426 re_LabelString = re.compile(b'^(\\s*)(LabelString)(\\s+)(("[^"]+")|(\\S+))', re.IGNORECASE)
427 re_LabelStringAppendix = re.compile(b'^(\\s*)(LabelStringAppendix)(\\s+)(("[^"]+")|(\\S+))', re.IGNORECASE)
428 re_LatexType = re.compile(b'^(\\s*)(LatexType)(\\s+)(\\S+)', re.IGNORECASE)
429 re_Style = re.compile(b'^(\\s*)(Style)(\\s+)(\\S+)', re.IGNORECASE)
430 re_IfStyle = re.compile(b'^(\\s*)IfStyle(\\s+\\S+)', re.IGNORECASE)
431 re_CopyStyle = re.compile(b'^(\\s*)(CopyStyle)(\\s+)(\\S+)', re.IGNORECASE)
432 re_NoStyle = re.compile(b'^(\\s*)(NoStyle)(\\s+)(\\S+)', re.IGNORECASE)
433 re_End = re.compile(b'^(\\s*)(End)(\\s*)$', re.IGNORECASE)
434 re_Provides = re.compile(b'^(\\s*)Provides(\\S+)(\\s+)(\\S+)', re.IGNORECASE)
435 re_CharStyle = re.compile(b'^(\\s*)CharStyle(\\s+)(\\S+)$', re.IGNORECASE)
436 re_CiteFormat = re.compile(b'^(\\s*)(CiteFormat)(?:(\\s*)()|(\\s+)(default|authoryear|numerical))', re.IGNORECASE)
437 re_AMSMaths = re.compile(b'^\\s*Input ams(?:math|def)s.inc\\s*')
438 re_AMSMathsPlain = re.compile(b'^\\s*Input amsmaths-plain.inc\\s*')
439 re_AMSMathsSeq = re.compile(b'^\\s*Input amsmaths-seq.inc\\s*')
440 re_TocLevel = re.compile(b'^(\\s*)(TocLevel)(\\s+)(\\S+)', re.IGNORECASE)
441 re_I18nPreamble = re.compile(b'^(\\s*)I18nPreamble', re.IGNORECASE)
442 re_EndI18nPreamble = re.compile(b'^(\\s*)EndI18nPreamble', re.IGNORECASE)
443 re_Float = re.compile(b'^\\s*Float\\s*$', re.IGNORECASE)
444 re_Type = re.compile(b'\\s*Type\\s+(\\w+)', re.IGNORECASE)
445 re_Builtin = re.compile(b'^(\\s*)LaTeXBuiltin\\s+(\\w*)', re.IGNORECASE)
446 re_True = re.compile(b'^\\s*(?:true|1)\\s*$', re.IGNORECASE)
447 re_InsetLayout = re.compile(b'^\\s*InsetLayout\\s+(?:Custom|CharStyle|Element):(\\S+)\\s*$', re.IGNORECASE)
448 re_ResetsFont = re.compile(b'^(\\s*)ResetsFont(\\s+)(\\S+)$', re.IGNORECASE)
450 re_QInsetLayout = re.compile(b'^\\s*InsetLayout\\s+"(?:Custom|CharStyle|Element):([^"]+)"\\s*$', re.IGNORECASE)
451 re_InsetLayout_CopyStyle = re.compile(b'^\\s*CopyStyle\\s+(?:Custom|CharStyle|Element):(\\S+)\\s*$', re.IGNORECASE)
452 re_QInsetLayout_CopyStyle = re.compile(b'^\\s*CopyStyle\\s+"(?:Custom|CharStyle|Element):([^"]+)"\\s*$', re.IGNORECASE)
453 re_NeedsFloatPkg = re.compile(b'^(\\s*)NeedsFloatPkg\\s+(\\w+)\\s*$', re.IGNORECASE)
454 re_Fill = re.compile(b'^\\s*Fill_(?:Top|Bottom).*$', re.IGNORECASE)
455 re_InsetLayout2 = re.compile(b'^\\s*InsetLayout\\s+(\\S+)\\s*$', re.IGNORECASE)
457 re_QInsetLayout2 = re.compile(b'^\\s*InsetLayout\\s+"([^"]+)"\\s*$', re.IGNORECASE)
458 re_IsFlex = re.compile(b'\\s*LyXType.*$', re.IGNORECASE)
459 re_CopyStyle2 = re.compile(b'(\\s*CopyStyle\\s+)"?([^"]+)"?\\s*$')
460 re_Separator = re.compile(b'^(?:(-*)|(\\s*))(Separator|EndOfSlide)(?:(-*)|(\\s*))$', re.IGNORECASE)
462 re_ExtractCategory = re.compile(b'^(#\\s*\\Declare\\w+Class(?:\\[[^]]*?\\])?){([^(]+?)\\s+\\(([^)]+?)\\)\\s*}\\s*$')
463 ConvDict = {b"article": b"Articles", b"book": b"Books", b"letter": b"Letters", b"report": b"Reports",
464 b"presentation": b"Presentations", b"curriculum vitae": b"Curricula Vitae", b"handout": b"Handouts"}
466 re_OptArgs = re.compile(b'^(\\s*)OptionalArgs(\\s+)(\\d+)\\D*$', re.IGNORECASE)
467 re_ReqArgs = re.compile(b'^(\\s*)RequiredArgs(\\s+)(\\d+)\\D*$', re.IGNORECASE)
469 # various changes associated with changing how chapters are handled
470 re_LabelTypeIsCounter = re.compile(b'^(\\s*)LabelType(\\s*)Counter\\s*$', re.IGNORECASE)
471 re_TopEnvironment = re.compile(b'^(\\s*)LabelType(\\s+)Top_Environment\\s*$', re.IGNORECASE)
472 re_CenteredEnvironment = re.compile(b'^(\\s*)LabelType(\\s+)Centered_Top_Environment\\s*$', re.IGNORECASE)
473 re_ChapterStyle = re.compile(b'^\\s*Style\\s+Chapter\\s*$', re.IGNORECASE)
474 re_InsetLayout_CaptionLTNN = re.compile(b'^(\\s*InsetLayout\\s+)(Caption:LongTableNonumber)', re.IGNORECASE)
476 re_trimLabelString = re.compile(b'^(\\s*LabelString\\s+)"\\s*(.*?)\\s*"\\s*$')
477 re_trimLabelStringAppendix = re.compile(b'^(\\s*LabelStringAppendix\\s+)"\\s*(.*?)\\s*"\\s*$')
478 re_trimEndLabelString = re.compile(b'^(\\s*EndLabelString\\s+)"\\s*(.*?)\\s*"\\s*$')
479 re_trimLabelCounter = re.compile(b'^(\\s*LabelCounter\\s+)"\\s*(.*?)\\s*"\\s*$')
481 re_InsetLayout100 = re.compile(b'^\\s*InsetLayout\\s+\\"?(Box|Float|Foot|Marginal|Listings|Note:Comment|Note:Greyedout|Tabular)(:\\S*)?\\"?\\s*$', re.IGNORECASE)
482 re_InheritFont = re.compile(b'^(\\s*)InheritFont(\\s+)(\\S+)$', re.IGNORECASE)
483 # counters for sectioning styles (hardcoded in 1.3)
484 counters = {b"part" : b"\\Roman{part}",
485 b"chapter" : b"\\arabic{chapter}",
486 b"section" : b"\\arabic{section}",
487 b"subsection" : b"\\arabic{section}.\\arabic{subsection}",
488 b"subsubsection" : b"\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}",
489 b"paragraph" : b"\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}",
490 b"subparagraph" : b"\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}.\\arabic{subparagraph}"}
492 # counters for sectioning styles in appendix (hardcoded in 1.3)
493 appendixcounters = {b"chapter" : b"\\Alph{chapter}",
494 b"section" : b"\\Alph{section}",
495 b"subsection" : b"\\arabic{section}.\\arabic{subsection}",
496 b"subsubsection" : b"\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}",
497 b"paragraph" : b"\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}",
498 b"subparagraph" : b"\\arabic{section}.\\arabic{subsection}.\\arabic{subsubsection}.\\arabic{paragraph}.\\arabic{subparagraph}"}
500 # Value of TocLevel for sectioning styles
501 toclevels = {b"part" : -1,
505 b"subsubsection" : 3,
516 labelstring_line = -1
517 labelstringappendix_line = -1
530 # Whether a style is inherited (works only for CopyStyle currently,
531 # not for true inherited styles, see bug 8920
532 inherited = False # only used for 48 -> 49
534 while i < len(lines):
535 # Skip comments and empty lines
536 if (re_Comment.match(lines[i]) or re_Empty.match(lines[i])):
537 # We need to deal with this conversion here, because it happens
538 # inside the initial comment block.
539 if only_comment and format == 39:
540 match = re_ExtractCategory.match(lines[i])
542 lpre = match.group(1)
543 lcat = match.group(2)
544 lnam = match.group(3)
546 lcat = ConvDict[lcat]
547 lines[i] = lpre + b"{" + lnam + b"}"
548 lines.insert(i+1, b"# \\DeclareCategory{" + lcat + b"}")
553 # insert file format if not already there
555 match = re_Format.match(lines[i])
558 format_ = int(match.group(4))
559 if 1 < format_ < end_format:
560 lines[i] = b"Format %d" % (format_ + 1)
562 elif format_ == end_format:
566 error(f'Cannot convert file format {format_} to {end_format}')
568 lines.insert(i, b"Format 2")
572 # Don't get confused by LaTeX code
573 if re_Preamble.match(lines[i]):
575 while i < len(lines) and not re_EndPreamble.match(lines[i]):
578 if re_LangPreamble.match(lines[i]):
580 while i < len(lines) and not re_EndLangPreamble.match(lines[i]):
583 if re_BabelPreamble.match(lines[i]):
585 while i < len(lines) and not re_EndBabelPreamble.match(lines[i]):
589 if 101 <= format <= 104:
595 # InheritFont has been introduced and defaults to true. Some insets had
596 # an hardcoded inheritFont') method returning true. We removed them, so
597 # we want to introduce the correct tag if it is not already there.
598 match = re_InsetLayout100.match(lines[i])
603 inheritfont_found = False
605 while i < len(lines):
606 match = re_InheritFont.match(lines[i])
608 inheritfont_found = True
610 match = re_CopyStyle.match(lines[i])
614 match = re_End.match(lines[i])
618 if not inheritfont_found and not inherited:
619 lines.insert(i, b"\tInheritFont false")
623 if 87 <= format <= 99:
629 if lines[i].lstrip().lower().startswith(b"stepmastercounter"):
630 pattern = re.compile(b"stepmastercounter", re.IGNORECASE)
631 lines[i] = pattern.sub(b"StepParentCounter", lines[i])
635 if 82 <= format <= 85:
641 match = re.compile(b'^(\\s*Header\\s+)("?\\w+"?)', re.IGNORECASE).match(lines[i])
646 match = re.compile(b'(\\s*LyXType\\s+)(\\w+)(\\s*Element\\s+)', re.IGNORECASE).match(lines[i])
654 if 65 <= format <= 80:
660 match = re.compile(b'(\\s*Color\\s+)(\\w+)', re.IGNORECASE).match(lines[i])
665 if col == "collapsable":
666 lines[i] = match.group(1) + b"collapsible"
671 for r in (re_trimLabelString, re_trimLabelStringAppendix,\
672 re_trimEndLabelString, re_trimLabelCounter):
673 m = r.match(lines[i])
675 lines[i] = m.group(1) + b'"' + m.group(2) + b'"'
679 if 60 <= format <= 62:
685 match = re_InsetLayout_CaptionLTNN.match(lines[i])
689 # '^(\s*InsetLayout\s+)(Caption:LongTableNonumber)'
690 lead = match.group(1)
691 lines[i] = lead + b"Caption:Unnumbered"
701 match = re_IfStyle.match(lines[i])
705 # b'^(\\s*)IfStyle(\\s+\\S+)
706 lead = match.group(1)
707 trail = match.group(2)
708 lines[i] = lead + b"ModifyStyle" + trail
712 if 50 <= format <= 56:
720 # delete separator styles
721 match = re_Style.match(lines[i])
723 style = match.group(4).lower()
724 if re_Separator.match(style):
726 while i < len(lines) and not re_End.match(lines[i]):
727 separator.append(lines[i])
730 error('Incomplete separator style.')
735 # delete undefinition of separator styles
736 match = re_NoStyle.match(lines[i])
738 style = match.group(4).lower()
739 if re_Separator.match(style):
743 # replace the CopyStyle statement with the definition of the real
744 # style. This may result in duplicate statements, but that is OK
745 # since the second one will overwrite the first one.
746 match = re_CopyStyle.match(lines[i])
748 style = match.group(4).lower()
749 if re_Separator.match(style):
750 if len(separator) > 0:
751 lines[i:i+1] = separator
753 # FIXME: If this style was redefined in an include file,
754 # we should replace the real style and not this default.
755 lines[i:i+1] = [b' Category MainText',
758 b' LatexType Paragraph',
762 b' LabelType Static',
763 b' LabelString "--- Separate Environment ---"',
775 # The default of ResetsFont in LyX changed from true to false,
776 # because it is now used for all InsetLayouts, not only flex ones.
777 # Therefore, we need to set it to true for all flex insets which do
778 # not already have a ResetsFont.
779 match = re_InsetLayout2.match(lines[i])
784 name = match.group(1).lower()
785 if name != b"flex" and name != b"\"flex\"" and name[0:5] != b"flex:" and name [0:6] != b"\"flex:":
789 resetsfont_found = False
791 while i < len(lines):
792 match = re_ResetsFont.match(lines[i])
794 resetsfont_found = True
796 match = re_CopyStyle.match(lines[i])
800 match = re_End.match(lines[i])
804 if not resetsfont_found and not inherited:
805 lines.insert(i, b"\tResetsFont true")
809 if 44 <= format <= 47:
815 match = re_LabelTypeIsCounter.match(lines[i])
818 lines[i] = match.group(1) + b"LabelType" + match.group(2) + b"Above"
820 lines[i] = match.group(1) + b"LabelType" + match.group(2) + b"Static"
822 match = re_TopEnvironment.match(lines[i])
824 lines[i] = match.group(1) + b"LabelType" + match.group(2) + b"Above"
826 match = re_CenteredEnvironment.match(lines[i])
828 lines[i] = match.group(1) + b"LabelType" + match.group(2) + b"Centered"
831 match = re_Style.match(lines[i])
835 match = re_ChapterStyle.match(lines[i])
843 if lines[i] == b"InsetLayout Caption":
844 lines[i] = b"InsetLayout Caption:Standard"
854 # reset counters on Style beginning
855 match = re_Style.match(lines[i])
861 match = re_OptArgs.match(lines[i])
863 # Save number of optional arguments
864 space1 = match.group(1)
865 opts = int(match.group(3))
866 # OptionalArgs 0 > ResetArgs 1
868 lines[i] = space1 + b"ResetArgs\t1"
873 match = re_ReqArgs.match(lines[i])
875 # Save number of required arguments
876 space1 = match.group(1)
877 reqs = int(match.group(3))
880 # Insert the required number of arguments at the end of the style definition
881 match = re_End.match(lines[i])
884 # First the optionals (this is the required order pre 2.1)
887 newarg = [ b'%sArgument 1' % (space1),
888 b'%s\tLabelString\t\"Optional Layout Argument\"' % (space1),
889 b'%sEndArgument' % (space1)]
892 while actopt < (opts + 1):
893 newarg += [ b'%sArgument %d' % (space1, actopt),
894 b'%s\tLabelString\t\"Optional Layout Argument %d\"' % (space1, actopt),
895 b'%sEndArgument' % (space1)]
897 # Now the mandatories
900 while actopt < opts + reqs + 1:
901 newarg += [ b'%sArgument %d' % (space1, actopt),
902 b'%s\tLabelString\t"Required Layout Argument %d"' % (space1, actopt - opts),
903 b'%s\tMandatory\t1' % (space1),
904 b'%sEndArgument' % (space1)]
906 # Since we replace the "End" line, re-add this line
909 lines[i:i+1] = newarg
918 # There is a conversion with format 40, but it is done within the
919 # initial comment block and so is above.
923 if format == 37 or format == 38:
928 match = re_CiteFormat.match(lines[i])
929 if match and match.group(4) == b"":
930 lines[i] = match.group(0) + b" default"
939 match = re_QInsetLayout2.match(lines[i])
941 match = re_InsetLayout2.match(lines[i])
943 match = re_CopyStyle2.match(lines[i])
947 style = match.group(2)
949 if flexstyles.count(style):
950 lines[i] = match.group(1) + b"\"Flex:" + style + b"\""
954 name = match.group(1)
955 names = name.split(b":", 1)
956 if len(names) > 1 and names[0] == b"Flex":
961 for j in range(i + 1, len(lines)):
962 if re_IsFlex.match(lines[j]):
965 if re_End.match(lines[j]):
969 flexstyles.append(name)
970 lines[i] = b"InsetLayout \"Flex:" + name + b"\""
976 m = re_Fill.match(lines[i])
983 match = re_NeedsFloatPkg.match(lines[i])
985 space = match.group(1)
987 lines[i] = space + b"UsesFloatPkg " + val
989 if val == b'1' or val.lower() == b'true':
991 lines.insert(i, space + b"IsPredefined " + newval)
997 if 29 <= format <= 31:
1002 match = re_InsetLayout.match(lines[i])
1004 lines[i] = b"InsetLayout Flex:" + match.group(1)
1006 match = re_QInsetLayout.match(lines[i])
1008 lines[i] = b"InsetLayout \"Flex:" + match.group(1) + b"\""
1010 match = re_InsetLayout_CopyStyle.match(lines[i])
1012 lines[i] = b"\tCopyStyle Flex:" + match.group(1)
1014 match = re_QInsetLayout_CopyStyle.match(lines[i])
1016 lines[i] = b"\tCopyStyle \"Flex:" + match.group(1) + b"\""
1021 if 24 <= format <= 27:
1026 match = re_Float.match(lines[i])
1030 # we need to do two things:
1031 # (i) Convert Builtin to NeedsFloatPkg
1032 # (ii) Write ListCommand lines for the builtin floats table and figure
1035 while True and i < len(lines):
1036 m1 = re_End.match(lines[i])
1039 line = b" ListCommand " + cmd
1040 lines.insert(i, line)
1043 m2 = re_Builtin.match(lines[i])
1049 if re_True.match(arg):
1053 lines[i] = ws1 + b"NeedsFloatPkg " + newarg
1054 m3 = re_Type.match(lines[i])
1056 fltype = m3.group(1)
1057 fltype = fltype.lower()
1058 if fltype == b"table":
1059 cmd = b"listoftables"
1060 elif fltype == b"figure":
1061 cmd = b"listoffigures"
1062 # else unknown, which is why we're doing this
1066 # This just involved new features, not any changes to old ones
1067 if 14 <= format <= 22:
1071 # Rename I18NPreamble to BabelPreamble
1073 match = re_I18nPreamble.match(lines[i])
1075 lines[i] = match.group(1) + b"BabelPreamble"
1077 match = re_EndI18nPreamble.match(lines[i])
1078 while i < len(lines) and not match:
1080 match = re_EndI18nPreamble.match(lines[i])
1081 lines[i] = match.group(1) + b"EndBabelPreamble"
1085 # These just involved new features, not any changes to old ones
1086 if format == 11 or format == 12:
1091 match = re_UseMod.match(lines[i])
1093 module = match.group(1)
1094 lines[i] = b"DefaultModule " + module
1099 match = re_Counter.match(lines[i])
1103 while i < len(lines):
1104 namem = re_Name.match(lines[i])
1106 name = namem.group(1)
1108 lines[counterline] = b"Counter %s" % name
1109 # we don't need to increment i
1111 endem = re_End.match(lines[i])
1120 # We want to scan for ams-type includes and, if we find them,
1121 # add corresponding UseModule tags to the layout.
1122 match = re_AMSMaths.match(lines[i])
1124 addstring(b"theorems-ams", usemodules)
1125 addstring(b"theorems-ams-extended", usemodules)
1126 addstring(b"theorems-sec", usemodules)
1129 match = re_AMSMathsPlain.match(lines[i])
1131 addstring(b"theorems-starred", usemodules)
1134 match = re_AMSMathsSeq.match(lines[i])
1136 addstring(b"theorems-ams", usemodules)
1137 addstring(b"theorems-ams-extended", usemodules)
1143 # These just involved new features, not any changes to old ones
1144 if 5 <= format <= 7:
1149 # Handle conversion to long CharStyle names
1150 match = re_CharStyle.match(lines[i])
1152 lines[i] = b"InsetLayout CharStyle:%s" % (match.group(3))
1154 lines.insert(i, b"\tLyXType charstyle")
1156 lines.insert(i, b"")
1157 lines[i] = b"\tLabelString %s" % (match.group(3))
1162 # convert 'providesamsmath x', 'providesmakeidx x', 'providesnatbib x', 'providesurl x' to
1163 # 'provides amsmath x', 'provides makeidx x', 'provides natbib x', 'provides url x'
1164 # x is either 0 or 1
1165 match = re_Provides.match(lines[i])
1167 lines[i] = b"%sProvides %s%s%s" % (match.group(1), match.group(2).lower(),
1168 match.group(3), match.group(4))
1175 # delete caption styles
1176 match = re_Style.match(lines[i])
1178 style = match.group(4).lower()
1179 if style == b"caption":
1181 while i < len(lines) and not re_End.match(lines[i]):
1182 caption.append(lines[i])
1185 error('Incomplete caption style.')
1190 # delete undefinition of caption styles
1191 match = re_NoStyle.match(lines[i])
1193 style = match.group(4).lower()
1194 if style == b"caption":
1198 # replace the CopyStyle statement with the definition of the real
1199 # style. This may result in duplicate statements, but that is OK
1200 # since the second one will overwrite the first one.
1201 match = re_CopyStyle.match(lines[i])
1203 style = match.group(4).lower()
1204 if style == b"caption":
1205 if len(caption) > 0:
1206 lines[i:i+1] = caption
1208 # FIXME: This style comes from an include file, we
1209 # should replace the real style and not this default.
1210 lines[i:i+1] = [b' Margin First_Dynamic',
1211 b' LatexType Command',
1212 b' LatexName caption',
1218 b' AlignPossible Center',
1219 b' LabelType Sensitive',
1220 b' LabelString "Senseless!"',
1229 # Delete MaxCounter and remember the value of it
1230 match = re_MaxCounter.match(lines[i])
1232 level = match.group(4).lower()
1233 if level == b"counter_chapter":
1235 elif level == b"counter_section":
1237 elif level == b"counter_subsection":
1239 elif level == b"counter_subsubsection":
1241 elif level == b"counter_paragraph":
1243 elif level == b"counter_subparagraph":
1245 elif level == b"counter_enumi":
1247 elif level == b"counter_enumii":
1249 elif level == b"counter_enumiii":
1256 # LabelType Counter_EnumI
1261 # LabelCounter EnumI
1263 match = re_LabelType.match(lines[i])
1265 label = match.group(4)
1266 # Remember indenting space for later reuse in added lines
1267 space1 = match.group(1)
1268 # Remember the line for adding the LabelCounter later.
1269 # We can't do it here because it could shift latextype_line etc.
1271 if label[:8].lower() == b"counter_":
1272 counter = label[8:].lower()
1273 lines[i] = re_LabelType.sub(b'\\1\\2\\3Counter', lines[i])
1275 # Remember the LabelString line
1276 match = re_LabelString.match(lines[i])
1278 labelstring = match.group(4)
1279 labelstring_line = i
1281 # Remember the LabelStringAppendix line
1282 match = re_LabelStringAppendix.match(lines[i])
1284 labelstringappendix_line = i
1286 # Remember the LatexType line
1287 match = re_LatexType.match(lines[i])
1289 latextype = match.group(4).lower()
1292 # Remember the TocLevel line
1293 match = re_TocLevel.match(lines[i])
1295 toclevel = match.group(4).lower()
1297 # Reset variables at the beginning of a style definition
1298 match = re_Style.match(lines[i])
1300 style = match.group(4).lower()
1306 labelstring_line = -1
1307 labelstringappendix_line = -1
1312 if re_End.match(lines[i]):
1314 # Add a line "LatexType Bib_Environment" if LabelType is Bibliography
1315 # (or change the existing LatexType)
1316 if label.lower() == b"bibliography":
1317 if (latextype_line < 0):
1318 lines.insert(i, b"%sLatexType Bib_Environment" % space1)
1321 lines[latextype_line] = re_LatexType.sub(b'\\1\\2\\3Bib_Environment', lines[latextype_line])
1323 # Change "LabelType Static" to "LabelType Itemize" for itemize environments
1324 if latextype == b"item_environment" and label.lower() == b"static":
1325 lines[labeltype_line] = re_LabelType.sub(b'\\1\\2\\3Itemize', lines[labeltype_line])
1327 # Change "LabelType Counter_EnumI" to "LabelType Enumerate" for enumerate environments
1328 if latextype == b"item_environment" and label.lower() == b"counter_enumi":
1329 lines[labeltype_line] = re_LabelType.sub(b'\\1\\2\\3Enumerate', lines[labeltype_line])
1330 # Don't add the LabelCounter line later
1335 # LabelString "Chapter"
1339 # LabelString "Chapter \arabic{chapter}"
1341 # if this style has a counter. Ditto for LabelStringAppendix.
1342 # This emulates the hardcoded article style numbering of 1.3
1345 if style in counters:
1346 if labelstring_line < 0:
1347 lines.insert(i, b'%sLabelString "%s"' % (space1, counters[style]))
1350 new_labelstring = concatenate_label(labelstring, counters[style])
1351 lines[labelstring_line] = re_LabelString.sub(
1352 b'\\1\\2\\3%s' % new_labelstring.replace(b"\\", b"\\\\"),
1353 lines[labelstring_line])
1354 if style in appendixcounters:
1355 if labelstringappendix_line < 0:
1356 lines.insert(i, b'%sLabelStringAppendix "%s"' % (space1, appendixcounters[style]))
1359 new_labelstring = concatenate_label(labelstring, appendixcounters[style])
1360 lines[labelstringappendix_line] = re_LabelStringAppendix.sub(
1361 b'\\1\\2\\3%s' % new_labelstring.replace(b"\\", b"\\\\"),
1362 lines[labelstringappendix_line])
1364 # Now we can safely add the LabelCounter line
1365 lines.insert(labeltype_line + 1, b"%sLabelCounter %s" % (space1, counter))
1368 # Add the TocLevel setting for sectioning styles
1369 if toclevel == b"" and style in toclevels and maxcounter <= toclevels[style]:
1370 lines.insert(i, b'%s\tTocLevel %d' % (space1, toclevels[style]))
1376 lines.insert(i, b"Format 2")
1379 for mod in usemodules:
1380 lines.insert(i, b"UseModule " + mod)
1387 args = {"description": "Convert layout file <inputfile> to a newer format."}
1388 parser = argparse.ArgumentParser(**args)
1390 parser.add_argument("-t", "--to", type=int, dest="format", default= currentFormat,
1391 help=("destination layout format, default %i (latest)") % currentFormat)
1392 parser.add_argument("input_file", nargs='?', type=str, default=None,
1393 help="input file (default stdin)")
1394 parser.add_argument("output_file", nargs='?', type=str, default=None,
1395 help="output file (default stdout)")
1397 options = parser.parse_args(argv[1:])
1400 if options.input_file:
1401 source = open(options.input_file, 'rb')
1403 source = sys.stdin.buffer
1405 if options.output_file:
1406 output = open(options.output_file, 'wb')
1408 output = sys.stdout.buffer
1410 if options.format > currentFormat:
1411 error("Format %i does not exist" % options.format)
1414 lines = read(source)
1416 while format < options.format:
1417 format = convert(lines, options.format)
1418 write(output, lines)
1421 if options.input_file:
1423 if options.output_file:
1429 if __name__ == "__main__":