1 #LyX 2.4 created this file. For more info see https://www.lyx.org/
5 \save_transient_properties true
6 \origin /systemlyxdir/doc/
9 % DO NOT ALTER THIS PREAMBLE!!!
11 % This preamble is designed to ensure that this document prints
12 % out as advertised. If you mess with this preamble,
13 % parts of this document may not print out as expected. If you
14 % have problems LaTeXing this file, please contact
15 % the documentation team
16 % email: lyx-docs@lists.lyx.org
18 % the pages of the TOC is numbered roman
19 % and a pdf-bookmark for the TOC is added
20 \let\myTOC\tableofcontents
21 \renewcommand\tableofcontents{%
23 \pdfbookmark[1]{\contentsname}{}
27 % increase link area for cross-references and autoname them,
28 \AtBeginDocument{\renewcommand{\ref}[1]{\mbox{\autoref{#1}}}}
29 \@ifundefined{extrasenglish}{\usepackage[english]{babel}}{}
30 \@ifpackageloaded{babel}{
31 \addto\extrasenglish{%
32 \renewcommand*{\equationautorefname}[1]{}%
33 \renewcommand{\sectionautorefname}{sec.\negthinspace}%
34 \renewcommand{\subsectionautorefname}{sec.\negthinspace}%
35 \renewcommand{\subsubsectionautorefname}{sec.\negthinspace}%
39 \options bibliography=totoc,index=totoc,BCOR7.5mm,titlepage,captions=tableheading
40 \use_default_options false
44 \maintain_unincluded_children no
46 \language_package default
49 \font_roman "lmodern" "default"
50 \font_sans "lmss" "default"
51 \font_typewriter "lmtt" "default"
52 \font_math "auto" "auto"
53 \font_default_family default
54 \use_non_tex_fonts false
58 \font_typewriter_osf false
59 \font_sf_scale 100 100
60 \font_tt_scale 100 100
62 \use_dash_ligatures true
64 \default_output_format pdf2
66 \bibtex_command default
67 \index_command default
71 \pdf_title "LyX Configuration Manual"
72 \pdf_author "LyX Team"
73 \pdf_subject "LyX-documentation Customization"
74 \pdf_keywords "LyX, documentation, customization"
76 \pdf_bookmarksnumbered true
77 \pdf_bookmarksopen true
78 \pdf_bookmarksopenlevel 1
83 \pdf_pdfusetitle false
84 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
87 \use_package amsmath 1
88 \use_package amssymb 1
91 \use_package mathdots 1
92 \use_package mathtools 1
94 \use_package stackrel 1
95 \use_package stmaryrd 1
96 \use_package undertilde 1
98 \cite_engine_type default
102 \paperorientation portrait
108 \notefontcolor #0000ff
120 \paragraph_separation indent
121 \paragraph_indentation default
123 \math_indentation default
124 \math_numbering_side default
125 \quotes_style english
129 \paperpagestyle headings
131 \tracking_changes true
132 \output_changes false
134 \postpone_fragile_content false
138 \docbook_table_output 0
139 \author -970929547 "Thibaut Cuvelier"
140 \author -712698321 "Jürgen Spitzmüller"
141 \author -584632292 "Richard Kimberly Heck"
142 \author -495245474 "Jean-Marc Lasgouttes"
144 \author 232239728 "Owner"
145 \author 731793113 "Richard Kimberly Heck" rikiheck@lyx.org
146 \author 1075283030 "Thibaut"
152 Customizing \SpecialChar LyX
153 : Features for the Advanced User
157 by the \SpecialChar LyX
162 \begin_layout Plain Layout
163 If you have comments or error corrections, please send them to the \SpecialChar LyX
166 \begin_inset CommandInset href
168 target "lyx-docs@lists.lyx.org"
176 \begin_inset Quotes eld
180 \begin_inset Quotes erd
183 in the subject header, and please cc the current maintainer of this file,
185 \change_inserted 5863208 1604930692
189 \change_inserted 5863208 1604930729
191 \change_deleted 5863208 1604930668
200 \begin_inset Newline newline
204 \begin_inset Newline newline
210 \begin_layout Standard
211 \begin_inset CommandInset toc
212 LatexCommand tableofcontents
219 \begin_layout Standard
220 \begin_inset Note Note
223 \begin_layout Plain Layout
224 Please use change tracking when modifying this document.
225 This makes it easier for our translators to recognize things that have
226 been changed, and it helps the maintainer keep up-to-date with what's been
235 \begin_layout Chapter
239 \begin_layout Standard
240 This manual covers the customization features present in \SpecialChar LyX
242 In it, we discuss issues like keyboard shortcuts, screen previewing options,
243 printer options, sending commands to \SpecialChar LyX
244 via the \SpecialChar LyX
245 Server, internationalization,
246 installing new \SpecialChar LaTeX
247 classes and \SpecialChar LyX
249 We can't possibly hope to touch on everything you can change—our developers
250 add new features faster than we can document them—but we will explain the
251 most common customizations and hopefully point you in the right direction
252 for some of the more obscure ones.
255 \begin_layout Standard
256 \begin_inset Branch OutDated
260 \begin_layout Standard
261 Information from previous versions of this document that now seems to be
262 outdated is contained in the OutDated branch of this document.
263 By default, this information will not appear in the \SpecialChar LaTeX
272 \begin_layout Chapter
277 \begin_layout Standard
278 This chapter aims to help you to find your way through the \SpecialChar LyX
281 Before continuing to read this chapter, you should find out where your
283 library and user directories are by using
284 \begin_inset Flex Noun
287 \begin_layout Plain Layout
288 Help\SpecialChar menuseparator
299 The library directory is the place where \SpecialChar LyX
300 places its system-wide configuration
301 files; the user directory is where you can place your modified versions.
302 We will call the former
303 \begin_inset Flex Code
306 \begin_layout Plain Layout
313 \begin_inset Flex Noun
316 \begin_layout Plain Layout
322 in the remainder of this document.
326 \begin_layout Section
328 \begin_inset Flex Code
331 \begin_layout Plain Layout
340 \begin_layout Standard
341 \begin_inset Flex Code
344 \begin_layout Plain Layout
350 and its sub-directories contain a number of files
351 \change_deleted 232239728 1604787780
354 that can be used to customize \SpecialChar LyX
356 You can change many of these files from within \SpecialChar LyX
358 \begin_inset Flex Noun
361 \begin_layout Plain Layout
362 Tools\SpecialChar menuseparator
369 Most customization that you will want to do in \SpecialChar LyX
370 is possible through this
372 However, many other inner aspects of \SpecialChar LyX
373 can be customized by modifying the
375 \begin_inset Flex Code
378 \begin_layout Plain Layout
385 These files fall in different categories, described in the following subsection
389 \begin_layout Subsection
390 Automatically generated files
393 \begin_layout Standard
395 \begin_inset Flex Noun
398 \begin_layout Plain Layout
404 are generated when you configure \SpecialChar LyX
406 They contain various default values that are
407 \change_inserted 5863208 1604919565
408 automatically detected during reconfiguration.
409 \change_deleted 232239728 1604788241
410 guessed by inspection
412 In general, it is not a good idea to modify them, since they might be overwritt
416 \begin_layout Labeling
417 \labelwidthstring 00.00.0000
418 \begin_inset Flex Code
421 \begin_layout Plain Layout
428 \change_deleted 5863208 1604919950
430 \begin_inset Note Note
433 \begin_layout Plain Layout
435 \change_inserted 232239728 1604853928
436 I capitalized the first word in all of these lists.
437 To me it looks better but it really is a stylistic thing, your call.
438 However if you are not going to capitalize them, the english in some needs
439 to be modified to make it read correctly as a sentence.
447 \change_deleted 232239728 1604853510
449 \change_inserted 232239728 1604853510
452 ontains defaults for various commands.
455 \begin_layout Labeling
456 \labelwidthstring 00.00.0000
457 \begin_inset Flex Code
460 \begin_layout Plain Layout
467 \change_deleted 232239728 1604853512
469 \change_inserted 232239728 1604853512
472 ontains the list of packages that have been recognized by \SpecialChar LyX
474 It is currently unused by the \SpecialChar LyX
475 program itself, but the information extracted,
476 and more, is made available with
477 \begin_inset Flex Noun
480 \begin_layout Plain Layout
481 Help\SpecialChar menuseparator
495 \begin_layout Labeling
496 \labelwidthstring 00.00.0000
497 \begin_inset Flex Code
500 \begin_layout Plain Layout
507 \change_deleted 232239728 1604853515
509 \change_inserted 232239728 1604853515
512 he list of text classes that have been found in your
513 \begin_inset Flex Code
516 \begin_layout Plain Layout
522 directories, along with the associated \SpecialChar LaTeX
523 document class and their description.
526 \begin_layout Labeling
527 \labelwidthstring 00.00.0000
528 \begin_inset Flex Code
531 \begin_layout Plain Layout
538 \change_deleted 232239728 1604853518
540 \change_inserted 232239728 1604853518
543 he list of layout modules found in your
544 \begin_inset Flex Code
547 \begin_layout Plain Layout
556 \begin_layout Labeling
557 \labelwidthstring 00.00.0000
558 \begin_inset Flex Code
561 \begin_layout Plain Layout
568 \change_deleted 232239728 1604853523
570 \change_inserted 232239728 1604853523
573 ists of various sorts of \SpecialChar LaTeX
574 -related files found on your system
577 \begin_layout Labeling
578 \labelwidthstring 00.00.0000
579 \begin_inset Flex Code
582 \begin_layout Plain Layout
583 doc/\SpecialChar LaTeX
589 is automatically generated during configuration from the file
590 \begin_inset Flex Code
593 \begin_layout Plain Layout
601 It contains information on your \SpecialChar LaTeX
605 \begin_layout Subsection
609 \begin_layout Standard
611 \change_deleted 5863208 1604928729
615 \change_inserted 5863208 1604928636
619 \change_inserted 5863208 1604928661
623 \begin_inset Flex Code
626 \begin_layout Plain Layout
633 \change_inserted 5863208 1604928662
635 \change_deleted 5863208 1604928642
639 \change_deleted 5863208 1604928669
641 \begin_inset Flex Code
644 \begin_layout Plain Layout
651 \change_inserted 5863208 1604928680
655 \begin_inset Flex Code
658 \begin_layout Plain Layout
666 \change_deleted 232239728 1604794430
669 exists in both places, the one in
670 \begin_inset Flex Code
673 \begin_layout Plain Layout
682 \begin_layout Labeling
683 \labelwidthstring 00.00.0000
684 \begin_inset Flex Code
687 \begin_layout Plain Layout
694 \change_deleted 232239728 1604794460
696 \change_inserted 232239728 1604794460
699 his directory contains files with the extension
700 \begin_inset Flex Code
703 \begin_layout Plain Layout
709 that define the keybindings used in \SpecialChar LyX
711 If there exists an internationalized version of the bind file named
712 \begin_inset Flex Code
715 \begin_layout Plain Layout
721 , that will be used first.
724 \begin_layout Labeling
725 \labelwidthstring 00.00.0000
726 \begin_inset Flex Code
729 \begin_layout Plain Layout
736 \change_deleted 232239728 1604794478
738 \change_inserted 232239728 1604794478
741 ontains files with the extension
742 \begin_inset Flex Code
745 \begin_layout Plain Layout
751 which define the diverse citation possibilities (natbib, biblatex etc.).
753 \begin_inset CommandInset ref
755 reference "subsec:Cite-Engine-Files"
765 \begin_layout Labeling
766 \labelwidthstring 00.00.0000
767 \begin_inset Flex Code
770 \begin_layout Plain Layout
777 \change_deleted 232239728 1604794483
779 \change_inserted 232239728 1604794486
782 ontains graphics files that can be included in documents.
786 \begin_layout Labeling
787 \labelwidthstring 00.00.0000
788 \begin_inset Flex Code
791 \begin_layout Plain Layout
798 \change_deleted 232239728 1604794492
800 \change_inserted 232239728 1604794492
803 ontains \SpecialChar LyX
804 documentation files (including the one you are currently reading).
806 \begin_inset Flex Code
809 \begin_layout Plain Layout
811 \change_deleted 232239728 1604794660
814 \change_inserted 232239728 1604794661
822 deserves special attention, as noted above.
823 The internationalized help docs are in subdirectories
824 \begin_inset Flex Code
827 \begin_layout Plain Layout
834 \begin_inset Quotes eld
838 \begin_inset Quotes erd
841 is the ISO language code.
843 \begin_inset CommandInset ref
845 reference "cha:Internationalizing-LyX"
852 \begin_layout Labeling
853 \labelwidthstring 00.00.0000
854 \begin_inset Flex Code
857 \begin_layout Plain Layout
864 \change_deleted 232239728 1604794497
866 \change_inserted 232239728 1604794497
869 ontains example files that explain how to use some features.
870 In the file browser, press the
871 \begin_inset Flex Noun
874 \begin_layout Plain Layout
883 \begin_layout Labeling
884 \labelwidthstring 00.00.0000
885 \begin_inset Flex Code
888 \begin_layout Plain Layout
895 \change_deleted 232239728 1604794500
897 \change_inserted 232239728 1604794500
900 ontains image files that are used by the
901 \begin_inset Flex Noun
904 \begin_layout Plain Layout
911 In addition, it also contains the individual icons used in the toolbar
912 and the banners that can be shown when \SpecialChar LyX
916 \begin_layout Labeling
917 \labelwidthstring 00.00.0000
918 \begin_inset Flex Code
921 \begin_layout Plain Layout
928 \change_deleted 232239728 1604794505
930 \change_inserted 232239728 1604794505
933 ontains keyboard keymapping files.
935 \begin_inset CommandInset ref
937 reference "sec:International-Keymap-Stuff"
944 \begin_layout Labeling
945 \labelwidthstring 00.00.0000
946 \begin_inset Flex Code
949 \begin_layout Plain Layout
956 \change_deleted 232239728 1604794508
958 \change_inserted 232239728 1604794508
961 ontains the text class and module files described in
962 \begin_inset CommandInset ref
964 reference "cha:Installing-New-Document"
971 \begin_layout Labeling
972 \labelwidthstring 00.00.0000
973 \begin_inset Flex Code
976 \begin_layout Plain Layout
983 \change_deleted 232239728 1604794513
985 \change_inserted 232239728 1604794513
989 \begin_inset Flex Code
992 \begin_layout Plain Layout
998 Python scripts used to convert between \SpecialChar LyX
1000 These can be run from the command line if
1001 \change_deleted 232239728 1604794749
1004 you want to batch-convert files.
1007 \begin_layout Labeling
1008 \labelwidthstring 00.00.0000
1009 \begin_inset Flex Code
1012 \begin_layout Plain Layout
1019 \change_deleted 232239728 1604794516
1021 \change_inserted 232239728 1604794516
1024 ontains some files that demonstrate the capabilities of the
1025 \begin_inset Flex Noun
1028 \begin_layout Plain Layout
1030 \begin_inset space ~
1039 Also contains some scripts used by \SpecialChar LyX
1043 \begin_layout Labeling
1044 \labelwidthstring 00.00.0000
1045 \begin_inset Flex Code
1048 \begin_layout Plain Layout
1055 \change_deleted 232239728 1604794520
1057 \change_inserted 232239728 1604794520
1060 ontains the standard \SpecialChar LyX
1061 template files described in
1062 \begin_inset CommandInset ref
1064 reference "subsec:Creating-Templates"
1071 \begin_layout Labeling
1072 \labelwidthstring 00.00.0000
1073 \begin_inset Flex Code
1076 \begin_layout Plain Layout
1083 \change_deleted 232239728 1604794524
1085 \change_inserted 232239728 1604794524
1088 ontains files with the extension
1089 \begin_inset Flex Code
1092 \begin_layout Plain Layout
1098 that define the user interface to \SpecialChar LyX
1100 That is, the files define which items appear in which menus and the items
1101 appearing on the toolbar.
1104 \begin_layout Labeling
1105 \labelwidthstring 00.00.0000
1106 \begin_inset Flex Code
1109 \begin_layout Plain Layout
1116 \change_deleted 232239728 1604794528
1118 \change_inserted 232239728 1604794528
1121 ontains files with the extension
1122 \begin_inset Flex Code
1125 \begin_layout Plain Layout
1131 which define the templates for the insertion of external material to a
1134 \begin_inset CommandInset ref
1136 reference "chap:Including-External-Material"
1143 \begin_layout Subsection
1144 Files you don't want to modify
1147 \begin_layout Standard
1148 These files are used internally by \SpecialChar LyX
1149 and you generally do not need to modify
1150 them unless you are a developer.
1153 \begin_layout Labeling
1154 \labelwidthstring 00.00.0000
1155 \begin_inset Flex Code
1158 \begin_layout Plain Layout
1165 \change_deleted 232239728 1604797616
1167 \change_inserted 232239728 1604797616
1170 his file contains the list of \SpecialChar LyX
1172 The contents are displayed with the menu entry
1173 \begin_inset Flex Noun
1176 \begin_layout Plain Layout
1177 Help\SpecialChar menuseparator
1179 \begin_inset space ~
1190 \begin_layout Labeling
1191 \labelwidthstring 00.00.0000
1192 \begin_inset Flex Code
1195 \begin_layout Plain Layout
1202 \change_deleted 232239728 1604797620
1204 \change_inserted 232239728 1604797620
1207 his is a \SpecialChar LaTeX
1208 script used during the configuration process.
1209 Do not run directly.
1212 \begin_layout Labeling
1213 \labelwidthstring 00.00.0000
1214 \begin_inset Flex Code
1217 \begin_layout Plain Layout
1224 \change_deleted 232239728 1604797624
1226 \change_inserted 232239728 1604797624
1229 his is a Python script that is used to re-configure \SpecialChar LyX
1231 It creates configuration files in the directory it was run from.
1234 \begin_layout Subsection
1235 Other files needing a line or two
1238 \begin_layout Labeling
1239 \labelwidthstring 00.00.0000
1240 \begin_inset Flex Code
1243 \begin_layout Plain Layout
1250 \change_deleted 232239728 1604797580
1252 \change_inserted 232239728 1604797580
1255 his contains tables describing how different character encodings can be
1259 \begin_layout Labeling
1260 \labelwidthstring 00.00.0000
1261 \begin_inset Flex Code
1264 \begin_layout Plain Layout
1271 \change_deleted 232239728 1604797584
1273 \change_inserted 232239728 1604797584
1276 his file contains a list of all the languages currently supported by \SpecialChar LyX
1280 \begin_layout Labeling
1281 \labelwidthstring 00.00.0000
1282 \begin_inset Flex Code
1285 \begin_layout Plain Layout
1292 \change_deleted 232239728 1604797587
1294 \change_inserted 232239728 1604797587
1297 ontains information about the supported fonts.
1300 \begin_layout Labeling
1301 \labelwidthstring 00.00.0000
1302 \begin_inset Flex Code
1305 \begin_layout Plain Layout
1312 \change_deleted 232239728 1604797591
1314 \change_inserted 232239728 1604797591
1317 his file contains translations for internationalized paragraph styles (see
1319 \begin_inset CommandInset ref
1321 reference "subsec:I18n"
1328 \begin_layout Labeling
1329 \labelwidthstring 00.00.0000
1330 \begin_inset Flex Code
1333 \begin_layout Plain Layout
1340 \change_deleted 232239728 1604797594
1342 \change_inserted 232239728 1604797594
1345 his file contains information about Unicode-encoded glyphs and the way they
1346 are supported by \SpecialChar LyX
1347 via \SpecialChar LaTeX
1351 \begin_layout Section
1352 Your local configuration directory
1355 \begin_layout Standard
1356 Even if you are using \SpecialChar LyX
1357 as an unprivileged user, you might want to change
1359 configuration for your own use.
1361 \begin_inset Flex Code
1364 \begin_layout Plain Layout
1370 directory contains all your personal configuration files.
1371 This is the directory described as
1372 \begin_inset Quotes eld
1376 \begin_inset Quotes erd
1380 \begin_inset Flex Noun
1383 \begin_layout Plain Layout
1384 Help\SpecialChar menuseparator
1386 \begin_inset space ~
1395 This directory is used as a mirror of
1396 \begin_inset Flex Code
1399 \begin_layout Plain Layout
1405 , which means that every file in
1406 \begin_inset Flex Code
1409 \begin_layout Plain Layout
1415 is a replacement for the corresponding file in
1416 \begin_inset Flex Code
1419 \begin_layout Plain Layout
1426 Any configuration file described in the above sections can be placed either
1427 in the system-wide directory, in which case it will affect all users, or
1428 in your local directory for your own use.
1431 \begin_layout Standard
1432 To make things clearer, let's provide a few examples:
1435 \begin_layout Itemize
1436 The preferences set in the
1437 \begin_inset Flex Noun
1440 \begin_layout Plain Layout
1441 Tools\SpecialChar menuseparator
1447 dialog are saved to a file
1448 \begin_inset Flex Code
1451 \begin_layout Plain Layout
1458 \begin_inset Flex Code
1461 \begin_layout Plain Layout
1470 \begin_layout Itemize
1471 When you reconfigure using
1472 \begin_inset Flex Noun
1475 \begin_layout Plain Layout
1476 Tools\SpecialChar menuseparator
1484 \begin_inset Flex Code
1487 \begin_layout Plain Layout
1493 script, and the resulting files are written in your local configuration
1495 This means that any additional text class file that you might have added
1497 \begin_inset Flex Code
1500 \begin_layout Plain Layout
1506 will be added to the list of classes in the
1507 \begin_inset Flex Noun
1510 \begin_layout Plain Layout
1511 Document\SpecialChar menuseparator
1520 \begin_layout Itemize
1521 If you get some updated documentation from
1522 \change_inserted 232239728 1604798171
1526 ftp site and cannot install it because you do not have sysadmin rights
1527 on your system, you can just copy the files
1528 \change_deleted 232239728 1604798193
1530 \change_inserted 232239728 1604798193
1534 \begin_inset Flex Code
1537 \begin_layout Plain Layout
1543 and the items in the
1544 \begin_inset Flex Noun
1547 \begin_layout Plain Layout
1553 menu will open them!
1556 \begin_layout Section
1557 Running \SpecialChar LyX
1558 with multiple configurations
1561 \begin_layout Standard
1562 The configuration freedom of the local configuration directory may not suffice
1563 if you want to have more than one configuration at your disposal.
1564 For example, you may want to
1565 \change_deleted 232239728 1604798238
1568 use different key bindings or printer settings at different times.
1569 You can achieve this by having several such directories.
1570 You then specify which directory to use at run-time.
1573 \begin_layout Standard
1574 Invoking \SpecialChar LyX
1575 with the command line switch
1576 \begin_inset Flex Code
1579 \begin_layout Plain Layout
1589 instructs the program to read the configuration from that directory, and
1590 not from the default directory.
1591 (You can determine the default directory by running \SpecialChar LyX
1593 \begin_inset Flex Code
1596 \begin_layout Plain Layout
1602 switch.) If the specified directory does not exist, \SpecialChar LyX
1604 for you, just like it does for the default directory
1605 \change_deleted 232239728 1604798318
1608 the first time you run the program.
1609 You can modify the configuration options in this additional user directory
1610 exactly as you would for the default directory.
1611 These directories are completely independent (but read on).
1612 Note that setting the environment variable
1613 \begin_inset Flex Code
1616 \begin_layout Plain Layout
1622 to some value has exactly the same effect.
1625 \begin_layout Standard
1626 Having several configurations also requires more maintenance: if you want
1627 to add a new layout to
1628 \begin_inset Flex Code
1631 \begin_layout Plain Layout
1637 which you want available from all your configurations, you must add it
1638 to each directory separately.
1639 You can avoid this with the following trick: after \SpecialChar LyX
1640 creates the additional
1641 directory, most of the subdirectories (see above) are empty.
1642 If you want the new configuration to mirror an existing one, replace the
1643 empty subdirectory with a symbolic link to the matching subdirectory in
1644 the existing configuration.
1646 \begin_inset Flex Code
1649 \begin_layout Plain Layout
1655 subdirectory, however, since it contains a file written by the configuration
1656 script (also accessible through
1657 \begin_inset Flex Noun
1660 \begin_layout Plain Layout
1661 Tools\SpecialChar menuseparator
1667 ) which is configuration
1668 \change_deleted 232239728 1604798083
1670 \change_inserted 232239728 1604798100
1676 \begin_layout Chapter
1677 The Preferences dialog
1680 \begin_layout Standard
1681 All options of the preferences dialog are described in the Appendix
1683 The Preferences Dialog
1690 For some options you might find here more details.
1693 \begin_layout Section
1695 \begin_inset CommandInset label
1704 \begin_layout Standard
1705 The first step is to define your file formats if they are not already defined.
1707 \begin_inset Flex Noun
1710 \begin_layout Plain Layout
1711 Tools\SpecialChar menuseparator
1719 \begin_inset Flex Noun
1722 \begin_layout Plain Layout
1723 File Handling\SpecialChar menuseparator
1730 \begin_inset Flex Noun
1733 \begin_layout Plain Layout
1739 button to define your new format.
1741 \begin_inset Flex Noun
1744 \begin_layout Plain Layout
1750 field contains the name used to identify the format in the GUI.
1752 \begin_inset Flex Noun
1755 \begin_layout Plain Layout
1761 is used to identify the format internally.
1762 You will also need to enter a file extension.
1763 These are all required.
1765 \begin_inset Flex Noun
1768 \begin_layout Plain Layout
1774 field is used to provide a keyboard shortcut on the menus.
1775 (For example, pressing
1776 \begin_inset Flex Noun
1779 \begin_layout Plain Layout
1786 \begin_inset Flex Noun
1789 \begin_layout Plain Layout
1790 Document\SpecialChar menuseparator
1791 View (Other Formats)\SpecialChar menuseparator
1800 \begin_layout Standard
1802 \begin_inset Flex Noun
1805 \begin_layout Plain Layout
1812 \begin_inset Flex Noun
1815 \begin_layout Plain Layout
1822 For example, you might want to use
1823 \begin_inset Flex Noun
1826 \begin_layout Plain Layout
1832 to view PostScript files.
1833 You can enter the command needed to start the program in the corresponding
1835 In defining this command, you can use the four variables listed in the
1837 The viewer is launched when you view an image in \SpecialChar LyX
1839 \begin_inset Flex Noun
1842 \begin_layout Plain Layout
1843 Document\SpecialChar menuseparator
1850 The editor is for example launched when you right-click on an image and
1852 \begin_inset Flex Noun
1855 \begin_layout Plain Layout
1861 in the appearing context menu.
1864 \begin_layout Standard
1866 \begin_inset Flex Noun
1869 \begin_layout Plain Layout
1875 type of a format is optional, but if it is specified, it must be unique
1877 It is used to detect files of this format from the file contents.
1878 For some important file formats there is no MIME type officially registered
1880 \begin_inset CommandInset href
1883 target "http://www.iana.org/assignments/media-types/"
1889 Therefore \SpecialChar LyX
1890 uses the extended list of MIME types as specified by
1891 \begin_inset CommandInset href
1893 name "freedesktop.org"
1894 target "http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"
1902 \begin_layout Standard
1904 \begin_inset Flex Noun
1907 \begin_layout Plain Layout
1913 option tells \SpecialChar LyX
1914 that a format is suitable for document export.
1915 If this is set and if a suitable conversion route exists (see
1916 \begin_inset CommandInset ref
1918 reference "sec:Converters"
1922 ), the format will appear in the
1923 \begin_inset Flex Noun
1926 \begin_layout Plain Layout
1927 File\SpecialChar menuseparator
1934 The format will also appear in the
1935 \begin_inset Flex Noun
1938 \begin_layout Plain Layout
1939 Document\SpecialChar menuseparator
1945 menu if a viewer is specified for the format.
1946 Pure image formats, such as
1947 \begin_inset Flex Code
1950 \begin_layout Plain Layout
1956 , should not use this option.
1957 Formats that can both represent vector graphics and documents like
1958 \begin_inset Flex Code
1961 \begin_layout Plain Layout
1970 \begin_layout Standard
1972 \begin_inset Flex Noun
1975 \begin_layout Plain Layout
1976 Vector graphics format
1981 tells \SpecialChar LyX
1982 that a format can contain vector graphics.
1983 This information is used to determine the target format of included graphics
1985 \begin_inset Flex Noun
1988 \begin_layout Plain Layout
1995 Included graphics may need to be converted to either
1996 \begin_inset Flex Noun
1999 \begin_layout Plain Layout
2006 \begin_inset Flex Noun
2009 \begin_layout Plain Layout
2016 \begin_inset Flex Noun
2019 \begin_layout Plain Layout
2026 \begin_inset Flex Noun
2029 \begin_layout Plain Layout
2035 cannot handle other image formats.
2036 If an included graphic is not already in
2037 \begin_inset Flex Noun
2040 \begin_layout Plain Layout
2047 \begin_inset Flex Noun
2050 \begin_layout Plain Layout
2057 \begin_inset Flex Noun
2060 \begin_layout Plain Layout
2066 format, it is converted to
2067 \begin_inset Flex Noun
2070 \begin_layout Plain Layout
2076 if the vector format option is set, and otherwise to
2077 \begin_inset Flex Noun
2080 \begin_layout Plain Layout
2089 \begin_layout Section
2093 \begin_layout Standard
2094 Since all conversions from one format to another take place in \SpecialChar LyX
2096 directory, it is sometimes necessary to modify a file before copying it
2097 to the temporary directory in order that the conversion may be performed.
2101 \begin_layout Plain Layout
2102 For example, the file may refer to other files—images, for example—using
2103 relative file names, and these may become invalid when the file is copied
2104 to the temporary directory.
2109 This is done by a Copier: It copies a file to (or from) the temporary directory
2110 and may modify it in the process.
2113 \begin_layout Standard
2114 The definitions of the copiers may use eight variables:
2117 \begin_layout Labeling
2118 \labelwidthstring 00.00.0000
2119 \begin_inset Flex Code
2122 \begin_layout Plain Layout
2128 The \SpecialChar LyX
2129 system directory (e.
2130 \begin_inset space \thinspace{}
2134 \begin_inset space \space{}
2138 \begin_inset Flex Noun
2141 \begin_layout Plain Layout
2150 \begin_layout Labeling
2151 \labelwidthstring 00.00.0000
2152 \begin_inset Flex Code
2155 \begin_layout Plain Layout
2164 \begin_layout Labeling
2165 \labelwidthstring 00.00.0000
2166 \begin_inset Flex Code
2169 \begin_layout Plain Layout
2178 \begin_layout Labeling
2179 \labelwidthstring 00.00.0000
2180 \begin_inset Flex Code
2183 \begin_layout Plain Layout
2189 The base name (without filename extension) in the \SpecialChar LyX
2193 \begin_layout Labeling
2194 \labelwidthstring 00.00.0000
2195 \begin_inset Flex Code
2198 \begin_layout Plain Layout
2204 The full directory path of the \SpecialChar LyX
2208 \begin_layout Labeling
2209 \labelwidthstring 00.00.0000
2210 \begin_inset Flex Code
2213 \begin_layout Plain Layout
2219 The full pathname to the original \SpecialChar LyX
2220 file being processed
2223 \begin_layout Labeling
2224 \labelwidthstring 00.00.0000
2225 \begin_inset Flex Code
2228 \begin_layout Plain Layout
2234 The filename (without any directory path) of the \SpecialChar LyX
2238 \begin_layout Labeling
2239 \labelwidthstring 00.00.0000
2240 \begin_inset Flex Code
2243 \begin_layout Plain Layout
2249 The `\SpecialChar LaTeX
2253 \begin_layout Standard
2254 The latter should be the filename as it would be used in a \SpecialChar LaTeX
2262 It is relevant only when exporting files suitable for such inclusion.
2265 \begin_layout Standard
2266 Copiers can be used to do almost anything with output files.
2267 For example, suppose you want generated pdf files to be copied to a special
2269 \begin_inset Flex Code
2272 \begin_layout Plain Layout
2279 Then you could write a shell script such as this one:
2282 \begin_layout Standard
2283 \begin_inset listings
2287 \begin_layout Plain Layout
2292 \begin_layout Plain Layout
2297 \begin_layout Plain Layout
2299 TOFILE=`basename $2`
2302 \begin_layout Plain Layout
2304 cp $FROMFILE /home/you/pdf/$TOFILE
2309 Save it in your local \SpecialChar LyX
2311 \begin_inset Flex Code
2314 \begin_layout Plain Layout
2315 /home/you/.lyx/scripts/pdfcopier.sh
2320 —and make it executable, if you need to do so on your platform.
2322 \begin_inset Flex Noun
2325 \begin_layout Plain Layout
2326 Tools\SpecialChar menuseparator
2332 dialog, select under
2333 \begin_inset Flex Noun
2336 \begin_layout Plain Layout
2337 File Handling\SpecialChar menuseparator
2344 \begin_inset Flex Noun
2347 \begin_layout Plain Layout
2353 format—or one of the other pdf formats—and enter
2354 \begin_inset Flex Code
2357 \begin_layout Plain Layout
2358 pdfcopier.sh $$i $$o
2364 \begin_inset Flex Noun
2367 \begin_layout Plain Layout
2377 \begin_layout Standard
2378 Copiers are used by \SpecialChar LyX
2379 in various of its own conversions.
2380 For example, if appropriate programs are found, \SpecialChar LyX
2381 will automatically install
2383 \begin_inset Flex Noun
2386 \begin_layout Plain Layout
2393 \begin_inset Flex Noun
2396 \begin_layout Plain Layout
2398 \begin_inset space ~
2407 When these formats are exported, the copier sees that not just the main
2408 HTML file but various associated files (style files, images, etc.) are also
2410 All these files are written to a subdirectory of the directory in which
2411 the original \SpecialChar LyX
2416 \begin_layout Plain Layout
2417 This copier can be customized.
2419 \begin_inset Quotes eld
2423 \begin_inset Quotes erd
2426 argument takes a comma-separated list of extensions to be copied; if it
2427 is omitted, all files will be copied.
2429 \begin_inset Quotes eld
2433 \begin_inset Quotes erd
2436 argument determines the extension added to the generated directory.
2438 \begin_inset Quotes eld
2442 \begin_inset Flex Noun
2445 \begin_layout Plain Layout
2452 \begin_inset Quotes erd
2455 , so HTML generated from
2456 \begin_inset Flex Noun
2459 \begin_layout Plain Layout
2460 /path/to/filename.lyx
2466 \begin_inset Flex Noun
2469 \begin_layout Plain Layout
2470 /path/to/filename.html.LyXconv
2484 \begin_layout Section
2486 \begin_inset CommandInset label
2488 name "sec:Converters"
2495 \begin_layout Standard
2496 You can define your own Converters to convert files between different formats.
2498 \begin_inset Flex Noun
2501 \begin_layout Plain Layout
2502 Tools\SpecialChar menuseparator
2503 Preferences\SpecialChar menuseparator
2504 File Handling\SpecialChar menuseparator
2513 \begin_layout Standard
2514 To define a new converter, select the
2515 \begin_inset Flex Noun
2518 \begin_layout Plain Layout
2520 \begin_inset space ~
2529 \begin_inset Flex Noun
2532 \begin_layout Plain Layout
2534 \begin_inset space ~
2542 from the drop-down lists, enter the command needed for the conversion,
2544 \begin_inset Flex Noun
2547 \begin_layout Plain Layout
2554 Several variables can be used in the definition of converters:
2557 \begin_layout Labeling
2558 \labelwidthstring 00.00.0000
2559 \begin_inset Flex Code
2562 \begin_layout Plain Layout
2568 The \SpecialChar LyX
2572 \begin_layout Labeling
2573 \labelwidthstring 00.00.0000
2574 \begin_inset Flex Code
2577 \begin_layout Plain Layout
2586 \begin_layout Labeling
2587 \labelwidthstring 00.00.0000
2588 \begin_inset Flex Code
2591 \begin_layout Plain Layout
2600 \begin_layout Labeling
2601 \labelwidthstring 00.00.0000
2602 \begin_inset Flex Code
2605 \begin_layout Plain Layout
2611 The base filename of the input file (i.
2612 \begin_inset space \thinspace{}
2615 g., without the extension)
2618 \begin_layout Labeling
2619 \labelwidthstring 00.00.0000
2620 \begin_inset Flex Code
2623 \begin_layout Plain Layout
2629 The path to the input file
2632 \begin_layout Labeling
2633 \labelwidthstring 00.00.0000
2634 \begin_inset Flex Code
2637 \begin_layout Plain Layout
2643 The path to the original input file (this is different from $$p when a
2644 chain of converters is called)
2647 \begin_layout Labeling
2648 \labelwidthstring 00.00.0000
2649 \begin_inset Flex Code
2652 \begin_layout Plain Layout
2658 The iconv name for the encoding of the document.
2661 \begin_layout Standard
2663 \begin_inset Flex Noun
2666 \begin_layout Plain Layout
2668 \begin_inset space ~
2676 field you can enter the following flags, separated by commas:
2679 \begin_layout Labeling
2680 \labelwidthstring 00.00.0000
2681 \begin_inset Flex Code
2684 \begin_layout Plain Layout
2686 \change_inserted -712698321 1524656940
2694 This converter runs some form of \SpecialChar LaTeX
2696 This will make \SpecialChar LyX
2697 's \SpecialChar LaTeX
2698 error logs available.
2700 \change_inserted -712698321 1524657018
2702 \begin_inset Flex Code
2705 \begin_layout Plain Layout
2707 \change_inserted -712698321 1524657012
2715 value specifies the form of \SpecialChar LaTeX
2717 \begin_inset Flex Code
2720 \begin_layout Plain Layout
2722 \change_inserted -712698321 1524657005
2723 latex, pdflatex, platex, xetex, luatex
2731 If no value is specified,
2732 \begin_inset Flex Code
2735 \begin_layout Plain Layout
2737 \change_inserted -712698321 1524657018
2750 \begin_layout Labeling
2751 \labelwidthstring 00.00.0000
2752 \begin_inset Flex Code
2755 \begin_layout Plain Layout
2757 \change_inserted -712698321 1524656935
2765 Needs the \SpecialChar LaTeX
2767 \begin_inset Flex Noun
2770 \begin_layout Plain Layout
2776 file for the conversion.
2778 \change_inserted -712698321 1524657047
2780 \begin_inset Flex Code
2783 \begin_layout Plain Layout
2785 \change_inserted -712698321 1524657030
2793 value specifies the form of \SpecialChar LaTeX
2794 that is run in order to generate the
2795 \begin_inset Flex Noun
2798 \begin_layout Plain Layout
2800 \change_inserted -712698321 1524657047
2809 \begin_inset Flex Code
2812 \begin_layout Plain Layout
2814 \change_inserted -712698321 1524657030
2815 latex, pdflatex, platex, xetex, luatex
2823 If no value is specified,
2824 \begin_inset Flex Code
2827 \begin_layout Plain Layout
2829 \change_inserted -712698321 1524657030
2842 \begin_layout Labeling
2843 \labelwidthstring 00.00.0000
2844 \begin_inset Flex Code
2847 \begin_layout Plain Layout
2854 \begin_inset Quotes eld
2858 \begin_inset Quotes erd
2861 file from the backend, which in practice means a \SpecialChar LaTeX
2862 file like the one we
2863 would export, without
2864 \begin_inset Flex Code
2867 \begin_layout Plain Layout
2876 \begin_layout Labeling
2877 \labelwidthstring 00.00.0000
2878 \begin_inset Flex Code
2881 \begin_layout Plain Layout
2890 \begin_layout Standard
2891 The following three flags are not really flags at all because they take
2893 \begin_inset Flex Noun
2896 \begin_layout Plain Layout
2898 \begin_inset space ~
2902 \begin_inset space ~
2913 \begin_layout Labeling
2914 \labelwidthstring 00.00.0000
2916 \change_inserted -712698321 1523206314
2917 \begin_inset Flex Code
2920 \begin_layout Plain Layout
2922 \change_inserted -712698321 1523206193
2930 The name of the driver that needs to be loaded with the
2934 package for this converter.
2935 The loading of the correct driver is necessary to get some PDF-specific
2944 \begin_layout Labeling
2945 \labelwidthstring 00.00.0000
2946 \begin_inset Flex Code
2949 \begin_layout Plain Layout
2955 If set, the converter's standard error will be redirected to a file
2956 \begin_inset Flex Code
2959 \begin_layout Plain Layout
2965 , and the script given as argument will be run as:
2966 \begin_inset Flex Code
2969 \begin_layout Plain Layout
2970 script < infile.out > infile.log
2976 The argument may contain
2977 \begin_inset Flex Code
2980 \begin_layout Plain Layout
2989 \begin_layout Labeling
2990 \labelwidthstring 00.00.0000
2991 \begin_inset Flex Code
2994 \begin_layout Plain Layout
3000 The name of the directory in which the converter will dump the generated
3003 will not create this directory, and it does not copy anything into it,
3004 though it will copy this directory to the destination.
3005 The argument may contain
3006 \begin_inset Flex Code
3009 \begin_layout Plain Layout
3015 , which will be replaced by the base name of the input and output files,
3016 respectively, when the directory is copied.
3017 \begin_inset Newline newline
3020 Note that resultdir and usetempdir make no sense together.
3021 The latter will be ignored if the former is given.
3024 \begin_layout Labeling
3025 \labelwidthstring 00.00.0000
3026 \begin_inset Flex Code
3029 \begin_layout Plain Layout
3035 Determines the output file name and may, contain
3036 \begin_inset Flex Code
3039 \begin_layout Plain Layout
3046 Sensible only with resultdir and optional even then; if not given, it defaults
3050 \begin_layout Standard
3052 \change_inserted -712698321 1523206384
3053 A suitable hyperref-driver is set for some converters that are installed
3054 with \SpecialChar LyX
3057 \change_deleted -712698321 1523206388
3059 \change_inserted -712698321 1523206389
3063 \change_inserted -712698321 1523206400
3067 \change_inserted -712698321 1523206407
3071 \change_inserted -712698321 1523206437
3075 \change_deleted -712698321 1523206442
3076 that are installed with \SpecialChar LyX
3083 \begin_layout Standard
3084 You do not have to define converters for all formats between which you want
3086 For example, you will note that there is no `\SpecialChar LyX
3087 to PostScript' converter,
3088 but \SpecialChar LyX
3089 will export PostScript.
3090 It does so by first creating a \SpecialChar LaTeX
3091 file (no converter needs to be defined
3092 for this) which is then converted to DVI using the `\SpecialChar LaTeX
3094 and finally converting the resulting DVI file to PostScript.
3096 finds such `chains' of converters automatically, and it will always choose
3097 the shortest possible chain.
3098 You can, though, still define multiple conversion methods between file
3100 For example, the standard \SpecialChar LyX
3101 configuration provides five ways to convert
3106 \begin_layout Enumerate
3108 \begin_inset Flex Noun
3111 \begin_layout Plain Layout
3120 \begin_layout Enumerate
3121 via (DVI and) PostScript, using
3122 \begin_inset Flex Noun
3125 \begin_layout Plain Layout
3134 \begin_layout Enumerate
3136 \begin_inset Flex Noun
3139 \begin_layout Plain Layout
3148 \begin_layout Enumerate
3150 \begin_inset Flex Noun
3153 \begin_layout Plain Layout
3163 \begin_layout Enumerate
3165 \begin_inset Flex Noun
3168 \begin_layout Plain Layout
3178 \begin_layout Standard
3179 To define such alternate chains, you must define multiple target `file formats',
3181 \begin_inset CommandInset ref
3183 reference "sec:Formats"
3188 For example, in the standard configuration, the formats named
3189 \begin_inset Flex Noun
3192 \begin_layout Plain Layout
3199 \begin_inset Flex Noun
3202 \begin_layout Plain Layout
3209 \begin_inset Flex Noun
3212 \begin_layout Plain Layout
3219 \begin_inset Flex Noun
3222 \begin_layout Plain Layout
3229 \begin_inset Flex Noun
3232 \begin_layout Plain Layout
3239 \begin_inset Flex Noun
3242 \begin_layout Plain Layout
3249 \begin_inset Flex Noun
3252 \begin_layout Plain Layout
3259 \begin_inset Flex Noun
3262 \begin_layout Plain Layout
3270 \begin_inset Flex Noun
3273 \begin_layout Plain Layout
3280 \begin_inset Flex Noun
3283 \begin_layout Plain Layout
3290 ) are defined, all of which share the extension
3291 \begin_inset Flex Noun
3294 \begin_layout Plain Layout
3300 , and which correspond to the conversion methods just mentioned.
3303 \begin_layout Chapter
3304 Internationalizing \SpecialChar LyX
3306 \begin_inset CommandInset label
3308 name "cha:Internationalizing-LyX"
3315 \begin_layout Standard
3317 supports using a translated interface.
3318 Last time we checked, \SpecialChar LyX
3319 provided text in thirty languages.
3320 The language of choice is called your
3325 (For further reading on locale settings, see also the documentation for
3326 locale that comes with your operating system.
3327 For Linux, the manual page for
3328 \begin_inset Flex Code
3331 \begin_layout Plain Layout
3337 could be a good place to start).
3340 \begin_layout Standard
3341 Notice that these translations will work, but do contain a few flaws.
3342 In particular, all dialogs have been designed with the English text in
3343 mind, which means that some of the translated text will be too large to
3344 fit within the space allocated.
3345 This is only a display problem and will not cause any harm.
3346 Also, you will find that some of the translations do not define shortcut
3347 keys for everything.
3348 Sometimes, there are simply not enough free letters to do it.
3349 Other times, the translator just hasn't got around to doing it yet.
3350 Our localization team, which you may wish to join,
3354 \begin_layout Plain Layout
3355 If you are a fluent speaker of a language other than English, joining these
3356 teams is a great way to give back to the \SpecialChar LyX
3362 will of course try to fix these shortcomings in future versions of \SpecialChar LyX
3366 \begin_layout Section
3367 Translating \SpecialChar LyX
3371 \begin_layout Subsection
3372 Translating the graphical user interface (text messages).
3375 \begin_layout Standard
3378 \begin_inset Flex Code
3381 \begin_layout Plain Layout
3387 library to handle the internationalization of the interface.
3388 To have \SpecialChar LyX
3389 speak your favorite language in all menus and dialogs, you need
3391 \begin_inset Flex Code
3394 \begin_layout Plain Layout
3400 -file for that language.
3401 When this is available, you'll have to generate a
3402 \begin_inset Flex Code
3405 \begin_layout Plain Layout
3411 -file from it and install the
3412 \begin_inset Flex Code
3415 \begin_layout Plain Layout
3422 The process of doing all of this is explained in the documentation for
3424 \begin_inset Flex Code
3427 \begin_layout Plain Layout
3434 It is possible to do this just for yourself, but if you're going to do
3435 it, you might as well share the results of your labors with the rest of
3436 the \SpecialChar LyX
3438 Send a message to the \SpecialChar LyX
3439 developers' list for more information about how
3443 \begin_layout Standard
3444 In short, this is what you should do (xx denotes the language code):
3447 \begin_layout Itemize
3448 Check out the \SpecialChar LyX
3451 \begin_inset CommandInset href
3453 name "information on the web"
3454 target "https://www.lyx.org/HowToUseGIT"
3462 \begin_layout Itemize
3464 \begin_inset Flex Code
3467 \begin_layout Plain Layout
3473 to the folder of the
3474 \begin_inset Flex Code
3477 \begin_layout Plain Layout
3485 \begin_inset Flex Code
3488 \begin_layout Plain Layout
3496 \begin_inset Flex Code
3499 \begin_layout Plain Layout
3505 doesn't exist anywhere, it can be remade with the console command
3506 \begin_inset Flex Code
3509 \begin_layout Plain Layout
3515 in that directory, or you can use an existing po-file for some other language
3519 \begin_layout Itemize
3521 \begin_inset Flex Code
3524 \begin_layout Plain Layout
3534 \begin_layout Plain Layout
3535 This is just a text file, so it can be edited in any text editor.
3536 But there are also specialized programs that support such editing, such
3541 (for all platforms) or
3550 contains a `mode' for editing
3551 \begin_inset Flex Code
3554 \begin_layout Plain Layout
3561 \begin_inset Flex URL
3564 \begin_layout Plain Layout
3566 https://www.gnu.org/software/gettext/manual/html_node/PO-Mode.html#PO-Mode
3576 For some menu- and widget-labels, there are also shortcut keys that should
3578 Those keys are marked after a `|', and should be translated according to
3579 the words and phrases of the language.
3580 You should also fill also out the information at the beginning of the new
3582 \begin_inset Flex Code
3585 \begin_layout Plain Layout
3591 -file with your email-address, etc., so people know where to reach you with
3592 suggestions and entertaining flames.
3595 \begin_layout Standard
3596 If you are just doing this on your own, then:
3599 \begin_layout Itemize
3601 \begin_inset Flex Code
3604 \begin_layout Plain Layout
3611 This can be done with
3612 \begin_inset Flex Code
3615 \begin_layout Plain Layout
3616 msgfmt -o xx.mo < xx.po
3624 \begin_layout Itemize
3626 \begin_inset Flex Code
3629 \begin_layout Plain Layout
3635 -file to your locale-tree, at the correct directory for application messages
3640 xx, and under the name
3641 \begin_inset Flex Code
3644 \begin_layout Plain Layout
3651 \begin_inset space \thinspace{}
3655 \begin_inset space \space{}
3659 \begin_inset Flex Code
3662 \begin_layout Plain Layout
3663 /usr/local/share/locale/xx/LC_MESSAGES/lyx.mo
3673 \begin_layout Standard
3674 As said, however, it would be best if the new
3675 \begin_inset Flex Code
3678 \begin_layout Plain Layout
3684 file could be added to the \SpecialChar LyX
3685 distribution, so others can use it.
3686 Adding it involves making additional changes to \SpecialChar LyX
3688 So send an email to the developers' mailing list if you're interested in
3692 \begin_layout Subsubsection
3696 \begin_layout Standard
3697 Sometimes it turns out that one English message needs to be translated into
3698 different messages in the target language.
3699 One example is the message
3700 \begin_inset Flex Code
3703 \begin_layout Plain Layout
3709 which has the German translation
3717 , depending upon exactly what the English
3718 \begin_inset Quotes eld
3722 \begin_inset Quotes erd
3727 \begin_inset Flex Code
3730 \begin_layout Plain Layout
3736 does not handle such ambiguous translations.
3737 Therefore you have to add some context information to the message: Instead
3739 \begin_inset Flex Code
3742 \begin_layout Plain Layout
3749 \begin_inset Flex Code
3752 \begin_layout Plain Layout
3753 To[[as in 'From format x to format y']]
3759 \begin_inset Flex Code
3762 \begin_layout Plain Layout
3763 To[[as in 'From page x to page y']].
3768 Now the two occurrences of
3769 \begin_inset Flex Code
3772 \begin_layout Plain Layout
3779 \begin_inset Flex Code
3782 \begin_layout Plain Layout
3788 and can be translated correctly to
3799 \begin_layout Standard
3800 Of course the context information needs to be stripped off the original
3801 message when no translation is used.
3802 Therefore you have to put it in double square brackets at the end of the
3803 message (see the example above).
3804 The translation mechanism of \SpecialChar LyX
3805 ensures that everything in double square
3806 brackets at the end of messages is removed before displaying the message.
3809 \begin_layout Subsection
3810 Translating the documentation.
3813 \begin_layout Standard
3814 The online documentation (in the
3815 \begin_inset Flex Noun
3818 \begin_layout Plain Layout
3824 -menu) can (and should!) be translated.
3825 If there are translated versions of the documentation available
3829 \begin_layout Plain Layout
3830 As of March 2008, at least some of the documents have been translated into
3831 fourteen languages, with the Tutorial available in a few more.
3836 and the locale is set accordingly, these will be used automagically by
3840 looks for translated versions as
3841 \begin_inset Flex Code
3844 \begin_layout Plain Layout
3845 LyXDir/doc/xx/DocName.lyx
3851 \begin_inset Flex Code
3854 \begin_layout Plain Layout
3860 is the code for the language currently in use.
3861 If there are no translated documents, the default English versions will
3863 Note that the translated versions must have the same filenames (
3864 \begin_inset Flex Code
3867 \begin_layout Plain Layout
3873 above) as the original.
3874 If you feel up to translating the documentation (an excellent way to proof-read
3875 the original documentation by the way!), there are a few things you should
3879 \begin_layout Itemize
3880 Check out the documentation translation web page at
3881 \begin_inset CommandInset href
3883 name "https://www.lyx.org/Translation"
3884 target "https://www.lyx.org/Translation"
3890 That way, you can find out which (if any) documents have already been translate
3891 d into your language.
3892 You can also find out who (if anyone) is organizing the effort to translate
3893 the documentation into your language.
3894 If no one is organizing the effort, please let us know that you're interested.
3897 \begin_layout Standard
3898 Once you get to actually translating, here's a few hints for you that may
3902 \begin_layout Itemize
3903 Join the documentation team! There is information on how to do that in
3904 \begin_inset Flex Code
3907 \begin_layout Plain Layout
3914 \begin_inset Flex Noun
3917 \begin_layout Plain Layout
3918 Help\SpecialChar menuseparator
3924 ), which by the way is the first document you should translate.
3927 \begin_layout Itemize
3928 Learn the typographic conventions for the language you are translating to.
3929 Typography is an ancient art and over the centuries, a great variety of
3930 conventions have developed throughout different parts of the world.
3931 Also study the professional terminology amongst typographers in your country.
3932 Inventing your own terminology will only confuse the users.
3935 (Warning! Typography is addictive!)
3938 \begin_layout Itemize
3939 Make a copy of the document.
3940 This will be your working copy.
3941 You can use this as your personal translated help-file by placing it in
3943 \begin_inset Flex Code
3946 \begin_layout Plain Layout
3953 \begin_inset Note Greyedout
3956 \begin_layout Plain Layout
3961 For a complex document with external material (images, etc.), if you make
3963 \begin_inset space \thinspace{}
3967 \begin_inset space \space{}
3970 in a temp dir, beware that the links to external material may be broken
3971 when the document is moved to a different place.
3972 The best way is to retrieve the \SpecialChar LyX
3974 \begin_inset Flex URL
3977 \begin_layout Plain Layout
3979 https://www.lyx.org/HowToUseGIT
3984 ) and to edit the doc file in place.
3992 \begin_layout Itemize
3993 Sometimes the original document (from the \SpecialChar LyX
3994 team) will be updated.
3995 Use the source viewer at
3996 \begin_inset CommandInset href
3998 name "https://www.lyx.org/trac/timeline"
3999 target "https://www.lyx.org/trac/timeline"
4004 to see what has been changed.
4005 That way you can easily see which parts of the translated document need
4009 \begin_layout Standard
4010 If you ever find an error in the original document, fix it and notify the
4011 rest of the documentation team of the changes! (You didn't forget to join
4012 the documentation team, did you?)
4015 \begin_layout Standard
4016 \begin_inset Branch OutDated
4020 \begin_layout Section
4021 International Keyboard Support
4024 \begin_layout Standard
4027 [Editor's Note: The following section is by
4035 It needs to be fixed to conform to the new Documentation Style sheet and
4036 to make use of the new v1.0 features.
4037 The whole thing also needs to be merged with the section following it.-jw
4038 It may also be badly out of date.-rh (2008)]
4041 \begin_layout Subsection
4042 Defining Own Keymaps: Keymap File Format
4045 \begin_layout Standard
4046 Let's look at a keyboard definition file a little closer.
4047 It is a plain text file defining
4050 \begin_layout Itemize
4051 key-to-key or key-to-string translations
4054 \begin_layout Itemize
4058 \begin_layout Itemize
4059 dead keys exceptions
4062 \begin_layout Standard
4063 To define key-to-key or key-to-string translation, use this command:
4066 \begin_layout Quotation
4067 \begin_inset Flex Code
4070 \begin_layout Plain Layout
4079 \begin_inset Flex Code
4082 \begin_layout Plain Layout
4091 \begin_layout Standard
4093 \begin_inset Flex Code
4096 \begin_layout Plain Layout
4102 is the key to be translated and
4103 \begin_inset Flex Code
4106 \begin_layout Plain Layout
4112 is the string to be inserted into the document.
4113 To define dead keys, use:
4116 \begin_layout Quotation
4117 \begin_inset Flex Code
4120 \begin_layout Plain Layout
4129 \begin_inset Flex Code
4132 \begin_layout Plain Layout
4141 \begin_layout Standard
4143 \begin_inset Flex Code
4146 \begin_layout Plain Layout
4152 is a keyboard key and
4153 \begin_inset Flex Code
4156 \begin_layout Plain Layout
4163 The following dead keys are supported (shortcut name is in parentheses):
4166 \begin_layout Quotation
4170 \begin_inset space \hfill{}
4176 \begin_layout Quotation
4178 \begin_inset space \hfill{}
4184 \begin_layout Quotation
4186 \begin_inset space \hfill{}
4192 \begin_layout Quotation
4194 \begin_inset space \hfill{}
4200 \begin_layout Quotation
4202 \begin_inset space \hfill{}
4208 \begin_layout Quotation
4210 \begin_inset space \hfill{}
4217 \begin_layout Plain Layout
4229 \begin_layout Quotation
4231 \begin_inset space \hfill{}
4237 \begin_layout Quotation
4239 \begin_inset space \hfill{}
4246 \begin_layout Plain Layout
4258 \begin_layout Quotation
4260 \begin_inset space \hfill{}
4266 \begin_layout Quotation
4268 \begin_inset space \hfill{}
4274 \begin_layout Quotation
4276 \begin_inset space \hfill{}
4283 \begin_layout Plain Layout
4295 \begin_layout Quotation
4297 \begin_inset space \hfill{}
4304 \begin_layout Plain Layout
4316 \begin_layout Quotation
4318 \begin_inset space \hfill{}
4324 \begin_layout Quotation
4325 hungarian umlaut (hug)
4326 \begin_inset space \hfill{}
4332 \begin_layout Quotation
4334 \begin_inset space \hfill{}
4340 \begin_layout Quotation
4342 \begin_inset space \hfill{}
4349 \begin_layout Plain Layout
4361 \begin_layout Standard
4362 Since in many international keyboards there are exceptions to what some
4363 dead keys should do, you can define them using
4366 \begin_layout Quotation
4367 \begin_inset Flex Code
4370 \begin_layout Plain Layout
4378 deadkey key outstring
4381 \begin_layout Standard
4382 For example, on Slovak keyboard, if you enter caron-o, it generates circumflex-o
4386 \begin_layout Quotation
4387 \begin_inset Flex Code
4390 \begin_layout Plain Layout
4403 \begin_layout Standard
4404 to make it work correctly.
4405 Also, you have to define as exceptions dead keys over i and j, to remove
4406 the dot from them before inserting an accent mark.
4407 I will change this when the time comes, but so far I haven't had time.
4410 \begin_layout Standard
4411 Oh, and about characters: backslash is escaped, so to enter it, you'll need
4414 \begin_inset Flex Code
4417 \begin_layout Plain Layout
4423 have different meaning.
4425 \begin_inset Flex Code
4428 \begin_layout Plain Layout
4434 marks comments, quotes start and end \SpecialChar LaTeX
4436 To enter quote, you'll need to use
4437 \begin_inset Flex Code
4440 \begin_layout Plain Layout
4449 \begin_inset Flex Code
4452 \begin_layout Plain Layout
4459 \begin_inset Flex Code
4462 \begin_layout Plain Layout
4473 \begin_layout Standard
4474 If you make a keyboard description file that works for your language, please
4475 mail it to me, so I can include it in the next keymap distribution.
4478 \begin_layout Standard
4479 More keywords will be supported in keymap configuration file in future,
4483 \begin_layout Itemize
4484 \begin_inset Flex Code
4487 \begin_layout Plain Layout
4498 \begin_inset space \hfill{}
4502 \begin_inset Flex Code
4505 \begin_layout Plain Layout
4514 \begin_layout Itemize
4515 \begin_inset Flex Code
4518 \begin_layout Plain Layout
4529 \begin_inset space \hfill{}
4533 \begin_inset Flex Code
4536 \begin_layout Plain Layout
4542 an external keymap translation program
4545 \begin_layout Standard
4546 Also, it should look into
4547 \begin_inset Flex Code
4550 \begin_layout Plain Layout
4556 file for defaults, too (for example, a
4557 \begin_inset Flex Code
4560 \begin_layout Plain Layout
4568 option to include default keyboard).
4576 \begin_layout Section
4577 International Keymap Stuff
4578 \begin_inset CommandInset label
4580 name "sec:International-Keymap-Stuff"
4587 \begin_layout Standard
4588 \begin_inset Note Note
4591 \begin_layout Plain Layout
4592 In doing the revisions on this document in March 2008, I did not look over
4593 this stuff, as I do not understand it.
4594 It would be good if someone else could do so.
4603 \begin_layout Standard
4604 The next two sections describe the
4605 \begin_inset Flex Code
4608 \begin_layout Plain Layout
4617 \begin_inset Flex Code
4620 \begin_layout Plain Layout
4628 file syntax in detail.
4629 These sections should help you design your own key map if the ones provided
4630 do not meet your needs.
4633 \begin_layout Subsection
4637 \begin_layout Standard
4641 \begin_inset Flex Code
4644 \begin_layout Plain Layout
4650 file maps keystrokes to characters or strings.
4651 As the name suggests, it sets a keyboard mapping.
4653 \begin_inset Flex Code
4656 \begin_layout Plain Layout
4667 \begin_inset Flex Code
4670 \begin_layout Plain Layout
4685 \begin_inset Flex Code
4688 \begin_layout Plain Layout
4701 \begin_inset Flex Code
4704 \begin_layout Plain Layout
4713 \begin_inset Flex Code
4716 \begin_layout Plain Layout
4724 are described in this section.
4727 \begin_layout Labeling
4728 \labelwidthstring 00.00.0000
4729 \begin_inset Flex Code
4732 \begin_layout Plain Layout
4740 Map a character to a string
4743 \begin_layout LyX-Code
4758 \begin_layout Standard
4791 the double-quote (")
4808 must be escaped with a preceding backslash (
4819 \begin_layout Standard
4821 \begin_inset Flex Noun
4824 \begin_layout Plain Layout
4832 statement to cause the symbol
4833 \begin_inset Flex Noun
4836 \begin_layout Plain Layout
4844 to be output for the keystroke
4845 \begin_inset Flex Noun
4848 \begin_layout Plain Layout
4859 \begin_layout LyX-Code
4865 \begin_layout Labeling
4866 \labelwidthstring 00.00.0000
4867 \begin_inset Flex Code
4870 \begin_layout Plain Layout
4878 Specify an accent character
4881 \begin_layout LyX-Code
4890 \begin_layout Standard
4891 This will make the cha
4929 This is the dead key
4933 \begin_layout Plain Layout
4940 refers to a key that does not produce a character by itself, but when followed
4941 with another key, produces the desired accent character.
4942 For example, a German characte
4944 r with an umlaut like
4954 can be produced in this manner.
4963 \begin_layout Standard
4976 and then another key not in
4993 followed by the other, not allowed key, as output.
4997 \begin_inset Flex Noun
5000 \begin_layout Plain Layout
5008 cancels a dead key, so if
5019 \begin_inset Flex Noun
5022 \begin_layout Plain Layout
5031 , the cursor will not go one position backwards but will instead cancel
5047 might have had on the next keystroke.
5051 \begin_layout Standard
5052 The following example specifies that the character ' is to be an acute accent,
5053 allowed on the characters a, e, i, o, u, A, E, I, O, and U:
5056 \begin_layout LyX-Code
5059 kmod ' acute aeiouAEIOU
5062 \begin_layout Labeling
5063 \labelwidthstring 00.00.0000
5064 \begin_inset Flex Code
5067 \begin_layout Plain Layout
5073 Specify an exception to the accent character
5076 \begin_layout LyX-Code
5085 \begin_layout Standard
5086 This defines an exce
5127 have been assigned a keystroke with a previous
5130 \begin_inset Flex Code
5133 \begin_layout Plain Layout
5157 must not belong in the
5204 If such a declaration does not exist in
5212 \begin_inset Flex Code
5215 \begin_layout Plain Layout
5249 \begin_inset Flex Code
5252 \begin_layout Plain Layout
5266 \begin_layout Standard
5267 The following command produces causes äi to be produced when you enter acute-i
5271 \begin_layout LyX-Code
5285 \begin_layout Labeling
5286 \labelwidthstring 00.00.0000
5287 \begin_inset Flex Code
5290 \begin_layout Plain Layout
5296 Combine two accent characters
5299 \begin_layout LyX-Code
5305 accent1 accent2 allowed
5308 \begin_layout Standard
5309 This one is getting pretty esoteric.
5310 It allows you to combine the effect
5366 \begin_inset Flex Code
5369 \begin_layout Plain Layout
5397 \begin_layout Standard
5398 Consider this example from the
5399 \begin_inset Flex Code
5402 \begin_layout Plain Layout
5413 \begin_layout LyX-Code
5416 kmod ; acute aeioyvhAEIOYVH
5420 kcomb acute umlaut iyIY
5423 \begin_layout Standard
5424 This allows you to press
5425 \begin_inset Flex Noun
5428 \begin_layout Plain Layout
5436 and get the effect of
5437 \begin_inset Flex Code
5440 \begin_layout Plain Layout
5459 in this case cancels the last dead key, so if you press
5460 \begin_inset Flex Noun
5463 \begin_layout Plain Layout
5472 \begin_inset Flex Code
5475 \begin_layout Plain Layout
5488 \begin_layout Subsection
5492 \begin_layout Standard
5494 \begin_inset Flex Code
5497 \begin_layout Plain Layout
5505 mapping is performed, a
5506 \begin_inset Flex Code
5509 \begin_layout Plain Layout
5519 file maps the strings that the symbols generate to characters in the current
5521 The \SpecialChar LyX
5522 distribution currently includes at least the
5523 \begin_inset Flex Code
5526 \begin_layout Plain Layout
5535 \begin_inset Flex Code
5538 \begin_layout Plain Layout
5549 \begin_layout Standard
5551 \begin_inset Flex Code
5554 \begin_layout Plain Layout
5562 file is a sequence of declarations of the form
5565 \begin_layout LyX-Code
5578 \begin_layout Standard
5579 For example, in order to map
5580 \begin_inset Flex Noun
5583 \begin_layout Plain Layout
5593 to the corresponding character in the iso-8859-1 set (233), the following
5597 \begin_layout LyX-Code
5605 \begin_layout Standard
5607 \begin_inset Flex Code
5610 \begin_layout Plain Layout
5619 \begin_inset Flex Code
5622 \begin_layout Plain Layout
5640 the same character can apply to more than one string.
5642 \begin_inset Flex Code
5645 \begin_layout Plain Layout
5656 \begin_layout LyX-Code
5668 \begin_inset Newline newline
5684 \begin_layout Standard
5686 cannot find a mapping for the string produced by the keystroke or a
5687 deadkey sequence, it will check if it looks like an accented char and try
5688 to draw an accent over the character on screen.
5691 \begin_layout Subsection
5695 \begin_layout Standard
5696 There is a second way to add support for international characters through
5697 so-called dead-keys.
5698 A dead-key works in combination with a letter to produce an accented character.
5699 Here, we'll explain how to create a really simple dead-key to illustrate
5703 \begin_layout Standard
5704 Suppose you happen to need the circumflex character,
5705 \begin_inset Quotes eld
5709 \begin_inset Quotes erd
5714 \begin_inset Flex Noun
5717 \begin_layout Plain Layout
5724 \begin_inset space ~
5728 \begin_inset Flex Noun
5731 \begin_layout Plain Layout
5737 ] to the \SpecialChar LyX
5739 \begin_inset Flex Code
5742 \begin_layout Plain Layout
5749 \begin_inset Flex Code
5752 \begin_layout Plain Layout
5759 Now, whenever you type the
5760 \begin_inset Flex Noun
5763 \begin_layout Plain Layout
5769 -key followed by a letter, that letter will have a circumflex accent on
5771 For example, the sequence
5772 \begin_inset Quotes eld
5776 \begin_inset Flex Noun
5779 \begin_layout Plain Layout
5786 \begin_inset Quotes erd
5789 produces the letter:
5790 \begin_inset Quotes eld
5794 \begin_inset Quotes erd
5798 If you tried to type
5799 \begin_inset Quotes eld
5803 \begin_inset Flex Noun
5806 \begin_layout Plain Layout
5813 \begin_inset Quotes erd
5816 , however, \SpecialChar LyX
5817 will complain with a beep, since a
5818 \begin_inset Quotes eld
5822 \begin_inset Flex Noun
5825 \begin_layout Plain Layout
5832 \begin_inset Quotes erd
5835 never takes a circumflex accent.
5837 \begin_inset Flex Noun
5840 \begin_layout Plain Layout
5846 after a dead-key produces the bare-accent.
5847 Please note this last point! If you bind a key to a dead-key, you'll need
5848 to rebind the character on that key to yet another key.
5850 \begin_inset Flex Noun
5853 \begin_layout Plain Layout
5859 to a cedilla is a bad idea, since you'll only get cedillas instead of commas.
5862 \begin_layout Standard
5863 One common way to bind dead-keys is to use
5864 \begin_inset Flex Noun
5867 \begin_layout Plain Layout
5874 \begin_inset Flex Noun
5877 \begin_layout Plain Layout
5884 \begin_inset Flex Noun
5887 \begin_layout Plain Layout
5893 in combination with an accent, like
5894 \begin_inset Quotes eld
5898 \begin_inset Flex Noun
5901 \begin_layout Plain Layout
5908 \begin_inset Quotes erd
5912 \begin_inset Quotes eld
5916 \begin_inset Flex Noun
5919 \begin_layout Plain Layout
5926 \begin_inset Quotes erd
5930 \begin_inset Quotes eld
5934 \begin_inset Flex Noun
5937 \begin_layout Plain Layout
5944 \begin_inset Quotes erd
5948 Another way involves using
5949 \begin_inset Flex Code
5952 \begin_layout Plain Layout
5959 \begin_inset Flex Code
5962 \begin_layout Plain Layout
5968 to set up the special
5969 \begin_inset Flex Code
5972 \begin_layout Plain Layout
5980 \begin_inset Flex Code
5983 \begin_layout Plain Layout
5989 acts in some ways just like
5990 \begin_inset Flex Noun
5993 \begin_layout Plain Layout
5999 and permits you to bind keys to accented characters.
6000 You can also turn keys into dead-keys by binding them to something like
6002 \begin_inset Flex Code
6005 \begin_layout Plain Layout
6011 and then binding this symbolic key to the corresponding \SpecialChar LyX
6016 \begin_layout Plain Layout
6021 : This is exactly what I do in my
6022 \begin_inset Flex Code
6025 \begin_layout Plain Layout
6032 \begin_inset Flex Code
6035 \begin_layout Plain Layout
6043 \begin_inset Flex Noun
6046 \begin_layout Plain Layout
6048 \begin_inset space ~
6057 \begin_inset Flex Code
6060 \begin_layout Plain Layout
6066 and a bunch of these
6067 \begin_inset Quotes eld
6071 \begin_inset Flex Code
6074 \begin_layout Plain Layout
6081 \begin_inset Quotes erd
6084 symbolic keys bound such things as
6085 \begin_inset Flex Noun
6088 \begin_layout Plain Layout
6090 \begin_inset space ~
6099 \begin_inset Flex Noun
6102 \begin_layout Plain Layout
6104 \begin_inset space ~
6113 This is how I produce my accented characters.
6118 You can make just about anything into the
6119 \begin_inset Flex Code
6122 \begin_layout Plain Layout
6129 \begin_inset Flex Noun
6132 \begin_layout Plain Layout
6138 keys, a spare function key, etc.
6139 As for the \SpecialChar LyX
6140 commands that produce accents, check the entry for
6141 \begin_inset Flex Code
6144 \begin_layout Plain Layout
6155 You'll find the complete list there.
6158 \begin_layout Subsection
6159 Saving your Language Configuration
6162 \begin_layout Standard
6163 You can edit your preferences so that your desired language environment
6164 is automatically configured when \SpecialChar LyX
6166 \begin_inset Flex Noun
6169 \begin_layout Plain Layout
6170 Edit\SpecialChar menuseparator
6179 \begin_layout Chapter
6180 Installing New Document Classes, Layouts, and Templates
6181 \begin_inset CommandInset label
6183 name "cha:Installing-New-Document"
6188 \begin_inset Argument 1
6191 \begin_layout Plain Layout
6192 Installing New Document Classes
6200 \begin_layout Standard
6201 In this chapter, we describe the procedures for creating and installing
6202 new \SpecialChar LyX
6203 layout and template files, as well as offer a refresher on correctly
6204 installing new \SpecialChar LaTeX
6209 \begin_layout Standard
6210 First, let us a say a few words about how one ought to think about the relation
6211 between \SpecialChar LyX
6212 and \SpecialChar LaTeX
6214 The thing to understand is that, in a certain sense, \SpecialChar LyX
6215 doesn't know anything
6216 about \SpecialChar LaTeX
6218 Indeed, from \SpecialChar LyX
6219 's point of view, \SpecialChar LaTeX
6220 is just one of several
6221 \begin_inset Quotes eld
6225 \begin_inset Quotes erd
6228 in which it is capable of producing output.
6229 Other such formats are DocBook, plaintext, and XHTML.
6231 is, of course, a particularly important format, but very little of the
6232 information \SpecialChar LyX
6233 has about \SpecialChar LaTeX
6234 is actually contained in the program itself.
6238 \begin_layout Plain Layout
6239 Some commands are sufficiently complex that they are
6240 \begin_inset Quotes eld
6244 \begin_inset Quotes erd
6247 into \SpecialChar LyX
6249 But the developers generally regard this as a Bad Thing.
6254 Rather, that information, even for the standard classes like
6255 \begin_inset Flex Code
6258 \begin_layout Plain Layout
6264 , is contained in `layout files'.
6265 Similarly, \SpecialChar LyX
6266 itself does not know much about DocBook or XHTML.
6267 What it knows is contained in layout files.
6270 \begin_layout Standard
6271 You can think of the layout file for a given document class as a translation
6272 manual between \SpecialChar LyX
6273 constructs—paragraphs with their corresponding styles,
6274 certain sorts of insets, etc—and the corresponding \SpecialChar LaTeX
6277 Almost everything \SpecialChar LyX
6279 \begin_inset Flex Code
6282 \begin_layout Plain Layout
6288 , for example, is contained in the file
6289 \begin_inset Flex Code
6292 \begin_layout Plain Layout
6298 and in various other files it includes.
6299 For this reason, anyone intending to write layout files should plan to
6300 study the existing files.
6301 A good place to start is with
6302 \begin_inset Flex Code
6305 \begin_layout Plain Layout
6311 , which is included in
6312 \begin_inset Flex Code
6315 \begin_layout Plain Layout
6322 \begin_inset Flex Code
6325 \begin_layout Plain Layout
6331 , and many of the other layout files for document classes.
6332 This file is where sections and the like are defined:
6333 \begin_inset Flex Code
6336 \begin_layout Plain Layout
6342 tells \SpecialChar LyX
6343 how paragraphs that are marked with the Section, Subsection, etc,
6344 styles can be translated into corresponding \SpecialChar LaTeX
6345 , DocBook, and XHTML commands
6348 \begin_inset Flex Code
6351 \begin_layout Plain Layout
6357 file basically just includes several of these
6358 \begin_inset Flex Code
6361 \begin_layout Plain Layout
6370 \begin_layout Standard
6371 Defining the \SpecialChar LyX
6373 correspondence is not the only thing layout files do, though.
6374 Their other job is to define how the \SpecialChar LyX
6375 constructs themselves will appear
6377 The fact that layout files have these two jobs is often a source of confusion,
6378 because they are completely separate.
6379 Telling \SpecialChar LyX
6380 how to translate a certain paragraph style into \SpecialChar LaTeX
6383 how to display it; conversely, telling \SpecialChar LyX
6384 how to display a certain paragraph
6385 style does not tell \SpecialChar LyX
6386 how to translate it into \SpecialChar LaTeX
6387 (let alone tell \SpecialChar LaTeX
6390 So, in general, when you define a new \SpecialChar LyX
6391 construct, you must always do two
6392 quite separate things: (i)
6393 \begin_inset space ~
6396 tell \SpecialChar LyX
6397 how to translate it into \SpecialChar LaTeX
6399 \begin_inset space ~
6402 tell \SpecialChar LyX
6406 \begin_layout Standard
6407 Much the same is true, of course, as regards \SpecialChar LyX
6408 's other backend formats, though
6409 XHTML is in some ways different, because in that case \SpecialChar LyX
6414 able, to some extent, to use information about how it should display a
6415 paragraph on the screen to output information (in the form of CSS) about
6416 how the paragraph should be displayed in a browser.
6417 Even in this case, however, the distinction between what \SpecialChar LyX
6419 and how things are rendered externally remains in force, and the two can
6420 be controlled separately.
6422 \begin_inset CommandInset ref
6424 reference "sec:Tags-for-XHTML"
6431 \begin_layout Section
6432 Installing new \SpecialChar LaTeX
6436 \begin_layout Standard
6437 Some installations may not include a \SpecialChar LaTeX
6438 package or class file that you would
6439 like to use within \SpecialChar LyX
6441 For example, you might need Foil\SpecialChar TeX
6442 , a package for preparing slides for overhead
6444 Modern \SpecialChar LaTeX
6445 distributions like \SpecialChar TeX
6446 Live (2008 or newer) or MiK\SpecialChar TeX
6447 provide a user interface
6448 for installing such packages.
6449 For example, with MiK\SpecialChar TeX
6450 , you start the program
6451 \begin_inset Quotes eld
6455 \begin_inset space ~
6459 \begin_inset Quotes erd
6462 to get a list of available packages.
6463 To install one of them, right click on it or use the corresponding toolbar
6467 \begin_layout Standard
6468 If your \SpecialChar LaTeX
6469 distribution does not provide such a `package manager', or if the
6470 package is not available from your distribution, then follow these steps
6471 to install it manually:
6474 \begin_layout Enumerate
6475 Get the package from
6476 \begin_inset CommandInset href
6479 target "http://www.ctan.org/"
6487 \begin_layout Enumerate
6488 If the package contains a file with the ending
6489 \begin_inset Quotes eld
6493 \begin_inset Flex Code
6496 \begin_layout Plain Layout
6503 \begin_inset Quotes erd
6506 (is the case for Foil\SpecialChar TeX
6507 ) then open a console, change to the folder of this
6508 file and execute the command
6509 \begin_inset Flex Code
6512 \begin_layout Plain Layout
6519 You have now unpacked the package and have all files to install it.
6520 Most \SpecialChar LaTeX
6521 -packages are not packed and you can skip this step.
6524 \begin_layout Enumerate
6525 Now you need to decide if the package should be available for all users
6530 \begin_layout Enumerate
6531 On *nix systems (Linux, OSX, etc.), if you want the new package to be available
6532 for all users on your system, then install it in your `local' \SpecialChar TeX
6534 install it in your own `user' \SpecialChar TeX
6536 Where these trees should be created, if they do not already exist, depends
6538 To find this out, look in the file
6539 \begin_inset Flex Code
6542 \begin_layout Plain Layout
6552 \begin_layout Plain Layout
6553 This is usually in the directory
6554 \begin_inset Flex Code
6557 \begin_layout Plain Layout
6563 , though you can execute the command
6564 \begin_inset Flex Code
6567 \begin_layout Plain Layout
6578 The location of the `local' \SpecialChar TeX
6579 tree is defined by the
6580 \begin_inset Flex Code
6583 \begin_layout Plain Layout
6589 variable; this is usually somewhere like
6590 \begin_inset Flex Code
6593 \begin_layout Plain Layout
6594 /usr/local/share/texmf
6599 or /usr/local/texlive/XXXX where XXXX is the year of the installed \SpecialChar TeX
6602 The location of the `user' \SpecialChar TeX
6604 \begin_inset Flex Code
6607 \begin_layout Plain Layout
6614 \begin_inset Flex Code
6617 \begin_layout Plain Layout
6624 \begin_inset Flex Code
6627 \begin_layout Plain Layout
6636 (If these variables are not predefined, you have to define them.) You'll
6637 probably need root permissions to create or modify the `local' tree, but
6638 not for your `user' tree.
6639 \begin_inset Newline newline
6642 In general, it is recommended to install in the user tree because your user
6643 will not be modified or even overwritten when you upgrade your system.
6644 It will typically also be backed up together with everything else when
6645 you backup your home directory (which, of course, you do on a regular basis).
6648 \begin_layout Enumerate
6649 On Windows, if you want the new package to be available for all users on
6650 your system, change to the folder where \SpecialChar LaTeX
6651 is installed and then change to
6653 \begin_inset Flex Code
6656 \begin_layout Plain Layout
6667 (For MiK\SpecialChar TeX
6668 , this would be by default the folder
6669 \begin_inset Flex Code
6672 \begin_layout Plain Layout
6690 \begin_layout Plain Layout
6691 Note that this will be the correct path only on English installations.
6692 On a German one, it would be
6693 \begin_inset Flex Code
6696 \begin_layout Plain Layout
6710 , and similarly for other languages.
6715 Create there a new folder
6716 \begin_inset Flex Code
6719 \begin_layout Plain Layout
6725 and copy all files of the package into it.
6727 \begin_inset Newline newline
6730 If the package should only available for you or you don't have admin permissions
6731 , do the same, but in the local \SpecialChar LaTeX
6734 \begin_inset space \thinspace{}
6737 g., for MiK\SpecialChar TeX
6739 \begin_inset space ~
6742 2.8 under Windows XP, this would be the folder:
6743 \begin_inset Newline newline
6749 \begin_inset Flex Code
6752 \begin_layout Plain Layout
6755 Documents and Settings
6767 \begin_inset Newline newline
6773 \begin_inset Phantom HPhantom
6776 \begin_layout Plain Layout
6787 \begin_inset Flex Code
6790 \begin_layout Plain Layout
6803 \begin_inset Newline newline
6806 On Vista, it would be:
6807 \begin_inset Newline newline
6811 \begin_inset Flex Code
6814 \begin_layout Plain Layout
6840 \begin_layout Enumerate
6841 Now one only need to tell \SpecialChar LaTeX
6842 that there are new files.
6843 This depends on the used \SpecialChar LaTeX
6848 \begin_layout Enumerate
6849 For \SpecialChar TeX
6850 Live execute the command
6851 \begin_inset Flex Code
6854 \begin_layout Plain Layout
6861 If you installed the package for all users, then you will probably need
6862 to have root permissions for that.
6865 \begin_layout Enumerate
6866 For MiK\SpecialChar TeX
6867 , if you have installed the package for all users, start the program
6869 \begin_inset Quotes eld
6873 \begin_inset space ~
6877 \begin_inset Quotes erd
6880 and press the button marked
6881 \begin_inset Quotes eld
6885 \begin_inset Quotes erd
6889 Otherwise start the program
6890 \begin_inset Quotes eld
6894 \begin_inset Quotes erd
6901 \begin_layout Enumerate
6902 Finally, you need to tell \SpecialChar LyX
6903 that there are new packages available.
6904 So, in \SpecialChar LyX
6906 \begin_inset Flex Noun
6909 \begin_layout Plain Layout
6912 \SpecialChar menuseparator
6918 and then restart \SpecialChar LyX
6922 \begin_layout Standard
6923 Now the package is installed.
6924 In our example, the document class
6925 \begin_inset Flex Code
6928 \begin_layout Plain Layout
6934 will now be available under
6935 \begin_inset Flex Noun
6938 \begin_layout Plain Layout
6939 Document\SpecialChar menuseparator
6940 Settings\SpecialChar menuseparator
6947 \begin_inset Quotes eld
6951 \begin_inset Quotes erd
6958 \begin_layout Standard
6959 If you would like to use a \SpecialChar LaTeX
6960 document class that is not even listed in the
6962 \begin_inset Flex Noun
6965 \begin_layout Plain Layout
6966 Document\SpecialChar menuseparator
6967 Settings\SpecialChar menuseparator
6973 , then you need to create a `layout' file for it.
6974 That is the topic of the next section.
6977 \begin_layout Section
6978 Types of layout files
6981 \begin_layout Standard
6982 This section describes the various sorts of \SpecialChar LyX
6983 files that contain layout informati
6985 These files describe various paragraph and character styles, determining
6986 how \SpecialChar LyX
6987 should display them and how they should be translated into \SpecialChar LaTeX
6989 XHTML, or whatever output format is being used.
6993 \begin_layout Standard
6994 We shall try to provide a thorough description of the process of writing
6996 However, there are so many different types of documents supported even
6997 by just \SpecialChar LaTeX
6998 that we can't hope to cover every different possibility or problem
6999 you might encounter.
7000 The \SpecialChar LyX
7001 users' list is frequented by people with lots of experience with layout
7002 design who are willing to share what they've learned, so please feel free
7003 to ask questions there.
7006 \begin_layout Standard
7007 As you prepare to write a new layout, it is extremely helpful to look at
7008 the layouts distributed with \SpecialChar LyX
7010 If you write a \SpecialChar LyX
7011 layout for a \SpecialChar LaTeX
7012 document class that might also be used by
7013 others, or write a module that might be useful to others, then you should
7014 consider posting your layout to the
7015 \begin_inset CommandInset href
7017 name "layout section on the LyX wiki"
7018 target "https://wiki.lyx.org/Layouts/Layouts"
7023 or even to the \SpecialChar LyX
7024 developers' list, so that it might be included in \SpecialChar LyX
7029 \begin_layout Plain Layout
7030 Note that \SpecialChar LyX
7031 is licensed under the General Public License, so any material
7032 that is contributed to \SpecialChar LyX
7033 must be similarly licensed.
7041 \begin_layout Subsection
7043 \begin_inset CommandInset label
7045 name "subsec:Layout-modules"
7052 \begin_layout Standard
7053 We have spoken to this point about `layout files'.
7054 But there are different sorts of files that contain layout information.
7055 Layout files, strictly so called, have the
7056 \begin_inset Flex Code
7059 \begin_layout Plain Layout
7065 extension and provide \SpecialChar LyX
7066 with information about document classes.
7067 Since \SpecialChar LyX
7068 1.6 layout information can also be contained in layout
7073 \begin_inset Flex Code
7076 \begin_layout Plain Layout
7083 Modules are to \SpecialChar LaTeX
7084 packages much as layouts are to \SpecialChar LaTeX
7085 classes, and some modules—such
7087 \begin_inset Flex Code
7090 \begin_layout Plain Layout
7096 module—specifically provide support for one package.
7097 In a sense, layout modules are similar to included
7101 \begin_layout Plain Layout
7102 These can have any extension, but by convention have the
7103 \begin_inset Flex Code
7106 \begin_layout Plain Layout
7118 \begin_inset Flex Code
7121 \begin_layout Plain Layout
7127 —in that modules are not specific to a given document class but may be used
7128 with many different classes.
7129 The difference is that using an included file with
7130 \begin_inset Flex Code
7133 \begin_layout Plain Layout
7139 requires editing that file.
7140 Modules, by contrast, are selected in the
7141 \begin_inset Flex Noun
7144 \begin_layout Plain Layout
7145 Document\SpecialChar menuseparator
7154 \begin_layout Standard
7155 Building modules is the easiest way to get started with layout editing,
7156 since it can be as simple as adding a single new paragraph style or flex
7158 But modules may, in principle, contain anything a layout file can contain.
7161 \begin_layout Standard
7162 After creating a new module and copying it to the
7163 \begin_inset Flex Code
7166 \begin_layout Plain Layout
7172 folder, you will need to reconfigure and then restart \SpecialChar LyX
7175 However, changes you make to the module will be seen immediately, if you
7177 \begin_inset Flex Noun
7180 \begin_layout Plain Layout
7181 Document\SpecialChar menuseparator
7187 , highlight something, and then hit
7188 \begin_inset Quotes eld
7192 \begin_inset Quotes erd
7198 It is strongly recommended that you save your work before doing this
7203 it is strongly recommended that you not attempt to edit modules while simultaneo
7204 usly working on actual documents
7207 Though of course the developers strive to keep \SpecialChar LyX
7208 stable in such situations,
7209 syntax errors and the like in your module file could cause strange behavior.
7212 \begin_layout Subsubsection
7216 \begin_layout Standard
7217 Modules are to \SpecialChar LyX
7218 as packages are to \SpecialChar LaTeX
7220 Sometimes, however, you find yourself wanting a specific inset or character
7221 style just for one document and writing a module that will also be available
7222 to other documents makes little sense.
7223 What you need is \SpecialChar LyX
7225 \begin_inset Quotes eld
7229 \begin_inset Quotes erd
7235 \begin_layout Standard
7236 You will find it under
7238 Document\SpecialChar menuseparator
7239 Settings\SpecialChar menuseparator
7243 The large text box allows you to enter anything that you might enter in
7244 a layout file or module.
7245 You can think of a document's local layout, in fact, as a module that belongs
7247 So, in particular, you must enter a
7248 \begin_inset Flex Code
7251 \begin_layout Plain Layout
7258 Any format is acceptable, but one would normally use the format current
7260 (In \SpecialChar LyX
7267 , the current layout format is
7276 \begin_layout Standard
7277 When you have entered something in the
7278 \begin_inset Flex Code
7281 \begin_layout Plain Layout
7287 pane, \SpecialChar LyX
7289 \begin_inset Quotes eld
7293 \begin_inset Quotes erd
7296 button at the bottom.
7297 Clicking this button will cause \SpecialChar LyX
7298 to determine whether what you have entered
7299 is valid layout information for the chosen format.
7301 will report the result but, unfortunately, will not tell you what errors
7302 there might have been.
7303 These will be written to the terminal, however, if \SpecialChar LyX
7304 is started from a terminal.
7305 You will not be permitted to save your local layout until you have entered
7309 \begin_layout Standard
7310 The warnings at the end of the previous section apply here, too.
7311 Do not play with local layout while you are actually working, especially
7312 if you have not saved your document.
7313 That said, using local layout with a test document can be a very convenient
7314 way to try out layout ideas, or even to start developing a module.
7317 \begin_layout Subsection
7319 \begin_inset Flex Noun
7322 \begin_layout Plain Layout
7331 \begin_layout Standard
7332 There are two situations you are likely to encounter when wanting to support
7333 a new \SpecialChar LaTeX
7334 document class, involving style (
7335 \begin_inset Flex Code
7338 \begin_layout Plain Layout
7344 ) files and \SpecialChar LaTeX2e
7346 \begin_inset Flex Code
7349 \begin_layout Plain Layout
7356 Supporting a style file is usually fairly easy.
7357 Supporting a new class file is a bit harder.
7358 We'll discuss the former in this section and the latter in the next.
7360 \change_deleted 5863208 1594239023
7361 Similar remarks apply, of course, if you want to support a new DocBook DTD.
7366 \begin_layout Standard
7367 The easier case is the one in which your new document class is provided
7368 as a style file that is to be used in conjunction with an already supported
7370 For the sake of the example, we'll assume that the style file is called
7372 \begin_inset Flex Noun
7375 \begin_layout Plain Layout
7381 and that it is meant to be used with
7382 \begin_inset Flex Noun
7385 \begin_layout Plain Layout
7391 , which is a standard class.
7395 \begin_layout Standard
7396 Start by copying the existing class's layout file into your local directory:
7400 \begin_layout Plain Layout
7401 Of course, which directory is your local directory will vary by platform,
7402 and \SpecialChar LyX
7403 allows you to specify your local directory on startup, too, using
7405 \begin_inset Flex Code
7408 \begin_layout Plain Layout
7422 \begin_layout LyX-Code
7423 cp report.layout ~/.lyx/layouts/myclass.layout
7426 \begin_layout Standard
7428 \begin_inset Flex Code
7431 \begin_layout Plain Layout
7437 and change the line:
7440 \begin_layout LyX-Code
7443 DeclareLaTeXClass{Report (Standard Class)}
7446 \begin_layout Standard
7450 \begin_layout LyX-Code
7453 DeclareLaTeXClass[report, myclass.sty]{Report (My Class)}
7456 \begin_layout Standard
7460 \begin_layout LyX-Code
7462 \begin_inset Newline newline
7468 \begin_inset Newline newline
7474 \begin_layout Standard
7475 near the top of the file.
7478 \begin_layout Standard
7479 Start \SpecialChar LyX
7481 \begin_inset Flex Noun
7484 \begin_layout Plain Layout
7485 Tools\SpecialChar menuseparator
7492 Then restart \SpecialChar LyX
7493 and try creating a new document.
7495 \begin_inset Flex Noun
7498 \begin_layout Plain Layout
7504 " as a document class option in the
7505 \begin_inset Flex Noun
7508 \begin_layout Plain Layout
7509 Document\SpecialChar menuseparator
7516 It is likely that some of the sectioning commands and such in your new
7517 class will work differently from how they worked in the base class—
7518 \begin_inset Flex Code
7521 \begin_layout Plain Layout
7527 in this example—so you can fiddle around with the settings for the different
7528 sections if you wish.
7529 The layout information for sections is contained in
7530 \begin_inset Flex Code
7533 \begin_layout Plain Layout
7539 , but you do not need to copy and change this file.
7540 Instead, you can simply add your changes to your layout file, after the
7542 \begin_inset Flex Code
7545 \begin_layout Plain Layout
7551 , which itself includes
7552 \begin_inset Flex Code
7555 \begin_layout Plain Layout
7562 For example, you might add these lines:
7565 \begin_layout LyX-Code
7569 \begin_layout LyX-Code
7573 \begin_layout LyX-Code
7577 \begin_layout LyX-Code
7581 \begin_layout LyX-Code
7585 \begin_layout Standard
7586 to change the font for chapter headings to sans-serif.
7587 This will override (or, in this case, add to) the existing declaration
7588 for the Chapter style.
7592 \begin_layout Standard
7593 Your new package may also provide commands or environments not present in
7595 In this case, you will want to add these to the layout file.
7597 \begin_inset CommandInset ref
7599 reference "sec:TextClass"
7603 for information on how to do so.
7606 \begin_layout Standard
7608 \begin_inset Flex Noun
7611 \begin_layout Plain Layout
7617 can be used with several different document classes, and even if it cannot,
7618 you might find it easiest just to write a module that you can load with
7620 The simplest possible such module would be:
7623 \begin_layout LyX-Code
7626 DeclareLyXModule{My Class}
7629 \begin_layout LyX-Code
7633 \begin_layout LyX-Code
7634 #Support for myclass.sty.
7637 \begin_layout LyX-Code
7639 \begin_inset Newline newline
7645 \begin_layout LyX-Code
7653 \begin_inset Newline newline
7659 \begin_layout LyX-Code
7661 \begin_inset Newline newline
7667 \begin_inset Newline newline
7673 \begin_layout Standard
7674 A more complex module might modify the behavior of some existing constructs
7675 or define some new ones.
7677 \begin_inset CommandInset ref
7679 reference "sec:TextClass"
7686 \begin_layout Subsection
7688 \begin_inset Flex Noun
7691 \begin_layout Plain Layout
7700 \begin_layout Standard
7701 There are two possibilities here.
7702 One is that the class file is itself based upon an existing document class.
7703 For example, many thesis classes are based upon
7704 \begin_inset Flex Noun
7707 \begin_layout Plain Layout
7714 To see whether yours is, look for a line like
7717 \begin_layout LyX-Code
7723 \begin_layout Standard
7725 If so, then you may proceed largely as in the previous section, though
7727 \begin_inset Flex Code
7730 \begin_layout Plain Layout
7731 Declare\SpecialChar LaTeX
7737 line will be different.
7738 If your new class is
7739 \begin_inset Flex Code
7742 \begin_layout Plain Layout
7748 and it is based upon
7749 \begin_inset Flex Code
7752 \begin_layout Plain Layout
7758 , then the line should read:
7762 \begin_layout Plain Layout
7763 And it will be easiest if you save the file to
7764 \begin_inset Flex Code
7767 \begin_layout Plain Layout
7774 assumes that the document class has the same name as the layout file.
7783 \begin_layout LyX-Code
7786 DeclareLaTeXClass[thesis,book]{thesis}
7789 \begin_layout Standard
7790 If, on the other hand, the new class is not based upon an existing class,
7791 you will probably have to
7792 \begin_inset Quotes eld
7796 \begin_inset Quotes erd
7800 We strongly suggest copying an existing layout file which uses a similar
7802 class and then modifying it, if you can do so.
7803 At least use an existing file as a starting point so you can find out what
7804 items you need to worry about.
7805 Again, the specifics are covered below.
7808 \begin_layout Subsection
7810 \begin_inset CommandInset label
7812 name "subsec:Creating-Templates"
7819 \begin_layout Standard
7820 Once you have written a layout file for a new document class, you might
7821 want to consider writing a
7826 A template acts as a kind of tutorial for your layout, showing how it might
7827 be used, though containing dummy content.
7828 You can of course look at the various templates included with \SpecialChar LyX
7832 \begin_layout Standard
7833 Templates are created just like usual documents: using \SpecialChar LyX
7835 The only difference is that usual documents contain all possible settings,
7836 including the font scheme and the paper size.
7837 Usually a user doesn't want a template to overwrite his preferred settings
7838 for such parameters.
7839 For that reason, the designer of a template should remove the corresponding
7841 \begin_inset Flex Code
7844 \begin_layout Plain Layout
7853 \begin_inset Flex Code
7856 \begin_layout Plain Layout
7864 from the template \SpecialChar LyX
7866 This can be done with any simple text-editor, for example
7867 \begin_inset Flex Code
7870 \begin_layout Plain Layout
7877 \begin_inset Flex Code
7880 \begin_layout Plain Layout
7889 \begin_layout Standard
7890 Put the edited template files you create in
7891 \begin_inset Flex Code
7894 \begin_layout Plain Layout
7900 , copy the ones you use from the global template directory in
7901 \begin_inset Flex Code
7904 \begin_layout Plain Layout
7910 to the same place, and redefine the template path in the
7911 \begin_inset Flex Noun
7914 \begin_layout Plain Layout
7915 Tools\SpecialChar menuseparator
7916 Preferences\SpecialChar menuseparator
7925 \begin_layout Standard
7926 Note, by the way, that there is a template which has a particular meaning:
7927 \begin_inset Newline linebreak
7931 \begin_inset Flex Code
7934 \begin_layout Plain Layout
7941 This template is loaded every time you create a new document with
7942 \begin_inset Flex Noun
7945 \begin_layout Plain Layout
7946 File\SpecialChar menuseparator
7952 in order to provide useful defaults.
7953 To create this template from inside \SpecialChar LyX
7954 , all you have to do is to open a document
7955 with the correct settings, and use the
7956 \begin_inset Flex Noun
7959 \begin_layout Plain Layout
7960 Save as Document Defaults
7968 \begin_layout Subsection
7969 Upgrading old layout files
7972 \begin_layout Standard
7973 The format of layout files changes with each \SpecialChar LyX
7974 release, so old layout files
7975 need to be converted to the new format.
7977 reads a layout file in an older format, it automatically calls the
7979 \begin_inset Flex Code
7982 \begin_layout Plain Layout
7988 to convert it to a temporary file in current format.
7989 The original file is left untouched.
7990 If you use the layout file often, then, you may want to convert it permanently,
7991 so that \SpecialChar LyX
7992 does not have to do so itself every time.
7993 To do this, you can call the converter manually:
7996 \begin_layout Enumerate
7998 \begin_inset Flex Code
8001 \begin_layout Plain Layout
8008 \begin_inset Flex Code
8011 \begin_layout Plain Layout
8020 \begin_layout Enumerate
8022 \begin_inset Newline newline
8026 \begin_inset Flex Code
8029 \begin_layout Plain Layout
8030 python LyXDir/scripts/layout2layout.py myclass.old myclass.layout
8036 \begin_inset Newline newline
8040 \begin_inset Flex Code
8043 \begin_layout Plain Layout
8049 is the name of your \SpecialChar LyX
8053 \begin_layout Standard
8054 Note that manual conversion does not affect included files, so these will
8055 have to be converted separately.
8058 \begin_layout Subsection
8059 \begin_inset CommandInset label
8061 name "subsec:Cite-Engine-Files"
8068 \begin_layout Standard
8069 A specific form of layout files are the so-called
8070 \begin_inset Flex Code
8073 \begin_layout Plain Layout
8079 files that are located in the
8080 \begin_inset Flex Code
8083 \begin_layout Plain Layout
8090 Their purpose is to define the specifics of \SpecialChar LaTeX
8091 packages aimed at bibliography
8104 , but also the way how normal Bib\SpecialChar TeX
8105 citations (without additional packages)
8106 are handled in \SpecialChar LyX
8107 is defined in such a file.
8111 \begin_layout Standard
8112 More specifically, it is defined which packages \SpecialChar LyX
8113 needs to load, which citation
8114 commands are available, how these are to be displayed in \SpecialChar LyX
8116 the dialogs, the context menus) as well as in the XHTML and plain text
8118 Furthermore, the files specify available style variants (author-year, numerical
8119 , etc.) and their specifics.
8120 The cite engine files are also used to generate the options that are available
8123 Document\SpecialChar menuseparator
8124 Settings\SpecialChar menuseparator
8125 Bibliography\SpecialChar menuseparator
8131 \begin_layout Standard
8132 Even though a cite engine file is essentially a normal layout file that
8133 could theoretically include any layout information, it usually primarily
8134 includes some specific parameters such as
8135 \begin_inset Flex Code
8138 \begin_layout Plain Layout
8145 \begin_inset Flex Code
8148 \begin_layout Plain Layout
8155 \begin_inset Flex Code
8158 \begin_layout Plain Layout
8165 \begin_inset Flex Code
8168 \begin_layout Plain Layout
8175 The syntax of the latter two is described in
8176 \begin_inset CommandInset ref
8178 reference "subsec:Citation-engine-description"
8186 \begin_inset CommandInset ref
8188 reference "subsec:Citation-format-description"
8192 , as well as in the files themselves.
8195 \begin_layout Section
8196 \begin_inset CommandInset label
8198 name "sec:TextClass"
8202 The layout file format
8205 \begin_layout Standard
8206 The following sections describe how layout files are structured and written.
8207 Our advice is to go slowly, save and test often.
8208 It is really not that hard, except that the multitude of options can become
8209 overwhelming, especially if you try to check out too many at once.
8210 It becomes easier if you use existing layouts of \SpecialChar LyX
8211 as examples/reference
8212 or if you modify an existing layout to your needs.
8215 \begin_layout Standard
8216 Note that all the tags used in layout files are case-insensitive.
8218 \begin_inset Flex Code
8221 \begin_layout Plain Layout
8228 \begin_inset Flex Code
8231 \begin_layout Plain Layout
8238 \begin_inset Flex Code
8241 \begin_layout Plain Layout
8247 are really the same tag.
8248 The possible arguments are printed in brackets after the tag's name.
8249 The default argument is typeset
8250 \begin_inset Flex Code
8253 \begin_layout Plain Layout
8262 If the argument has a data type like
8263 \begin_inset Quotes eld
8267 \begin_inset Quotes erd
8271 \begin_inset Quotes eld
8275 \begin_inset Quotes erd
8278 , the default is shown like this:
8279 \begin_inset Flex Code
8282 \begin_layout Plain Layout
8293 \begin_layout Subsection
8294 The document class declaration and classification
8297 \begin_layout Standard
8298 Lines in a layout file which begin with
8299 \begin_inset Flex Code
8302 \begin_layout Plain Layout
8309 There is one exception to this rule.
8311 \begin_inset Flex Code
8314 \begin_layout Plain Layout
8320 files should begin with lines like:
8323 \begin_layout LyX-Code
8326 #% Do not delete the line below; configure depends on this
8329 \begin_layout LyX-Code
8334 DeclareLaTeXClass{Article (Standard Class)}
8337 \begin_layout LyX-Code
8342 DeclareCategory{Articles}
8345 \begin_layout Standard
8346 The second and third lines are used when you (re)configure \SpecialChar LyX
8348 The layout file is read by the \SpecialChar LaTeX
8350 \begin_inset Flex Code
8353 \begin_layout Plain Layout
8359 , in a special mode where
8360 \begin_inset Flex Code
8363 \begin_layout Plain Layout
8370 The first line is just a \SpecialChar LaTeX
8371 comment, the second one contains the mandatory
8372 declaration of the text class and the third line contains the optional
8373 classification of the class.
8374 If these lines appear in a file named
8375 \begin_inset Flex Code
8378 \begin_layout Plain Layout
8384 , then they define a text class of name
8385 \begin_inset Flex Code
8388 \begin_layout Plain Layout
8394 (the name of the layout file) which uses the \SpecialChar LaTeX
8396 \begin_inset Flex Code
8399 \begin_layout Plain Layout
8405 (the default is to use the same name as the layout).
8407 \begin_inset Quotes eld
8410 Article (Standard Class)
8411 \begin_inset Quotes erd
8414 that appears above is used as a description of the text class in the
8415 \begin_inset Flex Noun
8418 \begin_layout Plain Layout
8419 Document\SpecialChar menuseparator
8427 \begin_inset Quotes eld
8431 \begin_inset Quotes erd
8434 in the example) is also used in the
8435 \begin_inset Flex Noun
8438 \begin_layout Plain Layout
8439 Document\SpecialChar menuseparator
8445 dialog: the text classes are grouped by these categories (which are usually
8446 genres, so typical categories are
8447 \begin_inset Quotes eld
8451 \begin_inset Quotes erd
8455 \begin_inset Quotes eld
8459 \begin_inset Quotes erd
8463 \begin_inset Quotes eld
8467 \begin_inset Quotes erd
8471 \begin_inset Quotes eld
8475 \begin_inset Quotes erd
8479 \begin_inset Quotes eld
8483 \begin_inset Quotes erd
8487 \begin_inset Quotes eld
8491 \begin_inset Quotes erd
8495 If no category has been declared, the class will be put in the
8496 \begin_inset Quotes eld
8500 \begin_inset Quotes erd
8506 \begin_layout Standard
8507 Let's assume that you wrote your own text class that uses the
8508 \begin_inset Flex Code
8511 \begin_layout Plain Layout
8517 document class, but where you changed the appearance of the section headings.
8518 If you put it in a file
8519 \begin_inset Flex Code
8522 \begin_layout Plain Layout
8528 , the header of this file should be:
8531 \begin_layout LyX-Code
8534 #% Do not delete the line below; configure depends on this
8537 \begin_layout LyX-Code
8542 DeclareLaTeXClass[article]{Article (with My Own Headings)}
8545 \begin_layout LyX-Code
8550 DeclareCategory{Articles}
8553 \begin_layout Standard
8554 This declares a text class
8555 \begin_inset Flex Code
8558 \begin_layout Plain Layout
8564 , associated with the \SpecialChar LaTeX
8566 \begin_inset Flex Code
8569 \begin_layout Plain Layout
8576 \begin_inset Quotes eld
8579 Article (with My Own Headings)
8580 \begin_inset Quotes erd
8584 If your text class depends on several packages, you can declare it as:
8587 \begin_layout LyX-Code
8590 #% Do not delete the line below; configure depends on this
8593 \begin_layout LyX-Code
8598 DeclareLaTeXClass[article,foo.sty]{Article (with My Own Headings)}
8601 \begin_layout LyX-Code
8606 DeclareCategory{Articles}
8609 \begin_layout Standard
8610 This indicates that your text class uses the
8611 \begin_inset Flex Code
8614 \begin_layout Plain Layout
8622 \change_deleted 5863208 1594239179
8623 Finally, it is also possible to declare classes for DocBook code.
8624 Typical declarations will look like:
8627 \begin_layout LyX-Code
8629 \change_deleted 5863208 1594239179
8632 #% Do not delete the line below; configure depends on this
8635 \begin_layout LyX-Code
8637 \change_deleted 5863208 1594239179
8642 DeclareDocBookClass[article]{SGML (DocBook Article)}
8645 \begin_layout LyX-Code
8647 \change_deleted 5863208 1594239179
8652 DeclareCategory{Articles (DocBook)}
8657 \begin_layout Standard
8658 Note that these declarations can also be given an optional parameter declaring
8659 the name of the document class (but not a list).
8662 \begin_layout Standard
8663 So, to be as explicit as possible, the form of the layout declaration is:
8666 \begin_layout LyX-Code
8671 DeclareLaTeXClass[class,package.sty]{layout description}
8674 \begin_layout LyX-Code
8679 DeclareCategory{category}
8682 \begin_layout Standard
8683 The class need only be specified if the name of the \SpecialChar LaTeX
8685 name of the layout file are different or if there are packages to load.
8686 If the name of the class file is not specified, then \SpecialChar LyX
8688 that it is the same as the name of the layout file.
8691 \begin_layout Standard
8692 When the text class has been modified to your taste, all you have to do
8693 is to copy it either to
8694 \begin_inset Flex Code
8697 \begin_layout Plain Layout
8704 \begin_inset Flex Code
8707 \begin_layout Plain Layout
8714 \begin_inset Flex Noun
8717 \begin_layout Plain Layout
8718 Tools\SpecialChar menuseparator
8724 , exit \SpecialChar LyX
8726 Then your new text class should be available along with the others.
8729 \begin_layout Standard
8730 Once the layout file is installed, you can edit it and see your changes
8731 without having to reconfigure or to restart \SpecialChar LyX
8736 \begin_layout Plain Layout
8737 In versions of \SpecialChar LyX
8738 prior to 1.6, this was not true.
8739 As a result, editing layout files was very time consuming, since you had
8740 constantly to restart \SpecialChar LyX
8746 You can force a reload of the current layout by using the \SpecialChar LyX
8748 \begin_inset Flex Noun
8751 \begin_layout Plain Layout
8758 There is no default binding for this function—though, of course, you can
8759 bind it to a key yourself.
8760 But you will normally use this function simply by entering it in the mini-buffe
8765 \begin_layout Standard
8771 \begin_inset Flex Noun
8774 \begin_layout Plain Layout
8780 is very much an `advanced feature'.
8785 recommended that you save your work before using this function.
8790 recommended that you not attempt to edit layout information while simultaneousl
8791 y working on a document that you care about.
8792 Use a test document.
8793 Syntax errors and the like in your layout file could cause peculiar behavior.
8794 In particular, such errors could cause \SpecialChar LyX
8795 to regard the current layout as
8796 invalid and to attempt to switch to some other layout.
8800 \begin_layout Plain Layout
8801 Really bad syntax errors may even caused \SpecialChar LyX
8803 This is because certain sorts of errors may make \SpecialChar LyX
8814 The \SpecialChar LyX
8815 team strives to keep \SpecialChar LyX
8816 stable in such situations, but safe is better
8821 \begin_layout Plain Layout
8822 While we're giving advice: make regular backups.
8823 And be nice to your mother.
8831 \begin_layout Subsection
8832 The Module declaration
8835 \begin_layout Standard
8836 A module must begin with a line like the following:
8839 \begin_layout LyX-Code
8842 DeclareLyXModule[endnotes.sty]{Endnotes}
8843 \change_inserted -712698321 1554395911
8847 \begin_layout LyX-Code
8849 \change_inserted -712698321 1554395924
8854 DeclareCategory{Foot- and Endnotes}
8855 \change_deleted -712698321 1554395911
8863 \begin_layout Standard
8864 The mandatory argument
8865 \change_inserted -712698321 1554395956
8874 , in curly brackets, is the name of the module, as it should appear in
8875 \begin_inset Flex Noun
8878 \begin_layout Plain Layout
8879 Document\SpecialChar menuseparator
8880 Settings\SpecialChar menuseparator
8887 The argument in square brackets is optional: It declares any \SpecialChar LaTeX
8889 on which the module depends.
8890 It is also possible to use the form
8891 \begin_inset Flex Noun
8894 \begin_layout Plain Layout
8900 as an optional argument, which declares that the module can only be used
8901 when there exists a conversion chain between the formats `
8902 \begin_inset Flex Code
8905 \begin_layout Plain Layout
8912 \begin_inset Flex Code
8915 \begin_layout Plain Layout
8923 \change_inserted -712698321 1554396133
8930 declaration is not strictly mandatory, but you should add it, since it
8931 is helpful to find the module.
8932 Please have a look at the existing module categories and if appropriate,
8938 \begin_layout Standard
8940 \change_inserted -712698321 1554395988
8943 declaration should then be followed by lines like the following:
8947 \begin_layout Plain Layout
8948 Preferably in English if the module should be published with \SpecialChar LyX
8950 This description will appear in the list of messages to be translated and
8951 will be thus translated with the next interface update.
8959 \begin_layout LyX-Code
8963 \begin_layout LyX-Code
8964 #Adds an endnote command, in addition to footnotes.
8968 \begin_layout LyX-Code
8969 #You will need to add
8971 theendnotes in TeX code where you
8974 \begin_layout LyX-Code
8975 #want the endnotes to appear.
8979 \begin_layout LyX-Code
8983 \begin_layout LyX-Code
8984 #Requires: somemodule | othermodule
8987 \begin_layout LyX-Code
8988 #Excludes: badmodule
8991 \begin_layout Standard
8992 The description is used in
8993 \begin_inset Flex Noun
8996 \begin_layout Plain Layout
8997 Document\SpecialChar menuseparator
8998 Settings\SpecialChar menuseparator
9004 to provide the user with information about what the module does.
9006 \begin_inset Flex Code
9009 \begin_layout Plain Layout
9015 line is used to identify other modules with which this one must be used;
9017 \begin_inset Flex Code
9020 \begin_layout Plain Layout
9026 line is used to identify modules with which this one may not be used.
9027 Both are optional, and, as shown, multiple modules should be separated
9028 with the pipe symbol: |.
9029 Note that the required modules are treated disjunctively:
9033 of the required modules must be used.
9038 excluded module may be used.
9039 Note that modules are identified here by their filenames without the
9040 \begin_inset Flex Code
9043 \begin_layout Plain Layout
9051 \begin_inset Flex Code
9054 \begin_layout Plain Layout
9061 \begin_inset Flex Code
9064 \begin_layout Plain Layout
9073 \begin_layout Subsection
9074 The CiteEngine file declaration
9077 \begin_layout Standard
9078 A cite engine file must begin with a line like the following:
9081 \begin_layout LyX-Code
9084 DeclareLyXCiteEngineModule[biblatex.sty]{Biblatex}
9087 \begin_layout Standard
9088 The mandatory argument, in curly brackets, is the name of the cite style,
9089 as it should appear in
9090 \begin_inset Flex Noun
9093 \begin_layout Plain Layout
9094 Document\SpecialChar menuseparator
9095 Settings\SpecialChar menuseparator
9102 The argument in square brackets is optional: It declares any \SpecialChar LaTeX
9104 on which the cite engine depends.
9107 \begin_layout Standard
9108 The cite engine declaration should then be followed by lines like the following:
9112 \begin_layout Plain Layout
9113 Preferably in English if the module should be published with \SpecialChar LyX
9115 This description will appear in the list of messages to be translated and
9116 will be thus translated with the next interface update.
9124 \begin_layout LyX-Code
9128 \begin_layout LyX-Code
9129 # Biblatex supports many author-year and numerical styles.
9132 \begin_layout LyX-Code
9133 # It is mainly aimed at the Humanities.
9137 \begin_layout LyX-Code
9138 # customizable, fully localized and provides many features
9141 \begin_layout LyX-Code
9142 # that are not possible with BibTeX.
9143 The use of 'biber' as
9146 \begin_layout LyX-Code
9147 # bibliography processor is advised.
9150 \begin_layout LyX-Code
9154 \begin_layout Standard
9155 The description is used in
9156 \begin_inset Flex Noun
9159 \begin_layout Plain Layout
9160 Document\SpecialChar menuseparator
9161 Settings\SpecialChar menuseparator
9167 to provide the user with information about the cite engine.
9170 \begin_layout Subsection
9174 \begin_layout Standard
9175 The first non-comment line of any layout file, included file, or module
9180 contain the file format number:
9183 \begin_layout Description
9184 \begin_inset Flex Code
9187 \begin_layout Plain Layout
9194 \begin_inset Flex Code
9197 \begin_layout Plain Layout
9203 ] The format number of the layout file.
9206 \begin_layout Standard
9207 This tag was introduced with \SpecialChar LyX
9209 \begin_inset space ~
9213 Layout files from older \SpecialChar LyX
9214 versions do not have an explicit file format and
9215 are considered to have
9216 \begin_inset Flex Code
9219 \begin_layout Plain Layout
9221 \begin_inset space ~
9230 The format for the present version of \SpecialChar LyX
9232 But each version of \SpecialChar LyX
9233 is capable of reading earlier versions' layout files,
9234 just as they are capable of reading files produced by earlier versions
9237 There is, however, no provision for converting to earlier formats.
9240 \begin_layout Subsection
9241 \begin_inset CommandInset label
9243 name "subsec:General-text-class"
9247 General text class parameters
9250 \begin_layout Standard
9251 These are general parameters that govern the behavior of an entire document
9257 mean that they must appear in
9258 \begin_inset Flex Code
9261 \begin_layout Plain Layout
9267 files rather than in modules.
9268 A module can contain any layout tag.)
9271 \begin_layout Description
9273 \change_inserted -712698321 1526899478
9274 \begin_inset Flex Code
9277 \begin_layout Plain Layout
9279 \change_inserted -712698321 1526898610
9280 AddToCiteEngine <engine>
9287 Extends the possibilities for displaying citation references.
9289 \begin_inset CommandInset ref
9291 reference "subsec:Citation-engine-description"
9300 \begin_inset Flex Code
9303 \begin_layout Plain Layout
9305 \change_inserted -712698321 1526898823
9316 \begin_layout Description
9317 \begin_inset Flex Code
9320 \begin_layout Plain Layout
9326 Adds information that will be output in the
9327 \begin_inset Flex Code
9330 \begin_layout Plain Layout
9336 block when the document is output to XHTML.
9337 Typically, this would be used to output CSS style information, but it can
9338 be used for anything that can appear in
9339 \begin_inset Flex Code
9342 \begin_layout Plain Layout
9350 \begin_inset Quotes eld
9354 \begin_inset Flex Code
9357 \begin_layout Plain Layout
9364 \begin_inset Quotes erd
9370 \begin_layout Description
9371 \begin_inset Flex Code
9374 \begin_layout Plain Layout
9380 Adds information to the document preamble.
9382 \begin_inset Newline newline
9386 \begin_inset Quotes eld
9390 \begin_inset Flex Code
9393 \begin_layout Plain Layout
9400 \begin_inset Quotes erd
9404 \change_inserted -712698321 1562592950
9408 \begin_layout Description
9410 \change_inserted -712698321 1562593040
9411 \begin_inset Flex Code
9414 \begin_layout Plain Layout
9416 \change_inserted -712698321 1562592954
9425 \begin_inset Flex Code
9428 \begin_layout Plain Layout
9430 \change_inserted -712698321 1562592950
9441 \begin_inset space \thinspace{}
9445 \begin_inset Flex Code
9448 \begin_layout Plain Layout
9450 \change_inserted -712698321 1562592950
9458 ] If the document class adds the bibliography to the table of contents,
9459 add this option with value
9460 \begin_inset Flex Code
9463 \begin_layout Plain Layout
9465 \change_inserted -712698321 1562592996
9474 \begin_inset Flex Code
9477 \begin_layout Plain Layout
9479 \change_inserted -712698321 1562593006
9488 This prevents the bibliography from being added twice.
9493 \begin_layout Description
9494 \begin_inset Flex Code
9497 \begin_layout Plain Layout
9503 Defines the possibilities for displaying citation references.
9505 \begin_inset CommandInset ref
9507 reference "subsec:Citation-engine-description"
9516 \begin_inset Quotes eld
9520 \begin_inset Flex Code
9523 \begin_layout Plain Layout
9530 \begin_inset Quotes erd
9534 Primarily used in cite engine files (see
9535 \begin_inset CommandInset ref
9537 reference "subsec:Cite-Engine-Files"
9546 \change_inserted -712698321 1526898530
9547 Note that if you specify this in a layout file or module, any cite engine
9548 definition will be overridden.
9550 \begin_inset Flex Code
9553 \begin_layout Plain Layout
9555 \change_inserted -712698321 1526898530
9568 \begin_layout Description
9569 \begin_inset Flex Code
9572 \begin_layout Plain Layout
9578 Defines formats for use in the display of bibliographic information.
9580 \begin_inset CommandInset ref
9582 reference "subsec:Citation-format-description"
9588 \begin_inset Quotes eld
9592 \begin_inset Flex Code
9595 \begin_layout Plain Layout
9602 \begin_inset Quotes erd
9606 Primarily used in cite engine files (see
9607 \begin_inset CommandInset ref
9609 reference "subsec:Cite-Engine-Files"
9618 \change_inserted -712698321 1526898585
9619 A cite format defined in a layout or module will override the cite engine
9625 \begin_layout Description
9626 \begin_inset Flex Code
9629 \begin_layout Plain Layout
9636 \begin_inset Flex Code
9639 \begin_layout Plain Layout
9648 \begin_inset Flex Code
9651 \begin_layout Plain Layout
9657 ] Determines whether
9661 or Bib\SpecialChar TeX
9662 is used to generate a Bibliography.
9663 Primarily used in cite engine files (see
9664 \begin_inset CommandInset ref
9666 reference "subsec:Cite-Engine-Files"
9676 \begin_layout Description
9677 \begin_inset Flex Code
9680 \begin_layout Plain Layout
9686 Describes various global options supported by the document class.
9688 \begin_inset CommandInset ref
9690 reference "subsec:ClassOptions"
9696 \begin_inset Quotes eld
9700 \begin_inset Flex Code
9703 \begin_layout Plain Layout
9710 \begin_inset Quotes erd
9716 \begin_layout Description
9717 \begin_inset Flex Code
9720 \begin_layout Plain Layout
9727 \begin_inset Flex Code
9730 \begin_layout Plain Layout
9739 \begin_inset space \thinspace{}
9743 \begin_inset Flex Code
9746 \begin_layout Plain Layout
9752 ] Whether the class should
9756 to having one or two columns.
9757 Can be changed in the
9758 \begin_inset Flex Noun
9761 \begin_layout Plain Layout
9762 Document\SpecialChar menuseparator
9771 \begin_layout Description
9772 \begin_inset Flex Code
9775 \begin_layout Plain Layout
9782 \begin_inset Flex Code
9785 \begin_layout Plain Layout
9791 ] This sequence defines the properties for a counter.
9792 If the counter does not yet exist, it is created; if it does exist, it
9795 \begin_inset Quotes eld
9799 \begin_inset Flex Code
9802 \begin_layout Plain Layout
9809 \begin_inset Quotes erd
9813 \begin_inset Newline newline
9817 \begin_inset CommandInset ref
9819 reference "subsec:Counters"
9823 for details on counters.
9826 \begin_layout Description
9827 \begin_inset Flex Code
9830 \begin_layout Plain Layout
9836 Sets the default font used to display the document.
9838 \begin_inset CommandInset ref
9840 reference "subsec:Font-description"
9844 for how to declare fonts.
9846 \begin_inset Quotes eld
9850 \begin_inset Flex Code
9853 \begin_layout Plain Layout
9860 \begin_inset Quotes erd
9866 \begin_layout Description
9867 \begin_inset Flex Code
9870 \begin_layout Plain Layout
9877 \begin_inset Flex Code
9880 \begin_layout Plain Layout
9886 ] Specifies a module to be included by default with this document class.
9887 The module is specified as filename without the
9888 \begin_inset Flex Code
9891 \begin_layout Plain Layout
9898 The user can still remove the module, but it will be active at the outset.
9899 (This applies only when new files are created, or when this class is chosen
9900 for an existing document.)
9903 \begin_layout Description
9904 \begin_inset Flex Code
9907 \begin_layout Plain Layout
9914 \begin_inset Flex Code
9917 \begin_layout Plain Layout
9923 ] This is the style that will be assigned to new paragraphs, usually
9924 \begin_inset Flex Noun
9927 \begin_layout Plain Layout
9934 This will default to the first defined style if not given, but you are
9935 encouraged to use this directive.
9938 \begin_layout Description
9940 \change_inserted -970929547 1515112870
9941 \begin_inset Flex Code
9944 \begin_layout Plain Layout
9946 \change_inserted -970929547 1515112782
9955 \begin_inset Flex Code
9958 \begin_layout Plain Layout
9960 \change_inserted -970929547 1515112766
9968 ] The root element (at the top of the document) to use when outputting documents
9969 with this class in DocBook.
9970 The default value is
9971 \begin_inset Quotes eld
9975 \begin_inset Flex Code
9978 \begin_layout Plain Layout
9980 \change_inserted -970929547 1515112845
9989 \begin_inset Quotes erd
9994 \change_deleted 1075283030 1594226862
9996 \change_inserted 1075283030 1594226777
10000 \begin_layout Description
10002 \change_inserted 1075283030 1594226859
10003 \begin_inset Flex Code
10006 \begin_layout Plain Layout
10008 \change_inserted 1075283030 1594226785
10009 DocBookForceAbstract
10017 \begin_inset Flex Code
10020 \begin_layout Plain Layout
10022 \change_inserted 1075283030 1594226804
10031 \begin_inset Quotes eld
10039 \begin_inset Quotes erd
10042 , the root element will always have an
10047 The default value is
10048 \begin_inset Quotes eld
10056 \begin_inset Quotes erd
10064 \begin_layout Description
10065 \begin_inset Flex Code
10068 \begin_layout Plain Layout
10075 \begin_inset Flex Code
10078 \begin_layout Plain Layout
10084 ] This tag indicates that the module (which is specified by filename without
10086 \begin_inset Flex Code
10089 \begin_layout Plain Layout
10095 extension) cannot be used with this document class.
10096 This might be used in a journal-specific layout file to prevent, say, the
10098 \begin_inset Flex Code
10101 \begin_layout Plain Layout
10107 module that numbers theorems by section.
10112 be used in a module.
10113 Modules have their own way of excluding other modules (see
10114 \begin_inset CommandInset ref
10116 reference "subsec:Layout-modules"
10123 \begin_layout Description
10124 \begin_inset Flex Code
10127 \begin_layout Plain Layout
10133 Defines a new float.
10135 \begin_inset CommandInset ref
10137 reference "subsec:Floats"
10143 \begin_inset Quotes eld
10147 \begin_inset Flex Code
10150 \begin_layout Plain Layout
10157 \begin_inset Quotes erd
10163 \begin_layout Description
10164 \begin_inset Flex Code
10167 \begin_layout Plain Layout
10173 Sets the information that will be output in the
10174 \begin_inset Flex Code
10177 \begin_layout Plain Layout
10183 block when this document class is output to XHTML.
10184 Note that this will completely override any prior
10185 \begin_inset Flex Code
10188 \begin_layout Plain Layout
10195 \begin_inset Flex Code
10198 \begin_layout Plain Layout
10206 \begin_inset Newline newline
10210 \begin_inset Flex Code
10213 \begin_layout Plain Layout
10219 if you just want to add material to the preamble.) Must end with
10220 \begin_inset Quotes eld
10224 \begin_inset Flex Code
10227 \begin_layout Plain Layout
10234 \begin_inset Quotes erd
10240 \begin_layout Description
10241 \begin_inset Flex Code
10244 \begin_layout Plain Layout
10251 \begin_inset Flex Code
10254 \begin_layout Plain Layout
10260 ] The style to use for the table of contents, bibliography, and so forth,
10261 when the document is output to HTML.
10262 For articles, this should normally be
10263 \begin_inset Flex Code
10266 \begin_layout Plain Layout
10273 \begin_inset Flex Code
10276 \begin_layout Plain Layout
10283 If it is not given, then \SpecialChar LyX
10284 will attempt to figure out which layout to use.
10287 \begin_layout Description
10288 \begin_inset Flex Code
10291 \begin_layout Plain Layout
10298 \begin_inset Flex Code
10301 \begin_layout Plain Layout
10307 ] Modifies the properties of the given counter.
10308 If the counter does not exist, the statement is ignored.
10310 \begin_inset Quotes eld
10314 \begin_inset Flex Code
10317 \begin_layout Plain Layout
10324 \begin_inset Quotes erd
10328 \begin_inset Newline newline
10332 \begin_inset CommandInset ref
10334 reference "subsec:Counters"
10338 for details on counters.
10341 \begin_layout Description
10342 \begin_inset Flex Code
10345 \begin_layout Plain Layout
10352 \begin_inset Flex Code
10355 \begin_layout Plain Layout
10361 ] This allows you to include another layout definition file within yours
10362 to avoid duplicating commands.
10363 Common examples are the standard layout files, for example,
10364 \begin_inset Flex Code
10367 \begin_layout Plain Layout
10373 , which contains most of the basic layouts.
10376 \begin_layout Description
10377 \begin_inset Flex Code
10380 \begin_layout Plain Layout
10387 \begin_inset Flex Code
10390 \begin_layout Plain Layout
10396 ] This section (re-)defines the layout of an inset.
10397 It can be applied to an existing inset or to a new, user-defined inset,
10398 e.g., a new character style.
10400 \begin_inset Quotes eld
10404 \begin_inset Flex Code
10407 \begin_layout Plain Layout
10414 \begin_inset Quotes erd
10418 \begin_inset Newline newline
10422 \begin_inset CommandInset ref
10424 reference "subsec:Flex-insets-and"
10428 for more information.
10432 \begin_layout Description
10433 \begin_inset Flex Code
10436 \begin_layout Plain Layout
10443 \begin_inset Flex Code
10446 \begin_layout Plain Layout
10452 ] A string that indicates the width of the left margin on the screen, for
10454 \begin_inset Quotes eld
10458 \begin_inset Flex Code
10461 \begin_layout Plain Layout
10468 \begin_inset Quotes erd
10472 (Note that this is not a `length', like
10473 \begin_inset Quotes eld
10477 \begin_inset Quotes erd
10483 \begin_layout Description
10484 \begin_inset Flex Code
10487 \begin_layout Plain Layout
10494 \begin_inset Flex Code
10497 \begin_layout Plain Layout
10503 ] An integer that determines the maximal number of names displayed in an
10504 author-year citation before the citation switches to
10505 \begin_inset Quotes eld
10509 \begin_inset Quotes erd
10513 Primarily used in cite engine files (see
10514 \begin_inset CommandInset ref
10516 reference "subsec:Cite-Engine-Files"
10526 \begin_layout Description
10527 \begin_inset Flex Code
10530 \begin_layout Plain Layout
10537 \begin_inset Flex Code
10540 \begin_layout Plain Layout
10546 ] Modifies the properties of the given paragraph style.
10547 If the style does not exist, this section is ignored.
10549 \begin_inset Quotes eld
10553 \begin_inset Flex Code
10556 \begin_layout Plain Layout
10563 \begin_inset Quotes erd
10569 \begin_layout Description
10570 \begin_inset Flex Code
10573 \begin_layout Plain Layout
10580 \begin_inset Flex Code
10583 \begin_layout Plain Layout
10589 ] Deletes an existing counter, usually one defined in an included file.
10592 \begin_layout Description
10593 \begin_inset Flex Code
10596 \begin_layout Plain Layout
10603 \begin_inset Flex Code
10606 \begin_layout Plain Layout
10612 ] Deletes an existing float.
10613 This is particularly useful when you want to suppress a float that has
10614 been defined in an input file.
10617 \begin_layout Description
10618 \begin_inset Flex Code
10621 \begin_layout Plain Layout
10628 \begin_inset Flex Code
10631 \begin_layout Plain Layout
10637 ] Deletes an existing style.
10640 \begin_layout Description
10641 \begin_inset Flex Code
10644 \begin_layout Plain Layout
10651 \begin_inset Flex Code
10654 \begin_layout Plain Layout
10661 \begin_inset Flex Code
10664 \begin_layout Plain Layout
10670 ] Define a new table of contents with type
10671 \begin_inset Flex Code
10674 \begin_layout Plain Layout
10681 \begin_inset Flex Code
10684 \begin_layout Plain Layout
10691 See also the AddToToc commands.
10694 \begin_layout Description
10695 \begin_inset Flex Code
10698 \begin_layout Plain Layout
10705 \begin_inset Flex Code
10708 \begin_layout Plain Layout
10714 ] The file format (as defined in the \SpecialChar LyX
10715 preferences) produced by this document
10717 It is mainly useful when
10718 \begin_inset Flex Code
10721 \begin_layout Plain Layout
10728 \begin_inset Flex Code
10731 \begin_layout Plain Layout
10737 and one wants to define a new type of literate document.
10738 The format is reset to
10739 \change_deleted 5863208 1594239413
10741 \begin_inset Quotes eld
10745 \begin_inset Flex Code
10748 \begin_layout Plain Layout
10755 \begin_inset Quotes erd
10761 \begin_inset Quotes eld
10765 \begin_inset Flex Code
10768 \begin_layout Plain Layout
10775 \begin_inset Quotes erd
10778 when the corresponding
10779 \begin_inset Flex Code
10782 \begin_layout Plain Layout
10788 parameter is encountered.
10791 \begin_layout Description
10792 \begin_inset Flex Code
10795 \begin_layout Plain Layout
10802 \begin_inset Flex Code
10805 \begin_layout Plain Layout
10816 \change_deleted 5863208 1594239430
10818 \begin_inset Flex Code
10821 \begin_layout Plain Layout
10830 \begin_inset Flex Code
10833 \begin_layout Plain Layout
10839 ] Specifies what sort of output documents using this class will produce.
10842 \begin_layout Description
10843 \begin_inset Flex Code
10846 \begin_layout Plain Layout
10853 \begin_inset Flex Code
10856 \begin_layout Plain Layout
10863 \begin_inset Flex Code
10866 \begin_layout Plain Layout
10872 ] Specifies options, given in the second string, for the package named by
10875 \begin_inset Quotes eld
10879 \begin_inset Flex Code
10882 \begin_layout Plain Layout
10883 PackageOptions natbib square
10889 \begin_inset Quotes erd
10893 \begin_inset Flex Code
10896 \begin_layout Plain Layout
10902 to be loaded with the
10903 \begin_inset Flex Code
10906 \begin_layout Plain Layout
10913 (For \SpecialChar TeX
10914 perts, this causes \SpecialChar LyX
10916 \begin_inset Flex Code
10919 \begin_layout Plain Layout
10922 PassOptionsToPackage{natbib}{square}
10928 \begin_inset Flex Code
10931 \begin_layout Plain Layout
10938 \change_inserted -712698321 1565102364
10942 \begin_layout Description
10944 \change_inserted -712698321 1565102470
10945 \begin_inset Flex Code
10948 \begin_layout Plain Layout
10950 \change_inserted -712698321 1565102365
10959 \begin_inset Flex Code
10962 \begin_layout Plain Layout
10964 \change_inserted -712698321 1565105222
10969 , letter, legal, executive, a0, a1, a2, a3, a4, a5, a6, b0, b1, b2, b3,
10970 b4, b5, b6, c0, c1, c2, c3, c4, c5, c6, b0j, b1j, b2j, b3j, b4j, b5j, b6j
10977 ] The default page size.
10978 This is used by some converters.
10983 \begin_layout Description
10984 \begin_inset Flex Code
10987 \begin_layout Plain Layout
10994 \begin_inset Flex Code
10997 \begin_layout Plain Layout
11006 \begin_inset Flex Code
11009 \begin_layout Plain Layout
11016 \begin_inset Flex Code
11019 \begin_layout Plain Layout
11025 ] The default pagestyle.
11026 Can be changed in the
11027 \begin_inset Flex Noun
11030 \begin_layout Plain Layout
11031 Document\SpecialChar menuseparator
11040 \begin_layout Description
11041 \begin_inset Flex Code
11044 \begin_layout Plain Layout
11050 Sets the preamble for the \SpecialChar LaTeX
11052 Note that this will completely override any prior
11053 \begin_inset Flex Code
11056 \begin_layout Plain Layout
11063 \begin_inset Flex Code
11066 \begin_layout Plain Layout
11074 \begin_inset Flex Code
11077 \begin_layout Plain Layout
11083 if you just want to add material to the preamble.) Must end with
11084 \begin_inset Quotes eld
11088 \begin_inset Flex Code
11091 \begin_layout Plain Layout
11098 \begin_inset Quotes erd
11104 \begin_layout Description
11105 \begin_inset Flex Code
11108 \begin_layout Plain Layout
11115 \begin_inset Flex Code
11118 \begin_layout Plain Layout
11125 \begin_inset Flex Code
11128 \begin_layout Plain Layout
11137 \begin_inset space \thinspace{}
11141 \begin_inset Flex Code
11144 \begin_layout Plain Layout
11150 ] Whether the class already provides the feature
11151 \begin_inset Flex Code
11154 \begin_layout Plain Layout
11161 A feature is in general the name of a package (e.
11162 \begin_inset space \thinspace{}
11166 \begin_inset space \space{}
11170 \begin_inset Flex Code
11173 \begin_layout Plain Layout
11180 \begin_inset Flex Code
11183 \begin_layout Plain Layout
11190 \begin_inset space \thinspace{}
11194 \begin_inset space \space{}
11198 \begin_inset Flex Code
11201 \begin_layout Plain Layout
11208 \begin_inset Flex Code
11211 \begin_layout Plain Layout
11219 \begin_inset CommandInset ref
11221 reference "chap:List-of-functions"
11225 for the list of features.
11228 \begin_layout Description
11229 \begin_inset Flex Code
11232 \begin_layout Plain Layout
11239 \begin_inset Flex Code
11242 \begin_layout Plain Layout
11248 ] Indicates that this layout provides the functionality of the module mentioned,
11249 which should be specified by the filename without the
11250 \begin_inset Flex Code
11253 \begin_layout Plain Layout
11260 This will typically be used if the layout includes the module directly,
11261 rather than using the
11262 \begin_inset Flex Code
11265 \begin_layout Plain Layout
11271 tag to indicate that it ought to be used.
11272 It could also be used in a module that provided an alternate implementation
11273 of the same functionality.
11276 \begin_layout Description
11277 \begin_inset Flex Code
11280 \begin_layout Plain Layout
11287 \begin_inset Flex Code
11290 \begin_layout Plain Layout
11296 ] Creates a new paragraph style if it does not already exist.
11297 If the style does exist, this section is ignored.
11299 \begin_inset Quotes eld
11303 \begin_inset Flex Code
11306 \begin_layout Plain Layout
11313 \begin_inset Quotes erd
11319 \begin_layout Description
11320 \begin_inset Flex Code
11323 \begin_layout Plain Layout
11330 \begin_inset Flex Code
11333 \begin_layout Plain Layout
11339 ] Whether the class requires the feature
11340 \begin_inset Flex Code
11343 \begin_layout Plain Layout
11350 Multiple features must be separated by commas.
11351 Note that you can only request supported features.
11353 \begin_inset CommandInset ref
11355 reference "chap:List-of-functions"
11359 for the list of features.).
11360 If you require a package with specific options, you can additionally use
11362 \begin_inset Flex Code
11365 \begin_layout Plain Layout
11374 \begin_layout Description
11375 \begin_inset Flex Code
11378 \begin_layout Plain Layout
11385 \begin_inset Flex Code
11388 \begin_layout Plain Layout
11394 ] A string that indicates the width of the right margin on the screen, for
11396 \begin_inset Quotes eld
11400 \begin_inset Flex Code
11403 \begin_layout Plain Layout
11410 \begin_inset Quotes erd
11416 \begin_layout Description
11417 \begin_inset Flex Code
11420 \begin_layout Plain Layout
11427 \begin_inset Flex Code
11430 \begin_layout Plain Layout
11436 ] Sets which divisions get numbered.
11438 \begin_inset Newline newline
11442 \begin_inset Flex Code
11445 \begin_layout Plain Layout
11451 counter in \SpecialChar LaTeX
11455 \begin_layout Description
11456 \begin_inset Flex Code
11459 \begin_layout Plain Layout
11466 \begin_inset Flex Code
11469 \begin_layout Plain Layout
11478 \begin_inset space \thinspace{}
11482 \begin_inset Flex Code
11485 \begin_layout Plain Layout
11491 ] Whether the class-default should be printing on one or both sides of the
11493 Can be changed in the
11494 \begin_inset Flex Noun
11497 \begin_layout Plain Layout
11498 Document\SpecialChar menuseparator
11507 \begin_layout Description
11508 \begin_inset Flex Code
11511 \begin_layout Plain Layout
11518 \begin_inset Flex Code
11521 \begin_layout Plain Layout
11527 ] This sequence defines a paragraph style.
11528 If the style does not yet exist, it is created; if it does exist, its parameter
11531 \begin_inset Quotes eld
11535 \begin_inset Flex Code
11538 \begin_layout Plain Layout
11545 \begin_inset Quotes erd
11549 \begin_inset Newline newline
11553 \begin_inset CommandInset ref
11555 reference "subsec:Paragraph-Styles"
11559 for details on paragraph styles.
11560 \change_inserted -712698321 1553617804
11564 \begin_layout Description
11566 \change_inserted -712698321 1553617862
11567 \begin_inset Flex Code
11570 \begin_layout Plain Layout
11572 \change_inserted -712698321 1553617809
11581 \begin_inset Flex Code
11584 \begin_layout Plain Layout
11586 \change_inserted -712698321 1553617805
11594 ] defines the default table style that is used when inserting a table.
11595 The following styles are available:
11599 \begin_layout Itemize
11601 \change_inserted -712698321 1554308039
11602 \begin_inset Flex Code
11605 \begin_layout Plain Layout
11607 \change_inserted -712698321 1554307928
11608 Formal_with_Footline
11616 \begin_inset Quotes eld
11620 \begin_inset Quotes erd
11623 ) style with horizontal lines only, using a bold top and bottom line, the
11624 first and last row are additionally separated from the table body with
11625 a thin middle line.
11628 \begin_layout Itemize
11630 \change_inserted -712698321 1554308087
11631 \begin_inset Flex Code
11634 \begin_layout Plain Layout
11636 \change_inserted -712698321 1554308042
11637 Formal_without_Footline
11644 : same as the above, but the last row is not separated with a middle line
11648 \begin_layout Itemize
11650 \change_inserted -712698321 1553618031
11651 \begin_inset Flex Code
11654 \begin_layout Plain Layout
11656 \change_inserted -712698321 1553618006
11664 : Simple table lines.
11667 \begin_layout Itemize
11669 \change_inserted -712698321 1553618309
11670 \begin_inset Flex Code
11673 \begin_layout Plain Layout
11675 \change_inserted -712698321 1553618031
11684 \begin_inset Flex Code
11687 \begin_layout Plain Layout
11689 \change_inserted -712698321 1553618043
11697 , but with the header column offset with a second horizontal line.
11698 This is also the default style of \SpecialChar LyX
11702 \begin_layout Itemize
11704 \change_inserted -712698321 1553618280
11705 \begin_inset Flex Code
11708 \begin_layout Plain Layout
11710 \change_inserted -712698321 1553618261
11718 : Table without lines.
11724 \begin_layout Description
11725 \begin_inset Flex Code
11728 \begin_layout Plain Layout
11735 \begin_inset Flex Code
11738 \begin_layout Plain Layout
11744 ] The name of the command or environment to be used with
11745 \begin_inset Flex Code
11748 \begin_layout Plain Layout
11757 \begin_layout Description
11758 \begin_inset Flex Code
11761 \begin_layout Plain Layout
11768 \begin_inset Flex Code
11771 \begin_layout Plain Layout
11780 \begin_inset Flex Code
11783 \begin_layout Plain Layout
11789 ] Indicates what kind of markup is used to define the title of a document.
11791 \begin_inset Flex Code
11794 \begin_layout Plain Layout
11800 means that the macro with name
11801 \begin_inset Flex Code
11804 \begin_layout Plain Layout
11810 will be inserted after the last layout which has
11811 \begin_inset Quotes eld
11815 \begin_inset Flex Code
11818 \begin_layout Plain Layout
11820 \begin_inset space ~
11829 \begin_inset Quotes erd
11834 \begin_inset Flex Code
11837 \begin_layout Plain Layout
11843 corresponds to the case where all layouts which have
11844 \begin_inset Quotes eld
11848 \begin_inset Flex Code
11851 \begin_layout Plain Layout
11853 \begin_inset space ~
11862 \begin_inset Quotes erd
11865 should be enclosed into the
11866 \begin_inset Flex Code
11869 \begin_layout Plain Layout
11878 \begin_layout Description
11879 \begin_inset Flex Code
11882 \begin_layout Plain Layout
11889 \begin_inset Flex Code
11892 \begin_layout Plain Layout
11898 ] Sets which divisions are included in the table of contents.
11900 \begin_inset Flex Code
11903 \begin_layout Plain Layout
11909 counter in \SpecialChar LaTeX
11913 \begin_layout Subsection
11914 \begin_inset Flex Code
11917 \begin_layout Plain Layout
11924 \begin_inset CommandInset label
11926 name "subsec:ClassOptions"
11933 \begin_layout Standard
11935 \begin_inset Flex Code
11938 \begin_layout Plain Layout
11944 section can contain the following entries:
11947 \begin_layout Description
11948 \begin_inset Flex Code
11951 \begin_layout Plain Layout
11958 \begin_inset Flex Code
11961 \begin_layout Plain Layout
11967 ] The list of available font sizes for the document's main font, separated
11969 \begin_inset Quotes eld
11973 \begin_inset Flex Code
11976 \begin_layout Plain Layout
11983 \begin_inset Quotes erd
11988 \change_inserted -712698321 1565110196
11989 Any number is possible.
11992 \begin_layout Description
11994 \change_inserted -712698321 1565110259
11995 \begin_inset Flex Code
11998 \begin_layout Plain Layout
12000 \change_inserted -712698321 1565110199
12009 \begin_inset Flex Code
12012 \begin_layout Plain Layout
12014 \change_inserted -712698321 1565110196
12022 ] The format for the font size option.
12024 \begin_inset Flex Code
12027 \begin_layout Plain Layout
12029 \change_inserted -712698321 1565110238
12039 \begin_inset Flex Code
12042 \begin_layout Plain Layout
12044 \change_inserted -712698321 1565110248
12052 is a placeholder for the font size.
12057 \begin_layout Description
12059 \change_deleted 5863208 1594239483
12060 \begin_inset Flex Code
12063 \begin_layout Plain Layout
12069 Used to set the DTD line with XML-based output classes.
12071 \begin_inset space \thinspace{}
12075 \begin_inset Quotes eld
12078 -//OASIS//DTD DocBook V4.2//EN
12079 \begin_inset Quotes erd
12083 \change_inserted -712698321 1565101761
12087 \begin_layout Description
12089 \change_inserted -712698321 1565180598
12090 \begin_inset Flex Code
12093 \begin_layout Plain Layout
12095 \change_inserted -712698321 1565101918
12104 \begin_inset Flex Code
12107 \begin_layout Plain Layout
12109 \change_inserted -712698321 1565105399
12110 string="letter|\SpecialChar allowbreak
12111 legal|\SpecialChar allowbreak
12112 executive|\SpecialChar allowbreak
12113 a0|\SpecialChar allowbreak
12114 a1|\SpecialChar allowbreak
12115 a2|\SpecialChar allowbreak
12116 a3|\SpecialChar allowbreak
12117 a4|\SpecialChar allowbreak
12118 a5|\SpecialChar allowbreak
12119 a6|\SpecialChar allowbreak
12120 b0|\SpecialChar allowbreak
12121 b1|\SpecialChar allowbreak
12122 b2|\SpecialChar allowbreak
12123 b3|\SpecialChar allowbreak
12124 b4|\SpecialChar allowbreak
12125 b5|\SpecialChar allowbreak
12126 b6|\SpecialChar allowbreak
12127 c0|\SpecialChar allowbreak
12128 c1|\SpecialChar allowbreak
12130 2|\SpecialChar allowbreak
12131 c3|\SpecialChar allowbreak
12132 c4|\SpecialChar allowbreak
12133 c5|\SpecialChar allowbreak
12134 c6|\SpecialChar allowbreak
12135 b0j|\SpecialChar allowbreak
12136 b1j|\SpecialChar allowbreak
12137 b2j|\SpecialChar allowbreak
12138 b3j|\SpecialChar allowbreak
12139 b4j|\SpecialChar allowbreak
12140 b5j|\SpecialChar allowbreak
12148 ] The list of available page sizes, separated by
12149 \begin_inset Quotes eld
12153 \begin_inset Flex Code
12156 \begin_layout Plain Layout
12158 \change_inserted -712698321 1565101779
12167 \begin_inset Quotes erd
12171 Currently, only the listed sizes are supported.
12172 Other sizes might be entered as custom class option.
12175 \begin_layout Description
12177 \change_inserted -712698321 1565180623
12178 \begin_inset Flex Code
12181 \begin_layout Plain Layout
12183 \change_inserted -712698321 1565180605
12192 \begin_inset Flex Code
12195 \begin_layout Plain Layout
12197 \change_inserted -712698321 1565180601
12205 ] The format for the page size option.
12207 \begin_inset Flex Code
12210 \begin_layout Plain Layout
12212 \change_inserted -712698321 1565180618
12222 \begin_inset Flex Code
12225 \begin_layout Plain Layout
12227 \change_inserted -712698321 1565180601
12235 is a placeholder for the paper size.
12240 \begin_layout Description
12241 \begin_inset Flex Code
12244 \begin_layout Plain Layout
12251 \begin_inset Flex Code
12254 \begin_layout Plain Layout
12255 string="empty|plain|headings|fancy"
12260 ] The list of available page sty\SpecialChar softhyphen
12262 \begin_inset Quotes eld
12266 \begin_inset Flex Code
12269 \begin_layout Plain Layout
12276 \begin_inset Quotes erd
12282 \begin_layout Description
12283 \begin_inset Flex Code
12286 \begin_layout Plain Layout
12293 \begin_inset Flex Code
12296 \begin_layout Plain Layout
12302 ] Some document class options, separated by a comma, that will be added
12303 to the optional part of the
12304 \begin_inset Flex Code
12307 \begin_layout Plain Layout
12318 \begin_layout Standard
12320 \begin_inset Flex Code
12323 \begin_layout Plain Layout
12329 section must end with
12330 \begin_inset Quotes eld
12334 \begin_inset Flex Code
12337 \begin_layout Plain Layout
12344 \begin_inset Quotes erd
12350 \begin_layout Subsection
12352 \begin_inset CommandInset label
12354 name "subsec:Paragraph-Styles"
12361 \begin_layout Standard
12362 A paragraph style description looks like this:
12366 \begin_layout Plain Layout
12367 Note that this will either define a new style or modify an existing one.
12375 \begin_layout LyX-Code
12382 \begin_layout LyX-Code
12386 \begin_layout LyX-Code
12390 \begin_layout Standard
12391 where the following commands are allowed:
12394 \begin_layout Description
12395 \begin_inset Flex Code
12398 \begin_layout Plain Layout
12405 \begin_inset Flex Code
12408 \begin_layout Plain Layout
12414 =""] This paragraph will appear in the table of contents of the given type.
12415 An empty string disables.
12416 See also the OutlinerName and the IsTocCaption commands.
12420 \begin_layout Description
12421 \begin_inset Flex Code
12424 \begin_layout Plain Layout
12431 \begin_inset Flex Code
12434 \begin_layout Plain Layout
12439 , left, right, center
12444 ] Paragraph alignment.
12447 \begin_layout Description
12448 \begin_inset Flex Code
12451 \begin_layout Plain Layout
12458 \begin_inset Flex Code
12461 \begin_layout Plain Layout
12466 , left, right, center
12471 ] A comma separated list of permitted alignments.
12472 (Some \SpecialChar LaTeX
12473 styles prohibit certain alignments, since those wouldn't make sense.
12474 For example a right-aligned or centered enumeration isn't possible.)
12477 \begin_layout Description
12478 \begin_inset Flex Code
12481 \begin_layout Plain Layout
12488 \begin_inset Flex Code
12491 \begin_layout Plain Layout
12497 ] Defines argument number <int> of a command\SpecialChar breakableslash
12498 environment associated with
12500 This is useful for things like section headings, and only makes sense with
12503 Every (optional or required) argument of a command or environment – except
12504 for the required argument that is associated with the content of the paragraph
12505 itself – has a separate definition, where the number specifies the order
12507 The definition must end with
12508 \begin_inset Flex Code
12511 \begin_layout Plain Layout
12518 So a command with two optional arguments has:
12522 \begin_layout Quote
12528 \begin_layout Quote
12534 \begin_layout Quote
12540 \begin_layout Quote
12546 \begin_layout Quote
12552 \begin_layout Quote
12558 \begin_layout Standard
12560 \begin_inset Flex Code
12563 \begin_layout Plain Layout
12569 definition, the following specifications are possible:
12572 \begin_layout Itemize
12573 \begin_inset Flex Code
12576 \begin_layout Plain Layout
12583 \begin_inset Flex Code
12586 \begin_layout Plain Layout
12592 The string that will appear both in the menu (to insert this argument)
12593 and on the argument inset button (unless you also specify a separate
12594 \begin_inset Flex Code
12597 \begin_layout Plain Layout
12604 For the menu, you can define an accelerator by appending the respective
12605 character to the string, divided by
12606 \begin_inset Quotes eld
12610 \begin_inset Quotes erd
12614 \begin_inset space \thinspace{}
12618 \begin_inset space \space{}
12622 \begin_inset Quotes eld
12626 \begin_inset Flex Code
12629 \begin_layout Plain Layout
12636 \begin_inset Quotes erd
12642 \begin_layout Itemize
12643 \begin_inset Flex Code
12646 \begin_layout Plain Layout
12653 \begin_inset Flex Code
12656 \begin_layout Plain Layout
12662 A separate string for the menu.
12663 You can define an accelerator by appending the respective character to
12664 the string, divided by
12665 \begin_inset Quotes eld
12669 \begin_inset Quotes erd
12673 \begin_inset space \thinspace{}
12677 \begin_inset space \space{}
12681 \begin_inset Quotes eld
12685 \begin_inset Flex Code
12688 \begin_layout Plain Layout
12695 \begin_inset Quotes erd
12699 This specification is optional.
12700 If it is not given the
12701 \begin_inset Flex Code
12704 \begin_layout Plain Layout
12710 will be used instead for the menu.
12713 \begin_layout Itemize
12714 \begin_inset Flex Code
12717 \begin_layout Plain Layout
12724 \begin_inset Flex Code
12727 \begin_layout Plain Layout
12733 A longer explanatory text that appears in the tooltip when hovering over
12734 the argument inset.
12737 \begin_layout Itemize
12738 \begin_inset Flex Code
12741 \begin_layout Plain Layout
12748 \begin_inset Flex Code
12751 \begin_layout Plain Layout
12760 \begin_inset space \thinspace{}
12764 \begin_inset Flex Code
12767 \begin_layout Plain Layout
12773 ] Declare if this is a mandatory (1) or an optional (0) argument.
12774 Mandatory arguments will be output empty if not given, while optional arguments
12775 will not be output at all.
12776 By default, mandatory arguments are delimited by
12777 \begin_inset Flex Code
12780 \begin_layout Plain Layout
12786 , while optional arguments are delimited by
12787 \begin_inset Flex Code
12790 \begin_layout Plain Layout
12797 \change_inserted -712698321 1555579782
12801 \begin_layout Itemize
12803 \change_inserted -712698321 1555579780
12804 \begin_inset Flex Code
12807 \begin_layout Plain Layout
12809 \change_inserted -712698321 1555579780
12818 \begin_inset Flex Code
12821 \begin_layout Plain Layout
12823 \change_inserted -712698321 1555579780
12831 Option to define a different command (from the default
12832 \begin_inset Flex Code
12835 \begin_layout Plain Layout
12837 \change_inserted -712698321 1555579780
12849 ) to be used for line breaks.
12850 The initial backslash must not be specified.
12855 \begin_layout Itemize
12856 \begin_inset Flex Code
12859 \begin_layout Plain Layout
12866 \begin_inset Flex Code
12869 \begin_layout Plain Layout
12875 defines another argument (by its number) which this argument requires to
12876 be output if it is itself output.
12878 \begin_inset space \thinspace{}
12881 g., in \SpecialChar LaTeX
12882 commands, optional arguments often require previous optional arguments
12883 to be output (at least empty), as in
12884 \begin_inset Flex Code
12887 \begin_layout Plain Layout
12890 command[][argument]{text}
12896 This can be achieved by the statement
12897 \begin_inset Flex Code
12900 \begin_layout Plain Layout
12907 \begin_inset Flex Code
12910 \begin_layout Plain Layout
12919 \begin_layout Itemize
12920 \begin_inset Flex Code
12923 \begin_layout Plain Layout
12930 \begin_inset Flex Code
12933 \begin_layout Plain Layout
12939 defines a custom left delimiter (instead of
12940 \begin_inset Flex Code
12943 \begin_layout Plain Layout
12950 \begin_inset Flex Code
12953 \begin_layout Plain Layout
12960 A line break in the output can be indicated by
12961 \begin_inset Flex Code
12964 \begin_layout Plain Layout
12973 \begin_layout Itemize
12974 \begin_inset Flex Code
12977 \begin_layout Plain Layout
12984 \begin_inset Flex Code
12987 \begin_layout Plain Layout
12993 defines a custom right delimiter (instead of
12994 \begin_inset Flex Code
12997 \begin_layout Plain Layout
13004 \begin_inset Flex Code
13007 \begin_layout Plain Layout
13014 A line break in the output can be indicated by
13015 \begin_inset Flex Code
13018 \begin_layout Plain Layout
13027 \begin_layout Itemize
13028 \begin_inset Flex Code
13031 \begin_layout Plain Layout
13038 \begin_inset Flex Code
13041 \begin_layout Plain Layout
13047 defines an argument that is inserted if and only if no user-specified arguments
13049 \begin_inset space \thinspace{}
13053 \begin_inset space \space{}
13056 if no argument inset has been inserted (note that also an empty argument
13057 inset omits the DefaultArg).
13058 Multiple arguments need to be separated by comma.
13061 \begin_layout Itemize
13062 \begin_inset Flex Code
13065 \begin_layout Plain Layout
13072 \begin_inset Flex Code
13075 \begin_layout Plain Layout
13081 defines an argument that is inserted in any case (alone or in addition
13082 to user-specified arguments).
13083 Multiple arguments need to be separated by comma.
13086 \begin_layout Itemize
13087 \begin_inset Flex Code
13090 \begin_layout Plain Layout
13096 The font used for the argument content, see
13097 \begin_inset CommandInset ref
13099 reference "subsec:Font-description"
13104 \change_inserted -712698321 1559484228
13108 \begin_layout Itemize
13110 \change_inserted -712698321 1559484228
13111 \begin_inset Flex Code
13114 \begin_layout Plain Layout
13116 \change_inserted -712698321 1559484228
13125 \begin_inset Flex Code
13128 \begin_layout Plain Layout
13130 \change_inserted -712698321 1559484228
13141 \begin_inset space \thinspace{}
13145 \begin_inset Flex Code
13148 \begin_layout Plain Layout
13150 \change_inserted -712698321 1559484228
13158 ] As with paragraph styles, see
13159 \begin_inset CommandInset ref
13161 reference "subsec:Paragraph-Styles"
13170 \begin_layout Itemize
13171 \begin_inset Flex Code
13174 \begin_layout Plain Layout
13180 The font used for the label; see
13181 \begin_inset CommandInset ref
13183 reference "subsec:Font-description"
13190 \begin_layout Itemize
13191 \begin_inset Flex Code
13194 \begin_layout Plain Layout
13201 \begin_inset Flex Code
13204 \begin_layout Plain Layout
13209 , Minimalistic, Conglomerate
13214 ] describes the rendering style used for the inset's frame and buttons.
13217 \begin_layout Itemize
13218 \begin_inset Flex Code
13221 \begin_layout Plain Layout
13228 \begin_inset Flex Code
13231 \begin_layout Plain Layout
13238 \begin_inset Flex Code
13241 \begin_layout Plain Layout
13247 , this argument is automatically inserted when the respective style is selected.
13249 \change_deleted -712698321 1559484200
13250 Currently, only one argument per style\SpecialChar breakableslash
13251 layout can be automatically inserted.
13256 \begin_layout Itemize
13258 \change_inserted -712698321 1559491402
13259 \begin_inset Flex Code
13262 \begin_layout Plain Layout
13264 \change_inserted -712698321 1559490711
13273 \begin_inset Flex Code
13276 \begin_layout Plain Layout
13278 \change_inserted -712698321 1559490703
13287 \begin_inset Flex Code
13290 \begin_layout Plain Layout
13292 \change_inserted -712698321 1559490703
13300 , this argument will be inserted on a new line with
13301 \begin_inset Flex Code
13304 \begin_layout Plain Layout
13306 \change_inserted -712698321 1559491402
13314 (only available within Flex insets).
13317 \begin_layout Itemize
13318 \begin_inset Flex Code
13321 \begin_layout Plain Layout
13328 \begin_inset Flex Code
13331 \begin_layout Plain Layout
13338 \begin_inset Flex Code
13341 \begin_layout Plain Layout
13347 , this argument will be inserted with a copy of the co-text (either selected
13348 text or the whole paragraph) as content.
13351 \begin_layout Itemize
13352 \begin_inset Flex Code
13355 \begin_layout Plain Layout
13362 \begin_inset Flex Code
13365 \begin_layout Plain Layout
13375 ] Whether the contents of this argument should be output in raw form, meaning
13376 without special translations that \SpecialChar LaTeX
13379 \begin_inset Flex Code
13382 \begin_layout Plain Layout
13388 status is inherited by the inset or paragraph layout the argument belongs
13389 to, true and false change the status for the given argument only.
13392 \begin_layout Itemize
13393 \begin_inset Flex Code
13396 \begin_layout Plain Layout
13403 \begin_inset Flex Code
13406 \begin_layout Plain Layout
13407 string of characters
13416 Defines individual characters
13417 \begin_inset Newline linebreak
13420 that should be output in raw form, meaning without special translations
13421 that \SpecialChar LaTeX
13423 Note that, contrary to PassThru, this needs to be explicitly defined for
13425 That is, arguments do not inherit PassThruChars from their parent inset
13429 \begin_layout Itemize
13430 \begin_inset Flex Code
13433 \begin_layout Plain Layout
13440 \begin_inset Flex Code
13443 \begin_layout Plain Layout
13452 \begin_inset space \thinspace{}
13456 \begin_inset Flex Code
13459 \begin_layout Plain Layout
13465 ] If this is set to 1, the argument will output its content in the corresponding
13466 item in the table of contents.
13470 \begin_layout Standard
13471 By default, the text entered in the \SpecialChar LyX
13472 workarea in the respective layout is
13473 the last (mandatory) argument of a command if the
13474 \begin_inset Flex Code
13477 \begin_layout Plain Layout
13484 \begin_inset Flex Code
13487 \begin_layout Plain Layout
13494 However, arguments with the prefix
13495 \begin_inset Flex Code
13498 \begin_layout Plain Layout
13504 are output after this workarea argument.
13505 Note that post-argument numbering restarts at 1, so the first argument
13506 following the workarea argument is
13507 \begin_inset Flex Code
13510 \begin_layout Plain Layout
13517 Post-arguments are ignored in any other
13518 \begin_inset Flex Code
13521 \begin_layout Plain Layout
13528 \begin_inset Flex Code
13531 \begin_layout Plain Layout
13540 \begin_layout Standard
13542 \begin_inset Flex Code
13545 \begin_layout Plain Layout
13554 \begin_inset Flex Code
13557 \begin_layout Plain Layout
13566 \begin_inset Flex Code
13569 \begin_layout Plain Layout
13575 followed by the number (e.
13576 \begin_inset space \thinspace{}
13580 \begin_inset space \space{}
13584 \begin_inset Flex Code
13587 \begin_layout Plain Layout
13594 \change_inserted -712698321 1534487781
13598 \begin_layout Standard
13600 \change_inserted -712698321 1534488561
13601 Finally, there is a special argument type with the prefix
13602 \begin_inset Flex Code
13605 \begin_layout Plain Layout
13607 \change_inserted -712698321 1534487844
13616 It is not really an argument, but uses the argument interface (thus, the
13617 prefix is also followed by a number, e.
13618 \begin_inset space \thinspace{}
13623 \begin_inset Flex Code
13626 \begin_layout Plain Layout
13628 \change_inserted -712698321 1534488412
13629 Argument listpreamble:1
13637 As the name implies, it is targeted at lists such as
13654 Its content will be output at the list start, before the first
13655 \begin_inset Flex Code
13658 \begin_layout Plain Layout
13660 \change_inserted -712698321 1534488058
13670 , on an own line (a place that is otherwise not accessible in \SpecialChar LyX
13672 This way, users can insert redefinitions (of lengths etc.) to individual
13674 By default, these arguments do not have a delimiter.
13680 \begin_layout Description
13681 \begin_inset Flex Code
13684 \begin_layout Plain Layout
13690 Includes a comma-separated list of layouts that should be nested in and
13691 after the current layout.
13692 Only makes sense for nestable layouts (such as environments).
13694 \begin_inset Quotes eld
13698 \begin_inset Flex Code
13701 \begin_layout Plain Layout
13708 \begin_inset Quotes erd
13713 \begin_inset Flex Code
13716 \begin_layout Plain Layout
13725 \begin_layout Description
13726 \begin_inset Flex Code
13729 \begin_layout Plain Layout
13735 Note that this will completely override any prior
13736 \begin_inset Flex Code
13739 \begin_layout Plain Layout
13745 declaration for this style.
13747 \begin_inset Quotes eld
13751 \begin_inset Flex Code
13754 \begin_layout Plain Layout
13761 \begin_inset Quotes erd
13766 \begin_inset CommandInset ref
13768 reference "subsec:I18n"
13772 for details on its use.
13775 \begin_layout Description
13776 \begin_inset Flex Code
13779 \begin_layout Plain Layout
13786 \begin_inset Flex Code
13789 \begin_layout Plain Layout
13799 \begin_layout Plain Layout
13800 Note that a `float' here is a real number, such as: 1.5.
13805 The vertical space with which the last of a chain of paragraphs with this
13806 style is separated from the following paragraph.
13807 If the next paragraph has another style, the separations are not simply
13808 added, but the maximum is taken.
13811 \begin_layout Description
13812 \begin_inset Flex Code
13815 \begin_layout Plain Layout
13822 \begin_inset Flex Code
13825 \begin_layout Plain Layout
13831 ] The category for this style.
13832 This is used to group related styles in the style combobox on the toolbar.
13833 Any string can be used, but you may want to use existing categories with
13838 \begin_layout Description
13839 \begin_inset Flex Code
13842 \begin_layout Plain Layout
13848 Depth of XML command.
13849 Used only with XML-type formats.
13852 \begin_layout Description
13853 \begin_inset Flex Code
13856 \begin_layout Plain Layout
13863 \begin_inset Flex Code
13866 \begin_layout Plain Layout
13872 ] Copies all the features of an existing style into the current one.
13876 \begin_layout Description
13877 \begin_inset Flex Code
13880 \begin_layout Plain Layout
13887 \begin_inset Flex Code
13890 \begin_layout Plain Layout
13896 ] The name of a style whose preamble should be output
13901 This allows to ensure some ordering of the preamble snippets when macros
13902 definitions depend on one another.
13906 \begin_layout Plain Layout
13907 Note that, besides that functionality, there is no way to ensure any ordering
13909 The ordering that you see in a given version of \SpecialChar LyX
13910 may change without warning
13919 \begin_layout Description
13920 \begin_inset Flex Code
13923 \begin_layout Plain Layout
13930 \begin_inset Flex Code
13933 \begin_layout Plain Layout
13938 , Box, Filled_Box, Static
13943 ] The type of label that stands at the end of the paragraph (or sequence
13945 \begin_inset Flex Code
13948 \begin_layout Plain Layout
13955 \begin_inset Newline newline
13959 \begin_inset Flex Code
13962 \begin_layout Plain Layout
13969 \begin_inset Flex Code
13972 \begin_layout Plain Layout
13979 \begin_inset Flex Code
13982 \begin_layout Plain Layout
13990 \begin_inset Flex Code
13993 \begin_layout Plain Layout
14000 \begin_inset Quotes eld
14004 \begin_inset Quotes erd
14008 \begin_inset Flex Code
14011 \begin_layout Plain Layout
14018 \begin_inset space \space{}
14022 \begin_inset Flex Code
14025 \begin_layout Plain Layout
14031 ) is a white (resp.
14032 \begin_inset space ~
14035 black) square suitable for end of proof markers,
14036 \begin_inset Flex Code
14039 \begin_layout Plain Layout
14045 is an explicit text string.
14048 \begin_layout Description
14049 \begin_inset Flex Code
14052 \begin_layout Plain Layout
14059 \begin_inset Flex Code
14062 \begin_layout Plain Layout
14068 ] The string used for a label with a
14069 \begin_inset Flex Code
14072 \begin_layout Plain Layout
14079 \begin_inset Newline newline
14083 \begin_inset Flex Code
14086 \begin_layout Plain Layout
14096 \begin_layout Description
14097 \begin_inset Flex Code
14100 \begin_layout Plain Layout
14106 The font used for both the text body
14112 \begin_inset CommandInset ref
14114 reference "subsec:Font-description"
14119 Note that defining this font automatically defines the
14120 \begin_inset Flex Code
14123 \begin_layout Plain Layout
14130 So you should define this one first if you also want to define
14131 \begin_inset Flex Code
14134 \begin_layout Plain Layout
14143 \begin_layout Description
14144 \begin_inset Flex Code
14147 \begin_layout Plain Layout
14154 \begin_inset Flex Code
14157 \begin_layout Plain Layout
14163 ] Used for backporting new styles to stable \SpecialChar LyX
14165 The first stable version that supports this tag is \SpecialChar LyX
14167 The argument is a number which may either be 0, -1 or any value greater
14170 \begin_inset Flex Code
14173 \begin_layout Plain Layout
14179 flag of a style is greater than zero, it will always be written to the
14181 If a .lyx file is read, the style definitions from the document header are
14182 added to the document class.
14183 Therefore even older \SpecialChar LyX
14184 versions can handle the style.
14186 \begin_inset Flex Code
14189 \begin_layout Plain Layout
14195 is a version number: if the style is read, and the version number is less
14196 than the version number of the already existing style in the document class,
14197 the new style is ignored.
14198 If the version number is greater, the new style replaces the existing style.
14199 A value of -1 means an infinite version number, i.
14200 \begin_inset space \thinspace{}
14204 \begin_inset space \space{}
14207 the style is always used.
14210 \begin_layout Description
14211 \begin_inset Flex Code
14214 \begin_layout Plain Layout
14221 \begin_inset Flex Code
14224 \begin_layout Plain Layout
14233 \begin_inset space \thinspace{}
14237 \begin_inset Flex Code
14240 \begin_layout Plain Layout
14246 ] Usually \SpecialChar LyX
14247 does not allow you to insert more than one space between words,
14248 since a space is considered as the separation between two words, not a
14249 character or symbol of its own.
14250 This is a very fine thing but sometimes annoying, for example, when typing
14251 program code or plain \SpecialChar LaTeX
14254 \begin_inset Flex Code
14257 \begin_layout Plain Layout
14265 \change_deleted -495245474 1550490105
14269 will create protected blanks for the additional blanks when in
14270 \change_inserted -495245474 1550490096
14272 \begin_inset Flex Code
14275 \begin_layout Plain Layout
14277 \change_inserted -495245474 1550490089
14286 \change_deleted -495245474 1550490116
14287 another mode than \SpecialChar LaTeX
14290 \change_inserted -495245474 1550247760
14292 \begin_inset Flex Code
14295 \begin_layout Plain Layout
14297 \change_inserted -495245474 1550247736
14306 \begin_inset Flex Code
14309 \begin_layout Plain Layout
14311 \change_inserted -495245474 1550247755
14324 \begin_layout Description
14325 \begin_inset Flex Code
14328 \begin_layout Plain Layout
14334 These tags are used with XHTML output.
14336 \begin_inset CommandInset ref
14338 reference "subsec:Paragraph-Style-XHTML"
14345 \begin_layout Description
14346 \begin_inset Flex Code
14349 \begin_layout Plain Layout
14355 [FIXME] (Used only with XML-type formats.)
14358 \begin_layout Description
14359 \begin_inset Flex Code
14362 \begin_layout Plain Layout
14369 \begin_inset Flex Code
14372 \begin_layout Plain Layout
14381 \begin_inset space \thinspace{}
14385 \begin_inset Flex Code
14388 \begin_layout Plain Layout
14395 \begin_inset Flex Code
14398 \begin_layout Plain Layout
14404 , marks the style as to be included in the document preamble and not in
14406 This is useful for document classes that want such information as the title
14407 and author to appear in the preamble.
14408 Note that this works only for styles for which the
14409 \begin_inset Flex Code
14412 \begin_layout Plain Layout
14419 \begin_inset Flex Code
14422 \begin_layout Plain Layout
14429 \begin_inset Flex Code
14432 \begin_layout Plain Layout
14441 \begin_layout Description
14442 \begin_inset Flex Code
14445 \begin_layout Plain Layout
14452 \begin_inset Flex Code
14455 \begin_layout Plain Layout
14464 \begin_inset space \thinspace{}
14468 \begin_inset Flex Code
14471 \begin_layout Plain Layout
14478 \begin_inset Flex Code
14481 \begin_layout Plain Layout
14487 , marks the style as being part of a title block (see also the
14488 \begin_inset Flex Code
14491 \begin_layout Plain Layout
14498 \begin_inset Flex Code
14501 \begin_layout Plain Layout
14510 \begin_layout Description
14511 \begin_inset Flex Code
14514 \begin_layout Plain Layout
14520 Includes a comma-separated list of layouts after which this one should
14522 Only makes sense with regard to nestable layouts (such as environments).
14524 \begin_inset Quotes eld
14528 \begin_inset Flex Code
14531 \begin_layout Plain Layout
14538 \begin_inset Quotes erd
14543 \begin_inset Flex Code
14546 \begin_layout Plain Layout
14555 \begin_layout Description
14556 \begin_inset Flex Code
14559 \begin_layout Plain Layout
14566 \begin_inset Flex Code
14569 \begin_layout Plain Layout
14578 \begin_inset space \thinspace{}
14582 \begin_inset Flex Code
14585 \begin_layout Plain Layout
14591 ] If this is set to 1 and AddToToc is enabled, the paragraph adds a summary
14592 of its contents in its item in the table of contents.
14593 Otherwise, only the label, if it exists, appears.
14596 \begin_layout Description
14597 \begin_inset Flex Code
14600 \begin_layout Plain Layout
14607 \begin_inset Flex Code
14610 \begin_layout Plain Layout
14616 ] The \SpecialChar LaTeX
14617 command sequence declaring an item in a list.
14618 The command is to be defined without the preceding backslash (the default
14620 \begin_inset Quotes eld
14624 \begin_inset Quotes erd
14628 \begin_inset Flex Code
14631 \begin_layout Plain Layout
14639 in the \SpecialChar LaTeX
14643 \begin_layout Description
14644 \begin_inset Flex Code
14647 \begin_layout Plain Layout
14654 \begin_inset Flex Code
14657 \begin_layout Plain Layout
14663 ] This provides extra space between paragraphs that have the same style.
14664 If you put other styles into an environment, each is separated with the
14666 \begin_inset Flex Code
14669 \begin_layout Plain Layout
14676 But the whole items of the environment are additionally separated with
14678 \begin_inset Flex Code
14681 \begin_layout Plain Layout
14688 Note that this is a
14693 \begin_layout Description
14694 \begin_inset Flex Code
14697 \begin_layout Plain Layout
14703 [FIXME] (Used only with XML-type formats.)
14706 \begin_layout Description
14707 \begin_inset Flex Code
14710 \begin_layout Plain Layout
14717 \begin_inset Flex Code
14720 \begin_layout Plain Layout
14729 \begin_inset space \thinspace{}
14733 \begin_inset Flex Code
14736 \begin_layout Plain Layout
14742 ] Usually \SpecialChar LyX
14743 does not allow you to leave a paragraph empty, since it would
14744 lead to empty \SpecialChar LaTeX
14746 There are some cases where this could be desirable however: in a letter
14747 template, the required fields can be provided as empty fields, so that
14748 people do not forget them; in some special classes, a style can be used
14749 as some kind of break, which does not contain actual text.
14752 \begin_layout Description
14753 \begin_inset Flex Code
14756 \begin_layout Plain Layout
14763 \begin_inset Flex Code
14766 \begin_layout Plain Layout
14772 ] The vertical space between the label and the text body.
14773 Only used for labels that are above the text body (
14774 \begin_inset Flex Code
14777 \begin_layout Plain Layout
14784 \begin_inset Newline newline
14788 \begin_inset Flex Code
14791 \begin_layout Plain Layout
14792 Centered_Top_Environment
14800 \begin_layout Description
14801 \begin_inset Flex Code
14804 \begin_layout Plain Layout
14811 \begin_inset Flex Code
14814 \begin_layout Plain Layout
14820 ] The name of the counter for automatic numbering.
14821 In order to have the counter appear with your label, you will need to reference
14823 \begin_inset Flex Code
14826 \begin_layout Plain Layout
14835 This will work with
14836 \begin_inset Flex Code
14839 \begin_layout Plain Layout
14846 \begin_inset Flex Code
14849 \begin_layout Plain Layout
14856 \begin_inset Flex Code
14859 \begin_layout Plain Layout
14866 \begin_inset Flex Code
14869 \begin_layout Plain Layout
14876 \begin_inset Newline newline
14884 \begin_inset Flex Code
14887 \begin_layout Plain Layout
14894 \begin_inset Flex Code
14897 \begin_layout Plain Layout
14903 , though this case is a bit complicated.
14904 Suppose you declare
14905 \begin_inset Quotes eld
14909 \begin_inset Flex Code
14912 \begin_layout Plain Layout
14913 LabelCounter myenum
14919 \begin_inset Quotes erd
14923 Then the actual counters used are
14924 \begin_inset Flex Code
14927 \begin_layout Plain Layout
14934 \begin_inset Flex Code
14937 \begin_layout Plain Layout
14944 \begin_inset Flex Code
14947 \begin_layout Plain Layout
14954 \begin_inset Flex Code
14957 \begin_layout Plain Layout
14963 , much as in \SpecialChar LaTeX
14965 These counters must all be declared separately.
14966 \begin_inset Newline newline
14970 \begin_inset CommandInset ref
14972 reference "subsec:Counters"
14976 for details on counters.
14979 \begin_layout Description
14980 \begin_inset Flex Code
14983 \begin_layout Plain Layout
14989 The font used for the label.
14991 \begin_inset CommandInset ref
14993 reference "subsec:Font-description"
15000 \begin_layout Description
15001 \begin_inset Flex Code
15004 \begin_layout Plain Layout
15011 \begin_inset Flex Code
15014 \begin_layout Plain Layout
15020 ] Text that indicates how far a label should be indented.
15023 \begin_layout Description
15024 \begin_inset Flex Code
15027 \begin_layout Plain Layout
15034 \begin_inset Flex Code
15037 \begin_layout Plain Layout
15043 ] Text that indicates the amount of horizontal space between the label and
15045 Only used for labels that are not above the text body.
15048 \begin_layout Description
15049 \begin_inset Flex Code
15052 \begin_layout Plain Layout
15059 \begin_inset Flex Code
15062 \begin_layout Plain Layout
15068 ] The string used for the label.
15070 \begin_inset Flex Code
15073 \begin_layout Plain Layout
15079 is set, this string can be contain the special formatting commands described
15081 \begin_inset CommandInset ref
15083 reference "subsec:Counters"
15090 \begin_layout Description
15091 \begin_inset Flex Code
15094 \begin_layout Plain Layout
15095 LabelStringAppendix
15101 \begin_inset Flex Code
15104 \begin_layout Plain Layout
15110 ] This is used inside the appendix instead of
15111 \begin_inset Newline newline
15115 \begin_inset Flex Code
15118 \begin_layout Plain Layout
15126 \begin_inset Flex Code
15129 \begin_layout Plain Layout
15136 \begin_inset Newline newline
15140 \begin_inset Flex Code
15143 \begin_layout Plain Layout
15144 LabelStringAppendix
15152 \begin_layout Description
15153 \begin_inset Flex Code
15156 \begin_layout Plain Layout
15162 [FIXME] (Used only with XML-type formats.)
15165 \begin_layout Description
15166 \begin_inset Flex Code
15169 \begin_layout Plain Layout
15176 \begin_inset Flex Code
15179 \begin_layout Plain Layout
15184 , Manual, Static, Above,
15185 \begin_inset Newline newline
15188 Centered, Sensitive, Enumerate,
15189 \begin_inset Newline newline
15192 Itemize, Bibliography
15201 \begin_layout Description
15202 \begin_inset Flex Code
15205 \begin_layout Plain Layout
15211 means the label is the very first word (up to the first real blank).
15212 Use protected spaces if you want more than one word as the label.
15216 \begin_layout Description
15217 \begin_inset Flex Code
15220 \begin_layout Plain Layout
15226 means the label is simply what is declared as
15227 \begin_inset Flex Code
15230 \begin_layout Plain Layout
15237 This will be displayed
15238 \begin_inset Quotes eld
15242 \begin_inset Quotes erd
15245 , at the beginning of the paragraph.
15247 \begin_inset Flex Code
15250 \begin_layout Plain Layout
15257 \begin_inset Flex Code
15260 \begin_layout Plain Layout
15266 , then it will be displayed only in the first paragraph of any sequence
15267 of paragraphs with the same
15268 \begin_inset Flex Code
15271 \begin_layout Plain Layout
15280 \begin_layout Description
15281 \begin_inset Flex Code
15284 \begin_layout Plain Layout
15291 \begin_inset space ~
15295 \begin_inset space ~
15299 \begin_inset Flex Code
15302 \begin_layout Plain Layout
15308 are special cases of
15309 \begin_inset Flex Code
15312 \begin_layout Plain Layout
15319 The label will be printed above the paragraph either at the beginning of
15320 the line or centered.
15323 \begin_layout Description
15324 \begin_inset Flex Code
15327 \begin_layout Plain Layout
15333 is a special case for the caption-labels
15334 \begin_inset Quotes eld
15338 \begin_inset Quotes erd
15342 \begin_inset Quotes eld
15346 \begin_inset Quotes erd
15350 \begin_inset Newline newline
15354 \begin_inset Flex Code
15357 \begin_layout Plain Layout
15363 means the (hardcoded) label string depends on the kind of float: It is
15364 hardcoded to be `FloatType N', where N is the value of the counter associated
15366 For the case that a caption is inserted outside of a float the
15367 \begin_inset Flex Code
15370 \begin_layout Plain Layout
15377 \begin_inset Quotes eld
15381 \begin_inset Quotes erd
15387 \begin_layout Description
15388 \begin_inset Flex Code
15391 \begin_layout Plain Layout
15397 produces the usual sort of enumeration labels.
15398 The number type needs to be set in the
15403 \begin_inset CommandInset ref
15405 reference "subsec:Counters"
15412 \begin_layout Description
15413 \begin_inset Flex Code
15416 \begin_layout Plain Layout
15422 produces various bullets at the different levels.
15423 The bullet types displayed can be set via
15424 \begin_inset Flex Noun
15427 \begin_layout Plain Layout
15428 Document\SpecialChar menuseparator
15429 Settings\SpecialChar menuseparator
15438 \begin_layout Description
15439 \begin_inset Flex Code
15442 \begin_layout Plain Layout
15448 should be used only with
15449 \begin_inset Flex Code
15452 \begin_layout Plain Layout
15453 LatexType BibEnvironment
15462 \begin_layout Description
15463 \begin_inset Flex Code
15466 \begin_layout Plain Layout
15472 Note that this will completely override any prior
15473 \begin_inset Flex Code
15476 \begin_layout Plain Layout
15482 declaration for this style.
15484 \begin_inset Quotes eld
15488 \begin_inset Flex Code
15491 \begin_layout Plain Layout
15498 \begin_inset Quotes erd
15503 \begin_inset CommandInset ref
15505 reference "subsec:I18n"
15509 for details on its use.
15512 \begin_layout Description
15513 \begin_inset Flex Code
15516 \begin_layout Plain Layout
15523 \begin_inset Flex Code
15526 \begin_layout Plain Layout
15532 ] The name of the corresponding \SpecialChar LaTeX
15534 Either the environment or command name.
15537 \begin_layout Description
15538 \begin_inset Flex Code
15541 \begin_layout Plain Layout
15548 \begin_inset Flex Code
15551 \begin_layout Plain Layout
15557 ] An optional parameter for the corresponding
15558 \begin_inset Flex Code
15561 \begin_layout Plain Layout
15568 This parameter cannot be changed from within \SpecialChar LyX
15570 \begin_inset Flex Code
15573 \begin_layout Plain Layout
15579 for customizable parameters).
15580 This will be output as is after all \SpecialChar LaTeX
15582 \begin_inset Flex Code
15585 \begin_layout Plain Layout
15594 \begin_layout Description
15595 \begin_inset Flex Code
15598 \begin_layout Plain Layout
15605 \begin_inset Flex Code
15608 \begin_layout Plain Layout
15613 , Command, Environment, Item_Environment,
15614 \begin_inset Newline newline
15617 List_Environment, Bib_Environment
15622 ] How the style should be translated into \SpecialChar LaTeX
15627 \begin_layout Plain Layout
15628 \begin_inset Flex Code
15631 \begin_layout Plain Layout
15637 is perhaps a bit misleading, since these rules apply to SGML classes, too.
15638 Visit the SGML class files for specific examples.
15647 \begin_layout Description
15648 \begin_inset Flex Code
15651 \begin_layout Plain Layout
15657 means nothing special.
15660 \begin_layout Description
15661 \begin_inset Flex Code
15664 \begin_layout Plain Layout
15671 \begin_inset Flex Code
15674 \begin_layout Plain Layout
15681 {\SpecialChar ldots
15690 \begin_layout Description
15691 \begin_inset Flex Code
15694 \begin_layout Plain Layout
15701 \begin_inset Flex Code
15704 \begin_layout Plain Layout
15711 }\SpecialChar ldots
15727 \begin_layout Description
15728 \begin_inset Flex Code
15731 \begin_layout Plain Layout
15738 \begin_inset Flex Code
15741 \begin_layout Plain Layout
15748 \begin_inset Flex Code
15751 \begin_layout Plain Layout
15759 is generated for each paragraph of this environment.
15763 \begin_layout Description
15764 \begin_inset Flex Code
15767 \begin_layout Plain Layout
15774 \begin_inset Flex Code
15777 \begin_layout Plain Layout
15784 \begin_inset Newline newline
15788 \begin_inset Flex Code
15791 \begin_layout Plain Layout
15797 is passed as an argument to the environment.
15798 \begin_inset Newline newline
15802 \begin_inset Flex Code
15805 \begin_layout Plain Layout
15811 can be defined in the
15812 \begin_inset Flex Noun
15815 \begin_layout Plain Layout
15816 Edit\SpecialChar menuseparator
15818 \begin_inset space ~
15829 \begin_layout Description
15830 \begin_inset Flex Code
15833 \begin_layout Plain Layout
15840 \begin_inset Flex Code
15843 \begin_layout Plain Layout
15849 but adds the necessary mandatory argument (the longest label) to the begin
15850 statement of the bibliography environment:
15851 \begin_inset Newline newline
15855 \begin_inset Flex Code
15858 \begin_layout Plain Layout
15861 begin{thebibliography}{99}
15867 It is therefore only useful for bibliography environments.
15868 The default longest label
15869 \begin_inset Quotes eld
15873 \begin_inset Quotes erd
15876 can be changed by the user in the paragraph settings of a bibliography
15880 \begin_layout Standard
15881 Putting the last few things together, the \SpecialChar LaTeX
15882 output will be either:
15885 \begin_layout LyX-Code
15888 LatexName[LatexParam]{\SpecialChar ldots
15892 \begin_layout Standard
15896 \begin_layout LyX-Code
15899 begin{LatexName}[LatexParam] \SpecialChar ldots
15905 \begin_layout Standard
15906 depending upon the \SpecialChar LaTeX
15911 \begin_layout Description
15912 \begin_inset Flex Code
15915 \begin_layout Plain Layout
15922 \begin_inset Flex Code
15925 \begin_layout Plain Layout
15931 ] A string that is put at the beginning of the style content.
15932 A line break in the output can be indicated by
15933 \begin_inset Flex Code
15936 \begin_layout Plain Layout
15945 \begin_layout Description
15946 \begin_inset Flex Code
15949 \begin_layout Plain Layout
15956 \begin_inset Flex Code
15959 \begin_layout Plain Layout
15965 ] If you put styles into environments, the different
15966 \begin_inset Flex Code
15969 \begin_layout Plain Layout
15975 are not simply added, but added with a factor
15976 \begin_inset Formula $\frac{4}{\mathrm{depth}+4}$
15980 Note that this parameter is also used when
15981 \begin_inset Flex Code
15984 \begin_layout Plain Layout
15991 \begin_inset Flex Code
15994 \begin_layout Plain Layout
16001 \begin_inset Flex Code
16004 \begin_layout Plain Layout
16011 Then it is added to the manual or dynamic margin.
16012 \begin_inset Newline newline
16016 \begin_inset Quotes eld
16020 \begin_inset Flex Code
16023 \begin_layout Plain Layout
16030 \begin_inset Quotes erd
16033 means that the paragraph is indented with the width of
16034 \begin_inset Quotes eld
16038 \begin_inset Flex Code
16041 \begin_layout Plain Layout
16048 \begin_inset Quotes erd
16051 in the normal font.
16052 You can get a negative width by prefixing the string with
16053 \begin_inset Quotes eld
16057 \begin_inset Flex Code
16060 \begin_layout Plain Layout
16067 \begin_inset Quotes erd
16071 This way was chosen so that the look is the same with each used screen
16075 \begin_layout Description
16076 \begin_inset Flex Code
16079 \begin_layout Plain Layout
16086 \begin_inset Flex Code
16089 \begin_layout Plain Layout
16094 , Manual, Dynamic, First_Dynamic, Right_Address_Box
16100 \begin_inset Newline newline
16103 The kind of margin that the style has on the left side.
16107 \begin_layout Description
16108 \begin_inset Flex Code
16111 \begin_layout Plain Layout
16117 just means a fixed margin.
16120 \begin_layout Description
16121 \begin_inset Flex Code
16124 \begin_layout Plain Layout
16130 means that the left margin depends on the string entered in the
16131 \begin_inset Flex Noun
16134 \begin_layout Plain Layout
16135 Edit\SpecialChar menuseparator
16137 \begin_inset space ~
16146 This is used to typeset nice lists without tabulators.
16149 \begin_layout Description
16150 \begin_inset Flex Code
16153 \begin_layout Plain Layout
16159 means that the margin depends on the size of the label.
16160 This is used for automatic enumerated headlines.
16161 It is obvious that the headline
16162 \begin_inset Quotes eld
16165 5.4.3.2.1 Very long headline
16166 \begin_inset Quotes erd
16169 must have a wider left margin (as wide as
16170 \begin_inset Quotes eld
16174 \begin_inset Quotes erd
16177 plus the space) than
16178 \begin_inset Quotes eld
16181 3.2 Very long headline
16182 \begin_inset Quotes erd
16186 \begin_inset Quotes eld
16190 \begin_inset Quotes erd
16193 are not able to do this.
16196 \begin_layout Description
16197 \begin_inset Flex Code
16200 \begin_layout Plain Layout
16206 is similar, but only the very first row of the paragraph is dynamic, while
16207 the others are static; this is used, for example, for descriptions.
16210 \begin_layout Description
16211 \begin_inset Flex Code
16214 \begin_layout Plain Layout
16220 means the margin is chosen in a way that the longest row of this paragraph
16221 fits to the right margin.
16222 This is used to typeset an address on the right edge of the page.
16226 \begin_layout Description
16227 \begin_inset Flex Code
16230 \begin_layout Plain Layout
16237 \begin_inset Flex Code
16240 \begin_layout Plain Layout
16249 \begin_inset space \thinspace{}
16253 \begin_inset Flex Code
16256 \begin_layout Plain Layout
16262 ] Whether fragile commands in this style should be
16263 \begin_inset Flex Code
16266 \begin_layout Plain Layout
16279 whether this command should itself be protected.)
16280 \change_inserted -712698321 1523696949
16284 \begin_layout Description
16286 \change_inserted -712698321 1552395557
16287 \begin_inset Flex Code
16290 \begin_layout Plain Layout
16292 \change_inserted -712698321 1523696950
16301 \begin_inset Flex Code
16304 \begin_layout Plain Layout
16306 \change_inserted -712698321 1523696950
16317 \begin_inset space \thinspace{}
16321 \begin_inset Flex Code
16324 \begin_layout Plain Layout
16326 \change_inserted -712698321 1523696950
16334 ] This causes macros that contain this layout to be protected with
16335 \begin_inset Flex Code
16338 \begin_layout Plain Layout
16340 \change_inserted -712698321 1523696950
16355 ) if necessary and thus allows (some) verbatim stuff in macros.
16358 \begin_layout Description
16360 \change_inserted -712698321 1552395844
16361 \begin_inset Flex Code
16364 \begin_layout Plain Layout
16366 \change_inserted -712698321 1552395561
16375 \begin_inset Flex Code
16378 \begin_layout Plain Layout
16380 \change_inserted -712698321 1552395557
16391 \begin_inset space \thinspace{}
16395 \begin_inset Flex Code
16398 \begin_layout Plain Layout
16400 \change_inserted -712698321 1552395557
16408 ] Whether specific commands in this style (such as
16409 \begin_inset Flex Code
16412 \begin_layout Plain Layout
16414 \change_inserted -712698321 1552395655
16425 \begin_inset Flex Code
16428 \begin_layout Plain Layout
16430 \change_inserted -712698321 1552395661
16440 ) should be protected in an
16441 \begin_inset Flex Code
16444 \begin_layout Plain Layout
16446 \change_inserted -712698321 1552395631
16457 This is particularly needed for styles that draw on
16465 commands which parse their content in complex ways.
16470 \begin_layout Description
16471 \begin_inset Flex Code
16474 \begin_layout Plain Layout
16481 \begin_inset Flex Code
16484 \begin_layout Plain Layout
16491 \begin_inset space \thinspace{}
16495 \begin_inset Flex Code
16498 \begin_layout Plain Layout
16506 ] Whether newlines are translated into \SpecialChar LaTeX
16508 \begin_inset Flex Code
16511 \begin_layout Plain Layout
16522 The translation can be switched off to allow more comfortable \SpecialChar LaTeX
16524 inside \SpecialChar LyX
16528 \begin_layout Description
16529 \begin_inset Flex Code
16532 \begin_layout Plain Layout
16539 \begin_inset Flex Code
16542 \begin_layout Plain Layout
16551 \begin_inset space \thinspace{}
16555 \begin_inset Flex Code
16558 \begin_layout Plain Layout
16564 ] If set to true, and if
16565 \begin_inset Flex Code
16568 \begin_layout Plain Layout
16575 \begin_inset Flex Code
16578 \begin_layout Plain Layout
16584 ) paragraphs are being indented, then the indentation of such a paragraph
16585 following one of this type will be suppressed.
16586 (So this will not affect the display of non-default paragraphs.)
16589 \begin_layout Description
16590 \begin_inset Flex Code
16593 \begin_layout Plain Layout
16600 \begin_inset Flex Code
16603 \begin_layout Plain Layout
16609 ] Name of a style that has replaced this style.
16610 This is used to rename a style, while keeping backward compatibility.
16613 \begin_layout Description
16614 \begin_inset Flex Code
16617 \begin_layout Plain Layout
16624 \begin_inset Flex Code
16627 \begin_layout Plain Layout
16634 \begin_inset space \thinspace{}
16638 \begin_inset Flex Code
16641 \begin_layout Plain Layout
16647 ] Determines whether consecutive paragraphs of the same type are treated
16648 as belonging together.
16649 This has the effect that the
16650 \begin_inset Flex Code
16653 \begin_layout Plain Layout
16659 is only printed once before such a group.
16660 By default, this is true for
16661 \begin_inset Flex Code
16664 \begin_layout Plain Layout
16671 \begin_inset Flex Code
16674 \begin_layout Plain Layout
16681 \begin_inset Flex Code
16684 \begin_layout Plain Layout
16690 and false for all other types.
16693 \begin_layout Description
16694 \begin_inset Flex Code
16697 \begin_layout Plain Layout
16704 \begin_inset Flex Code
16707 \begin_layout Plain Layout
16716 \begin_inset space \thinspace{}
16720 \begin_inset Flex Code
16723 \begin_layout Plain Layout
16729 ] Indicates that paragraphs will not be separated by an empty line in \SpecialChar LaTeX
16731 but only by a line break; together with
16732 \begin_inset Flex Code
16735 \begin_layout Plain Layout
16741 , this allows to emulate a plain text editor (like the ERT inset).
16744 \begin_layout Description
16745 \begin_inset Flex Code
16748 \begin_layout Plain Layout
16755 \begin_inset Flex Code
16758 \begin_layout Plain Layout
16764 ] The indent of the very first line of a paragraph.
16766 \begin_inset Newline newline
16770 \begin_inset Flex Code
16773 \begin_layout Plain Layout
16779 will be fixed for a certain style.
16780 The exception is the default style, since the indentation for these paragraphs
16781 can be prohibited with
16782 \begin_inset Flex Code
16785 \begin_layout Plain Layout
16793 \begin_inset Flex Code
16796 \begin_layout Plain Layout
16802 style paragraphs inside environments use the
16803 \begin_inset Flex Code
16806 \begin_layout Plain Layout
16812 of the environment, not their native one.
16814 \begin_inset Flex Code
16817 \begin_layout Plain Layout
16823 paragraphs inside an enumeration are not indented.
16826 \begin_layout Description
16827 \begin_inset Flex Code
16830 \begin_layout Plain Layout
16837 \begin_inset Flex Code
16840 \begin_layout Plain Layout
16846 ] The vertical space between two paragraphs of this style.
16849 \begin_layout Description
16850 \begin_inset Flex Code
16853 \begin_layout Plain Layout
16860 \begin_inset Flex Code
16863 \begin_layout Plain Layout
16870 allows the user to choose either
16871 \begin_inset Quotes eld
16875 \begin_inset Quotes erd
16879 \begin_inset Quotes eld
16883 \begin_inset Quotes erd
16886 to separate paragraphs.
16888 \begin_inset Quotes eld
16892 \begin_inset Quotes erd
16896 \begin_inset Flex Code
16899 \begin_layout Plain Layout
16907 \begin_inset Quotes eld
16911 \begin_inset Quotes erd
16915 \begin_inset Flex Code
16918 \begin_layout Plain Layout
16924 is ignored and all paragraphs are separated by the
16925 \begin_inset Flex Code
16928 \begin_layout Plain Layout
16935 The vertical space is calculated with
16936 \begin_inset Flex Code
16939 \begin_layout Plain Layout
16941 \begin_inset space ~
16950 \begin_inset Flex Code
16953 \begin_layout Plain Layout
16959 is the height of a row with the normal font.
16960 This way, the look stays the same with different screen fonts.
16963 \begin_layout Description
16964 \begin_inset Flex Code
16967 \begin_layout Plain Layout
16974 \begin_inset Flex Code
16977 \begin_layout Plain Layout
16986 \begin_inset space \thinspace{}
16990 \begin_inset Flex Code
16993 \begin_layout Plain Layout
16999 ] Whether the contents of this paragraph should be output in raw form, meaning
17000 without special translations that \SpecialChar LaTeX
17004 \begin_layout Description
17005 \begin_inset Flex Code
17008 \begin_layout Plain Layout
17015 \begin_inset Flex Code
17018 \begin_layout Plain Layout
17028 Defines individual characters that should be output in raw form, meaning
17029 without special translations that \SpecialChar LaTeX
17033 \begin_layout Description
17034 \begin_inset Flex Code
17037 \begin_layout Plain Layout
17043 Information to be included in the \SpecialChar LaTeX
17044 preamble when this style is used.
17045 Used to define macros, load packages, etc., required by this particular
17048 \begin_inset Quotes eld
17052 \begin_inset Flex Code
17055 \begin_layout Plain Layout
17062 \begin_inset Quotes erd
17068 \begin_layout Description
17069 \begin_inset Flex Code
17072 \begin_layout Plain Layout
17079 \begin_inset Flex Code
17082 \begin_layout Plain Layout
17088 ] The prefix to use when creating labels referring to paragraphs of this
17090 This allows the use of formatted references.
17093 \begin_layout Description
17094 \begin_inset Flex Code
17097 \begin_layout Plain Layout
17104 \begin_inset Flex Code
17107 \begin_layout Plain Layout
17113 ] Whether the style requires the feature
17114 \begin_inset Flex Code
17117 \begin_layout Plain Layout
17124 \begin_inset CommandInset ref
17126 reference "chap:List-of-functions"
17130 for the list of features).
17131 If you require a package with specific options, you can additionally use
17133 \begin_inset Flex Code
17136 \begin_layout Plain Layout
17142 as a general text class parameter (see
17143 \begin_inset CommandInset ref
17145 reference "subsec:General-text-class"
17152 \begin_layout Description
17153 \begin_inset Flex Code
17156 \begin_layout Plain Layout
17163 \begin_inset Flex Code
17166 \begin_layout Plain Layout
17175 \begin_inset Flex Code
17178 \begin_layout Plain Layout
17184 ] Resets the \SpecialChar LaTeX
17185 arguments of this style (as defined via the
17186 \begin_inset Flex Code
17189 \begin_layout Plain Layout
17196 This is useful if you have copied a style via
17197 \begin_inset Flex Code
17200 \begin_layout Plain Layout
17206 , but you do not want to inherit its (required and optional) arguments.
17209 \begin_layout Description
17210 \begin_inset Flex Code
17213 \begin_layout Plain Layout
17220 \begin_inset Flex Code
17223 \begin_layout Plain Layout
17232 \begin_inset Flex Code
17235 \begin_layout Plain Layout
17241 ] Resumes a counter that is usually reset at each new sequence of layouts.
17242 This is currently only useful when
17243 \begin_inset Flex Code
17246 \begin_layout Plain Layout
17253 \begin_inset Flex Code
17256 \begin_layout Plain Layout
17265 \begin_layout Description
17266 \begin_inset Flex Code
17269 \begin_layout Plain Layout
17276 \begin_inset Flex Code
17279 \begin_layout Plain Layout
17285 ] A string that is put at the end of the layout content.
17286 A line break in the output can be indicated by
17287 \begin_inset Flex Code
17290 \begin_layout Plain Layout
17299 \begin_layout Description
17300 \begin_inset Flex Code
17303 \begin_layout Plain Layout
17310 \begin_inset Flex Code
17313 \begin_layout Plain Layout
17320 \begin_inset Flex Code
17323 \begin_layout Plain Layout
17332 \begin_layout Description
17333 \begin_inset Flex Code
17336 \begin_layout Plain Layout
17343 \begin_inset Flex Code
17346 \begin_layout Plain Layout
17355 \begin_inset Flex Code
17358 \begin_layout Plain Layout
17365 \begin_inset Flex Code
17368 \begin_layout Plain Layout
17375 \begin_inset Flex Code
17378 \begin_layout Plain Layout
17380 \begin_inset space ~
17388 ] This defines what the default spacing should be in the style.
17390 \begin_inset Flex Code
17393 \begin_layout Plain Layout
17400 \begin_inset Flex Code
17403 \begin_layout Plain Layout
17410 \begin_inset Flex Code
17413 \begin_layout Plain Layout
17419 correspond respectively to a multiplier value of 1, 1.25 and 1.667.
17420 If you specify the argument
17421 \begin_inset Flex Code
17424 \begin_layout Plain Layout
17430 , then you must also provide a value argument which will be the actual multiplie
17432 Note that, contrary to other parameters,
17433 \begin_inset Flex Code
17436 \begin_layout Plain Layout
17442 implies the generation of specific \SpecialChar LaTeX
17443 code, using the \SpecialChar LaTeX
17447 \begin_inset Flex Code
17450 \begin_layout Plain Layout
17459 \begin_layout Description
17460 \begin_inset Flex Code
17463 \begin_layout Plain Layout
17470 \begin_inset Flex Code
17473 \begin_layout Plain Layout
17480 \begin_inset space \thinspace{}
17484 \begin_inset Flex Code
17487 \begin_layout Plain Layout
17495 ] Allow spell-checking paragraphs of this style.
17499 \begin_layout Description
17500 \begin_inset Flex Code
17503 \begin_layout Plain Layout
17505 \change_deleted 731793113 1604355211
17507 \change_inserted 731793113 1604355212
17516 \begin_inset Flex Code
17519 \begin_layout Plain Layout
17528 \begin_inset Flex Code
17531 \begin_layout Plain Layout
17538 \change_deleted 731793113 1604355214
17540 \change_inserted 731793113 1604355216
17543 counter of a given counter at the beginning of a new sequence of layouts.
17544 This is currently only useful when
17545 \begin_inset Flex Code
17548 \begin_layout Plain Layout
17555 \begin_inset Flex Code
17558 \begin_layout Plain Layout
17567 \begin_layout Description
17568 \begin_inset Flex Code
17571 \begin_layout Plain Layout
17577 The font used for the text body .
17579 \begin_inset CommandInset ref
17581 reference "subsec:Font-description"
17588 \begin_layout Description
17589 \begin_inset Flex Code
17592 \begin_layout Plain Layout
17601 \begin_inset Flex Code
17604 \begin_layout Plain Layout
17614 The level of the style in the table of contents.
17615 This is used for automatic numbering of section headings.
17618 \begin_layout Description
17619 \begin_inset Flex Code
17622 \begin_layout Plain Layout
17631 \begin_inset Flex Code
17634 \begin_layout Plain Layout
17645 \begin_inset Flex Code
17648 \begin_layout Plain Layout
17655 \begin_inset Flex Code
17658 \begin_layout Plain Layout
17664 ] This tag determines whether the first line indentation of this paragraph
17665 can be toggled via the Paragraph settings dialog.
17669 \begin_inset Flex Code
17672 \begin_layout Plain Layout
17682 is set, indentation can be toggled if the document settings use
17683 \begin_inset Quotes eld
17687 \begin_inset Quotes erd
17690 paragraph style, with
17691 \begin_inset Flex Code
17694 \begin_layout Plain Layout
17700 , indentation can always be toggled, notwithstanding the document settings,
17702 \begin_inset Flex Code
17705 \begin_layout Plain Layout
17711 , indentation can never be toggled.
17714 \begin_layout Description
17715 \begin_inset Flex Code
17718 \begin_layout Plain Layout
17725 \begin_inset Flex Code
17728 \begin_layout Plain Layout
17734 ] The vertical space with which the very first of a chain of paragraphs
17735 with this style is separated from the previous paragraph.
17736 If the previous paragraph has another style, the separations are not simply
17737 added, but the maximum is taken.
17740 \begin_layout Subsection
17741 \begin_inset CommandInset label
17747 Internationalization of Paragraph Styles
17750 \begin_layout Standard
17752 has long supported internationalization of layout information, but, until
17753 version 2.0, this applied only to the user interface and not to, say, PDF
17755 Thus, French authors were forced to resort to ugly hacks if they wanted
17760 1' instead of `Theorem 1'.
17761 Thanks to Georg Baum, that is no longer the case.
17764 \begin_layout Standard
17766 \begin_inset Flex Code
17769 \begin_layout Plain Layout
17775 defines text that is to appear in the typeset document, it may use
17776 \begin_inset Flex Code
17779 \begin_layout Plain Layout
17786 \begin_inset Flex Code
17789 \begin_layout Plain Layout
17795 to support non-English and even multi-language documents correctly.
17796 The following excerpt (from the
17797 \begin_inset Flex Code
17800 \begin_layout Plain Layout
17806 file) shows how this works:
17809 \begin_layout LyX-Code
17814 \begin_layout LyX-Code
17817 theoremstyle{remark}
17820 \begin_layout LyX-Code
17823 newtheorem{claim}[thm]{
17830 \begin_layout LyX-Code
17834 \begin_layout LyX-Code
17838 \begin_layout LyX-Code
17843 claimname}{_(Claim)}
17846 \begin_layout LyX-Code
17850 \begin_layout LyX-Code
17854 \begin_layout LyX-Code
17863 claimname}{_(Claim)}}
17866 \begin_layout LyX-Code
17871 \begin_layout Standard
17872 In principle, any legal \SpecialChar LaTeX
17874 \begin_inset Flex Code
17877 \begin_layout Plain Layout
17884 \begin_inset Flex Code
17887 \begin_layout Plain Layout
17893 tags, but in practice they will typically look as they do here.
17894 The key to correct translation of the typeset text is the definition of
17895 the \SpecialChar LaTeX
17897 \begin_inset Flex Code
17900 \begin_layout Plain Layout
17909 \begin_inset Flex Code
17912 \begin_layout Plain Layout
17924 \begin_layout Standard
17926 \begin_inset Flex Code
17929 \begin_layout Plain Layout
17935 tag provides for internationalization based upon the overall language of
17937 The contents of the tag will be included in the preamble, just as with
17939 \begin_inset Flex Code
17942 \begin_layout Plain Layout
17949 What makes it special is the use of the
17950 \begin_inset Quotes eld
17954 \begin_inset Quotes erd
17958 \begin_inset Flex Code
17961 \begin_layout Plain Layout
17967 , which will be replaced, when \SpecialChar LyX
17968 produces \SpecialChar LaTeX
17969 output, with the translation of
17970 its argument into the document language.
17973 \begin_layout Standard
17975 \begin_inset Flex Code
17978 \begin_layout Plain Layout
17984 tag is more complex, since it is meant to provide support for multi-language
17985 documents and so offers an interface to the
17986 \begin_inset Flex Code
17989 \begin_layout Plain Layout
17996 Its contents will be added to the preamble once for each language that
17997 appears in the document.
17998 In this case, the argument to
17999 \begin_inset Flex Code
18002 \begin_layout Plain Layout
18008 will be replaced with its translation into the language in question; the
18010 \begin_inset Flex Code
18013 \begin_layout Plain Layout
18019 is replaced by the language name (as used by the babel package).
18022 \begin_layout Standard
18023 A German document that also included a French section would thus have the
18024 following in the preamble:
18027 \begin_layout LyX-Code
18036 claimname}{Affirmation}}
18037 \begin_inset Newline newline
18048 claimname}{Behauptung}}
18049 \begin_inset Newline newline
18056 claimname}{Behauptung}
18059 \begin_layout Standard
18062 \begin_inset Flex Code
18065 \begin_layout Plain Layout
18071 will then conspire to produce the correct text in the output.
18074 \begin_layout Standard
18075 One important point to note here is that the translations are provided by
18077 itself, through the file
18078 \begin_inset Flex Code
18081 \begin_layout Plain Layout
18088 This means, in effect, that
18089 \begin_inset Flex Code
18092 \begin_layout Plain Layout
18099 \begin_inset Flex Code
18102 \begin_layout Plain Layout
18108 are really only of use in layout files that are provided with \SpecialChar LyX
18110 entered in user-created layout files will not be seen by \SpecialChar LyX
18111 's internationalizatio
18112 n routines unless the
18113 \begin_inset Flex Code
18116 \begin_layout Plain Layout
18122 file is modified accordingly.
18123 That said, however, any layout created with the intention that it will
18124 be included with \SpecialChar LyX
18125 should use these tags where appropriate.
18126 Please note that the paragraph style translations provided by \SpecialChar LyX
18128 change with a minor update (e.
18129 \begin_inset space \thinspace{}
18133 \begin_inset space \space{}
18136 from version 2.1.x to 2.1.y).
18137 It is however quite likely that a major update (e.
18138 \begin_inset space \thinspace{}
18142 \begin_inset space \space{}
18145 from 2.0.x to 2.1.0) will introduce new translations or corrections.
18148 \begin_layout Subsection
18150 \begin_inset CommandInset label
18152 name "subsec:Floats"
18159 \begin_layout Standard
18160 It is necessary to define the floats (
18161 \begin_inset Flex Noun
18164 \begin_layout Plain Layout
18171 \begin_inset Flex Noun
18174 \begin_layout Plain Layout
18180 , \SpecialChar ldots
18181 ) in the text class itself.
18182 Standard floats are included in the file
18183 \begin_inset Flex Code
18186 \begin_layout Plain Layout
18192 , so you may have to do no more than add
18195 \begin_layout LyX-Code
18196 Input stdfloats.inc
18199 \begin_layout Standard
18200 to your layout file.
18201 If you want to implement a text class that proposes some other float types
18202 (like the AGU class bundled with \SpecialChar LyX
18203 ), the information below will hopefully
18207 \begin_layout Description
18208 \begin_inset Flex Code
18211 \begin_layout Plain Layout
18218 \begin_inset Flex Code
18221 \begin_layout Plain Layout
18227 =!htbpH] Allowed placement options for this float type.
18228 The value is a string of placement characters.
18229 Possible characters include:
18234 \begin_inset Quotes eld
18238 \begin_inset Quotes erd
18246 \begin_inset Quotes eld
18250 \begin_inset Quotes erd
18258 \begin_inset Quotes eld
18262 \begin_inset Quotes erd
18270 \begin_inset Quotes eld
18274 \begin_inset Quotes erd
18282 \begin_inset Quotes eld
18286 \begin_inset Quotes erd
18294 \begin_inset Quotes eld
18298 \begin_inset Quotes erd
18302 The order of the characters in the string does not matter.
18303 If no placement options are allowed, use the string
18310 \begin_layout Description
18311 \begin_inset Flex Code
18314 \begin_layout Plain Layout
18321 \begin_inset Flex Code
18324 \begin_layout Plain Layout
18333 \begin_inset space \thinspace{}
18339 \begin_inset Flex Code
18342 \begin_layout Plain Layout
18352 ] Defines whether the float allows to be rotated via the \SpecialChar LaTeX
18359 \begin_inset Flex Code
18362 \begin_layout Plain Layout
18368 if the float does not support this feature.
18371 \begin_layout Description
18372 \begin_inset Flex Code
18375 \begin_layout Plain Layout
18382 \begin_inset Flex Code
18385 \begin_layout Plain Layout
18394 \begin_inset space \thinspace{}
18400 \begin_inset Flex Code
18403 \begin_layout Plain Layout
18413 ] Defines whether the float has a starred variant that spans columns in
18414 a two column paragraph.
18416 \begin_inset Flex Code
18419 \begin_layout Plain Layout
18425 if the float does not support this feature.
18428 \begin_layout Description
18429 \begin_inset Flex Code
18432 \begin_layout Plain Layout
18439 \begin_inset Flex Code
18442 \begin_layout Plain Layout
18449 \begin_inset Quotes erd
18453 \begin_inset Quotes erd
18456 ] The file name extension of an auxiliary file for the list of figures (or
18459 writes the captions to this file.
18462 \begin_layout Description
18463 \begin_inset Flex Code
18466 \begin_layout Plain Layout
18473 \begin_inset Flex Code
18476 \begin_layout Plain Layout
18483 \begin_inset Quotes erd
18487 \begin_inset Quotes erd
18490 ] The string that will be used in the menus and also for the caption.
18491 This is translated to the current language if babel is used.
18494 \begin_layout Description
18495 \begin_inset Flex Code
18498 \begin_layout Plain Layout
18504 These tags control the XHTML output.
18506 \begin_inset CommandInset ref
18508 reference "sec:Tags-for-XHTML"
18515 \begin_layout Description
18516 \begin_inset Flex Code
18519 \begin_layout Plain Layout
18528 \begin_inset Flex Code
18531 \begin_layout Plain Layout
18540 \begin_inset space \thinspace{}
18544 \begin_inset Flex Code
18547 \begin_layout Plain Layout
18553 ] Indicates whether the float is already defined in the document class or
18554 if instead the \SpecialChar LaTeX
18556 \begin_inset Flex Code
18559 \begin_layout Plain Layout
18565 needs to be loaded to define it on-the-fly.
18567 \begin_inset Flex Code
18570 \begin_layout Plain Layout
18577 \begin_inset Flex Code
18580 \begin_layout Plain Layout
18587 It should be set to
18588 \begin_inset Flex Code
18591 \begin_layout Plain Layout
18597 if the float is already defined by the \SpecialChar LaTeX
18601 \begin_layout Description
18602 \begin_inset Flex Code
18605 \begin_layout Plain Layout
18612 \begin_inset Flex Code
18615 \begin_layout Plain Layout
18622 \begin_inset Quotes erd
18626 \begin_inset Quotes erd
18629 ] The command used to generate a list of floats of this type; the leading
18638 \begin_inset Flex Code
18641 \begin_layout Plain Layout
18647 is false, since there is no standard way to generate this command.
18649 \begin_inset Flex Code
18652 \begin_layout Plain Layout
18658 is true, since in that case there is a standard way to define the command.
18661 \begin_layout Description
18662 \begin_inset Flex Code
18665 \begin_layout Plain Layout
18672 \begin_inset Flex Code
18675 \begin_layout Plain Layout
18682 \begin_inset Quotes erd
18686 \begin_inset Quotes erd
18689 ] A title for a list of floats of this kind (list of figures, tables, or
18691 It is used for the screen label within \SpecialChar LyX
18692 , it is used by \SpecialChar LaTeX
18694 it is used as the title in the XHTML output.
18695 It will be translated to the document language.
18698 \begin_layout Description
18699 \begin_inset Flex Code
18702 \begin_layout Plain Layout
18709 \begin_inset Flex Code
18712 \begin_layout Plain Layout
18719 \begin_inset Quotes erd
18723 \begin_inset Quotes erd
18726 ] This (optional) argument determines whether floats of this class will
18727 be numbered within some sectional unit of the document.
18729 \begin_inset Flex Code
18732 \begin_layout Plain Layout
18739 \begin_inset Quotes eld
18743 \begin_inset Flex Code
18746 \begin_layout Plain Layout
18753 \begin_inset Quotes erd
18756 , the floats will be numbered within chapters.
18760 \begin_layout Description
18761 \begin_inset Flex Code
18764 \begin_layout Plain Layout
18771 \begin_inset Flex Code
18774 \begin_layout Plain Layout
18781 \begin_inset Quotes erd
18785 \begin_inset Quotes erd
18788 ] The default placement for the given class of floats.
18789 The string should be as in standard \SpecialChar LaTeX
18791 \begin_inset Flex Code
18794 \begin_layout Plain Layout
18801 \begin_inset Flex Code
18804 \begin_layout Plain Layout
18811 \begin_inset Flex Code
18814 \begin_layout Plain Layout
18821 \begin_inset Flex Code
18824 \begin_layout Plain Layout
18830 for top, bottom, page, and here, respectively.
18834 \begin_layout Plain Layout
18835 Note that the order of these letters in the string is irrelevant, like in
18842 On top of that there is a new type,
18843 \begin_inset Flex Code
18846 \begin_layout Plain Layout
18852 , which does not really correspond to a float, since it means: put it
18853 \begin_inset Quotes eld
18857 \begin_inset Quotes erd
18861 Note however that the
18862 \begin_inset Flex Code
18865 \begin_layout Plain Layout
18871 specifier is special and, because of implementation details, cannot be
18872 used in non-built in float types.
18873 If you do not understand what this means, just use
18874 \begin_inset Quotes eld
18878 \begin_inset Flex Code
18881 \begin_layout Plain Layout
18888 \begin_inset Quotes erd
18894 \begin_layout Description
18895 \begin_inset Flex Code
18898 \begin_layout Plain Layout
18905 \begin_inset Flex Code
18908 \begin_layout Plain Layout
18914 ] The prefix to use when creating labels referring to floats of this type.
18915 This allows the use of formatted references.
18916 Note that you can remove any
18917 \begin_inset Flex Code
18920 \begin_layout Plain Layout
18926 set by a copied style by using the special value
18927 \begin_inset Quotes eld
18931 \begin_inset Quotes erd
18934 , which must be all caps.
18935 \change_inserted -712698321 1565605014
18939 \begin_layout Description
18941 \change_inserted -712698321 1565605014
18942 \begin_inset Flex Code
18945 \begin_layout Plain Layout
18947 \change_inserted -712698321 1565605014
18956 \begin_inset Flex Code
18959 \begin_layout Plain Layout
18961 \change_inserted -712698321 1565605014
18969 ] As with paragraph styles, see
18970 \begin_inset CommandInset ref
18972 reference "subsec:Paragraph-Styles"
18981 \begin_layout Description
18982 \begin_inset Flex Code
18985 \begin_layout Plain Layout
18992 \begin_inset Flex Code
18995 \begin_layout Plain Layout
19002 \begin_inset Quotes erd
19006 \begin_inset Quotes erd
19009 ] The style used when defining the float using
19010 \begin_inset Flex Code
19013 \begin_layout Plain Layout
19024 \begin_layout Description
19025 \begin_inset Flex Code
19028 \begin_layout Plain Layout
19035 \begin_inset Flex Code
19038 \begin_layout Plain Layout
19045 \begin_inset Quotes erd
19049 \begin_inset Quotes erd
19053 \begin_inset Quotes eld
19057 \begin_inset Quotes erd
19060 of the new class of floats, like program or algorithm.
19061 After the appropriate
19062 \begin_inset Flex Code
19065 \begin_layout Plain Layout
19074 \begin_inset Flex Code
19077 \begin_layout Plain Layout
19086 \begin_inset Flex Code
19089 \begin_layout Plain Layout
19100 \begin_layout Description
19101 \begin_inset Flex Code
19104 \begin_layout Plain Layout
19111 \begin_inset Flex Code
19114 \begin_layout Plain Layout
19121 \begin_inset space \thinspace{}
19125 \begin_inset Flex Code
19128 \begin_layout Plain Layout
19136 ] Specifies whether this float is defined using the \SpecialChar LaTeX
19138 \begin_inset Flex Code
19141 \begin_layout Plain Layout
19147 , either by the class file, another package or on-the-fly by \SpecialChar LyX
19151 \begin_layout Standard
19152 Note that defining a float with type
19153 \begin_inset Flex Code
19156 \begin_layout Plain Layout
19164 automatically defines the corresponding counter with name
19165 \begin_inset Flex Code
19168 \begin_layout Plain Layout
19179 \begin_layout Subsection
19180 Flex insets and InsetLayout
19181 \begin_inset CommandInset label
19183 name "subsec:Flex-insets-and"
19190 \begin_layout Standard
19191 Flex insets come in
19192 \change_deleted 5863208 1594239511
19194 \change_inserted 5863208 1594239512
19200 \begin_layout Itemize
19202 \begin_inset Flex Code
19205 \begin_layout Plain Layout
19211 ): These define semantic markup corresponding to such \SpecialChar LaTeX
19213 \begin_inset Flex Code
19216 \begin_layout Plain Layout
19225 \begin_inset Flex Code
19228 \begin_layout Plain Layout
19239 \begin_layout Itemize
19241 \begin_inset Flex Code
19244 \begin_layout Plain Layout
19250 ): These can be used to define custom collapsible insets, similar to \SpecialChar TeX
19252 footnote, and the like.
19253 An obvious example is an endnote inset, which is defined in the
19254 \begin_inset Flex Code
19257 \begin_layout Plain Layout
19266 \begin_layout Itemize
19268 \change_deleted 5863208 1594239528
19270 \begin_inset Flex Code
19273 \begin_layout Plain Layout
19279 ): For use with DocBook classes.
19284 \begin_layout Standard
19285 Flex insets are defined using the
19286 \begin_inset Flex Code
19289 \begin_layout Plain Layout
19295 tag, which shall be explained in a moment.
19298 \begin_layout Standard
19300 \begin_inset Flex Code
19303 \begin_layout Plain Layout
19309 tag also serves another function: It can be used to customize the general
19310 layout of many different types of insets.
19312 \begin_inset Flex Code
19315 \begin_layout Plain Layout
19321 can be used to customize the layout parameters for footnotes, marginal
19322 notes, note insets, \SpecialChar TeX
19323 code (ERT) insets, branches, listings, indexes, boxes,
19324 tables, algorithms, URLs, and captions, as well as to define Flex insets.
19327 \begin_layout Standard
19329 \begin_inset Flex Code
19332 \begin_layout Plain Layout
19338 definition must begin with a line of the form:
19341 \begin_layout LyX-Code
19345 \begin_layout Standard
19347 \begin_inset Flex Code
19350 \begin_layout Plain Layout
19356 indicates the inset whose layout is being defined, and here there are four
19360 \begin_layout Enumerate
19361 The layout for a pre-existing inset is being modified.
19362 In this case, can be
19363 \begin_inset Flex Code
19366 \begin_layout Plain Layout
19372 any one of the following:
19373 \begin_inset Flex Code
19376 \begin_layout Plain Layout
19383 \begin_inset Flex Code
19386 \begin_layout Plain Layout
19393 \begin_inset Flex Code
19396 \begin_layout Plain Layout
19403 \begin_inset Flex Code
19406 \begin_layout Plain Layout
19413 \begin_inset Flex Code
19416 \begin_layout Plain Layout
19423 \begin_inset Flex Code
19426 \begin_layout Plain Layout
19433 \begin_inset Flex Code
19436 \begin_layout Plain Layout
19443 \begin_inset Flex Code
19446 \begin_layout Plain Layout
19453 \begin_inset Flex Code
19456 \begin_layout Plain Layout
19463 \begin_inset Flex Code
19466 \begin_layout Plain Layout
19473 \begin_inset Flex Code
19476 \begin_layout Plain Layout
19483 \begin_inset Flex Code
19486 \begin_layout Plain Layout
19493 \begin_inset Flex Code
19496 \begin_layout Plain Layout
19503 \begin_inset Flex Code
19506 \begin_layout Plain Layout
19513 \begin_inset Flex Code
19516 \begin_layout Plain Layout
19523 \begin_inset Flex Code
19526 \begin_layout Plain Layout
19533 \begin_inset Flex Code
19536 \begin_layout Plain Layout
19543 \begin_inset Flex Code
19546 \begin_layout Plain Layout
19553 \begin_inset Flex Code
19556 \begin_layout Plain Layout
19563 \begin_inset Flex Code
19566 \begin_layout Plain Layout
19575 \begin_layout Enumerate
19576 The layout for a Flex inset is being defined.
19578 \begin_inset Flex Code
19581 \begin_layout Plain Layout
19587 must be of the form
19588 \begin_inset Quotes eld
19592 \begin_inset Flex Code
19595 \begin_layout Plain Layout
19602 \begin_inset Quotes erd
19606 \begin_inset Flex Code
19609 \begin_layout Plain Layout
19615 may be any valid identifier not used by a pre-existing Flex inset.
19616 The identifier may include spaces, but in that case the whole thing must
19617 be wrapped in quotes.
19618 Note that the definition of a flex inset
19623 \begin_inset Flex Code
19626 \begin_layout Plain Layout
19632 entry, declaring which type of inset it defines.
19635 \begin_layout Enumerate
19636 The layout for user specific branch is being defined.
19638 \begin_inset Flex Code
19641 \begin_layout Plain Layout
19647 must be of the form
19648 \begin_inset Quotes eld
19652 \begin_inset Flex Code
19655 \begin_layout Plain Layout
19662 \begin_inset Quotes erd
19666 \begin_inset Flex Code
19669 \begin_layout Plain Layout
19675 may be any valid identifier of branch defined in user's document.
19676 The identifier may include spaces, but in that case the whole thing must
19677 be wrapped in quotes.
19678 The main purpose of this feature is to allow \SpecialChar LaTeX
19679 wrapping around specific
19680 branches as user needs.
19683 \begin_layout Enumerate
19684 The layout of a user (or class) specific caption is being defined.
19686 \begin_inset Flex Code
19689 \begin_layout Plain Layout
19695 must be of the form
19696 \begin_inset Quotes eld
19700 \begin_inset Flex Code
19703 \begin_layout Plain Layout
19710 \begin_inset Quotes erd
19714 \begin_inset Flex Code
19717 \begin_layout Plain Layout
19723 specifies the name of the caption as it appears in the menu.
19724 Have a look at the standard caption (
19725 \begin_inset Flex Code
19728 \begin_layout Plain Layout
19734 ), the specific captions of the KOMA-Script classes (
19735 \begin_inset Flex Code
19738 \begin_layout Plain Layout
19745 \begin_inset Flex Code
19748 \begin_layout Plain Layout
19757 \begin_inset space ~
19761 \begin_inset Newline linebreak
19767 \begin_inset Flex Code
19770 \begin_layout Plain Layout
19776 ) for applications.
19779 \begin_layout Standard
19781 \begin_inset Flex Code
19784 \begin_layout Plain Layout
19790 definition can contain the following entries:
19793 \begin_layout Description
19794 \begin_inset Flex Code
19797 \begin_layout Plain Layout
19804 \begin_inset Flex Code
19807 \begin_layout Plain Layout
19813 =""] This inset will appear in the table of contents of the given type.
19814 An empty string disables.
19815 See also the OutlinerName and the IsTocCaption commands.
19816 This is only implemented for Flex insets.
19820 \begin_layout Description
19821 \begin_inset Flex Code
19824 \begin_layout Plain Layout
19831 \begin_inset Flex Code
19834 \begin_layout Plain Layout
19840 ] Defines argument number of a command\SpecialChar breakableslash
19841 environment associated with the current
19843 The definition must end with
19844 \begin_inset Flex Code
19847 \begin_layout Plain Layout
19855 \begin_inset CommandInset ref
19857 reference "subsec:Paragraph-Styles"
19864 \begin_layout Description
19865 \begin_inset Flex Code
19868 \begin_layout Plain Layout
19874 Preamble for changing language commands; see
19875 \begin_inset CommandInset ref
19877 reference "subsec:I18n"
19884 \begin_layout Description
19885 \begin_inset Flex Code
19888 \begin_layout Plain Layout
19895 \begin_inset Flex Code
19898 \begin_layout Plain Layout
19904 ] The color for the inset's background.
19906 \begin_inset CommandInset ref
19908 reference "chap:Names-of-colors"
19912 for a list of the available color names.
19915 \begin_layout Description
19916 \begin_inset Flex Code
19919 \begin_layout Plain Layout
19926 \begin_inset Flex Code
19929 \begin_layout Plain Layout
19938 \begin_inset space \thinspace{}
19942 \begin_inset Flex Code
19945 \begin_layout Plain Layout
19951 ] Whether to use the content of the inset as the label, when the inset is
19956 \begin_layout Description
19957 \begin_inset Flex Code
19960 \begin_layout Plain Layout
19967 \begin_inset Flex Code
19970 \begin_layout Plain Layout
19976 ] As with paragraph styles, see
19977 \begin_inset CommandInset ref
19979 reference "subsec:Paragraph-Styles"
19984 Note that you need to specify the complete type, e.
19985 \begin_inset space \thinspace{}
19989 \begin_inset space ~
19993 \begin_inset Flex Code
19996 \begin_layout Plain Layout
19997 CopyStyle Flex:<name>
20005 \begin_layout Description
20006 \begin_inset Flex Code
20009 \begin_layout Plain Layout
20016 \begin_inset Flex Code
20019 \begin_layout Plain Layout
20028 \begin_inset space \thinspace{}
20032 \begin_inset Flex Code
20035 \begin_layout Plain Layout
20041 ] Indicates whether the user may employ the Paragraph Settings dialog to
20042 customize the paragraph.
20045 \begin_layout Description
20046 \begin_inset Flex Code
20049 \begin_layout Plain Layout
20056 \begin_inset Flex Code
20059 \begin_layout Plain Layout
20066 \begin_inset Flex Code
20069 \begin_layout Plain Layout
20076 \begin_inset Flex Code
20079 \begin_layout Plain Layout
20085 , describing the rendering style used for the inset's frame and buttons.
20086 Footnotes generally use
20087 \begin_inset Flex Code
20090 \begin_layout Plain Layout
20096 , ERT insets generally
20097 \begin_inset Flex Code
20100 \begin_layout Plain Layout
20106 , and character styles
20107 \begin_inset Flex Code
20110 \begin_layout Plain Layout
20119 \begin_layout Description
20120 \begin_inset Flex Code
20123 \begin_layout Plain Layout
20130 \begin_inset Flex Code
20133 \begin_layout Plain Layout
20142 \begin_inset space \thinspace{}
20148 \begin_inset Flex Code
20151 \begin_layout Plain Layout
20160 \begin_inset Flex Code
20163 \begin_layout Plain Layout
20170 \begin_inset Flex Code
20173 \begin_layout Plain Layout
20180 Indicates whether the environment will stand on its own in the output or
20181 will appear inline with the surrounding text.
20182 If set to false, it is supposed that the \SpecialChar LaTeX
20183 environment ignores white space
20184 (including one newline character) after the
20185 \begin_inset Flex Code
20188 \begin_layout Plain Layout
20201 \begin_inset Flex Code
20204 \begin_layout Plain Layout
20218 \change_inserted 731793113 1538674858
20222 \begin_layout Description
20224 \change_inserted 731793113 1538674891
20225 \begin_inset Flex Code
20228 \begin_layout Plain Layout
20230 \change_inserted 731793113 1538674863
20242 ,1] Allow the contents of the inset to be edited externally (using whatever
20243 editor is defined for the document's output format).
20248 \begin_layout Description
20249 \begin_inset Flex Code
20252 \begin_layout Plain Layout
20258 Required at the end of the
20259 \begin_inset Flex Code
20262 \begin_layout Plain Layout
20271 \begin_layout Description
20272 \begin_inset Flex Code
20275 \begin_layout Plain Layout
20281 The font used for both the text body
20287 \begin_inset CommandInset ref
20289 reference "subsec:Font-description"
20294 Note that defining this font automatically defines the
20295 \begin_inset Flex Code
20298 \begin_layout Plain Layout
20304 to the same value, so define this first and define
20305 \begin_inset Flex Code
20308 \begin_layout Plain Layout
20314 later if you want them to be different.
20317 \begin_layout Description
20318 \begin_inset Flex Code
20321 \begin_layout Plain Layout
20322 FixedWidthPreambleEncoding
20328 \begin_inset Flex Code
20331 \begin_layout Plain Layout
20340 \begin_inset space \thinspace{}
20344 \begin_inset Flex Code
20347 \begin_layout Plain Layout
20353 ] Force a fixed width encoding for the translated contents of
20354 \begin_inset Flex Code
20357 \begin_layout Plain Layout
20364 \begin_inset Flex Code
20367 \begin_layout Plain Layout
20373 code generated by this layout.
20374 This is needed for special \SpecialChar LaTeX
20379 that do not work with variable width encodings such as
20384 This setting is ignored if fully Unicode aware \SpecialChar LaTeX
20385 backends such as Xe\SpecialChar TeX
20387 Lua\SpecialChar TeX
20391 \begin_layout Description
20392 \begin_inset Flex Code
20395 \begin_layout Plain Layout
20396 ForceLocalFontSwitch
20402 \begin_inset Flex Code
20405 \begin_layout Plain Layout
20414 \begin_inset space \thinspace{}
20418 \begin_inset Flex Code
20421 \begin_layout Plain Layout
20427 ] When using babel, always use a local font switch (
20428 \begin_inset Flex Code
20431 \begin_layout Plain Layout
20439 ), never a global one (such as
20440 \begin_inset Flex Code
20443 \begin_layout Plain Layout
20454 \begin_layout Description
20455 \begin_inset Flex Code
20458 \begin_layout Plain Layout
20465 \begin_inset Flex Code
20468 \begin_layout Plain Layout
20477 \begin_inset space \thinspace{}
20481 \begin_inset Flex Code
20484 \begin_layout Plain Layout
20491 \begin_inset Quotes eld
20495 \begin_inset Quotes erd
20498 language, leading to Left-to-Right (Latin) output, e.
20499 \begin_inset space \thinspace{}
20503 \begin_inset space \space{}
20506 in \SpecialChar TeX
20511 \begin_layout Description
20512 \begin_inset Flex Code
20515 \begin_layout Plain Layout
20522 \begin_inset Flex Code
20525 \begin_layout Plain Layout
20534 \begin_inset space \thinspace{}
20538 \begin_inset Flex Code
20541 \begin_layout Plain Layout
20547 ] Force a line break in the \SpecialChar LaTeX
20548 output before the inset starts and after the
20550 This assures the inset itself is output on its own lines, for parsing purposes.
20553 \begin_layout Description
20554 \begin_inset Flex Code
20557 \begin_layout Plain Layout
20564 \begin_inset Flex Code
20567 \begin_layout Plain Layout
20576 \begin_inset space \thinspace{}
20580 \begin_inset Flex Code
20583 \begin_layout Plain Layout
20589 ] Indicates whether the
20590 \begin_inset Flex Code
20593 \begin_layout Plain Layout
20599 should be used or, instead, the user can change the paragraph style used
20604 \begin_layout Description
20605 \begin_inset Flex Code
20608 \begin_layout Plain Layout
20615 \begin_inset Flex Code
20618 \begin_layout Plain Layout
20627 \begin_inset space \thinspace{}
20631 \begin_inset Flex Code
20634 \begin_layout Plain Layout
20640 ] As with paragraph styles, see
20641 \begin_inset CommandInset ref
20643 reference "subsec:Paragraph-Styles"
20650 \begin_layout Description
20651 \begin_inset Flex Code
20654 \begin_layout Plain Layout
20660 These tags control the XHTML output.
20662 \begin_inset CommandInset ref
20664 reference "sec:Tags-for-XHTML"
20671 \begin_layout Description
20672 \begin_inset Flex Code
20675 \begin_layout Plain Layout
20682 \begin_inset Flex Code
20685 \begin_layout Plain Layout
20694 \begin_inset space \thinspace{}
20698 \begin_inset Flex Code
20701 \begin_layout Plain Layout
20707 ] Whether to include the contents of this inset in the strings generated
20708 for the `Outline' pane for all table of contents, regardless of the AddToToc
20710 One would not, for example, want the content of a footnote in a section
20711 header to be included in the TOC displayed in the outline, but one would
20712 normally want the content of a character style displayed.
20713 Default is false: not to include.
20716 \begin_layout Description
20717 \begin_inset Flex Code
20720 \begin_layout Plain Layout
20727 \begin_inset Flex Code
20730 \begin_layout Plain Layout
20739 \begin_inset space \thinspace{}
20743 \begin_inset Flex Code
20746 \begin_layout Plain Layout
20752 ] If this is set to 1 and AddToToc is enabled, the inset adds a summary
20753 of its contents in its item in the table of contents.
20754 Otherwise, only the label appears.
20757 \begin_layout Description
20758 \begin_inset Flex Code
20761 \begin_layout Plain Layout
20770 \begin_inset Flex Code
20773 \begin_layout Plain Layout
20782 \begin_inset space \thinspace{}
20786 \begin_inset Flex Code
20789 \begin_layout Plain Layout
20795 ] As with paragraph styles, see
20796 \begin_inset CommandInset ref
20798 reference "subsec:Paragraph-Styles"
20805 \begin_layout Description
20806 \begin_inset Flex Code
20809 \begin_layout Plain Layout
20815 The font used for the label.
20817 \begin_inset CommandInset ref
20819 reference "subsec:Font-description"
20824 Note that this definition can never appear before
20825 \begin_inset Flex Code
20828 \begin_layout Plain Layout
20834 , lest it be ineffective.
20837 \begin_layout Description
20838 \begin_inset Flex Code
20841 \begin_layout Plain Layout
20848 \begin_inset Flex Code
20851 \begin_layout Plain Layout
20858 \begin_inset Quotes erd
20862 \begin_inset Quotes erd
20865 ] What will be displayed on the button or elsewhere as the inset label.
20867 \begin_inset Flex Code
20870 \begin_layout Plain Layout
20878 \begin_inset Flex Code
20881 \begin_layout Plain Layout
20887 ) modify this label on the fly.
20890 \begin_layout Description
20891 \begin_inset Flex Code
20894 \begin_layout Plain Layout
20900 Language dependent preamble; see
20901 \begin_inset CommandInset ref
20903 reference "subsec:I18n"
20910 \begin_layout Description
20911 \begin_inset Flex Code
20914 \begin_layout Plain Layout
20921 \begin_inset Flex Code
20924 \begin_layout Plain Layout
20930 ] The name of the corresponding \SpecialChar LaTeX
20932 Either the environment or command name.
20935 \begin_layout Description
20936 \begin_inset Flex Code
20939 \begin_layout Plain Layout
20946 \begin_inset Flex Code
20949 \begin_layout Plain Layout
20955 ] The optional parameter for the corresponding
20956 \begin_inset Flex Code
20959 \begin_layout Plain Layout
20965 stuff, including possible bracket pairs like
20966 \begin_inset Flex Code
20969 \begin_layout Plain Layout
20976 This parameter cannot be changed from within \SpecialChar LyX
20978 \begin_inset Flex Code
20981 \begin_layout Plain Layout
20987 for customizable parameters).
20988 It will be output as is after all \SpecialChar LaTeX
20990 \begin_inset Flex Code
20993 \begin_layout Plain Layout
21002 \begin_layout Description
21003 \begin_inset Flex Code
21006 \begin_layout Plain Layout
21013 \begin_inset Flex Code
21016 \begin_layout Plain Layout
21017 Command, Environment, None
21022 ] How the style should be translated into \SpecialChar LaTeX
21027 \begin_layout Plain Layout
21028 \begin_inset Flex Code
21031 \begin_layout Plain Layout
21037 is perhaps a bit misleading, since these rules apply to SGML classes too.
21038 Visit the SGML class files for specific examples.
21047 \begin_layout Description
21048 \begin_inset Flex Code
21051 \begin_layout Plain Layout
21057 means nothing special
21060 \begin_layout Description
21061 \begin_inset Flex Code
21064 \begin_layout Plain Layout
21071 \begin_inset Flex Code
21074 \begin_layout Plain Layout
21081 {\SpecialChar ldots
21090 \begin_layout Description
21091 \begin_inset Flex Code
21094 \begin_layout Plain Layout
21101 \begin_inset Flex Code
21104 \begin_layout Plain Layout
21111 }\SpecialChar ldots
21126 \begin_layout Standard
21127 Putting the last few things together, the \SpecialChar LaTeX
21128 output will be either:
21131 \begin_layout LyX-Code
21134 LatexName[LatexParam]{\SpecialChar ldots
21138 \begin_layout Standard
21142 \begin_layout LyX-Code
21145 begin{LatexName}[LatexParam] \SpecialChar ldots
21151 \begin_layout Standard
21152 depending upon the \SpecialChar LaTeX
21157 \begin_layout Description
21158 \begin_inset Flex Code
21161 \begin_layout Plain Layout
21168 \begin_inset Flex Code
21171 \begin_layout Plain Layout
21177 ] A string that is put at the beginning of the layout content.
21178 A line break in the output can be indicated by
21179 \begin_inset Flex Code
21182 \begin_layout Plain Layout
21191 \begin_layout Description
21192 \begin_inset Flex Code
21195 \begin_layout Plain Layout
21202 \begin_inset Flex Code
21205 \begin_layout Plain Layout
21212 \begin_inset Flex Code
21215 \begin_layout Plain Layout
21222 \begin_inset Flex Code
21225 \begin_layout Plain Layout
21232 \begin_inset Flex Code
21235 \begin_layout Plain Layout
21241 (indicating a dummy definition ending definitions of charstyles, etc).
21242 This entry is required in and is only meaningful for Flex insets.
21243 Among other things, it determines on which menu this inset will appear.
21245 \begin_inset Flex Code
21248 \begin_layout Plain Layout
21255 \begin_inset Flex Code
21258 \begin_layout Plain Layout
21264 will automatically set
21265 \begin_inset Flex Code
21268 \begin_layout Plain Layout
21275 \begin_inset Flex Code
21278 \begin_layout Plain Layout
21286 \begin_inset Flex Code
21289 \begin_layout Plain Layout
21295 can be set to true, or
21296 \begin_inset Flex Code
21299 \begin_layout Plain Layout
21306 \begin_inset Flex Code
21309 \begin_layout Plain Layout
21315 insets by setting it
21320 \begin_inset Flex Code
21323 \begin_layout Plain Layout
21330 \change_inserted -712698321 1555575738
21334 \begin_layout Description
21336 \change_inserted -712698321 1555575844
21337 \begin_inset Flex Code
21340 \begin_layout Plain Layout
21342 \change_inserted -712698321 1555575740
21351 \begin_inset Flex Code
21354 \begin_layout Plain Layout
21356 \change_inserted -712698321 1555575740
21364 A dedicated string for the menu.
21365 You can define an accelerator by appending the respective character to
21366 the string, divided by
21367 \begin_inset Quotes eld
21371 \begin_inset Quotes erd
21375 \begin_inset space \thinspace{}
21379 \begin_inset space \space{}
21383 \begin_inset Quotes eld
21387 \begin_inset Flex Code
21390 \begin_layout Plain Layout
21392 \change_inserted -712698321 1555575781
21401 \begin_inset Quotes erd
21405 This specification is optional.
21406 If it is not given the inset name as specified in the type declaration
21407 will be used instead for the menu.
21412 \begin_layout Description
21413 \begin_inset Flex Code
21416 \begin_layout Plain Layout
21423 \begin_inset Flex Code
21426 \begin_layout Plain Layout
21435 \begin_inset space \thinspace{}
21439 \begin_inset Flex Code
21442 \begin_layout Plain Layout
21448 ] Whether multiple paragraphs are permitted in this inset.
21450 \begin_inset Flex Code
21453 \begin_layout Plain Layout
21459 to the same value and
21460 \begin_inset Flex Code
21463 \begin_layout Plain Layout
21469 to the opposite value.
21470 These can be reset to other values, if they are used
21475 \begin_inset Flex Code
21478 \begin_layout Plain Layout
21488 \begin_layout Description
21489 \begin_inset Flex Code
21492 \begin_layout Plain Layout
21499 \begin_inset Flex Code
21502 \begin_layout Plain Layout
21511 \begin_inset space \thinspace{}
21515 \begin_inset Flex Code
21518 \begin_layout Plain Layout
21524 ] Whether fragile commands in this inset should be
21525 \begin_inset Flex Code
21528 \begin_layout Plain Layout
21541 whether the command should itself be protected.) Default is false.
21542 \change_inserted -712698321 1523633958
21546 \begin_layout Description
21548 \change_inserted -712698321 1552395786
21549 \begin_inset Flex Code
21552 \begin_layout Plain Layout
21554 \change_inserted -712698321 1523633961
21563 \begin_inset Flex Code
21566 \begin_layout Plain Layout
21568 \change_inserted -712698321 1523633958
21579 \begin_inset space \thinspace{}
21583 \begin_inset Flex Code
21586 \begin_layout Plain Layout
21588 \change_inserted -712698321 1523633958
21596 ] This causes macros that contain this inset to be protected with
21597 \begin_inset Flex Code
21600 \begin_layout Plain Layout
21602 \change_inserted -712698321 1523634038
21617 ) if necessary and thus allows (some) verbatim stuff in macros.
21621 \begin_layout Description
21623 \change_inserted -712698321 1555579651
21624 \begin_inset Flex Code
21627 \begin_layout Plain Layout
21629 \change_inserted -712698321 1552395787
21638 \begin_inset Flex Code
21641 \begin_layout Plain Layout
21643 \change_inserted -712698321 1552395787
21654 \begin_inset space \thinspace{}
21658 \begin_inset Flex Code
21661 \begin_layout Plain Layout
21663 \change_inserted -712698321 1552395787
21671 ] Whether specific commands in this inset (such as
21672 \begin_inset Flex Code
21675 \begin_layout Plain Layout
21677 \change_inserted -712698321 1552395787
21688 \begin_inset Flex Code
21691 \begin_layout Plain Layout
21693 \change_inserted -712698321 1552395787
21703 ) should be protected in an
21704 \begin_inset Flex Code
21707 \begin_layout Plain Layout
21709 \change_inserted -712698321 1552395787
21720 This is particularly needed for insets that draw on
21728 commands which parse their content in complex ways.
21732 \begin_layout Description
21734 \change_inserted -712698321 1555579742
21735 \begin_inset Flex Code
21738 \begin_layout Plain Layout
21740 \change_inserted -712698321 1555579658
21749 \begin_inset Flex Code
21752 \begin_layout Plain Layout
21754 \change_inserted -712698321 1555579651
21762 Option to define a different command (from the default
21763 \begin_inset Flex Code
21766 \begin_layout Plain Layout
21768 \change_inserted -712698321 1555579742
21780 ) to be used for line breaks.
21781 The initial backslash must not be specified.
21786 \begin_layout Description
21787 \begin_inset Flex Code
21790 \begin_layout Plain Layout
21797 \begin_inset Flex Code
21800 \begin_layout Plain Layout
21806 ] Deletes an existing
21807 \begin_inset Flex Code
21810 \begin_layout Plain Layout
21819 \begin_layout Description
21820 \begin_inset Flex Code
21823 \begin_layout Plain Layout
21830 \begin_inset Flex Code
21833 \begin_layout Plain Layout
21840 \begin_inset Flex Code
21843 \begin_layout Plain Layout
21849 that has replaced this
21850 \begin_inset Flex Code
21853 \begin_layout Plain Layout
21860 This is used to rename an
21861 \begin_inset Flex Code
21864 \begin_layout Plain Layout
21870 , while keeping backward compatibility.
21871 \change_inserted -712698321 1559491850
21875 \begin_layout Description
21877 \change_inserted -712698321 1559492002
21878 \begin_inset Flex Code
21881 \begin_layout Plain Layout
21883 \change_inserted -712698321 1559491854
21892 \begin_inset Flex Code
21895 \begin_layout Plain Layout
21897 \change_inserted -712698321 1559491850
21908 \begin_inset space \thinspace{}
21912 \begin_inset Flex Code
21915 \begin_layout Plain Layout
21917 \change_inserted -712698321 1559491850
21925 ] If this is set to
21926 \begin_inset Flex Code
21929 \begin_layout Plain Layout
21931 \change_inserted -712698321 1559491881
21939 , paragraph breaks will be ignored in the output.
21940 This might be useful for insets where the content should be alignable on
21941 different lines only in the \SpecialChar LyX
21942 workarea, without any effect in the output.
21947 \begin_layout Description
21948 \begin_inset Flex Code
21951 \begin_layout Plain Layout
21958 \begin_inset Flex Code
21961 \begin_layout Plain Layout
21970 \begin_inset space \thinspace{}
21974 \begin_inset Flex Code
21977 \begin_layout Plain Layout
21983 ] As with paragraph styles, see
21984 \begin_inset CommandInset ref
21986 reference "subsec:Paragraph-Styles"
21994 \begin_layout Description
21995 \begin_inset Flex Code
21998 \begin_layout Plain Layout
22005 \begin_inset Flex Code
22008 \begin_layout Plain Layout
22017 \begin_inset space \thinspace{}
22021 \begin_inset Flex Code
22024 \begin_layout Plain Layout
22030 ] As with paragraph styles, see
22031 \begin_inset CommandInset ref
22033 reference "subsec:Paragraph-Styles"
22041 \begin_layout Description
22042 \begin_inset Flex Code
22045 \begin_layout Plain Layout
22051 As with paragraph styles, see
22052 \begin_inset CommandInset ref
22054 reference "subsec:Paragraph-Styles"
22061 \begin_layout Description
22062 \begin_inset Flex Code
22065 \begin_layout Plain Layout
22072 \begin_inset Flex Code
22075 \begin_layout Plain Layout
22081 ] The prefix to use when creating labels referring to insets of this type.
22082 This allows the use of formatted references.
22085 \begin_layout Description
22086 \begin_inset Flex Code
22089 \begin_layout Plain Layout
22096 \begin_inset Flex Code
22099 \begin_layout Plain Layout
22105 ] As with paragraph styles, see
22106 \begin_inset CommandInset ref
22108 reference "subsec:Paragraph-Styles"
22115 \begin_layout Description
22116 \begin_inset Flex Code
22119 \begin_layout Plain Layout
22126 \begin_inset Flex Code
22129 \begin_layout Plain Layout
22138 \begin_inset space \thinspace{}
22142 \begin_inset Flex Code
22145 \begin_layout Plain Layout
22151 ] Resets the \SpecialChar LaTeX
22152 arguments of this layout (as defined via the
22153 \begin_inset Flex Code
22156 \begin_layout Plain Layout
22163 This is useful if you have copied a style via
22164 \begin_inset Flex Code
22167 \begin_layout Plain Layout
22173 , but you do not want to inherit its (required and optional) arguments.
22176 \begin_layout Description
22177 \begin_inset Flex Code
22180 \begin_layout Plain Layout
22187 \begin_inset Flex Code
22190 \begin_layout Plain Layout
22199 \begin_inset space \thinspace{}
22203 \begin_inset Flex Code
22206 \begin_layout Plain Layout
22213 \change_inserted -712698321 1597733473
22215 \begin_inset Flex Code
22218 \begin_layout Plain Layout
22220 \change_inserted -712698321 1597732178
22228 , font changes are redone inside the respective inset (in the output) even
22229 if the inset itself is in the context of this font changes (e.
22230 \begin_inset space \thinspace{}
22234 \begin_inset Flex Code
22237 \begin_layout Plain Layout
22239 \change_inserted -712698321 1597733683
22242 textbf{Sourrounding text
22246 textbf{content}}\SpecialChar ldots
22255 \begin_inset Flex Code
22258 \begin_layout Plain Layout
22260 \change_inserted -712698321 1597733686
22263 textbf{Sourrounding text
22265 myinset{content}\SpecialChar ldots
22274 Setting this makes sense for commands that internally reset font settings
22276 \begin_inset space \thinspace{}
22280 Note that wrongly setting this might lead to unwanted result (e.
22281 \begin_inset space \thinspace{}
22285 \begin_inset Flex Code
22288 \begin_layout Plain Layout
22290 \change_inserted -712698321 1597733688
22293 emph{Sourrounding text
22297 emph{content}}\SpecialChar ldots
22305 , content is upright, as
22306 \begin_inset Flex Code
22309 \begin_layout Plain Layout
22311 \change_inserted -712698321 1597733278
22323 \change_deleted -712698321 1597733283
22324 Whether this inset should use the font of its surrounding environment or
22329 \change_deleted -712698321 1597733290
22331 \change_inserted -712698321 1597733290
22333 \begin_inset Flex Code
22336 \begin_layout Plain Layout
22338 \change_inserted -712698321 1597733292
22349 \change_deleted -712698321 1597733327
22350 use the font of the surrounding environment
22351 \change_inserted -712698321 1597733343
22352 font changes are not redone inside the inset
22357 \begin_layout Description
22358 \begin_inset Flex Code
22361 \begin_layout Plain Layout
22368 \begin_inset Flex Code
22371 \begin_layout Plain Layout
22377 ] A string that is put at the end of the layout content.
22378 A line break in the output can be indicated by
22379 \begin_inset Flex Code
22382 \begin_layout Plain Layout
22391 \begin_layout Description
22392 \begin_inset Flex Code
22395 \begin_layout Plain Layout
22402 \begin_inset Flex Code
22405 \begin_layout Plain Layout
22412 \begin_inset space \thinspace{}
22416 \begin_inset Flex Code
22419 \begin_layout Plain Layout
22427 ] Allow spell-checking the contents of this inset.
22431 \begin_layout Subsection
22433 \begin_inset CommandInset label
22435 name "subsec:Counters"
22442 \begin_layout Standard
22443 It is necessary to define the counters (
22444 \begin_inset Flex Noun
22447 \begin_layout Plain Layout
22454 \begin_inset Flex Noun
22457 \begin_layout Plain Layout
22463 , \SpecialChar ldots
22464 ) in the text class itself.
22465 The standard counters are defined in the file
22466 \begin_inset Flex Code
22469 \begin_layout Plain Layout
22475 , so you may have to do no more than add
22478 \begin_layout LyX-Code
22479 Input stdcounters.inc
22482 \begin_layout Standard
22483 to your layout file to get them to work.
22484 But if you want to define custom counters, then you can do so.
22485 The counter declaration must begin with:
22488 \begin_layout LyX-Code
22489 Counter CounterName
22492 \begin_layout Standard
22494 \begin_inset Flex Code
22497 \begin_layout Plain Layout
22503 ' is replaced by the name of the counter.
22504 And it must end with
22505 \begin_inset Quotes eld
22509 \begin_inset Flex Code
22512 \begin_layout Plain Layout
22519 \begin_inset Quotes erd
22523 The following parameters can also be used:
22526 \begin_layout Description
22527 \begin_inset Flex Code
22530 \begin_layout Plain Layout
22537 \begin_inset Flex Code
22540 \begin_layout Plain Layout
22546 ] Sets the initial value for the counter, to which it will be reset whenever
22548 Normally, one will want the default, 1.
22551 \begin_layout Description
22552 \begin_inset Flex Code
22555 \begin_layout Plain Layout
22562 \begin_inset Flex Code
22565 \begin_layout Plain Layout
22572 \begin_inset Quotes erd
22576 \begin_inset Quotes erd
22579 ] When defined, this string defines how the counter is displayed.
22580 Setting this value sets
22581 \begin_inset Flex Code
22584 \begin_layout Plain Layout
22585 LabelStringAppendix
22591 The following special constructs can be used in the string:
22595 \begin_layout Itemize
22596 \begin_inset Flex Code
22599 \begin_layout Plain Layout
22607 will be replaced by the expansion of the
22608 \begin_inset Flex Code
22611 \begin_layout Plain Layout
22618 \begin_inset Flex Code
22621 \begin_layout Plain Layout
22622 LabelStringAppendix
22628 \begin_inset Flex Code
22631 \begin_layout Plain Layout
22641 \begin_layout Itemize
22642 counter values can be expressed using \SpecialChar LaTeX
22644 \begin_inset Newline newline
22648 \begin_inset Flex Code
22651 \begin_layout Plain Layout
22668 \begin_inset Flex Code
22671 \begin_layout Plain Layout
22683 \begin_layout Plain Layout
22693 Actually, the situation is a bit more complicated: any
22712 other than those described below will produce arabic numerals.
22713 It would not be surprising to see this change in the future.
22719 \begin_inset Flex Code
22722 \begin_layout Plain Layout
22728 : 1, 2, 3,\SpecialChar ldots
22730 \begin_inset Flex Code
22733 \begin_layout Plain Layout
22739 for lower-case letters: a, b, c, \SpecialChar ldots
22741 \begin_inset Flex Code
22744 \begin_layout Plain Layout
22750 for upper-case letters: A, B, C, \SpecialChar ldots
22752 \begin_inset Flex Code
22755 \begin_layout Plain Layout
22761 for lower-case roman numerals: i, ii, iii, \SpecialChar ldots
22763 \begin_inset Flex Code
22766 \begin_layout Plain Layout
22772 for upper-case roman numerals: I, II, III\SpecialChar ldots
22774 \begin_inset Flex Code
22777 \begin_layout Plain Layout
22783 for hebrew numerals.
22787 \begin_layout Standard
22788 If LabelString is not defined, a default value is constructed as follows:
22789 if the counter has a
22790 \change_deleted 731793113 1604355218
22792 \change_inserted 731793113 1604355221
22796 \begin_inset Flex Code
22799 \begin_layout Plain Layout
22801 \change_deleted 731793113 1604355223
22803 \change_inserted 731793113 1604355226
22812 \begin_inset Flex Code
22815 \begin_layout Plain Layout
22822 \begin_inset Newline newline
22826 \begin_inset Flex Code
22829 \begin_layout Plain Layout
22833 \change_inserted 731793113 1604355228
22835 \change_deleted 731793113 1604355230
22845 is used; otherwise the string
22846 \begin_inset Flex Code
22849 \begin_layout Plain Layout
22860 \begin_layout Description
22861 \begin_inset Flex Code
22864 \begin_layout Plain Layout
22865 LabelStringAppendix
22871 \begin_inset Flex Code
22874 \begin_layout Plain Layout
22881 \begin_inset Quotes eld
22885 \begin_inset Quotes erd
22889 \begin_inset Flex Code
22892 \begin_layout Plain Layout
22898 , but for use in the Appendix.
22899 \change_inserted -584632292 1607202551
22903 \begin_layout Description
22905 \change_inserted -584632292 1607202682
22906 \begin_inset Flex Code
22909 \begin_layout Plain Layout
22916 \begin_inset Flex Code
22919 \begin_layout Plain Layout
22921 \change_inserted -584632292 1607202576
22930 \begin_inset Quotes eld
22934 \begin_inset Quotes erd
22937 ] The counter name as used in \SpecialChar LaTeX
22939 (E.g., in \SpecialChar LyX
22940 , there is a counter named `theorem', but it is output to \SpecialChar LaTeX
22946 \begin_layout Description
22947 \begin_inset Flex Code
22950 \begin_layout Plain Layout
22957 \begin_inset Flex Code
22960 \begin_layout Plain Layout
22967 \begin_inset Quotes erd
22971 \begin_inset Quotes erd
22974 ] A format for use with formatted references to this counter.
22975 For example, one might want to have references to section numbers appear
22977 \begin_inset Quotes eld
22981 \begin_inset Quotes erd
22985 The string should contain
22986 \begin_inset Quotes eld
22990 \begin_inset Quotes erd
22994 This will be replaced by the counter number itself.
22995 So, for sections, it would be: Section ##.
22998 \begin_layout Description
22999 \begin_inset Flex Code
23002 \begin_layout Plain Layout
23009 \begin_inset Flex Code
23012 \begin_layout Plain Layout
23019 \begin_inset Quotes erd
23023 \begin_inset Quotes erd
23026 ] If this is set to the name of another counter, the present counter will
23027 be reset every time the other one is increased.
23029 \begin_inset Flex Code
23032 \begin_layout Plain Layout
23039 \begin_inset Flex Code
23042 \begin_layout Plain Layout
23051 \begin_layout Subsection
23053 \begin_inset CommandInset label
23055 name "subsec:Font-description"
23062 \begin_layout Standard
23063 A font description looks like this:
23066 \begin_layout LyX-Code
23083 \begin_layout LyX-Code
23087 \begin_layout LyX-Code
23091 \begin_layout Standard
23092 The following commands are available:
23095 \begin_layout Description
23096 \begin_inset Flex Code
23099 \begin_layout Plain Layout
23106 \change_deleted -712698321 1607682984
23108 \begin_inset Flex Code
23111 \begin_layout Plain Layout
23120 \begin_inset Flex Code
23123 \begin_layout Plain Layout
23130 \begin_inset Flex Code
23133 \begin_layout Plain Layout
23140 \begin_inset Flex Code
23143 \begin_layout Plain Layout
23150 \begin_inset Flex Code
23153 \begin_layout Plain Layout
23160 \begin_inset Flex Code
23163 \begin_layout Plain Layout
23170 \begin_inset Flex Code
23173 \begin_layout Plain Layout
23180 \begin_inset Flex Code
23183 \begin_layout Plain Layout
23190 \begin_inset Flex Code
23193 \begin_layout Plain Layout
23200 \begin_inset Flex Code
23203 \begin_layout Plain Layout
23210 \begin_inset Flex Code
23213 \begin_layout Plain Layout
23220 \begin_inset Flex Code
23223 \begin_layout Plain Layout
23230 \begin_inset Flex Code
23233 \begin_layout Plain Layout
23240 \begin_inset Flex Code
23243 \begin_layout Plain Layout
23250 \begin_inset Flex Code
23253 \begin_layout Plain Layout
23260 \begin_inset Flex Code
23263 \begin_layout Plain Layout
23270 \begin_inset Flex Code
23273 \begin_layout Plain Layout
23280 \begin_inset Flex Code
23283 \begin_layout Plain Layout
23290 \begin_inset Flex Code
23293 \begin_layout Plain Layout
23300 \begin_inset Flex Code
23303 \begin_layout Plain Layout
23310 \change_inserted -712698321 1607683139
23312 \begin_inset Flex Code
23315 \begin_layout Plain Layout
23317 \change_inserted -712698321 1607683135
23324 \begin_inset space ~
23328 \begin_inset CommandInset ref
23330 reference "chap:Names-of-colors"
23338 \change_deleted -712698321 1607683144
23340 \change_inserted -712698321 1607683146
23346 \begin_layout Description
23347 \begin_inset Flex Code
23350 \begin_layout Plain Layout
23357 \begin_inset Flex Code
23360 \begin_layout Plain Layout
23369 \begin_inset Flex Code
23372 \begin_layout Plain Layout
23379 \begin_inset Flex Code
23382 \begin_layout Plain Layout
23391 \begin_layout Description
23392 \begin_inset Flex Code
23395 \begin_layout Plain Layout
23402 \begin_inset Flex Code
23405 \begin_layout Plain Layout
23411 ] Valid arguments are:
23412 \begin_inset Flex Code
23415 \begin_layout Plain Layout
23422 \begin_inset Flex Code
23425 \begin_layout Plain Layout
23432 \begin_inset Flex Code
23435 \begin_layout Plain Layout
23442 \begin_inset Flex Code
23445 \begin_layout Plain Layout
23452 \begin_inset Flex Code
23455 \begin_layout Plain Layout
23462 \begin_inset Flex Code
23465 \begin_layout Plain Layout
23472 \begin_inset Flex Code
23475 \begin_layout Plain Layout
23482 \begin_inset Flex Code
23485 \begin_layout Plain Layout
23492 \begin_inset Flex Code
23495 \begin_layout Plain Layout
23502 \begin_inset Flex Code
23505 \begin_layout Plain Layout
23512 \begin_inset Flex Code
23515 \begin_layout Plain Layout
23522 \begin_inset Flex Code
23525 \begin_layout Plain Layout
23532 Each of these turns on or off the corresponding attribute.
23534 \begin_inset Flex Code
23537 \begin_layout Plain Layout
23543 turns on emphasis, and
23544 \begin_inset Flex Code
23547 \begin_layout Plain Layout
23555 \begin_inset Newline newline
23558 If the latter seems puzzling, remember that the font settings for the present
23559 context are generally inherited from the surrounding context.
23561 \begin_inset Flex Code
23564 \begin_layout Plain Layout
23570 would turn off the emphasis that was anyway in effect, say, in a theorem
23574 \begin_layout Description
23575 \begin_inset Flex Code
23578 \begin_layout Plain Layout
23585 \begin_inset Flex Code
23588 \begin_layout Plain Layout
23597 \begin_inset Flex Code
23600 \begin_layout Plain Layout
23609 \begin_layout Description
23610 \begin_inset Flex Code
23613 \begin_layout Plain Layout
23620 \begin_inset Flex Code
23623 \begin_layout Plain Layout
23632 \begin_inset Flex Code
23635 \begin_layout Plain Layout
23642 \begin_inset Flex Code
23645 \begin_layout Plain Layout
23652 \begin_inset Flex Code
23655 \begin_layout Plain Layout
23664 \begin_layout Description
23665 \begin_inset Flex Code
23668 \begin_layout Plain Layout
23675 \begin_inset Flex Code
23678 \begin_layout Plain Layout
23685 \begin_inset Flex Code
23688 \begin_layout Plain Layout
23695 \begin_inset Flex Code
23698 \begin_layout Plain Layout
23707 \begin_inset Flex Code
23710 \begin_layout Plain Layout
23717 \begin_inset Flex Code
23720 \begin_layout Plain Layout
23727 \begin_inset Flex Code
23730 \begin_layout Plain Layout
23737 \begin_inset Flex Code
23740 \begin_layout Plain Layout
23747 \begin_inset Flex Code
23750 \begin_layout Plain Layout
23759 \begin_layout Subsection
23760 \begin_inset CommandInset label
23762 name "subsec:Citation-engine-description"
23766 Cite engine description
23769 \begin_layout Standard
23771 \begin_inset Flex Code
23774 \begin_layout Plain Layout
23780 blocks, as used mainly in cite engine files (see
23781 \begin_inset CommandInset ref
23783 reference "subsec:Cite-Engine-Files"
23790 ), define the citation commands provided by a specific
23791 \begin_inset Quotes eld
23795 \begin_inset Quotes erd
23799 A cite engine, in \SpecialChar LyX
23800 terms, is way specific way to format citations, using
23801 numbers, author names and/or years.
23802 Currently, \SpecialChar LyX
23803 supports three such engine types, namely:
23806 \begin_layout Enumerate
23807 \begin_inset Flex Code
23810 \begin_layout Plain Layout
23816 : the default Bib\SpecialChar TeX
23817 way to format citations, a simple numeric style (e.
23818 \begin_inset space \thinspace{}
23822 \begin_inset Quotes eld
23826 \begin_inset Quotes erd
23832 \begin_layout Enumerate
23833 \begin_inset Flex Code
23836 \begin_layout Plain Layout
23842 : Harvard-styled citations using author names and publication year (e.
23843 \begin_inset space \thinspace{}
23847 \begin_inset Quotes eld
23850 Smith and Miller (2017b)
23851 \begin_inset Quotes erd
23857 \begin_layout Enumerate
23858 \begin_inset Flex Code
23861 \begin_layout Plain Layout
23867 : extended numerical citations that also allow for author or title next
23869 \begin_inset space \thinspace{}
23873 \begin_inset Quotes eld
23876 Smith and Miller [1]
23877 \begin_inset Quotes erd
23883 \begin_layout Standard
23884 \begin_inset Flex Code
23887 \begin_layout Plain Layout
23893 blocks look like this:
23896 \begin_layout LyX-Code
23900 \begin_layout LyX-Code
23904 \begin_layout LyX-Code
23908 \begin_layout LyX-Code
23909 citeyearpar[][]=parencite*
23912 \begin_layout LyX-Code
23916 \begin_layout LyX-Code
23920 \begin_layout Standard
23922 \begin_inset Flex Code
23925 \begin_layout Plain Layout
23931 denotes the engine.
23932 The individual lines respectively define a cite command or cite command
23933 paradigm supported by this engine.
23934 The line can be as simple as a cite command that is used both to name the
23935 respective \SpecialChar LyX
23936 command and the \SpecialChar LaTeX
23937 output or more complex in order to differentiate
23939 The full syntax is:
23942 \begin_layout LyX-Code
23943 LyXName|alias$*<!_stardesc!_stardesctooltip>[][]=latexcmd
23946 \begin_layout Itemize
23947 \begin_inset Flex Code
23950 \begin_layout Plain Layout
23956 : The name as used in the
23957 \begin_inset Flex Code
23960 \begin_layout Plain Layout
23970 \begin_layout Standard
23971 For portability reasons, we try to use the same name for same-formatted
23972 commands in different cite packages (thus many names stem from natbib,
23973 and thus we need to differentiate a
23974 \begin_inset Flex Code
23977 \begin_layout Plain Layout
23983 sometimes, if the \SpecialChar LaTeX
23984 command names differ).
23988 \begin_layout Itemize
23989 \begin_inset Flex Code
23992 \begin_layout Plain Layout
23998 : a (comma-separated) list of commands that fall back to the given
23999 \begin_inset Flex Code
24002 \begin_layout Plain Layout
24008 in the current engine.
24009 This eases the switch of citation packages and engines.
24011 \begin_inset Flex Code
24014 \begin_layout Plain Layout
24021 \begin_inset Flex Code
24024 \begin_layout Plain Layout
24030 in layout definitions.
24033 \begin_layout Itemize
24034 \begin_inset Flex Code
24037 \begin_layout Plain Layout
24043 : The actual \SpecialChar LaTeX
24044 command that is output.
24048 \begin_layout Standard
24049 \begin_inset Flex Code
24052 \begin_layout Plain Layout
24059 \begin_inset Flex Code
24062 \begin_layout Plain Layout
24070 \begin_inset Flex Code
24073 \begin_layout Plain Layout
24080 \begin_inset Flex Code
24083 \begin_layout Plain Layout
24089 will be output to \SpecialChar LaTeX
24093 \begin_layout Standard
24097 \begin_layout Itemize
24098 Capitalization indicates that the command also has a capitalized form (
24099 \begin_inset Flex Code
24102 \begin_layout Plain Layout
24112 \begin_inset Flex Code
24115 \begin_layout Plain Layout
24124 These usually enforce up-casing of name prefixes (
24129 \begin_inset Formula $\Rightarrow$
24139 \begin_layout Itemize
24141 \begin_inset Flex Code
24144 \begin_layout Plain Layout
24150 indicate the number of optional arguments (there can be 0–2).
24153 \begin_layout Itemize
24155 \begin_inset Flex Code
24158 \begin_layout Plain Layout
24164 indicates there is a starred version of the command (
24165 \begin_inset Flex Code
24168 \begin_layout Plain Layout
24178 \begin_inset Flex Code
24181 \begin_layout Plain Layout
24194 \begin_layout Standard
24195 By default, the starred version means: Output all authors even if it should
24197 \begin_inset Quotes eld
24201 \begin_inset Quotes erd
24205 \begin_inset Flex Code
24208 \begin_layout Plain Layout
24217 \begin_layout Standard
24218 If the star has a different meaning for a given command, it can be specified
24220 \begin_inset Flex Code
24223 \begin_layout Plain Layout
24224 <!_stardesc!_stardesctooltip>
24230 Maximal two translatable macro keywords, marked by the prefix
24231 \begin_inset Flex Code
24234 \begin_layout Plain Layout
24241 The first points to the string that replaces the
24242 \begin_inset Quotes eld
24246 \begin_inset Quotes erd
24249 checkbox label in the citation dialog, the second one to an optional tool
24250 tip for this checkbox.
24254 \begin_layout Standard
24255 Note that these two macros have to be defined in a
24256 \begin_inset Flex Code
24259 \begin_layout Plain Layout
24265 (see next section), dropping the
24266 \begin_inset Flex Code
24269 \begin_layout Plain Layout
24275 from the prefix, like this:
24278 \begin_layout LyX-Code
24279 _stardesc Sta&rred command label
24282 \begin_layout LyX-Code
24283 _stardesctooltip Tooltip for the starred command checkbox.
24287 \begin_layout Itemize
24289 \begin_inset Flex Code
24292 \begin_layout Plain Layout
24298 indicates that this command features
24299 \begin_inset Quotes eld
24302 qualified citation lists
24303 \begin_inset Quotes erd
24311 -specific feature for multi-reference citations where an individual pre-
24312 and postnote can be given to each reference in the list.
24313 Please refer to the
24317 manual for details.
24318 \change_inserted -712698321 1526898670
24322 \begin_layout Standard
24324 \change_inserted -712698321 1526899524
24325 If you want to add a cite command to a cite engine (e.
24326 \begin_inset space \thinspace{}
24329 g., add a specific command provided by a class), you can use
24330 \begin_inset Flex Code
24333 \begin_layout Plain Layout
24335 \change_inserted -712698321 1526898768
24336 AddToCiteEngine <engine type> \SpecialChar ldots
24345 Note that only cite commands that do not exist yet are added.
24350 \begin_layout Subsection
24351 \begin_inset CommandInset label
24353 name "subsec:Citation-format-description"
24357 Cite format description
24360 \begin_layout Standard
24362 \begin_inset Flex Code
24365 \begin_layout Plain Layout
24371 blocks are used to describe how bibliographic information should be displayed,
24372 both within \SpecialChar LyX
24373 itself (in the citation dialog and in tooltips, for example)
24374 and in XHTML output.
24375 Such a block might look like this:
24378 \begin_layout LyX-Code
24382 \begin_layout LyX-Code
24386 \begin_layout LyX-Code
24390 \begin_layout LyX-Code
24394 \begin_layout Standard
24398 \begin_layout LyX-Code
24402 \begin_layout LyX-Code
24406 \begin_layout LyX-Code
24410 \begin_layout LyX-Code
24414 \begin_layout Standard
24415 In the first case, the individual lines define how the bibliographic information
24416 associated with an article or book, respectively, is to be displayed, and
24417 such a definition can be given for any
24418 \begin_inset Quotes els
24422 \begin_inset Quotes ers
24425 that might be present in a Bib\SpecialChar TeX
24428 defines a default format in the source code that will be used if no specific
24429 definition has been given.
24431 predefines several formats in the file
24432 \begin_inset Flex Code
24435 \begin_layout Plain Layout
24441 , which is included in most of \SpecialChar LyX
24442 's document classes.
24445 \begin_layout Standard
24446 In the second case, the lines define how a specific citation command (in
24448 \begin_inset Flex Code
24451 \begin_layout Plain Layout
24460 \begin_inset Flex Code
24463 \begin_layout Plain Layout
24471 ) is to be displayed on the citation inset label, in the citation dialog,
24472 menu or XHTML output.
24474 defines such formats for the citation style variants it supports via
24476 Document\SpecialChar menuseparator
24477 Setting\SpecialChar menuseparator
24478 Bibliography\SpecialChar ldots
24482 \begin_inset Flex Code
24485 \begin_layout Plain Layout
24491 files that are shipped with \SpecialChar LyX
24493 \begin_inset CommandInset ref
24495 reference "subsec:Cite-Engine-Files"
24505 \begin_layout Standard
24506 The definitions use a simple language that allows Bib\SpecialChar TeX
24507 keys to be replaced
24509 Keys should be enclosed in
24510 \begin_inset Flex Code
24513 \begin_layout Plain Layout
24520 \begin_inset Flex Code
24523 \begin_layout Plain Layout
24530 So a simple definition might look like this:
24533 \begin_layout LyX-Code
24535 \begin_inset Quotes eld
24539 \begin_inset Quotes erd
24545 \begin_layout Standard
24546 This would print the author, followed by a comma, followed by the title,
24547 in quotes, followed by a period.
24550 \begin_layout Standard
24551 Of course, sometimes you may want to print a key only if it exists.
24552 This can be done by using a conditional construction, such as:
24553 \begin_inset Flex Code
24556 \begin_layout Plain Layout
24558 \begin_inset space ~
24568 \begin_inset Flex Code
24571 \begin_layout Plain Layout
24577 key exists, then print
24578 \begin_inset Quotes eld
24582 \begin_inset space ~
24586 \begin_inset Quotes erd
24589 followed by the volume key.
24590 It is also possible to have an else clause in the conditional, such as:
24591 \begin_inset Newline newline
24595 \begin_inset Flex Code
24598 \begin_layout Plain Layout
24599 {%author%[[%author%]][[%editor%, ed.]]}
24605 \begin_inset Newline newline
24609 \begin_inset Flex Code
24612 \begin_layout Plain Layout
24618 key is printed if it exists; otherwise, the editor key is printed, followed
24620 \begin_inset Quotes eld
24624 \begin_inset space ~
24628 \begin_inset Quotes erd
24631 Note that the key is again enclosed in
24632 \begin_inset Flex Code
24635 \begin_layout Plain Layout
24641 signs; the entire conditional is enclosed in braces; and the if and else
24642 clauses are enclosed in double brackets,
24643 \begin_inset Quotes eld
24647 \begin_inset Flex Code
24650 \begin_layout Plain Layout
24657 \begin_inset Quotes eld
24661 \begin_inset Quotes eld
24665 \begin_inset Flex Code
24668 \begin_layout Plain Layout
24675 \begin_inset Quotes erd
24679 There must be no space between any of these.
24682 \begin_layout Standard
24683 Next to the entry keys, there are some special keys that can be used for
24684 these conditionals:
24687 \begin_layout Itemize
24688 \begin_inset Flex Code
24691 \begin_layout Plain Layout
24692 {%dialog%[[true]][[false]]}
24698 \begin_inset Quotes eld
24702 \begin_inset Quotes erd
24705 part for dialogs and menus, the
24706 \begin_inset Quotes eld
24710 \begin_inset Quotes erd
24713 part for other contexts (workarea, export)
24716 \begin_layout Itemize
24717 \begin_inset Flex Code
24720 \begin_layout Plain Layout
24721 {%export%[[true]][[false]]}
24727 \begin_inset Quotes eld
24731 \begin_inset Quotes erd
24734 part for export and menus, the
24735 \begin_inset Quotes eld
24739 \begin_inset Quotes erd
24742 part for other contexts (workarea, dialog)
24745 \begin_layout Itemize
24746 \begin_inset Flex Code
24749 \begin_layout Plain Layout
24756 \begin_inset Quotes eld
24760 \begin_inset Quotes erd
24763 part if another item follows (e.
24764 \begin_inset space \thinspace{}
24767 g., in a citation with multiple keys)
24770 \begin_layout Itemize
24771 \begin_inset Flex Code
24774 \begin_layout Plain Layout
24775 {%second%[[true]][[false]]}
24781 \begin_inset Quotes eld
24785 \begin_inset Quotes erd
24788 if this is the second of multiple items, else the
24789 \begin_inset Quotes eld
24793 \begin_inset Quotes erd
24799 \begin_layout Itemize
24800 \begin_inset Flex Code
24803 \begin_layout Plain Layout
24804 {%ifstar%[[true]][[false]]}
24810 \begin_inset Quotes eld
24814 \begin_inset Quotes erd
24817 part for starred citation commands (such as
24818 \begin_inset Flex Code
24821 \begin_layout Plain Layout
24829 ), the false part for unstarred
24832 \begin_layout Itemize
24833 \begin_inset Flex Code
24836 \begin_layout Plain Layout
24837 {%ifentrytype:<type>%[[true]][[false]]}
24843 \begin_inset Quotes eld
24847 \begin_inset Quotes erd
24850 if the current entry type matches
24851 \begin_inset Flex Code
24854 \begin_layout Plain Layout
24860 , else the false part (e.g., in a citation definition:
24861 \begin_inset Flex Code
24864 \begin_layout Plain Layout
24865 {%ifentrytype:book%[[this is a book]][[this is no book]]}
24873 \begin_layout Itemize
24874 \begin_inset Flex Code
24877 \begin_layout Plain Layout
24878 {%ifmultiple:<authortype>%[[true]][[false]]}
24884 \begin_inset Quotes eld
24888 \begin_inset Quotes erd
24891 if the current author type (author, editor etc.) has multiple authors, else
24892 the false part (e.g., in a bibliography definition:
24893 \begin_inset Flex Code
24896 \begin_layout Plain Layout
24897 {%ifmultiple:editor%[[eds.]][[ed.]]}
24905 \begin_layout Itemize
24906 \begin_inset Flex Code
24909 \begin_layout Plain Layout
24910 {%ifqualified%[[true]][[false]]}
24916 \begin_inset Quotes eld
24920 \begin_inset Quotes erd
24923 part if the current citation is a qualified citation list (a specific
24927 format for multi-reference citations), the false part if this is not the
24931 \begin_layout Standard
24933 \begin_inset Flex Code
24936 \begin_layout Plain Layout
24942 prints the author key as it is recorded in the bibliography file.
24943 This might not be what you want, since it will result in a string such
24945 \begin_inset Quotes eld
24948 Miller, Peter and Smith, Mary and White, Jane
24949 \begin_inset Quotes erd
24953 \begin_inset Quotes eld
24957 \begin_inset Quotes erd
24960 is used by Bib\SpecialChar TeX
24961 to delimit authors).
24963 therefore provides some methods to get properly formatted name lists (which
24964 will also get translated).
24965 The following keys are provided:
24968 \begin_layout Enumerate
24969 For name lists with pre- and surname, suitable for the main authors/editors
24970 of a bibliography item.
24972 \begin_inset Flex Code
24975 \begin_layout Plain Layout
24981 part denotes the kind of list that is requested (e.g.
24983 \begin_inset Flex Code
24986 \begin_layout Plain Layout
24996 \begin_layout Itemize
24997 \begin_inset Flex Code
25000 \begin_layout Plain Layout
25001 %abbrvnames:<nametype>%
25006 : Provides a name list which is abbreviated (with
25007 \begin_inset Quotes eld
25011 \begin_inset Quotes erd
25015 \begin_inset Flex Code
25018 \begin_layout Plain Layout
25027 \begin_layout Itemize
25028 \begin_inset Flex Code
25031 \begin_layout Plain Layout
25032 %fullnames:<nametype>%
25037 : Provides a full name list (never abbreviated with
25038 \begin_inset Quotes eld
25042 \begin_inset Quotes erd
25048 \begin_layout Itemize
25049 \begin_inset Flex Code
25052 \begin_layout Plain Layout
25053 %forceabbrvnames:<nametype>%
25058 : Provides a name list which is always abbreviated (with
25059 \begin_inset Quotes eld
25063 \begin_inset Quotes erd
25067 \begin_inset Flex Code
25070 \begin_layout Plain Layout
25080 \begin_layout Enumerate
25081 Alternative name lists with pre- and surname, if the order of pre- and surname
25082 inside the bibliography item differs (as in:
25083 \begin_inset Quotes eld
25086 Miller, John: Some text, in: Mary Smith, ed.: A volume
25087 \begin_inset Quotes erd
25094 \begin_layout Itemize
25095 \begin_inset Flex Code
25098 \begin_layout Plain Layout
25099 %abbrvbynames:<nametype>%
25104 : Provides a name list which is abbreviated (with
25105 \begin_inset Quotes eld
25109 \begin_inset Quotes erd
25113 \begin_inset Flex Code
25116 \begin_layout Plain Layout
25125 \begin_layout Itemize
25126 \begin_inset Flex Code
25129 \begin_layout Plain Layout
25130 %fullbynames:<nametype>%
25135 : Provides a full name list (never abbreviated with
25136 \begin_inset Quotes eld
25140 \begin_inset Quotes erd
25146 \begin_layout Itemize
25147 \begin_inset Flex Code
25150 \begin_layout Plain Layout
25151 %forceabbrvbynames:<nametype>%
25156 : Provides a name list which is always abbreviated (with
25157 \begin_inset Quotes eld
25161 \begin_inset Quotes erd
25165 \begin_inset Flex Code
25168 \begin_layout Plain Layout
25178 \begin_layout Enumerate
25179 And finally name lists which consist of family names only, as used in author-yea
25181 These do not take a
25182 \begin_inset Flex Code
25185 \begin_layout Plain Layout
25191 part, but always return either an author list or, if this does not exist,
25192 an editor list (as common in author-year labels):
25196 \begin_layout Itemize
25197 \begin_inset Flex Code
25200 \begin_layout Plain Layout
25206 : Provides a name list which is abbreviated (with
25207 \begin_inset Quotes eld
25211 \begin_inset Quotes erd
25215 \begin_inset Flex Code
25218 \begin_layout Plain Layout
25227 \begin_layout Itemize
25228 \begin_inset Flex Code
25231 \begin_layout Plain Layout
25237 : Provides a full name list (never abbreviated with
25238 \begin_inset Quotes eld
25242 \begin_inset Quotes erd
25248 \begin_layout Itemize
25249 \begin_inset Flex Code
25252 \begin_layout Plain Layout
25253 %forceabbrvciteauthor%
25258 : Provides a name list which is always abbreviated (with
25259 \begin_inset Quotes eld
25263 \begin_inset Quotes erd
25267 \begin_inset Flex Code
25270 \begin_layout Plain Layout
25280 \begin_layout Standard
25281 The order of pre- and surname in the former two lists can be adjusted by
25285 \begin_layout Itemize
25286 \begin_inset Flex Code
25289 \begin_layout Plain Layout
25290 !firstnameform %surname%, %prename%
25295 (first author in lists of type 1)
25298 \begin_layout Itemize
25299 \begin_inset Flex Code
25302 \begin_layout Plain Layout
25303 !othernameform %surname%, %prename%
25308 (other authors in lists of type 1)
25311 \begin_layout Itemize
25312 \begin_inset Flex Code
25315 \begin_layout Plain Layout
25316 !firstbynameform %prename% %surname%
25321 (first author in lists of type 2)
25324 \begin_layout Itemize
25325 \begin_inset Flex Code
25328 \begin_layout Plain Layout
25329 !otherbynameform %prename% %surname%
25334 (other authors in lists of type 2)
25337 \begin_layout Standard
25338 This allows you to configure namings like
25339 \begin_inset Quotes eld
25342 Miller, Peter and Mary Smith: \SpecialChar ldots
25343 , in: John Doe and Pat Green, eds.:\SpecialChar ldots
25345 \begin_inset Quotes erd
25351 \begin_layout Standard
25352 There is one other piece of syntax available in definitions, which looks
25354 \begin_inset Flex Code
25357 \begin_layout Plain Layout
25364 This defines a piece of formatting information that is to be used when
25366 \begin_inset Quotes eld
25370 \begin_inset Quotes erd
25374 Obviously, we do not want to output HTML tags when writing plain text,
25375 so they should be wrapped in
25376 \begin_inset Quotes eld
25380 \begin_inset Quotes erd
25384 \begin_inset Quotes eld
25388 \begin_inset Quotes erd
25394 \begin_layout Standard
25395 Two special sorts of definitions are also possible in a
25396 \begin_inset Flex Code
25399 \begin_layout Plain Layout
25406 An example of the first would be:
25409 \begin_layout LyX-Code
25411 \begin_inset Quotes eld
25415 \begin_inset Quotes erd
25421 \begin_layout Standard
25422 This is an abbreviation, or macro, and it can be used by treating it as
25424 \begin_inset Flex Code
25427 \begin_layout Plain Layout
25436 \begin_inset Flex Code
25439 \begin_layout Plain Layout
25445 exactly as it would treat its definition.
25446 So, let us issue the obvious
25454 \begin_layout LyX-Code
25458 \begin_layout Standard
25459 or anything like it.
25461 shouldn't go into an infinite loop, but it may go into a long one before
25465 \begin_layout Standard
25466 The second sort of special definition might look like this:
25469 \begin_layout LyX-Code
25473 \begin_layout Standard
25474 This defines a translatable piece of text, which allows relevant parts of
25475 the bibliography or citation to be translated.
25476 It can be included in a definition by treating it as a key:
25477 \begin_inset Flex Code
25480 \begin_layout Plain Layout
25487 Note that there are two different translation paths: All definitions starting
25489 \begin_inset Flex Code
25492 \begin_layout Plain Layout
25498 , such as in the example above, will be translated to the currently active
25499 buffer language (so the translation will match the generated document).
25500 All definitions starting with underscore only will be translated to the
25502 This is the proper translation for strings that only occur in the dialogs
25503 or on buttons, such as this one:
25506 \begin_layout LyX-Code
25507 _addtobib Add to bibliography only.
25510 \begin_layout Standard
25511 Several of these translatable strings are predefined in
25512 \begin_inset Flex Code
25515 \begin_layout Plain Layout
25522 \begin_inset Flex Code
25525 \begin_layout Plain Layout
25532 Note that these are not macros, in the sense just defined.
25533 They will not be expanded.
25536 \begin_layout Standard
25537 So here then is an example that uses several of these features:
25538 \begin_inset VSpace defskip
25544 \begin_layout Standard
25548 !authoredit {%author%[[%author%, ]][[{%editor%[[%editor%, %B_edtext%, ]]}]]}
25551 \begin_layout Standard
25552 \begin_inset VSpace defskip
25555 This defines a macro that prints the author, followed by a comma, if the
25557 \begin_inset Flex Code
25560 \begin_layout Plain Layout
25566 key is defined, or else prints the name of the editor, followed by the
25568 \begin_inset Flex Code
25571 \begin_layout Plain Layout
25577 or its translation (it is by default
25578 \begin_inset Quotes eld
25582 \begin_inset Quotes erd
25586 \begin_inset Flex Code
25589 \begin_layout Plain Layout
25596 Note that this is in fact defined in
25597 \begin_inset Flex Code
25600 \begin_layout Plain Layout
25606 , so you can use it in your own definitions, or re-definitions, if you load
25610 \begin_layout Section
25611 \begin_inset CommandInset label
25613 name "sec:Tags-for-XHTML"
25617 Tags for XHTML output
25620 \begin_layout Standard
25621 As with \SpecialChar LaTeX
25622 or DocBook, the format of \SpecialChar LyX
25623 's XHTML output is also controlled by
25624 layout information.
25625 In general, \SpecialChar LyX
25626 provides sensible defaults and, as mentioned earlier, it will
25627 even construct default CSS style rules from the other layout tags.
25628 For example, \SpecialChar LyX
25629 will attempt to use the information provided in the
25630 \begin_inset Flex Code
25633 \begin_layout Plain Layout
25639 declaration for the Chapter style to write CSS that will appropriately
25640 format chapter headings.
25643 \begin_layout Standard
25644 In many cases, then, you may not have to do anything at all to get acceptable
25645 XHTML output for your own environments, custom insets, and so forth.
25646 But in some cases you will, and so \SpecialChar LyX
25647 provides a number of layout tags that
25648 can be used to customize the XHTML and CSS that are generated.
25651 \begin_layout Standard
25652 Note that there are two tags,
25653 \begin_inset Flex Code
25656 \begin_layout Plain Layout
25663 \begin_inset Flex Code
25666 \begin_layout Plain Layout
25672 that may appear outside style and inset declarations.
25674 \begin_inset CommandInset ref
25676 reference "subsec:General-text-class"
25680 for details on these.
25683 \begin_layout Subsection
25684 \begin_inset CommandInset label
25686 name "subsec:Paragraph-Style-XHTML"
25693 \begin_layout Standard
25694 The sort of XHTML \SpecialChar LyX
25695 outputs for a paragraph depends upon whether we are dealing
25696 with a normal paragraph, a command, or an environment, where this is itself
25697 determined by the contents of the corresponding
25698 \begin_inset Flex Code
25701 \begin_layout Plain Layout
25712 \begin_layout Standard
25713 For a command or normal paragraph, the output XHTML has the following form:
25716 \begin_layout LyX-Code
25720 \begin_inset Quotes erd
25724 \begin_inset Quotes erd
25730 \begin_layout LyX-Code
25734 \begin_inset Quotes erd
25738 \begin_inset Quotes erd
25744 \begin_layout LyX-Code
25747 Contents of the paragraph.
25750 \begin_layout LyX-Code
25756 \begin_layout Standard
25757 The label tags are of course omitted if the paragraph does not have a label.
25760 \begin_layout Standard
25761 For an environment that is not some sort of list, the XHTML takes this form:
25764 \begin_layout LyX-Code
25768 \begin_inset Quotes erd
25772 \begin_inset Quotes erd
25778 \begin_layout LyX-Code
25782 \begin_inset Quotes erd
25786 \begin_inset Quotes erd
25790 \begin_inset Quotes erd
25794 \begin_inset Quotes erd
25797 >Environment Label</labeltag>First paragraph.</itemtag>
25800 \begin_layout LyX-Code
25803 <itemtag>Second paragraph.</itemtag>
25806 \begin_layout LyX-Code
25812 \begin_layout Standard
25813 Note that the label is output only for the first paragraph, as it should
25814 be for a theorem, for example.
25818 \begin_layout Standard
25819 For a list, we have one of these forms:
25822 \begin_layout LyX-Code
25826 \begin_inset Quotes erd
25830 \begin_inset Quotes erd
25836 \begin_layout LyX-Code
25840 \begin_inset Quotes erd
25844 \begin_inset Quotes erd
25848 \begin_inset Quotes erd
25852 \begin_inset Quotes erd
25855 >List Label</labeltag>First item.</itemtag>
25858 \begin_layout LyX-Code
25862 \begin_inset Quotes erd
25866 \begin_inset Quotes erd
25870 \begin_inset Quotes erd
25874 \begin_inset Quotes erd
25877 >List Label</labeltag>Second item.</itemtag>
25880 \begin_layout LyX-Code
25886 \begin_layout LyX-Code
25890 \begin_layout LyX-Code
25894 \begin_inset Quotes erd
25898 \begin_inset Quotes erd
25904 \begin_layout LyX-Code
25908 \begin_inset Quotes erd
25912 \begin_inset Quotes erd
25915 >List Label</labeltag><itemtag attr=
25916 \begin_inset Quotes erd
25920 \begin_inset Quotes erd
25923 >First item.</itemtag>
25926 \begin_layout LyX-Code
25930 \begin_inset Quotes erd
25934 \begin_inset Quotes erd
25937 >List Label</labeltag><itemtag attr=
25938 \begin_inset Quotes erd
25942 \begin_inset Quotes erd
25945 >Second item.</itemtag>
25948 \begin_layout LyX-Code
25954 \begin_layout Standard
25955 Note the different orders of
25956 \begin_inset Flex Code
25959 \begin_layout Plain Layout
25966 \begin_inset Flex Code
25969 \begin_layout Plain Layout
25976 Which order we get depends upon the setting of
25977 \begin_inset Flex Code
25980 \begin_layout Plain Layout
25987 \begin_inset Flex Code
25990 \begin_layout Plain Layout
25996 is false (the default), you get the first of these, with the label within
25997 the item; if true, you get the second, with the label outside the item.
26000 \begin_layout Standard
26001 The specific tags and attributes output for each paragraph type can be controlle
26002 d by means of the layout tags we are about to describe.
26003 As mentioned earlier, however, \SpecialChar LyX
26004 uses sensible defaults for many of these,
26005 so you often may not need to do very much to get good XHTML output.
26006 Think of the available tags as there so you can tweak things to your liking.
26009 \begin_layout Description
26010 \begin_inset Flex Code
26013 \begin_layout Plain Layout
26020 \begin_inset Flex Code
26023 \begin_layout Plain Layout
26029 ] Specifies attribute information to be output with the main tag.
26031 \begin_inset Quotes eld
26035 \begin_inset Flex Code
26038 \begin_layout Plain Layout
26045 \begin_inset Quotes erd
26049 By default, \SpecialChar LyX
26051 \begin_inset Quotes eld
26055 \begin_inset Flex Code
26058 \begin_layout Plain Layout
26065 \begin_inset Quotes erd
26069 \begin_inset Flex Code
26072 \begin_layout Plain Layout
26078 is the \SpecialChar LyX
26079 name of the layout, made lowercase, for example: chapter.
26084 contain any style information.
26086 \begin_inset Flex Code
26089 \begin_layout Plain Layout
26098 \begin_layout Description
26099 \begin_inset Flex Code
26102 \begin_layout Plain Layout
26109 \begin_inset Flex Code
26112 \begin_layout Plain Layout
26122 ] Whether to output the default CSS information \SpecialChar LyX
26123 generates for this layout,
26124 even if additional information is explicitly provided via
26125 \begin_inset Flex Code
26128 \begin_layout Plain Layout
26136 \begin_inset Flex Code
26139 \begin_layout Plain Layout
26145 allows you to alter or augment the generated CSS, rather than to override
26148 \begin_inset Flex Code
26151 \begin_layout Plain Layout
26160 \begin_layout Description
26161 \begin_inset Flex Code
26164 \begin_layout Plain Layout
26171 \begin_inset Flex Code
26174 \begin_layout Plain Layout
26180 ] The tag to be used for individual paragraphs of environments, replacing
26182 \begin_inset Flex Code
26185 \begin_layout Plain Layout
26191 in the examples above.
26193 \begin_inset Flex Code
26196 \begin_layout Plain Layout
26205 \begin_layout Description
26206 \begin_inset Flex Code
26209 \begin_layout Plain Layout
26216 \begin_inset Flex Code
26219 \begin_layout Plain Layout
26225 ] Attributes for the item tag.
26227 \begin_inset Newline newline
26231 \begin_inset Quotes eld
26235 \begin_inset Flex Code
26238 \begin_layout Plain Layout
26239 class=`layoutname_item'
26245 \begin_inset Quotes erd
26253 contain any style information.
26255 \begin_inset Flex Code
26258 \begin_layout Plain Layout
26267 \begin_layout Description
26268 \begin_inset Flex Code
26271 \begin_layout Plain Layout
26278 \begin_inset Flex Code
26281 \begin_layout Plain Layout
26287 ] The tag to be used for paragraph and item labels, replacing
26288 \begin_inset Flex Code
26291 \begin_layout Plain Layout
26297 in the examples above.
26299 \begin_inset Flex Code
26302 \begin_layout Plain Layout
26309 \begin_inset Flex Code
26312 \begin_layout Plain Layout
26319 \begin_inset Flex Code
26322 \begin_layout Plain Layout
26329 \begin_inset Flex Code
26332 \begin_layout Plain Layout
26333 Centered_Top_Environment
26338 , in which case it defaults to
26339 \begin_inset Flex Code
26342 \begin_layout Plain Layout
26351 \begin_layout Description
26352 \begin_inset Flex Code
26355 \begin_layout Plain Layout
26362 \begin_inset Flex Code
26365 \begin_layout Plain Layout
26371 ] Attributes for the label tag.
26373 \begin_inset Newline newline
26377 \begin_inset Quotes eld
26381 \begin_inset Flex Code
26384 \begin_layout Plain Layout
26385 class=`layoutname_label'
26391 \begin_inset Quotes erd
26399 contain any style information.
26401 \begin_inset Flex Code
26404 \begin_layout Plain Layout
26413 \begin_layout Description
26414 \begin_inset Flex Code
26417 \begin_layout Plain Layout
26424 \begin_inset Flex Code
26427 \begin_layout Plain Layout
26437 ] Meaningful only for list-like environments, this tag controls whether
26438 the label tag is output before or inside the item tag.
26439 This is used, for example, in the description environment, where we want
26441 \begin_inset Flex Code
26444 \begin_layout Plain Layout
26445 <dt>\SpecialChar ldots
26446 </dt><dd>\SpecialChar ldots
26454 \begin_inset Flex Code
26457 \begin_layout Plain Layout
26463 : The label tag is output inside the item tag.
26466 \begin_layout Description
26467 \begin_inset Flex Code
26470 \begin_layout Plain Layout
26476 Information to be output in the
26477 \begin_inset Flex Code
26480 \begin_layout Plain Layout
26486 section when this style is used.
26487 This might, for example, be used to include a
26488 \begin_inset Flex Code
26491 \begin_layout Plain Layout
26498 \begin_inset Flex Code
26501 \begin_layout Plain Layout
26510 \begin_layout Description
26511 \begin_inset Flex Code
26514 \begin_layout Plain Layout
26520 CSS style information to be included when this style is used.
26521 Note that this will automatically be wrapped in a layout-generated
26522 \begin_inset Flex Code
26525 \begin_layout Plain Layout
26531 block, so only the CSS itself need be included.
26533 \begin_inset Flex Code
26536 \begin_layout Plain Layout
26545 \begin_layout Description
26546 \begin_inset Flex Code
26549 \begin_layout Plain Layout
26556 \begin_inset Flex Code
26559 \begin_layout Plain Layout
26565 ] The tag to be used for the main label, replacing
26566 \begin_inset Flex Code
26569 \begin_layout Plain Layout
26575 in the examples above.
26577 \begin_inset Flex Code
26580 \begin_layout Plain Layout
26589 \begin_layout Description
26590 \begin_inset Flex Code
26593 \begin_layout Plain Layout
26600 \begin_inset Flex Code
26603 \begin_layout Plain Layout
26613 ] Marks this style as the one to be used to generate the
26614 \begin_inset Flex Code
26617 \begin_layout Plain Layout
26623 tag for the XHTML file.
26624 By default, it is false.
26626 \begin_inset Flex Code
26629 \begin_layout Plain Layout
26635 file sets it to true for the
26636 \begin_inset Flex Code
26639 \begin_layout Plain Layout
26649 \begin_layout Subsection
26653 \begin_layout Standard
26654 The XHTML output of insets can also be controlled by information in layout
26659 \begin_layout Plain Layout
26660 At present, this is true only for
26661 \begin_inset Quotes eld
26665 \begin_inset Quotes erd
26668 insets (insets you can type into) and is not true for
26669 \begin_inset Quotes eld
26673 \begin_inset Quotes erd
26676 insets (insets that are associated with dialog boxes).
26681 Here, too, \SpecialChar LyX
26682 tries to provide sensible defaults, and it constructs default
26684 But everything can be customized.
26687 \begin_layout Standard
26688 The XHTML \SpecialChar LyX
26689 outputs for an inset has the following form:
26692 \begin_layout LyX-Code
26694 \begin_inset Quotes erd
26698 \begin_inset Quotes erd
26704 \begin_layout LyX-Code
26705 <labeltag>Label</labeltag>
26708 \begin_layout LyX-Code
26710 \begin_inset Quotes erd
26714 \begin_inset Quotes erd
26717 >Contents of the inset.</innertag>
26720 \begin_layout LyX-Code
26724 \begin_layout Standard
26725 If the inset permits multiple paragraphs—that is, if
26726 \begin_inset Flex Code
26729 \begin_layout Plain Layout
26735 is true—then the contents of the inset will itself be output as paragraphs
26736 formatted according to the styles used for those paragraphs (standard,
26737 quote, and the like).
26738 The label tag is of course omitted if the paragraph does not have a label
26739 and, at present, is always
26740 \begin_inset Flex Code
26743 \begin_layout Plain Layout
26750 The inner tag is optional and, by default, does not appear.
26753 \begin_layout Standard
26754 The specific tags and attributes output for each inset can be controlled
26755 by means of the following layout tags.
26758 \begin_layout Description
26759 \begin_inset Flex Code
26762 \begin_layout Plain Layout
26769 \begin_inset Flex Code
26772 \begin_layout Plain Layout
26778 ] Specifies attribute information to be output with the main tag.
26780 \begin_inset Quotes eld
26784 \begin_inset Flex Code
26787 \begin_layout Plain Layout
26788 class=`myinset' onclick=`\SpecialChar ldots
26795 \begin_inset Quotes erd
26799 By default, \SpecialChar LyX
26801 \begin_inset Quotes eld
26805 \begin_inset Flex Code
26808 \begin_layout Plain Layout
26815 \begin_inset Quotes erd
26819 \begin_inset Flex Code
26822 \begin_layout Plain Layout
26828 is the \SpecialChar LyX
26829 name of the inset, made lowercase and with non-alphanumeric characters
26830 converted to underscores, for example: footnote.
26833 \begin_layout Description
26834 \begin_inset Flex Code
26837 \begin_layout Plain Layout
26844 \begin_inset Flex Code
26847 \begin_layout Plain Layout
26857 ] Whether to output the default CSS information \SpecialChar LyX
26858 generates for this layout,
26859 even if additional information is explicitly provided via
26860 \begin_inset Flex Code
26863 \begin_layout Plain Layout
26871 \begin_inset Flex Code
26874 \begin_layout Plain Layout
26880 allows you to alter or augment the generated CSS, rather than to override
26885 \begin_layout Description
26886 \begin_inset Flex Code
26889 \begin_layout Plain Layout
26896 \begin_inset Flex Code
26899 \begin_layout Plain Layout
26905 ] Attributes for the inner tag.
26907 \begin_inset Newline newline
26911 \begin_inset Quotes eld
26915 \begin_inset Flex Code
26918 \begin_layout Plain Layout
26919 class=`insetname_inner'
26925 \begin_inset Quotes erd
26931 \begin_layout Description
26932 \begin_inset Flex Code
26935 \begin_layout Plain Layout
26942 \begin_inset Flex Code
26945 \begin_layout Plain Layout
26951 ] The inner tag, replacing
26952 \begin_inset Flex Code
26955 \begin_layout Plain Layout
26961 in the examples above.
26962 By default, there is none.
26965 \begin_layout Description
26966 \begin_inset Flex Code
26969 \begin_layout Plain Layout
26976 \begin_inset Flex Code
26979 \begin_layout Plain Layout
26987 ] Whether this inset represents a standalone block of text (such as a footnote)
26988 or instead represents material that is included in the surrounding text
26989 (such as a branch).
26993 \begin_layout Description
26994 \begin_inset Flex Code
26997 \begin_layout Plain Layout
27004 \begin_inset Flex Code
27007 \begin_layout Plain Layout
27013 ] A label for this inset, possibly including a reference to a counter.
27014 For example, for footnote, it might be:
27015 \begin_inset Flex Code
27018 \begin_layout Plain Layout
27027 This is optional, and there is no default.
27030 \begin_layout Description
27031 \begin_inset Flex Code
27034 \begin_layout Plain Layout
27040 Information to be output in the
27041 \begin_inset Flex Code
27044 \begin_layout Plain Layout
27050 section when this style is used.
27051 This might, for example, be used to include a
27052 \begin_inset Flex Code
27055 \begin_layout Plain Layout
27062 \begin_inset Flex Code
27065 \begin_layout Plain Layout
27074 \begin_layout Description
27075 \begin_inset Flex Code
27078 \begin_layout Plain Layout
27084 CSS style information to be included when this style is used.
27085 Note that this will automatically be wrapped in a layout-generated
27086 \begin_inset Flex Code
27089 \begin_layout Plain Layout
27095 block, so only the CSS itself need be included.
27098 \begin_layout Description
27099 \begin_inset Flex Code
27102 \begin_layout Plain Layout
27109 \begin_inset Flex Code
27112 \begin_layout Plain Layout
27118 ] The tag to be used for the main label, replacing
27119 \begin_inset Flex Code
27122 \begin_layout Plain Layout
27128 in the examples above.
27129 The default depends upon the setting of
27130 \begin_inset Flex Code
27133 \begin_layout Plain Layout
27140 \begin_inset Flex Code
27143 \begin_layout Plain Layout
27149 is true, the default is
27150 \begin_inset Flex Code
27153 \begin_layout Plain Layout
27159 ; if it is false, the default is
27160 \begin_inset Flex Code
27163 \begin_layout Plain Layout
27172 \begin_layout Subsection
27176 \begin_layout Standard
27177 The XHTML output for floats too can be controlled by layout information.
27178 The output has the following form:
27181 \begin_layout LyX-Code
27183 \begin_inset Quotes erd
27187 \begin_inset Quotes erd
27193 \begin_layout LyX-Code
27194 Contents of the float.
27197 \begin_layout LyX-Code
27201 \begin_layout Standard
27202 The caption, if there is one, is a separate inset and will be output as
27204 Its appearance can be controlled via the InsetLayout for caption insets.
27208 \begin_layout Description
27209 \begin_inset Flex Code
27212 \begin_layout Plain Layout
27219 \begin_inset Flex Code
27222 \begin_layout Plain Layout
27228 ] Specifies attribute information to be output with the main tag.
27230 \begin_inset Quotes eld
27234 \begin_inset Flex Code
27237 \begin_layout Plain Layout
27238 class=`myfloat' onclick=`\SpecialChar ldots
27245 \begin_inset Quotes erd
27249 By default, \SpecialChar LyX
27251 \begin_inset Quotes eld
27255 \begin_inset Flex Code
27258 \begin_layout Plain Layout
27259 class=`float float-floattype'
27265 \begin_inset Quotes erd
27269 \begin_inset Flex Code
27272 \begin_layout Plain Layout
27278 is \SpecialChar LyX
27279 's name for this type of float, as determined by the float declaration
27281 \begin_inset CommandInset ref
27283 reference "subsec:Floats"
27287 ), though made lowercase and with non-alphanumeric characters converted
27288 to underscores, for example: float-table.
27291 \begin_layout Description
27292 \begin_inset Flex Code
27295 \begin_layout Plain Layout
27301 CSS style information to be included when this float is used.
27302 Note that this will automatically be wrapped in a layout-generated
27303 \begin_inset Flex Code
27306 \begin_layout Plain Layout
27312 block, so only the CSS itself need be included.
27315 \begin_layout Description
27316 \begin_inset Flex Code
27319 \begin_layout Plain Layout
27326 \begin_inset Flex Code
27329 \begin_layout Plain Layout
27335 ] The tag to be used for this float, replacing
27336 \begin_inset Quotes eld
27340 \begin_inset Flex Code
27343 \begin_layout Plain Layout
27350 \begin_inset Quotes erd
27353 in the example above.
27355 \begin_inset Flex Code
27358 \begin_layout Plain Layout
27364 and will rarely need changing.
27367 \begin_layout Subsection
27368 Bibliography formatting
27371 \begin_layout Standard
27372 The bibliography can be formatted using
27373 \begin_inset Flex Code
27376 \begin_layout Plain Layout
27384 \begin_inset CommandInset ref
27386 reference "subsec:Citation-format-description"
27393 \begin_layout Subsection
27398 \begin_layout Standard
27399 We have several times mentioned that \SpecialChar LyX
27400 will generate default CSS style rules
27401 for both insets and paragraph styles, based upon the other layout information
27403 In this section, we shall say a word about which layout information \SpecialChar LyX
27408 \begin_layout Standard
27409 At present, \SpecialChar LyX
27410 auto-generates CSS only for font information, making use of
27412 \begin_inset Flex Code
27415 \begin_layout Plain Layout
27422 \begin_inset Flex Code
27425 \begin_layout Plain Layout
27432 \begin_inset Flex Code
27435 \begin_layout Plain Layout
27442 \begin_inset Flex Code
27445 \begin_layout Plain Layout
27452 \begin_inset Flex Code
27455 \begin_layout Plain Layout
27462 \begin_inset CommandInset ref
27464 reference "subsec:Font-description"
27469 The translation is mostly straightforward and obvious.
27471 \begin_inset Quotes eld
27475 \begin_inset Flex Code
27478 \begin_layout Plain Layout
27485 \begin_inset Quotes erd
27489 \begin_inset Quotes eld
27493 \begin_inset Flex Code
27496 \begin_layout Plain Layout
27497 font-family: sans-serif;
27503 \begin_inset Quotes erd
27507 The correspondence of \SpecialChar LyX
27508 sizes and CSS sizes is a little less obvious but
27509 nonetheless intuitive.
27511 \begin_inset Flex Code
27514 \begin_layout Plain Layout
27521 \begin_inset Flex URL
27524 \begin_layout Plain Layout
27532 \change_inserted -970929547 1496610908
27536 \begin_layout Section
27538 \change_inserted -970929547 1496610966
27539 \begin_inset CommandInset label
27541 name "sec:Tags-for-DocBook"
27545 Tags for DocBook output
27548 \begin_layout Standard
27550 \change_inserted -970929547 1496611615
27551 As with \SpecialChar LaTeX
27552 or XHTML, the format of \SpecialChar LyX
27553 's DocBook output is also controlled by
27554 layout information.
27555 In general, \SpecialChar LyX
27556 provides sensible defaults; however, much of the styling is
27557 lost during the conversion, as DocBook is strictly semantic and does not
27559 When possible, information from \SpecialChar LyX
27560 will be rendered in
27568 \begin_layout Standard
27570 \change_inserted -970929547 1496612080
27571 In many cases, then, you may not have to do anything at all to get acceptable
27572 DocBook output for your own environments, custom insets, and so forth.
27573 But in some cases you will, and so \SpecialChar LyX
27574 provides a number of layout tags that
27575 can be used to customize the DocBook that is generated.
27578 \begin_layout Standard
27580 \change_inserted -970929547 1515109912
27581 Labels are rarely output, as they are redundant in DocBook: this information
27582 is carried by the tags themselves, and whether labels appear in the final
27583 documents (after processing of DocBook files) is controlled by the stylesheets.
27584 However, sometimes, labels are not redundant content, such as definition
27585 lists: in this case, the term being defined will be the label.
27589 \begin_layout Subsection
27591 \change_inserted 1075283030 1597699417
27592 \begin_inset CommandInset label
27594 name "subsec:Paragraph-Style-DocBook"
27599 \change_deleted 1075283030 1597699417
27601 \begin_inset CommandInset label
27603 name "subsec:Paragraph-Style-XHTML-1"
27608 \change_inserted -970929547 1496610966
27612 \begin_layout Standard
27614 \change_inserted -970929547 1496612059
27615 The sort of DocBook \SpecialChar LyX
27616 outputs for a paragraph depends upon whether we are
27617 dealing with a normal paragraph, a command, or an environment, where this
27618 is itself determined by the contents of the corresponding
27619 \begin_inset Flex Code
27622 \begin_layout Plain Layout
27624 \change_inserted -970929547 1496610966
27637 \begin_layout Standard
27639 \change_inserted -970929547 1496612107
27640 For a command or normal paragraph, the output DocBook has the following
27644 \begin_layout LyX-Code
27646 \change_inserted -970929547 1515109666
27650 \begin_layout LyX-Code
27652 \change_inserted -970929547 1496610966
27653 Contents of the paragraph.
27656 \begin_layout LyX-Code
27658 \change_inserted -970929547 1496610966
27662 \begin_layout Standard
27664 \change_inserted -970929547 1515109821
27665 For an environment that is not some sort of list, the generated DocBook
27669 \begin_layout LyX-Code
27671 \change_inserted -970929547 1515109671
27675 \begin_layout LyX-Code
27677 \change_inserted -970929547 1496612114
27678 <itemtag>First paragraph.</itemtag>
27681 \begin_layout LyX-Code
27683 \change_inserted -970929547 1496610966
27684 <itemtag>Second paragraph.</itemtag>
27687 \begin_layout LyX-Code
27689 \change_inserted -970929547 1496610966
27693 \begin_layout Standard
27695 \change_inserted -970929547 1515109825
27696 For a list, the resulting DocBook takes this form:
27699 \begin_layout LyX-Code
27701 \change_inserted -970929547 1515109672
27705 \begin_layout LyX-Code
27707 \change_inserted -970929547 1515109676
27708 <itemtag attr>First item.</itemtag>
27711 \begin_layout LyX-Code
27713 \change_inserted -970929547 1515109678
27714 <itemtag attr>Second item.</itemtag>
27717 \begin_layout LyX-Code
27719 \change_inserted -970929547 1496610966
27723 \begin_layout Standard
27725 \change_inserted -970929547 1496612243
27726 The specific tags and roles output for each paragraph type can be controlled
27727 by means of the layout tags we are about to describe.
27728 Please note that, due to the very nature of DocBook, no sensible defaults
27729 really exist, and the values must always be carefully chosen.
27733 \begin_layout Description
27735 \change_inserted -970929547 1515110057
27736 \begin_inset Flex Code
27739 \begin_layout Plain Layout
27741 \change_inserted -970929547 1515109656
27750 \begin_inset Flex Code
27753 \begin_layout Plain Layout
27755 \change_inserted -970929547 1496610966
27763 ] Specifies attribute information to be output with the main tag, replacing
27765 \begin_inset Quotes eld
27769 \begin_inset Flex Code
27772 \begin_layout Plain Layout
27774 \change_inserted -970929547 1515110057
27783 \begin_inset Quotes erd
27786 in the example above.
27787 This information can be used in further processing of the DocBook files.
27793 \begin_layout Description
27795 \change_inserted -970929547 1496612296
27796 \begin_inset Flex Code
27799 \begin_layout Plain Layout
27801 \change_inserted -970929547 1496612269
27810 \begin_inset Flex Code
27813 \begin_layout Plain Layout
27815 \change_inserted -970929547 1496610966
27823 ] The tag to be used for this inset, replacing
27824 \begin_inset Quotes eld
27828 \begin_inset Flex Code
27831 \begin_layout Plain Layout
27833 \change_inserted -970929547 1496612296
27842 \begin_inset Quotes erd
27845 in the example above.
27846 The default is the name of the float and always needs to be changed, as
27847 DocBook provides no generic tag.
27848 \change_inserted 1075283030 1597698868
27852 \begin_layout Description
27854 \change_inserted 1075283030 1597699399
27855 \begin_inset Flex Code
27858 \begin_layout Plain Layout
27860 \change_inserted 1075283030 1597698872
27869 \begin_inset Flex Code
27872 \begin_layout Plain Layout
27874 \change_inserted 1075283030 1597700585
27875 block, paragraph, inline
27882 ] The new-line policy for this tag, see Section
27883 \begin_inset space ~
27887 \begin_inset CommandInset ref
27889 reference "subsec:DocBook-New-line-policy"
27902 \begin_layout Subsection
27904 \change_inserted 1075283030 1597699385
27906 \begin_inset CommandInset label
27908 name "subsec:DocBook-New-line-policy"
27915 \begin_layout Standard
27917 \change_inserted 1075283030 1597698993
27918 For all tags, there are three possible policies for outputting new lines
27920 \begin_inset Flex Code
27923 \begin_layout Plain Layout
27925 \change_inserted 1075283030 1597698987
27936 \begin_layout Itemize
27938 \change_inserted 1075283030 1597699279
27939 \begin_inset Quotes eld
27943 \begin_inset Flex Code
27946 \begin_layout Plain Layout
27948 \change_inserted 1075283030 1597699012
27957 \begin_inset Quotes erd
27960 : the opening and closing tags are on their own lines (i.e.
27961 a line feed after and before the opening and the closing tags).
27962 Typical elements are floats.
27966 \begin_layout LyX-Code
27968 \change_inserted 1075283030 1597699194
27972 \begin_layout LyX-Code
27974 \change_inserted 1075283030 1597699194
27978 \begin_layout LyX-Code
27980 \change_inserted 1075283030 1597699098
27981 Contents of the block.
27984 \begin_layout LyX-Code
27986 \change_inserted 1075283030 1597699196
27990 \begin_layout LyX-Code
27992 \change_inserted 1075283030 1597699198
27996 \begin_layout Itemize
27998 \change_inserted 1075283030 1597699289
27999 \begin_inset Quotes eld
28003 \begin_inset Flex Code
28006 \begin_layout Plain Layout
28008 \change_inserted 1075283030 1597699113
28017 \begin_inset Quotes erd
28020 : the opening and closing tags are on the same, new line; a line feed is
28021 output before the opening tag and after the closing tag.
28022 Typical elements are paragraphs and list items.
28026 \begin_layout LyX-Code
28028 \change_inserted 1075283030 1597699186
28032 \begin_layout LyX-Code
28034 \change_inserted 1075283030 1597699357
28035 <paratag>Contents of the paragraph.</paratag>
28038 \begin_layout LyX-Code
28040 \change_inserted 1075283030 1597699231
28044 \begin_layout Itemize
28046 \change_inserted 1075283030 1597699343
28047 \begin_inset Quotes eld
28051 \begin_inset Flex Code
28054 \begin_layout Plain Layout
28056 \change_inserted 1075283030 1597699307
28065 \begin_inset Quotes erd
28068 : the opening and closing tags are on the same line as the rest of the content.
28069 No line feeds are output.
28070 Typical elements are fonts.
28074 \begin_layout LyX-Code
28076 \change_inserted 1075283030 1597699585
28077 Content before<inlinetag>Contents of the paragraph.</inlinetag>Content after
28080 \begin_layout Standard
28082 \change_inserted 1075283030 1597699585
28083 The default value is always
28084 \begin_inset Quotes eld
28088 \begin_inset Flex Code
28091 \begin_layout Plain Layout
28093 \change_inserted 1075283030 1597699585
28102 \begin_inset Quotes erd
28110 \begin_layout Subsection
28112 \change_inserted -970929547 1515111533
28113 InsetLayout DocBook
28118 \begin_layout Standard
28120 \change_inserted -970929547 1496611894
28121 The DocBook output of insets can also be controlled by information in layout
28125 \begin_layout Standard
28127 \change_inserted -970929547 1496612045
28128 The DocBook \SpecialChar LyX
28129 outputs for an inset has the following form:
28132 \begin_layout LyX-Code
28134 \change_inserted -970929547 1515110861
28135 <wrappertag wrapperattr>
28138 \begin_layout LyX-Code
28140 \change_inserted -970929547 1515110868
28144 \begin_layout LyX-Code
28146 \change_inserted -970929547 1515110869
28147 <innertag innerattr>
28150 \begin_layout LyX-Code
28152 \change_inserted -970929547 1515110869
28153 Contents of the inset.
28156 \begin_layout LyX-Code
28158 \change_inserted -970929547 1515110870
28162 \begin_layout LyX-Code
28164 \change_inserted -970929547 1515110871
28168 \begin_layout LyX-Code
28170 \change_inserted -970929547 1515111172
28174 \begin_layout Standard
28176 \change_inserted -970929547 1515111186
28177 For an itemising inset, it rather looks like this:
28180 \begin_layout LyX-Code
28182 \change_inserted -970929547 1515111186
28183 <wrappertag wrapperattr>
28186 \begin_layout LyX-Code
28188 \change_inserted -970929547 1515111186
28192 \begin_layout LyX-Code
28194 \change_inserted -970929547 1515111186
28195 <innertag innerattr>
28198 \begin_layout LyX-Code
28200 \change_inserted -970929547 1515111362
28201 <itemwrappertag itemwrapperattr>
28204 \begin_layout LyX-Code
28206 \change_inserted -970929547 1515111364
28207 <itemlabeltag itemattr>
28210 \begin_layout LyX-Code
28212 \change_inserted -970929547 1515111367
28213 Label of the first item.
28216 \begin_layout LyX-Code
28218 \change_inserted -970929547 1515111362
28224 \begin_layout LyX-Code
28226 \change_inserted -970929547 1515111517
28230 \begin_layout LyX-Code
28232 \change_inserted -970929547 1515111517
28238 \begin_layout LyX-Code
28240 \change_inserted -970929547 1515111516
28241 Contents of the first item.
28244 \begin_layout LyX-Code
28246 \change_inserted -970929547 1515111514
28252 \begin_layout LyX-Code
28254 \change_inserted -970929547 1515111247
28260 \begin_layout LyX-Code
28262 \change_inserted -970929547 1515111221
28266 \begin_layout LyX-Code
28268 \change_inserted -970929547 1515111370
28269 <itemwrappertag itemwrapperattr>
28272 \begin_layout LyX-Code
28274 \change_inserted -970929547 1515111370
28275 <itemlabeltag itemattr>
28278 \begin_layout LyX-Code
28280 \change_inserted -970929547 1515111372
28281 Label of the second item.
28284 \begin_layout LyX-Code
28286 \change_inserted -970929547 1515111370
28292 \begin_layout LyX-Code
28294 \change_inserted -970929547 1515111504
28298 \begin_layout LyX-Code
28300 \change_inserted -970929547 1515111505
28306 \begin_layout LyX-Code
28308 \change_inserted -970929547 1515111507
28309 Contents of the second item.
28312 \begin_layout LyX-Code
28314 \change_inserted -970929547 1515111509
28320 \begin_layout LyX-Code
28322 \change_inserted -970929547 1515111251
28328 \begin_layout LyX-Code
28330 \change_inserted -970929547 1515111221
28336 \begin_layout LyX-Code
28338 \change_inserted -970929547 1515111219
28344 \begin_layout LyX-Code
28346 \change_inserted -970929547 1515111186
28350 \begin_layout LyX-Code
28352 \change_inserted -970929547 1515111186
28356 \begin_layout LyX-Code
28358 \change_inserted -970929547 1515111186
28362 \begin_layout Standard
28364 \change_inserted -970929547 1515111183
28365 If the inset permits multiple paragraphs—that is, if
28366 \begin_inset Flex Code
28369 \begin_layout Plain Layout
28371 \change_inserted -970929547 1496610966
28379 is true—then the contents of the inset will itself be output as paragraphs
28380 formatted according to the styles used for those paragraphs (standard,
28381 quote, and the like).
28382 The inner tag is optional and, by default, does not appear.
28385 \begin_layout Standard
28387 \change_inserted -970929547 1496610966
28388 The specific tags and attributes output for each inset can be controlled
28389 by means of the following layout tags.
28392 \begin_layout Description
28394 \change_inserted -970929547 1515110317
28395 \begin_inset Flex Code
28398 \begin_layout Plain Layout
28400 \change_inserted -970929547 1515109695
28409 \begin_inset Flex Code
28412 \begin_layout Plain Layout
28414 \change_inserted -970929547 1496611854
28422 ] Specifies attribute information to be output with the main tag, replacing
28424 \begin_inset Quotes eld
28428 \begin_inset Flex Code
28431 \begin_layout Plain Layout
28433 \change_inserted -970929547 1515110044
28442 \begin_inset Quotes erd
28445 in the example above.
28446 This information can be used in further processing of the DocBook files.
28450 \begin_layout Description
28452 \change_inserted -970929547 1515110973
28453 \begin_inset Flex Code
28456 \begin_layout Plain Layout
28458 \change_inserted -970929547 1515110319
28467 \begin_inset Flex Code
28470 \begin_layout Plain Layout
28472 \change_inserted -970929547 1515110384
28473 never, always, maybe
28480 ] Specifies whether this tag goes into the
28481 \begin_inset Flex Code
28484 \begin_layout Plain Layout
28486 \change_inserted -970929547 1515110412
28494 tag at the beginning of the parent layout.
28496 \begin_inset Flex Code
28499 \begin_layout Plain Layout
28501 \change_inserted -970929547 1515110437
28509 indicates that the tag never goes into
28510 \begin_inset Flex Code
28513 \begin_layout Plain Layout
28515 \change_inserted -970929547 1515110497
28523 (this is default value, and corresponds to usual content).
28525 \begin_inset Flex Code
28528 \begin_layout Plain Layout
28530 \change_inserted -970929547 1515110517
28538 indicates that the tag always goes into
28539 \begin_inset Flex Code
28542 \begin_layout Plain Layout
28544 \change_inserted -970929547 1515110514
28552 (this corresponds to usual metadata): if there is no
28553 \begin_inset Flex Code
28556 \begin_layout Plain Layout
28558 \change_inserted -970929547 1515110550
28566 tag for the parent, one
28572 \begin_inset Flex Code
28575 \begin_layout Plain Layout
28577 \change_inserted -970929547 1515110540
28585 indicates that the tag may go into
28586 \begin_inset Flex Code
28589 \begin_layout Plain Layout
28591 \change_inserted -970929547 1515110538
28599 (this is only the case for titles): if there is no
28600 \begin_inset Flex Code
28603 \begin_layout Plain Layout
28605 \change_inserted -970929547 1515110585
28613 tag for the parent,
28617 will be generated, the corresponding tag will be output directly as content.
28621 \begin_layout Description
28623 \change_inserted -970929547 1515111461
28624 \begin_inset Flex Code
28627 \begin_layout Plain Layout
28629 \change_inserted -970929547 1515110974
28638 \begin_inset Flex Code
28641 \begin_layout Plain Layout
28643 \change_inserted -970929547 1515110973
28651 ] Specifies attribute information to be output with the item tag, replacing
28653 \begin_inset Quotes eld
28657 \begin_inset Flex Code
28660 \begin_layout Plain Layout
28662 \change_inserted -970929547 1515110984
28671 \begin_inset Quotes erd
28674 in the example above.
28675 This information can be used in further processing of the DocBook files.
28679 \begin_layout Description
28681 \change_inserted -970929547 1515111471
28682 \begin_inset Flex Code
28685 \begin_layout Plain Layout
28687 \change_inserted -970929547 1515111465
28688 DocBookItemInnerAttr
28696 \begin_inset Flex Code
28699 \begin_layout Plain Layout
28701 \change_inserted -970929547 1515111461
28709 ] Specifies attribute information to be output with the item inner tag,
28711 \begin_inset Quotes eld
28715 \begin_inset Flex Code
28718 \begin_layout Plain Layout
28720 \change_inserted -970929547 1515111476
28729 \begin_inset Quotes erd
28732 in the example above.
28733 This information can be used in further processing of the DocBook files.
28737 \begin_layout Description
28739 \change_inserted -970929547 1515111494
28740 \begin_inset Flex Code
28743 \begin_layout Plain Layout
28745 \change_inserted -970929547 1515111467
28746 DocBookItemInnerTag
28754 \begin_inset Flex Code
28757 \begin_layout Plain Layout
28759 \change_inserted -970929547 1515111461
28767 ] The tag to be used for the item inner tag within the inset, replacing
28769 \begin_inset Quotes eld
28773 \begin_inset Flex Code
28776 \begin_layout Plain Layout
28778 \change_inserted -970929547 1515111486
28787 \begin_inset Quotes erd
28790 in the example above.
28792 \begin_inset Flex Code
28795 \begin_layout Plain Layout
28797 \change_inserted -970929547 1515111461
28805 , indicating that there is no item inner tag: content is directly output
28806 without it for each itemised element.
28807 This parameter only makes sense when itemising layouts are used, such as
28810 \change_inserted 1075283030 1598469472
28811 The most likely value is
28812 \begin_inset Quotes eld
28816 \begin_inset Flex Code
28819 \begin_layout Plain Layout
28821 \change_inserted 1075283030 1598469476
28830 \begin_inset Quotes erd
28834 \begin_inset Newline newline
28837 When a list item is split using a new line, the item inner tag will be repeated
28838 for each part of the paragraph, parts being separated by new lines.
28842 \begin_layout Description
28844 \change_inserted 1075283030 1597699866
28845 \begin_inset Flex Code
28848 \begin_layout Plain Layout
28850 \change_inserted 1075283030 1597699853
28851 DocBookItemInnerTagType
28859 \begin_inset Flex Code
28862 \begin_layout Plain Layout
28864 \change_inserted 1075283030 1597699866
28865 block, paragraph, inline
28872 ] The new-line policy for this tag, see Section
28873 \begin_inset space ~
28877 \begin_inset CommandInset ref
28879 reference "subsec:DocBook-New-line-policy"
28892 \begin_layout Description
28894 \change_inserted -970929547 1515111290
28895 \begin_inset Flex Code
28898 \begin_layout Plain Layout
28900 \change_inserted -970929547 1515111283
28901 DocBookItemLabelAttr
28909 \begin_inset Flex Code
28912 \begin_layout Plain Layout
28914 \change_inserted -970929547 1515111279
28922 ] Specifies attribute information to be output with the item label tag,
28924 \begin_inset Quotes eld
28928 \begin_inset Flex Code
28931 \begin_layout Plain Layout
28933 \change_inserted -970929547 1515111304
28942 \begin_inset Quotes erd
28945 in the example above.
28946 This information can be used in further processing of the DocBook files.
28950 \begin_layout Description
28952 \change_inserted -970929547 1515111337
28953 \begin_inset Flex Code
28956 \begin_layout Plain Layout
28958 \change_inserted -970929547 1515111285
28959 DocBookItemLabelTag
28967 \begin_inset Flex Code
28970 \begin_layout Plain Layout
28972 \change_inserted -970929547 1515111279
28980 ] The tag to be used for the item label tag within the inset, replacing
28982 \begin_inset Quotes eld
28986 \begin_inset Flex Code
28989 \begin_layout Plain Layout
28991 \change_inserted -970929547 1515111311
29000 \begin_inset Quotes erd
29003 in the example above.
29004 This parameter only makes sense when itemising layouts are used with a
29005 notion of labels, such as definition lists.
29007 \change_inserted 1075283030 1597699874
29011 \begin_layout Description
29013 \change_inserted 1075283030 1597699874
29014 \begin_inset Flex Code
29017 \begin_layout Plain Layout
29019 \change_inserted 1075283030 1597699880
29020 DocBookItemLabelTagType
29028 \begin_inset Flex Code
29031 \begin_layout Plain Layout
29033 \change_inserted 1075283030 1597699874
29034 block, paragraph, inline
29041 ] The new-line policy for this tag, see Section
29042 \begin_inset space ~
29046 \begin_inset CommandInset ref
29048 reference "subsec:DocBook-New-line-policy"
29061 \begin_layout Description
29063 \change_inserted -970929547 1515111124
29064 \begin_inset Flex Code
29067 \begin_layout Plain Layout
29069 \change_inserted -970929547 1515111060
29078 \begin_inset Flex Code
29081 \begin_layout Plain Layout
29083 \change_inserted -970929547 1515111060
29091 ] The tag to be used for the item tag within the inset, replacing
29092 \begin_inset Quotes eld
29096 \begin_inset Flex Code
29099 \begin_layout Plain Layout
29101 \change_inserted -970929547 1515111060
29110 \begin_inset Quotes erd
29113 in the example above.
29115 \begin_inset Flex Code
29118 \begin_layout Plain Layout
29120 \change_inserted -970929547 1515111060
29128 , indicating that there is no item tag.
29129 This parameter only makes sense when itemising layouts are used, such as
29132 \change_inserted 1075283030 1597699890
29136 \begin_layout Description
29138 \change_inserted 1075283030 1597699890
29139 \begin_inset Flex Code
29142 \begin_layout Plain Layout
29144 \change_inserted 1075283030 1597699890
29153 \begin_inset Flex Code
29156 \begin_layout Plain Layout
29158 \change_inserted 1075283030 1597699890
29159 block, paragraph, inline
29166 ] The new-line policy for this tag, see Section
29167 \begin_inset space ~
29171 \begin_inset CommandInset ref
29173 reference "subsec:DocBook-New-line-policy"
29186 \begin_layout Description
29188 \change_inserted -970929547 1515111298
29189 \begin_inset Flex Code
29192 \begin_layout Plain Layout
29194 \change_inserted -970929547 1515111124
29195 DocBookItemWrapperAttr
29203 \begin_inset Flex Code
29206 \begin_layout Plain Layout
29208 \change_inserted -970929547 1515111124
29216 ] Specifies attribute information to be output with the item wrapper tag,
29218 \begin_inset Quotes eld
29222 \begin_inset Flex Code
29225 \begin_layout Plain Layout
29227 \change_inserted -970929547 1515111150
29236 \begin_inset Quotes erd
29239 in the example above.
29240 This information can be used in further processing of the DocBook files.
29246 \begin_layout Description
29248 \change_inserted -970929547 1515111113
29249 \begin_inset Flex Code
29252 \begin_layout Plain Layout
29254 \change_inserted -970929547 1515111073
29255 DocBookItemWrapperTag
29263 \begin_inset Flex Code
29266 \begin_layout Plain Layout
29268 \change_inserted -970929547 1515111073
29276 ] The tag to be used for the item wrapper tag within the inset, replacing
29278 \begin_inset Quotes eld
29282 \begin_inset Flex Code
29285 \begin_layout Plain Layout
29287 \change_inserted -970929547 1515111083
29296 \begin_inset Quotes erd
29299 in the example above.
29301 \begin_inset Flex Code
29304 \begin_layout Plain Layout
29306 \change_inserted -970929547 1515111073
29314 , indicating that there is no item wrapper tag: tag and content are directly
29315 output without it for each itemised element.
29316 This parameter only makes sense when itemising layouts are used, such as
29319 \change_inserted 1075283030 1597699897
29323 \begin_layout Description
29325 \change_inserted 1075283030 1597699897
29326 \begin_inset Flex Code
29329 \begin_layout Plain Layout
29331 \change_inserted 1075283030 1597699900
29332 DocBookItemWrapperTagType
29340 \begin_inset Flex Code
29343 \begin_layout Plain Layout
29345 \change_inserted 1075283030 1597699897
29346 block, paragraph, inline
29353 ] The new-line policy for this tag, see Section
29354 \begin_inset space ~
29358 \begin_inset CommandInset ref
29360 reference "subsec:DocBook-New-line-policy"
29373 \begin_layout Description
29375 \change_inserted -970929547 1515110104
29376 \begin_inset Flex Code
29379 \begin_layout Plain Layout
29381 \change_inserted -970929547 1515110104
29390 \begin_inset Flex Code
29393 \begin_layout Plain Layout
29395 \change_inserted -970929547 1515110104
29403 ] Specifies attribute information to be output with the inner tag, replacing
29405 \begin_inset Quotes eld
29409 \begin_inset Flex Code
29412 \begin_layout Plain Layout
29414 \change_inserted -970929547 1515110104
29423 \begin_inset Quotes erd
29426 in the example above.
29427 This information can be used in further processing of the DocBook files.
29431 \begin_layout Description
29433 \change_inserted -970929547 1515110906
29434 \begin_inset Flex Code
29437 \begin_layout Plain Layout
29439 \change_inserted -970929547 1515110104
29448 \begin_inset Flex Code
29451 \begin_layout Plain Layout
29453 \change_inserted -970929547 1515110104
29461 ] The tag to be used for the inner tag within the inset, replacing
29462 \begin_inset Quotes eld
29466 \begin_inset Flex Code
29469 \begin_layout Plain Layout
29471 \change_inserted -970929547 1515110104
29480 \begin_inset Quotes erd
29483 in the example above.
29485 \begin_inset Flex Code
29488 \begin_layout Plain Layout
29490 \change_inserted -970929547 1515110791
29498 , indicating that there is no inner tag: content is directly output without
29500 \change_inserted 1075283030 1597699904
29504 \begin_layout Description
29506 \change_inserted 1075283030 1597699904
29507 \begin_inset Flex Code
29510 \begin_layout Plain Layout
29512 \change_inserted 1075283030 1597699904
29513 DocBookInnerTagType
29521 \begin_inset Flex Code
29524 \begin_layout Plain Layout
29526 \change_inserted 1075283030 1597699904
29527 block, paragraph, inline
29534 ] The new-line policy for this tag, see Section
29535 \begin_inset space ~
29539 \begin_inset CommandInset ref
29541 reference "subsec:DocBook-New-line-policy"
29554 \begin_layout Description
29556 \change_inserted -970929547 1515110753
29557 \begin_inset Flex Code
29560 \begin_layout Plain Layout
29562 \change_inserted -970929547 1515110665
29571 \begin_inset Flex Code
29574 \begin_layout Plain Layout
29576 \change_inserted -970929547 1515110661
29584 ] Specifies the tag that corresponds to this kind of section.
29585 This parameter only makes sense for sectioning elements (part, chapter,
29587 The default value is
29588 \begin_inset Flex Code
29591 \begin_layout Plain Layout
29593 \change_inserted -970929547 1515110721
29601 , and is only overridden when DocBook uses something else for sectioning
29603 \change_inserted 1075283030 1597699921
29605 \change_inserted -970929547 1515110753
29606 parts and chapters of a book).
29612 \begin_layout Description
29614 \change_inserted -970929547 1515110811
29615 \begin_inset Flex Code
29618 \begin_layout Plain Layout
29620 \change_inserted -970929547 1496612023
29629 \begin_inset Flex Code
29632 \begin_layout Plain Layout
29634 \change_inserted -970929547 1496610966
29642 ] The tag to be used for this inset, replacing
29643 \begin_inset Quotes eld
29647 \begin_inset Flex Code
29650 \begin_layout Plain Layout
29652 \change_inserted -970929547 1496612033
29661 \begin_inset Quotes erd
29664 in the example above.
29665 The default is the name of the float and always needs to be changed, as
29666 DocBook provides no generic inset tag.
29667 \change_inserted 1075283030 1597699924
29671 \begin_layout Description
29673 \change_inserted 1075283030 1597699924
29674 \begin_inset Flex Code
29677 \begin_layout Plain Layout
29679 \change_inserted 1075283030 1597699924
29688 \begin_inset Flex Code
29691 \begin_layout Plain Layout
29693 \change_inserted 1075283030 1597699924
29694 block, paragraph, inline
29701 ] The new-line policy for this tag, see Section
29702 \begin_inset space ~
29706 \begin_inset CommandInset ref
29708 reference "subsec:DocBook-New-line-policy"
29721 \begin_layout Description
29723 \change_inserted -970929547 1515110832
29724 \begin_inset Flex Code
29727 \begin_layout Plain Layout
29729 \change_inserted -970929547 1515110822
29738 \begin_inset Flex Code
29741 \begin_layout Plain Layout
29743 \change_inserted -970929547 1515110811
29751 ] Specifies attribute information to be output with the outer tag, replacing
29753 \begin_inset Quotes eld
29757 \begin_inset Flex Code
29760 \begin_layout Plain Layout
29762 \change_inserted -970929547 1515110845
29771 \begin_inset Quotes erd
29774 in the example above.
29775 This information can be used in further processing of the DocBook files.
29779 \begin_layout Description
29781 \change_inserted -970929547 1515110917
29782 \begin_inset Flex Code
29785 \begin_layout Plain Layout
29787 \change_inserted -970929547 1515110826
29796 \begin_inset Flex Code
29799 \begin_layout Plain Layout
29801 \change_inserted -970929547 1515110811
29809 ] The tag to be used for the wrapper tag around the inset, replacing
29810 \begin_inset Quotes eld
29814 \begin_inset Flex Code
29817 \begin_layout Plain Layout
29819 \change_inserted -970929547 1515110842
29828 \begin_inset Quotes erd
29831 in the example above.
29833 \begin_inset Flex Code
29836 \begin_layout Plain Layout
29838 \change_inserted -970929547 1515110811
29846 , indicating that there is no wrapper tag: tag and content are directly
29848 \change_inserted 1075283030 1597699929
29852 \begin_layout Description
29854 \change_inserted 1075283030 1597699929
29855 \begin_inset Flex Code
29858 \begin_layout Plain Layout
29860 \change_inserted 1075283030 1597699932
29861 DocBookWrapperTagType
29869 \begin_inset Flex Code
29872 \begin_layout Plain Layout
29874 \change_inserted 1075283030 1597699929
29875 block, paragraph, inline
29882 ] The new-line policy for this tag, see Section
29883 \begin_inset space ~
29887 \begin_inset CommandInset ref
29889 reference "subsec:DocBook-New-line-policy"
29902 \begin_layout Subsection
29904 \change_inserted -970929547 1515110040
29908 \begin_layout Standard
29910 \change_inserted -970929547 1496611700
29911 The DocBook output for floats too can be controlled by layout information.
29912 The output has the following form:
29915 \begin_layout LyX-Code
29917 \change_inserted -970929547 1515109700
29921 \begin_layout LyX-Code
29923 \change_inserted -970929547 1515110138
29924 Contents of the float as DocBook.
29927 \begin_layout LyX-Code
29929 \change_inserted -970929547 1496610966
29933 \begin_layout Standard
29935 \change_inserted -970929547 1496611715
29936 The caption, if there is one, is a separate inset and will be output as
29941 \begin_layout Description
29943 \change_inserted -970929547 1515110033
29944 \begin_inset Flex Code
29947 \begin_layout Plain Layout
29949 \change_inserted -970929547 1515109702
29958 \begin_inset Flex Code
29961 \begin_layout Plain Layout
29963 \change_inserted -970929547 1496610966
29971 ] Specifies attribute information to be output with the main tag, replacing
29973 \begin_inset Quotes eld
29977 \begin_inset Flex Code
29980 \begin_layout Plain Layout
29982 \change_inserted -970929547 1515110035
29991 \begin_inset Quotes erd
29994 in the example above.
29995 This information can be used in further processing of the DocBook files.
29999 \begin_layout Description
30001 \change_inserted -970929547 1515110157
30002 \begin_inset Flex Code
30005 \begin_layout Plain Layout
30007 \change_inserted -970929547 1496611782
30016 \begin_inset Flex Code
30019 \begin_layout Plain Layout
30021 \change_inserted -970929547 1496610966
30029 ] The tag to be used for this float, replacing
30030 \begin_inset Quotes eld
30034 \begin_inset Flex Code
30037 \begin_layout Plain Layout
30039 \change_inserted -970929547 1496610966
30048 \begin_inset Quotes erd
30051 in the example above.
30052 The default is the name of the float and always needs to be changed, as
30053 DocBook provides no generic float tag.
30056 \begin_layout Subsection
30058 \change_inserted -970929547 1515110157
30059 Bibliography formatting
30062 \begin_layout Standard
30064 \change_deleted 1075283030 1597699984
30066 \change_inserted 1075283030 1597699985
30068 \change_inserted -970929547 1515110187
30070 \change_deleted 1075283030 1597699987
30072 \change_inserted 1075283030 1597699987
30074 \change_inserted -970929547 1515110187
30075 cannot be formatted: all fields are always output in the database-like
30076 DocBook format (equivalent to a BibTeX file)
30077 \change_inserted 1075283030 1597700117
30079 \begin_inset Flex Code
30082 \begin_layout Plain Layout
30084 \change_inserted 1075283030 1597700120
30093 \change_inserted -970929547 1515110187
30095 \change_inserted 1075283030 1597700092
30099 \begin_layout Standard
30101 \change_inserted 1075283030 1597700112
30102 When the bibliographic entries are manually inserted into the LyX document
30103 as Bibliography Items, the user deals with formatting themself: there is
30104 no attempt of parsing what the user wrote, the string is directly used
30106 \begin_inset Flex Code
30109 \begin_layout Plain Layout
30111 \change_inserted 1075283030 1597700076
30125 \begin_layout Chapter
30126 Including External Material
30127 \begin_inset CommandInset label
30129 name "chap:Including-External-Material"
30136 \begin_layout Standard
30137 \begin_inset Box Shadowbox
30147 height_special "totalheight"
30152 backgroundcolor "none"
30155 \begin_layout Plain Layout
30156 WARNING: This portion of the documentation has not been updated for some
30158 We certainly hope that it is still accurate, but there are no guarantees.
30166 \begin_layout Standard
30167 The use of material from sources external to \SpecialChar LyX
30168 is covered in detail in the
30174 This part of the manual covers what needs to happen behind the scenes for
30175 new sorts of material to be included.
30178 \begin_layout Section
30182 \begin_layout Standard
30183 The external material feature is based on the concept of a
30188 A template is a specification of how \SpecialChar LyX
30189 should interface with a certain kind
30191 As bundled, \SpecialChar LyX
30192 comes with predefined templates for Xfig figures, various
30193 raster format images, chess diagrams, and LilyPond music notation.
30194 You can check the actual list by using the menu
30195 \begin_inset Flex Noun
30198 \begin_layout Plain Layout
30199 Insert\SpecialChar menuseparator
30200 File\SpecialChar menuseparator
30207 Furthermore, it is possible to roll your own template to support a specific
30209 Later we'll describe in more detail what is involved, and hopefully you
30210 will submit all the templates you create so we can include them in a later
30215 \begin_layout Standard
30216 Another basic idea of the external material feature is to distinguish between
30217 the original file that serves as a base for final material and the produced
30218 file that is included in your exported or printed document.
30219 For example, consider the case of a figure produced with
30220 \begin_inset Flex Code
30223 \begin_layout Plain Layout
30230 The Xfig application itself works on an original file with the
30231 \begin_inset Flex Code
30234 \begin_layout Plain Layout
30241 Within Xfig, you create and change your figure, and when you are done,
30243 \begin_inset Flex Code
30246 \begin_layout Plain Layout
30253 When you want to include the figure in your document, you invoke
30254 \begin_inset Flex Code
30257 \begin_layout Plain Layout
30263 in order to create a PostScript file that can readily be included in your
30267 \begin_inset Flex Code
30270 \begin_layout Plain Layout
30276 file is the original file, and the PostScript file is the produced file.
30279 \begin_layout Standard
30280 This distinction is important in order to allow updating of the material
30281 while you are in the process of writing the document.
30282 Furthermore, it provides us with the flexibility that is needed to support
30283 multiple export formats.
30284 For instance, in the case of a plain text file, it is not exactly an award-winn
30285 ing idea to include the figure as raw PostScript.
30286 Instead, you would either prefer to just include a reference to the figure
30287 or try to invoke some graphics to ASCII converter to make the final result
30288 look similar to the real graphics.
30289 The external material management allows you to do this, because it is parametri
30290 zed on the different export formats that \SpecialChar LyX
30294 \begin_layout Standard
30295 Besides supporting the production of different products according to the
30296 exported format, it supports tight integration with editing and viewing
30298 In the case of an Xfig figure, you are able to invoke Xfig on the original
30299 file with a single click from within the external material dialog in \SpecialChar LyX
30301 and also preview the produced PostScript file with Ghostview with another
30303 No more fiddling around with the command line and/or file browsers to locate
30304 and manipulate the original or produced files.
30305 In this way, you are finally able to take full advantage of the many different
30306 applications that are relevant to use when you write your documents, and
30307 ultimately be more productive.
30310 \begin_layout Section
30311 The external template configuration files
30314 \begin_layout Standard
30315 It is relatively easy to add custom external template definitions to \SpecialChar LyX
30317 However, be aware that doing this in an careless manner most probably
30321 introduce an easily exploitable security hole.
30322 So before you do this, please read the discussion about security in
30323 \begin_inset CommandInset ref
30325 reference "sec:Security-discussion"
30332 \begin_layout Standard
30333 Having said that, we encourage you to submit any interesting templates that
30338 \begin_layout Standard
30339 The external templates are defined in the
30340 \begin_inset Flex Code
30343 \begin_layout Plain Layout
30349 files that are stored in the
30350 \begin_inset Flex Code
30353 \begin_layout Plain Layout
30354 LyXDir/lib/xtemplates/
30360 Each template is defined in a file of its own.
30361 You can place your own templates in
30362 \begin_inset Flex Code
30365 \begin_layout Plain Layout
30366 UserDir/xtemplates/
30371 or copy existing templates to that directory in order to modify them.
30374 \begin_layout Standard
30375 A typical template looks like this:
30378 \begin_layout LyX-Code
30382 \begin_layout LyX-Code
30383 GuiName "XFig: $$AbsOrRelPathParent$$Basename"
30386 \begin_layout LyX-Code
30390 \begin_layout LyX-Code
30394 \begin_layout LyX-Code
30398 \begin_layout LyX-Code
30402 \begin_layout LyX-Code
30406 \begin_layout LyX-Code
30407 AutomaticProduction true
30410 \begin_layout LyX-Code
30414 \begin_layout LyX-Code
30418 \begin_layout LyX-Code
30422 \begin_layout LyX-Code
30423 TransformCommand Rotate RotationLatexCommand
30426 \begin_layout LyX-Code
30427 TransformCommand Resize ResizeLatexCommand
30430 \begin_layout LyX-Code
30431 Product "$$RotateFront$$ResizeFront
30434 \begin_layout LyX-Code
30439 input{$$AbsOrRelPathMaster$$Basename.pstex_t}
30442 \begin_layout LyX-Code
30443 $$ResizeBack$$RotateBack"
30446 \begin_layout LyX-Code
30450 \begin_layout LyX-Code
30451 UpdateResult "$$AbsPath$$Basename.pstex_t"
30454 \begin_layout LyX-Code
30455 Requirement "graphicx"
30458 \begin_layout LyX-Code
30459 ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pstex_t"
30462 \begin_layout LyX-Code
30463 ReferencedFile latex "$$AbsPath$$Basename.eps"
30466 \begin_layout LyX-Code
30467 ReferencedFile dvi "$$AbsPath$$Basename.eps"
30470 \begin_layout LyX-Code
30474 \begin_layout LyX-Code
30478 \begin_layout LyX-Code
30479 TransformCommand Rotate RotationLatexCommand
30482 \begin_layout LyX-Code
30483 TransformCommand Resize ResizeLatexCommand
30486 \begin_layout LyX-Code
30487 Product "$$RotateFront$$ResizeFront
30490 \begin_layout LyX-Code
30495 input{$$AbsOrRelPathMaster$$Basename.pdftex_t}
30498 \begin_layout LyX-Code
30499 $$ResizeBack$$RotateBack"
30502 \begin_layout LyX-Code
30503 UpdateFormat pdftex
30506 \begin_layout LyX-Code
30507 UpdateResult "$$AbsPath$$Basename.pdftex_t"
30510 \begin_layout LyX-Code
30511 Requirement "graphicx"
30514 \begin_layout LyX-Code
30515 ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pdftex_t"
30518 \begin_layout LyX-Code
30519 ReferencedFile latex "$$AbsPath$$Basename.pdf"
30522 \begin_layout LyX-Code
30526 \begin_layout LyX-Code
30530 \begin_layout LyX-Code
30531 Product "[XFig: $$FName]"
30534 \begin_layout LyX-Code
30538 \begin_layout LyX-Code
30542 \begin_layout LyX-Code
30543 Product "<graphic fileref=
30545 "$$AbsOrRelPathMaster$$Basename.eps
30550 \begin_layout LyX-Code
30554 \begin_layout LyX-Code
30558 \begin_layout LyX-Code
30559 UpdateResult "$$AbsPath$$Basename.eps"
30562 \begin_layout LyX-Code
30563 ReferencedFile docbook "$$AbsPath$$Basename.eps"
30566 \begin_layout LyX-Code
30567 ReferencedFile docbook-xml "$$AbsPath$$Basename.eps"
30570 \begin_layout LyX-Code
30574 \begin_layout LyX-Code
30578 \begin_layout Standard
30579 As you can see, the template is enclosed in
30580 \begin_inset Flex Code
30583 \begin_layout Plain Layout
30591 \begin_inset Flex Code
30594 \begin_layout Plain Layout
30601 It contains a header specifying some general settings and, for each supported
30602 primary document file format, a section
30603 \begin_inset Flex Code
30606 \begin_layout Plain Layout
30614 \begin_inset Flex Code
30617 \begin_layout Plain Layout
30626 \begin_layout Subsection
30627 The template header
30630 \begin_layout Description
30631 \begin_inset Flex Code
30634 \begin_layout Plain Layout
30635 AutomaticProduction
30636 \begin_inset space ~
30644 Whether the file represented by the template must be generated by \SpecialChar LyX
30646 This command must occur exactly once.
30649 \begin_layout Description
30650 \begin_inset Flex Code
30653 \begin_layout Plain Layout
30655 \begin_inset space ~
30663 A glob pattern that is used in the file dialog to filter out the desired
30665 If there is more than one possible file extension (e.
30666 \begin_inset space \thinspace{}
30670 \begin_inset space \space{}
30674 \begin_inset Flex Code
30677 \begin_layout Plain Layout
30684 \begin_inset Flex Code
30687 \begin_layout Plain Layout
30693 ), use something like
30694 \begin_inset Flex Code
30697 \begin_layout Plain Layout
30704 This command must occur exactly once.
30707 \begin_layout Description
30708 \begin_inset Flex Code
30711 \begin_layout Plain Layout
30713 \begin_inset space ~
30721 The text that is displayed on the button.
30722 This command must occur exactly once.
30725 \begin_layout Description
30726 \begin_inset Flex Code
30729 \begin_layout Plain Layout
30731 \begin_inset space ~
30735 \begin_inset space ~
30743 The help text that is used in the External dialog.
30744 Provide enough information to explain to the user just what the template
30745 can provide him with.
30746 This command must occur exactly once.
30749 \begin_layout Description
30750 \begin_inset Flex Code
30753 \begin_layout Plain Layout
30755 \begin_inset space ~
30763 The file format of the original file.
30764 This must be the name of a format that is known to \SpecialChar LyX
30766 \begin_inset CommandInset ref
30768 reference "sec:Formats"
30774 \begin_inset Quotes eld
30778 \begin_inset Flex Code
30781 \begin_layout Plain Layout
30788 \begin_inset Quotes erd
30791 if the template can handle original files of more than one format.
30793 will attempt to interrogate the file itself in order to deduce its format
30795 This command must occur exactly once.
30798 \begin_layout Description
30799 \begin_inset Flex Code
30802 \begin_layout Plain Layout
30804 \begin_inset space ~
30812 A unique name for the template.
30813 It must not contain substitution macros (see below).
30816 \begin_layout Description
30817 \begin_inset Flex Code
30820 \begin_layout Plain Layout
30822 \begin_inset space ~
30825 Rotate|Resize|Clip|Extra
30830 This command specifies which transformations are supported by this template.
30831 It may occur zero or more times.
30832 This command enables the corresponding tabs in the external dialog.
30834 \begin_inset Flex Code
30837 \begin_layout Plain Layout
30843 command must have either a corresponding
30844 \begin_inset Flex Code
30847 \begin_layout Plain Layout
30854 \begin_inset Flex Code
30857 \begin_layout Plain Layout
30864 \begin_inset Flex Code
30867 \begin_layout Plain Layout
30874 Otherwise the transformation will not be supported by that format.
30877 \begin_layout Subsection
30881 \begin_layout Description
30882 \begin_inset Flex Code
30885 \begin_layout Plain Layout
30887 \begin_inset space ~
30890 LaTeX|PDFLaTeX|PlainText|DocBook|XHTML
30895 The primary document file format that this format definition is for.
30896 Not every template has a sensible representation in all document file formats.
30897 Please define nevertheless a
30898 \begin_inset Flex Code
30901 \begin_layout Plain Layout
30907 section for all templates.
30908 Use a dummy text when no representation is available.
30909 Then you can at least see a reference to the external material in the exported
30913 \begin_layout Description
30914 \begin_inset Flex Code
30917 \begin_layout Plain Layout
30919 \begin_inset space ~
30923 \begin_inset space ~
30931 This command defines an additional macro
30932 \begin_inset Flex Code
30935 \begin_layout Plain Layout
30941 for substitution in
30942 \begin_inset Flex Code
30945 \begin_layout Plain Layout
30953 \begin_inset Flex Code
30956 \begin_layout Plain Layout
30962 itself may contain substitution macros.
30963 The advantage over using
30964 \begin_inset Flex Code
30967 \begin_layout Plain Layout
30974 \begin_inset Flex Code
30977 \begin_layout Plain Layout
30983 is that the substituted value of
30984 \begin_inset Flex Code
30987 \begin_layout Plain Layout
30993 is sanitized so that it is a valid optional argument in the document format.
30994 This command may occur zero or more times.
30997 \begin_layout Description
30998 \begin_inset Flex Code
31001 \begin_layout Plain Layout
31003 \begin_inset space ~
31011 The text that is inserted in the exported document.
31012 This is actually the most important command and can be quite complex.
31013 This command must occur exactly once.
31016 \begin_layout Description
31017 \begin_inset Flex Code
31020 \begin_layout Plain Layout
31022 \begin_inset space ~
31030 This command specifies a preamble snippet that will be included in the
31033 It has to be defined using
31034 \begin_inset Flex Code
31037 \begin_layout Plain Layout
31045 \begin_inset Flex Code
31048 \begin_layout Plain Layout
31055 This command may occur zero or more times.
31058 \begin_layout Description
31059 \begin_inset Flex Code
31062 \begin_layout Plain Layout
31064 \begin_inset space ~
31068 \begin_inset space ~
31076 This command denotes files that are created by the conversion process and
31077 are needed for a particular export format.
31078 If the filename is relative, it is interpreted relative to the master document.
31079 This command may be given zero or more times.
31082 \begin_layout Description
31083 \begin_inset Flex Code
31086 \begin_layout Plain Layout
31088 \begin_inset space ~
31096 The name of a required \SpecialChar LaTeX
31098 The package is included via
31099 \begin_inset Flex Code
31102 \begin_layout Plain Layout
31110 in the \SpecialChar LaTeX
31112 This command may occur zero or more times.
31115 \begin_layout Description
31116 \begin_inset Flex Code
31119 \begin_layout Plain Layout
31121 \begin_inset space ~
31125 \begin_inset space ~
31128 RotationLatexCommand
31133 This command specifies that the built in \SpecialChar LaTeX
31134 command should be used for rotation.
31135 This command may occur once or not at all.
31138 \begin_layout Description
31139 \begin_inset Flex Code
31142 \begin_layout Plain Layout
31144 \begin_inset space ~
31148 \begin_inset space ~
31156 This command specifies that the built in \SpecialChar LaTeX
31157 command should be used for resizing.
31158 This command may occur once or not at all.
31161 \begin_layout Description
31162 \begin_inset Flex Code
31165 \begin_layout Plain Layout
31167 \begin_inset space ~
31171 \begin_inset space ~
31174 RotationLatexOption
31179 This command specifies that rotation is done via an optional argument.
31180 This command may occur once or not at all.
31183 \begin_layout Description
31184 \begin_inset Flex Code
31187 \begin_layout Plain Layout
31189 \begin_inset space ~
31193 \begin_inset space ~
31201 This command specifies that resizing is done via an optional argument.
31202 This command may occur once or not at all.
31205 \begin_layout Description
31206 \begin_inset Flex Code
31209 \begin_layout Plain Layout
31211 \begin_inset space ~
31215 \begin_inset space ~
31223 This command specifies that clipping is done via an optional argument.
31224 This command may occur once or not at all.
31227 \begin_layout Description
31228 \begin_inset Flex Code
31231 \begin_layout Plain Layout
31233 \begin_inset space ~
31237 \begin_inset space ~
31245 This command specifies that an extra optional argument is used.
31246 This command may occur once or not at all.
31249 \begin_layout Description
31250 \begin_inset Flex Code
31253 \begin_layout Plain Layout
31255 \begin_inset space ~
31263 The file format of the converted file.
31264 This must be the name of a format that is known to \SpecialChar LyX
31266 \begin_inset Flex Noun
31269 \begin_layout Plain Layout
31270 Tools\SpecialChar menuseparator
31271 Preferences\SpecialChar menuseparator
31272 File Handling\SpecialChar menuseparator
31279 This command must occur exactly once.
31280 If the resulting file format is PDF, you need to specify the format
31281 \begin_inset Flex Code
31284 \begin_layout Plain Layout
31291 This is the PDF format used for including graphics.
31292 The other defined PDF formats are for document export.
31295 \begin_layout Description
31296 \begin_inset Flex Code
31299 \begin_layout Plain Layout
31301 \begin_inset space ~
31309 The file name of the converted file.
31310 The file name must be absolute.
31311 This command must occur exactly once.
31314 \begin_layout Subsection
31315 Preamble definitions
31318 \begin_layout Standard
31319 The external template configuration file may contain additional preamble
31320 definitions enclosed by
31321 \begin_inset Flex Code
31324 \begin_layout Plain Layout
31332 \begin_inset Flex Code
31335 \begin_layout Plain Layout
31342 They can be used by the templates in the
31343 \begin_inset Flex Code
31346 \begin_layout Plain Layout
31355 \begin_layout Section
31356 The substitution mechanism
31359 \begin_layout Standard
31360 When the external material facility invokes an external program, it is done
31361 on the basis of a command defined in the template configuration file.
31362 These commands can contain various macros that are expanded before execution.
31363 Execution always take place in the directory of the containing document.
31366 \begin_layout Standard
31367 Also, whenever external material is to be displayed, the name will be produced
31368 by the substitution mechanism, and most other commands in the template
31369 definition support substitution as well.
31372 \begin_layout Standard
31373 The available macros are the following:
31376 \begin_layout Description
31377 \begin_inset Flex Code
31380 \begin_layout Plain Layout
31381 $$AbsOrRelPathMaster
31386 The file path, absolute or relative to the master \SpecialChar LyX
31390 \begin_layout Description
31391 \begin_inset Flex Code
31394 \begin_layout Plain Layout
31395 $$AbsOrRelPathParent
31400 The file path, absolute or relative to the \SpecialChar LyX
31404 \begin_layout Description
31405 \begin_inset Flex Code
31408 \begin_layout Plain Layout
31414 The absolute file path.
31417 \begin_layout Description
31418 \begin_inset Flex Code
31421 \begin_layout Plain Layout
31427 The filename without path and without the extension.
31430 \begin_layout Description
31431 \begin_inset Flex Code
31434 \begin_layout Plain Layout
31436 \begin_inset Quotes eld
31440 \begin_inset Quotes erd
31448 This macro will expand to the contents of the file with the name
31449 \begin_inset Flex Code
31452 \begin_layout Plain Layout
31461 \begin_layout Description
31462 \begin_inset Flex Code
31465 \begin_layout Plain Layout
31471 The file extension (including the dot).
31474 \begin_layout Description
31475 \begin_inset Flex Code
31478 \begin_layout Plain Layout
31484 This will be the string
31485 \begin_inset Quotes eld
31489 \begin_inset Quotes erd
31492 if the file is in JPEG format, otherwise it will be the string
31493 \begin_inset Quotes eld
31497 \begin_inset Quotes erd
31501 This is useful to avoid uneeded conversions for output formats that support
31502 both PNG and JPEG fomats.
31503 The predefined RasterImage template uses this macro for the pdf\SpecialChar TeX
31508 \begin_layout Description
31509 \begin_inset Flex Code
31512 \begin_layout Plain Layout
31518 The filename of the file specified in the external material dialog.
31519 This is either an absolute name, or it is relative to the \SpecialChar LyX
31523 \begin_layout Description
31524 \begin_inset Flex Code
31527 \begin_layout Plain Layout
31534 \begin_inset Flex Code
31537 \begin_layout Plain Layout
31543 (absolute name or relative to the \SpecialChar LyX
31547 \begin_layout Description
31548 \begin_inset Flex Code
31551 \begin_layout Plain Layout
31557 The file path, relative to the master \SpecialChar LyX
31561 \begin_layout Description
31562 \begin_inset Flex Code
31565 \begin_layout Plain Layout
31571 The file path, relative to the \SpecialChar LyX
31575 \begin_layout Description
31576 \begin_inset Flex Code
31579 \begin_layout Plain Layout
31585 This macro will expand to the absolute path of the system directory.
31586 This is typically used to point to the various helper scripts that are
31587 bundled with \SpecialChar LyX
31591 \begin_layout Description
31592 \begin_inset Flex Code
31595 \begin_layout Plain Layout
31601 A name and full path to a temporary file which will be automatically deleted
31602 whenever the containing document is closed, or the external material insertion
31606 \begin_layout Standard
31607 All path macros contain a trailing directory separator, so you can construct
31609 \begin_inset space \thinspace{}
31613 \begin_inset space \space{}
31616 the absolute filename with
31617 \begin_inset Flex Code
31620 \begin_layout Plain Layout
31621 $$AbsPath$$Basename$$Extension
31629 \begin_layout Standard
31630 The macros above are substituted in all commands unless otherwise noted.
31632 \begin_inset Flex Code
31635 \begin_layout Plain Layout
31641 supports additionally the following substitutions if they are enabled by
31643 \begin_inset Flex Code
31646 \begin_layout Plain Layout
31653 \begin_inset Flex Code
31656 \begin_layout Plain Layout
31665 \begin_layout Description
31666 \begin_inset Flex Code
31669 \begin_layout Plain Layout
31675 The front part of the resize command.
31678 \begin_layout Description
31679 \begin_inset Flex Code
31682 \begin_layout Plain Layout
31688 The back part of the resize command.
31691 \begin_layout Description
31692 \begin_inset Flex Code
31695 \begin_layout Plain Layout
31701 The front part of the rotation command.
31704 \begin_layout Description
31705 \begin_inset Flex Code
31708 \begin_layout Plain Layout
31714 The back part of the rotation command.
31717 \begin_layout Standard
31718 The value string of the
31719 \begin_inset Flex Code
31722 \begin_layout Plain Layout
31728 command supports additionally the following substitutions if they are enabled
31730 \begin_inset Flex Code
31733 \begin_layout Plain Layout
31740 \begin_inset Flex Code
31743 \begin_layout Plain Layout
31752 \begin_layout Description
31753 \begin_inset Flex Code
31756 \begin_layout Plain Layout
31765 \begin_layout Description
31766 \begin_inset Flex Code
31769 \begin_layout Plain Layout
31778 \begin_layout Description
31779 \begin_inset Flex Code
31782 \begin_layout Plain Layout
31791 \begin_layout Description
31792 \begin_inset Flex Code
31795 \begin_layout Plain Layout
31801 The rotation option.
31804 \begin_layout Standard
31805 You may ask why there are so many path macros.
31806 There are mainly two reasons:
31809 \begin_layout Enumerate
31810 Relative and absolute file names should remain relative or absolute, respectivel
31812 Users may have reasons to prefer either form.
31813 Relative names are useful for portable documents that should work on different
31814 machines, for example.
31815 Absolute names may be required by some programs.
31818 \begin_layout Enumerate
31820 treats relative file names differently than \SpecialChar LyX
31821 and other programs in nested
31823 For \SpecialChar LyX
31824 , a relative file name is always relative to the document that contains
31826 For \SpecialChar LaTeX
31827 , it is always relative to the master document.
31828 These two definitions are identical if you have only one document, but
31829 differ if you have a master document that includes part documents.
31830 That means that relative filenames must be transformed when presented to
31833 Fortunately \SpecialChar LyX
31834 does this automatically for you if you choose the right macros.
31837 \begin_layout Standard
31838 So which path macro should be used in new template definitions? The rule
31842 \begin_layout Itemize
31844 \begin_inset Flex Code
31847 \begin_layout Plain Layout
31853 if an absolute path is required.
31856 \begin_layout Itemize
31858 \begin_inset Flex Code
31861 \begin_layout Plain Layout
31862 $$AbsOrRelPathMaster
31867 if the substituted string is some kind of \SpecialChar LaTeX
31871 \begin_layout Itemize
31873 \begin_inset Flex Code
31876 \begin_layout Plain Layout
31877 $$AbsOrRelPathParent
31882 in order to preserve the user's choice.
31885 \begin_layout Standard
31886 There are special cases where this rule does not work and e.
31887 \begin_inset space \thinspace{}
31891 \begin_inset space \space{}
31894 relative names are needed, but normally it will work just fine.
31895 One example for such a case is the command
31896 \begin_inset Flex Code
31899 \begin_layout Plain Layout
31900 ReferencedFile latex "$$AbsOrRelPathMaster$$Basename.pstex_t"
31905 in the XFig template above: We can't use the absolute name because the
31907 \begin_inset Flex Code
31910 \begin_layout Plain Layout
31916 files needs the relative name in order to rewrite the file content.
31919 \begin_layout Section
31920 Security discussion
31921 \begin_inset CommandInset label
31923 name "sec:Security-discussion"
31930 \begin_layout Standard
31931 The external material feature interfaces with a lot of external programs
31932 and does so automatically, so we have to consider the security implications
31934 In particular, since you have the option of including your own filenames
31935 and/or parameter strings and those are expanded into a command, it seems
31936 that it would be possible to create a malicious document which executes
31937 arbitrary commands when a user views or prints the document.
31938 This is something we definitely want to avoid.
31941 \begin_layout Standard
31942 However, since the external program commands are specified in the template
31943 configuration file only, there are no security issues if \SpecialChar LyX
31944 is properly configure
31945 d with safe templates only.
31946 This is so because the external programs are invoked with the
31947 \begin_inset Flex Code
31950 \begin_layout Plain Layout
31956 -system call rather than the
31957 \begin_inset Flex Code
31960 \begin_layout Plain Layout
31966 system-call, so it's not possible to execute arbitrary commands from the
31967 filename or parameter section via the shell.
31970 \begin_layout Standard
31971 This also implies that you are restricted in what command strings you can
31972 use in the external material templates.
31973 In particular, pipes and redirection are not readily available.
31974 This has to be so if \SpecialChar LyX
31975 should remain safe.
31976 If you want to use some of the shell features, you should write a safe
31977 script to do this in a controlled manner, and then invoke the script from
31978 the command string.
31982 \begin_layout Standard
31983 It is possible to design a template that interacts directly with the shell,
31984 but since this would allow a malicious user to execute arbitrary commands
31985 by writing clever filenames and/or parameters, we generally recommend that
31986 you only use safe scripts that work with the
31987 \begin_inset Flex Code
31990 \begin_layout Plain Layout
31996 system call in a controlled manner.
31997 Of course, for use in a controlled environment, it can be tempting to just
31998 fall back to use ordinary shell scripts.
31999 If you do so, be aware that you
32003 provide an easily exploitable security hole in your system.
32004 Of course it stands to reason that such unsafe templates will never be
32005 included in the standard \SpecialChar LyX
32006 distribution, although we do encourage people
32007 to submit new templates in the open source tradition.
32008 But \SpecialChar LyX
32009 as shipped from the official distribution channels will never have
32013 \begin_layout Standard
32014 Including external material provides a lot of power, and you have to be
32015 careful not to introduce security hazards with this power.
32016 A subtle error in a single line in an innocent looking script can open
32017 the door to huge security problems.
32018 So if you do not fully understand the issues, we recommend that you consult
32019 a knowledgeable security professional or the \SpecialChar LyX
32020 development team if you have
32021 any questions about whether a given template is safe or not.
32022 And do this before you use it in an uncontrolled environment.
32025 \begin_layout Chapter
32027 List of supported \SpecialChar LyX
32028 functions to be used in layouts
32029 \begin_inset CommandInset label
32031 name "chap:List-of-functions"
32038 \begin_layout Standard
32040 \begin_inset Tabular
32041 <lyxtabular version="3" rows="11" columns="8">
32042 <features tabularvalignment="middle">
32043 <column alignment="left" valignment="top">
32044 <column alignment="left" valignment="top">
32045 <column alignment="left" valignment="top">
32046 <column alignment="left" valignment="top">
32047 <column alignment="left" valignment="top">
32048 <column alignment="left" valignment="top">
32049 <column alignment="left" valignment="top">
32050 <column alignment="left" valignment="top">
32052 <cell alignment="left" valignment="top" usebox="none">
32055 \begin_layout Plain Layout
32061 <cell alignment="left" valignment="top" usebox="none">
32064 \begin_layout Plain Layout
32070 <cell alignment="left" valignment="top" usebox="none">
32073 \begin_layout Plain Layout
32079 <cell alignment="left" valignment="top" usebox="none">
32082 \begin_layout Plain Layout
32088 <cell alignment="center" valignment="top" usebox="none">
32091 \begin_layout Plain Layout
32097 <cell alignment="center" valignment="top" usebox="none">
32100 \begin_layout Plain Layout
32106 <cell alignment="center" valignment="top" usebox="none">
32109 \begin_layout Plain Layout
32115 <cell alignment="center" valignment="top" usebox="none">
32118 \begin_layout Plain Layout
32126 <cell alignment="left" valignment="top" usebox="none">
32129 \begin_layout Plain Layout
32135 <cell alignment="left" valignment="top" usebox="none">
32138 \begin_layout Plain Layout
32144 <cell alignment="left" valignment="top" usebox="none">
32147 \begin_layout Plain Layout
32153 <cell alignment="left" valignment="top" usebox="none">
32156 \begin_layout Plain Layout
32162 <cell alignment="center" valignment="top" usebox="none">
32165 \begin_layout Plain Layout
32171 <cell alignment="center" valignment="top" usebox="none">
32174 \begin_layout Plain Layout
32180 <cell alignment="center" valignment="top" usebox="none">
32183 \begin_layout Plain Layout
32189 <cell alignment="center" valignment="top" usebox="none">
32192 \begin_layout Plain Layout
32200 <cell alignment="left" valignment="top" usebox="none">
32203 \begin_layout Plain Layout
32209 <cell alignment="left" valignment="top" usebox="none">
32212 \begin_layout Plain Layout
32218 <cell alignment="left" valignment="top" usebox="none">
32221 \begin_layout Plain Layout
32227 <cell alignment="left" valignment="top" usebox="none">
32230 \begin_layout Plain Layout
32236 <cell alignment="center" valignment="top" usebox="none">
32239 \begin_layout Plain Layout
32245 <cell alignment="center" valignment="top" usebox="none">
32248 \begin_layout Plain Layout
32254 <cell alignment="center" valignment="top" usebox="none">
32257 \begin_layout Plain Layout
32263 <cell alignment="center" valignment="top" usebox="none">
32266 \begin_layout Plain Layout
32274 <cell alignment="left" valignment="top" usebox="none">
32277 \begin_layout Plain Layout
32283 <cell alignment="left" valignment="top" usebox="none">
32286 \begin_layout Plain Layout
32292 <cell alignment="left" valignment="top" usebox="none">
32295 \begin_layout Plain Layout
32301 <cell alignment="left" valignment="top" usebox="none">
32304 \begin_layout Plain Layout
32310 <cell alignment="center" valignment="top" usebox="none">
32313 \begin_layout Plain Layout
32319 <cell alignment="center" valignment="top" usebox="none">
32322 \begin_layout Plain Layout
32328 <cell alignment="center" valignment="top" usebox="none">
32331 \begin_layout Plain Layout
32337 <cell alignment="center" valignment="top" usebox="none">
32340 \begin_layout Plain Layout
32348 <cell alignment="left" valignment="top" usebox="none">
32351 \begin_layout Plain Layout
32357 <cell alignment="left" valignment="top" usebox="none">
32360 \begin_layout Plain Layout
32366 <cell alignment="left" valignment="top" usebox="none">
32369 \begin_layout Plain Layout
32375 <cell alignment="left" valignment="top" usebox="none">
32378 \begin_layout Plain Layout
32384 <cell alignment="center" valignment="top" usebox="none">
32387 \begin_layout Plain Layout
32393 <cell alignment="center" valignment="top" usebox="none">
32396 \begin_layout Plain Layout
32402 <cell alignment="center" valignment="top" usebox="none">
32405 \begin_layout Plain Layout
32411 <cell alignment="center" valignment="top" usebox="none">
32414 \begin_layout Plain Layout
32422 <cell alignment="left" valignment="top" usebox="none">
32425 \begin_layout Plain Layout
32431 <cell alignment="left" valignment="top" usebox="none">
32434 \begin_layout Plain Layout
32440 <cell alignment="left" valignment="top" usebox="none">
32443 \begin_layout Plain Layout
32449 <cell alignment="left" valignment="top" usebox="none">
32452 \begin_layout Plain Layout
32458 <cell alignment="center" valignment="top" usebox="none">
32461 \begin_layout Plain Layout
32467 <cell alignment="center" valignment="top" usebox="none">
32470 \begin_layout Plain Layout
32476 <cell alignment="center" valignment="top" usebox="none">
32479 \begin_layout Plain Layout
32485 <cell alignment="center" valignment="top" usebox="none">
32488 \begin_layout Plain Layout
32496 <cell alignment="left" valignment="top" usebox="none">
32499 \begin_layout Plain Layout
32505 <cell alignment="left" valignment="top" usebox="none">
32508 \begin_layout Plain Layout
32514 <cell alignment="left" valignment="top" usebox="none">
32517 \begin_layout Plain Layout
32523 <cell alignment="left" valignment="top" usebox="none">
32526 \begin_layout Plain Layout
32532 <cell alignment="center" valignment="top" usebox="none">
32535 \begin_layout Plain Layout
32541 <cell alignment="center" valignment="top" usebox="none">
32544 \begin_layout Plain Layout
32550 <cell alignment="center" valignment="top" usebox="none">
32553 \begin_layout Plain Layout
32559 <cell alignment="center" valignment="top" usebox="none">
32562 \begin_layout Plain Layout
32570 <cell alignment="left" valignment="top" usebox="none">
32573 \begin_layout Plain Layout
32579 <cell alignment="left" valignment="top" usebox="none">
32582 \begin_layout Plain Layout
32588 <cell alignment="left" valignment="top" usebox="none">
32591 \begin_layout Plain Layout
32597 <cell alignment="left" valignment="top" usebox="none">
32600 \begin_layout Plain Layout
32606 <cell alignment="center" valignment="top" usebox="none">
32609 \begin_layout Plain Layout
32615 <cell alignment="center" valignment="top" usebox="none">
32618 \begin_layout Plain Layout
32624 <cell alignment="center" valignment="top" usebox="none">
32627 \begin_layout Plain Layout
32633 <cell alignment="center" valignment="top" usebox="none">
32636 \begin_layout Plain Layout
32644 <cell alignment="left" valignment="top" usebox="none">
32647 \begin_layout Plain Layout
32653 <cell alignment="left" valignment="top" usebox="none">
32656 \begin_layout Plain Layout
32662 <cell alignment="left" valignment="top" usebox="none">
32665 \begin_layout Plain Layout
32671 <cell alignment="left" valignment="top" usebox="none">
32674 \begin_layout Plain Layout
32680 <cell alignment="center" valignment="top" usebox="none">
32683 \begin_layout Plain Layout
32689 <cell alignment="center" valignment="top" usebox="none">
32692 \begin_layout Plain Layout
32698 <cell alignment="center" valignment="top" usebox="none">
32701 \begin_layout Plain Layout
32707 <cell alignment="center" valignment="top" usebox="none">
32710 \begin_layout Plain Layout
32718 <cell alignment="left" valignment="top" usebox="none">
32721 \begin_layout Plain Layout
32727 <cell alignment="left" valignment="top" usebox="none">
32730 \begin_layout Plain Layout
32736 <cell alignment="left" valignment="top" usebox="none">
32739 \begin_layout Plain Layout
32745 <cell alignment="left" valignment="top" usebox="none">
32748 \begin_layout Plain Layout
32754 <cell alignment="center" valignment="top" usebox="none">
32757 \begin_layout Plain Layout
32763 <cell alignment="center" valignment="top" usebox="none">
32766 \begin_layout Plain Layout
32772 <cell alignment="center" valignment="top" usebox="none">
32775 \begin_layout Plain Layout
32781 <cell alignment="center" valignment="top" usebox="none">
32784 \begin_layout Plain Layout
32792 <cell alignment="center" valignment="top" usebox="none">
32795 \begin_layout Plain Layout
32801 <cell alignment="center" valignment="top" usebox="none">
32804 \begin_layout Plain Layout
32810 <cell alignment="center" valignment="top" usebox="none">
32813 \begin_layout Plain Layout
32819 <cell alignment="center" valignment="top" usebox="none">
32822 \begin_layout Plain Layout
32828 <cell alignment="center" valignment="top" usebox="none">
32831 \begin_layout Plain Layout
32837 <cell alignment="center" valignment="top" usebox="none">
32840 \begin_layout Plain Layout
32846 <cell alignment="center" valignment="top" usebox="none">
32849 \begin_layout Plain Layout
32855 <cell alignment="center" valignment="top" usebox="none">
32858 \begin_layout Plain Layout
32872 \begin_layout Chapter
32873 Names of available colors to be used in layouts
32874 \begin_inset CommandInset label
32876 name "chap:Names-of-colors"
32883 \begin_layout Standard
32884 The colors listed below are the standard colors and those that you can adjust
32885 in the \SpecialChar LyX
32889 \begin_layout Section
32893 \begin_layout Standard
32894 The following are no real colors, but rather act on color definitions:
32897 \begin_layout Description
32898 ignore The color is ignored
32901 \begin_layout Description
32902 inherit The color is inherited
32905 \begin_layout Description
32918 No particular color – clear or default
32921 \begin_layout Section
32925 \begin_layout Standard
32926 These are fixed colors that cannot be customized
32927 \change_inserted -712698321 1607683177
32933 use these colors in layout definitions, since they will not work well with
32934 some color themes (such as dark themes)
32939 \begin_layout Description
32943 \begin_layout Description
32947 \begin_layout Description
32951 \begin_layout Description
32955 \begin_layout Description
32959 \begin_layout Description
32963 \begin_layout Description
32967 \begin_layout Description
32971 \begin_layout Description
32975 \begin_layout Description
32979 \begin_layout Description
32983 \begin_layout Description
32987 \begin_layout Description
32991 \begin_layout Description
32995 \begin_layout Description
32999 \begin_layout Description
33003 \begin_layout Description
33007 \begin_layout Description
33011 \begin_layout Description
33015 \begin_layout Section
33019 \begin_layout Standard
33020 These are the colors allocated to specific elements in
33023 arg "dialog-show prefs"
33029 \begin_layout Description
33030 added_space Added space color
33033 \begin_layout Description
33034 addedtext Added text color
33037 \begin_layout Description
33038 appendix Appendix marker color
33041 \begin_layout Description
33042 background Background color
33045 \begin_layout Description
33046 bottomarea Bottom area color
33049 \begin_layout Description
33050 branchlabel Label color for branches
33053 \begin_layout Description
33054 buttonbg Color used for button background
33057 \begin_layout Description
33058 buttonframe Color for inset button frames
33061 \begin_layout Description
33062 buttonhoverbg Color used for button background under focus
33065 \begin_layout Description
33066 changebar Changebar color
33069 \begin_layout Description
33070 changedtextauthor1 Changed text color author 1
33073 \begin_layout Description
33074 changedtextauthor2 Changed text color author 2
33077 \begin_layout Description
33078 changedtextauthor3 Changed text color author 3
33081 \begin_layout Description
33082 changedtextauthor4 Changed text color author 4
33085 \begin_layout Description
33086 changedtextauthor5 Changed text color author 5
33089 \begin_layout Description
33090 collapsible Collapsible insets text color
33093 \begin_layout Description
33094 collapsibleframe Collapsible insets framecolor
33097 \begin_layout Description
33098 command Text color for command insets
33101 \begin_layout Description
33102 commandbg Background color for command insets
33105 \begin_layout Description
33106 commandframe Frame color for command insets
33109 \begin_layout Description
33110 comment Label color for comments
33113 \begin_layout Description
33114 commentbg Background color of comments
33117 \begin_layout Description
33118 cursor Cursor color
33121 \begin_layout Description
33122 deletedtext Deleted text color
33125 \begin_layout Description
33126 deletedtextmodifier Deleted text modifying color
33129 \begin_layout Description
33130 depthbar Color for the depth bars in the margin
33133 \begin_layout Description
33134 eolmarker End of line marker color
33137 \begin_layout Description
33138 error Color of the \SpecialChar LaTeX
33142 \begin_layout Description
33143 footlabel Label color for footnotes
33146 \begin_layout Description
33147 foreground Foreground color
33150 \begin_layout Description
33151 graphicsbg Graphics inset background color
33154 \begin_layout Description
33155 greyedoutbg Background color of greyedout inset
33158 \begin_layout Description
33159 greyedoutlabel Label color for greyedout insets
33162 \begin_layout Description
33163 greyedouttext Color for greyedout inset text
33166 \begin_layout Description
33167 indexlabel Label color for index insets
33170 \begin_layout Description
33171 inlinecompletion Inline completion color
33174 \begin_layout Description
33175 insetbg Inset marker background color
33178 \begin_layout Description
33179 insetframe Inset marker frame color
33182 \begin_layout Description
33183 language Color for marking foreign language words
33186 \begin_layout Description
33187 latex Text color in \SpecialChar LaTeX
33191 \begin_layout Description
33192 listingsbg Background color of listings inset
33195 \begin_layout Description
33196 marginlabel Label color for margin notes
33199 \begin_layout Description
33200 math Math inset text color
33203 \begin_layout Description
33204 mathbg Math inset background color
33207 \begin_layout Description
33208 mathcorners Math inset frame color not under focus
33211 \begin_layout Description
33212 mathframe Math inset frame color under focus
33215 \begin_layout Description
33216 mathline Math line color
33219 \begin_layout Description
33220 mathmacrobg Macro math inset background color
33223 \begin_layout Description
33224 mathmacroblend Macro math blended color
33227 \begin_layout Description
33228 mathmacroframe Macro math frame color
33231 \begin_layout Description
33232 mathmacrohoverbg Macro math inset background color hovered
33235 \begin_layout Description
33236 mathmacrolabel Macro math label color
33239 \begin_layout Description
33240 mathmacronewarg Macro template color for new parameters
33243 \begin_layout Description
33244 mathmacrooldarg Macro template color for old parameters
33247 \begin_layout Description
33248 newpage New page color
33251 \begin_layout Description
33252 nonunique_inlinecompletion Inline completion color for the non-unique part
33255 \begin_layout Description
33256 note Label color for notes
33259 \begin_layout Description
33260 notebg Background color of notes
33263 \begin_layout Description
33264 pagebreak Page break/line break color
33267 \begin_layout Description
33268 paragraphmarker Color used for the pilcrow sign to mark the end of a paragraph
33271 \begin_layout Description
33272 phantomtext Text color for phantom insets
33275 \begin_layout Description
33276 preview The color used for previews
33279 \begin_layout Description
33280 previewframe Preview frame color
33283 \begin_layout Description
33284 regexpframe Color for regexp frame
33287 \begin_layout Description
33288 scroll Color that indicates when a row can be scrolled
33291 \begin_layout Description
33292 selection Background color of selected text
33295 \begin_layout Description
33296 selectiontext Foreground color of selected text
33299 \begin_layout Description
33300 shadedbg Background color of shaded box
33303 \begin_layout Description
33304 special Special chars text color
33307 \begin_layout Description
33308 tabularline Table line color
33311 \begin_layout Description
33312 tabularonoffline Table line color
33313 \change_inserted -712698321 1607682522
33317 \begin_layout Description
33319 \change_inserted -712698321 1607682563
33320 textlabel1 Color 1 of layout and custom inset labels
33323 \begin_layout Description
33325 \change_inserted -712698321 1607682565
33326 textlabel2 Color 2 of layout and custom inset labels
33329 \begin_layout Description
33331 \change_inserted -712698321 1607682568
33332 textlabel3 Color 3 of layout and custom inset labels
33337 \begin_layout Description
33338 urllabel Label color for URL insets
33341 \begin_layout Description
33342 urltext Color for URL inset text