X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=lib%2Fdoc%2FCustomization.lyx;h=c7f09d113db04b1b295aca5707b0c4d153424a81;hb=9aca8e4eb54157365f18380e67aa5cad27277622;hp=4a3aa122e0dbd145135b20ca048a09dca1d7f21d;hpb=87de34f36f5a3ba3266ec49cf9357e086f8c5281;p=lyx.git diff --git a/lib/doc/Customization.lyx b/lib/doc/Customization.lyx index 4a3aa122e0..c7f09d113d 100644 --- a/lib/doc/Customization.lyx +++ b/lib/doc/Customization.lyx @@ -1,14 +1,14 @@ #LyX 2.0.0svn created this file. For more info see http://www.lyx.org/ -\lyxformat 348 +\lyxformat 375 \begin_document \begin_header \textclass scrbook \begin_preamble % DO NOT ALTER THIS PREAMBLE!!! % -% This preamble is designed to ensure that the User's Guide prints +% This preamble is designed to ensure that this document prints % out as advertised. If you mess with this preamble, -% parts of the User's Guide may not print out as expected. If you +% parts of this document may not print out as expected. If you % have problems LaTeXing this file, please contact % the documentation team % email: lyx-docs@lists.lyx.org @@ -62,16 +62,21 @@ End \end_local_layout \language english \inputencoding auto +\fontencoding global \font_roman default \font_sans default \font_typewriter default \font_default_family default +\use_xetex false \font_sc false \font_osf false \font_sf_scale 100 \font_tt_scale 100 \graphics default +\default_output_format default +\bibtex_command default +\index_command default \paperfontsize 12 \spacing single \use_hyperref true @@ -93,25 +98,33 @@ End \use_geometry false \use_amsmath 0 \use_esint 0 +\use_mhchem 1 \cite_engine basic \use_bibtopic false +\use_indices false \paperorientation portrait +\suppress_date false \branch OutDated \selected 0 +\filename_suffix 0 \color #f5fae7 \end_branch +\index Index +\shortcut idx +\color #008000 +\end_index \secnumdepth 3 \tocdepth 3 \paragraph_separation indent -\defskip medskip +\paragraph_indentation default \quotes_language english \papercolumns 1 \papersides 2 \paperpagestyle headings \tracking_changes false \output_changes false -\author "" -\author "" +\html_use_mathml true +\html_be_strict true \end_header \begin_body @@ -169,6 +182,22 @@ LatexCommand tableofcontents \end_inset +\end_layout + +\begin_layout Standard +\begin_inset Note Note +status open + +\begin_layout Plain Layout +Please use change tracking when modifying this document. + This makes it easier for our translators to recognize things that have + been changed, and it helps the maintainer keep up-to-date with what's been + done. +\end_layout + +\end_inset + + \end_layout \begin_layout Chapter @@ -188,7 +217,7 @@ on, installing new LaTeX classes and LyX layouts, etc. \begin_layout Standard \begin_inset Branch OutDated -status collapsed +status open \begin_layout Standard Information from previous versions of this document that now seems to be @@ -599,7 +628,7 @@ xx \begin_inset CommandInset ref LatexCommand ref -reference "chap:i18n" +reference "cha:Internationalizing-LyX" \end_inset @@ -676,7 +705,7 @@ kbd/ \begin_inset CommandInset ref LatexCommand ref -reference "sec:keymap" +reference "sec:International-Keymap-Stuff" \end_inset @@ -701,7 +730,7 @@ layouts/ \begin_inset CommandInset ref LatexCommand ref -reference "chap:textclass" +reference "cha:Installing-New-Document" \end_inset @@ -781,7 +810,7 @@ templates/ \begin_inset CommandInset ref LatexCommand ref -reference "sec:templates" +reference "sub:Creating-Templates" \end_inset @@ -1257,142 +1286,14 @@ User's Guide \end_layout \begin_layout Section -Using the dialog for the first time -\end_layout - -\begin_layout Standard -The -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -UserDir/preferences -\end_layout - -\end_inset - - file will contain only changes that you have made to the default behavior, - some of which is hard-coded into LyX and some of which is contained in - the system file -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -LyXDir/lyxrc.defaults -\end_layout - -\end_inset - -. - Note that in both files lines beginning with a -\begin_inset Quotes eld -\end_inset - -# -\begin_inset Quotes erd -\end_inset - - are just comments and are not interpreted. - However, only system administrators should edit -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -LyXDir/lyxrc.defaults -\end_layout - -\end_inset - -. - Users should use the -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Tools\SpecialChar \menuseparator -Preferences -\end_layout - -\end_inset - - dialog to create and modify their own -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -UserDir/preferences -\end_layout - -\end_inset - - file. -\end_layout - -\begin_layout Standard -We hope that the -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Tools\SpecialChar \menuseparator -Preferences -\end_layout - -\end_inset - - dialog will be largely self-explanatory. - Most things in the dialog have associated `tool tips': hover your mouse - pointer over something for more information. - Before we highlight a few of the more important commands below, however, - a word of warning: Applying some of your changes (e. -\begin_inset space \thinspace{} -\end_inset - -g. -\begin_inset space \space{} -\end_inset - -screen fonts) will have an instant effect. - Others (e. -\begin_inset space \thinspace{} -\end_inset - -g. -\begin_inset space \space{} -\end_inset - -changing the bind file) will not. - If nothing appears to have changed, just -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Save -\end_layout - -\end_inset - - the changes and restart LyX. -\end_layout - -\begin_layout Section -File Handling -\end_layout - -\begin_layout Standard -LyX has a powerful mechanism to convert to and from any file format using - external programs. - -\end_layout - -\begin_layout Subsection +Formats \begin_inset CommandInset label LatexCommand label -name "sub:Formats" +name "sec:Formats" \end_inset -Formats + \end_layout \begin_layout Standard @@ -1442,7 +1343,7 @@ Format \end_inset - field contains the named used to identify the format in the GUI. + field contains the name used to identify the format in the GUI. The \begin_inset Flex CharStyle:MenuItem status collapsed @@ -1502,7 +1403,7 @@ Viewer \end_inset - and + and an \begin_inset Flex CharStyle:MenuItem status collapsed @@ -1539,37 +1440,18 @@ View \end_inset menu. - The editor is for example launched when you press the -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Edit -\end_layout - -\end_inset - - button in the -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Graphics -\end_layout - -\end_inset - - or the + The editor is for example launched when you right-click on an image and + choose \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -External material +Edit externally \end_layout \end_inset - dialog. + in the appearing context menu. \end_layout \begin_layout Standard @@ -1584,10 +1466,14 @@ Document format \end_inset option tells LyX that a format is suitable for document export. - If this is is set and if a suitable conversion route exists (see + If this is set and if a suitable conversion route exists (see sec. +\begin_inset space \thinspace{} +\end_inset + + \begin_inset CommandInset ref LatexCommand ref -reference "sub:Converters" +reference "sec:Converters" \end_inset @@ -1756,7 +1642,7 @@ png . \end_layout -\begin_layout Subsection +\begin_layout Section Copiers \end_layout @@ -1912,7 +1798,7 @@ cp $FROMFILE /home/you/pdf/$TOFILE \end_inset -Save that in your local LyX directory—say, +Save it in your local LyX directory—say, \begin_inset Flex CharStyle:Code status collapsed @@ -2083,14 +1969,15 @@ status collapsed \end_layout -\begin_layout Subsection +\begin_layout Section +Converters \begin_inset CommandInset label LatexCommand label -name "sub:Converters" +name "sec:Converters" \end_inset -Converters + \end_layout \begin_layout Standard @@ -2240,8 +2127,8 @@ $$r \end_inset - The path to the original input file (this is different from $$p when chain - of converters is called). + The path to the original input file (this is different from $$p when a + chain of converters is called). \end_layout \begin_layout Standard @@ -2364,7 +2251,7 @@ infile.out status collapsed \begin_layout Plain Layout -script infile.log +script < infile.out > infile.log \end_layout \end_inset @@ -2450,8 +2337,8 @@ None of these last three are presently used in any of the converters that \end_layout \begin_layout Standard -You do not have to define converters between all the formats between which - you want to convert. +You do not have to define converters for all formats between which you want + to convert. For example, you will note that there is no `LyX to PostScript' converter, but LyX will export PostScript. It does so by first creating a LaTeX file (no converter needs to be defined @@ -2497,7 +2384,7 @@ dvipdfm formats', as described in section \begin_inset CommandInset ref LatexCommand ref -reference "sub:Formats" +reference "sec:Formats" \end_inset @@ -2549,7 +2436,7 @@ status collapsed Internationalizing LyX \begin_inset CommandInset label LatexCommand label -name "chap:i18n" +name "cha:Internationalizing-LyX" \end_inset @@ -3093,21 +2980,6 @@ DocName do right away: \end_layout -\begin_layout Itemize -Read -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -DocStyle.lyx -\end_layout - -\end_inset - -, the guide to writing LyX documentation. - Pay special attention to the translator's section. -\end_layout - \begin_layout Itemize Check out the documentation translation web page at \begin_inset CommandInset href @@ -3147,11 +3019,7 @@ status collapsed \begin_layout Plain Layout Help\SpecialChar \menuseparator - -\bar under -I -\bar default -ntroduction +Introduction \end_layout \end_inset @@ -3768,13 +3636,14 @@ kinclude \end_layout \begin_layout Section +International Keymap Stuff \begin_inset CommandInset label LatexCommand label -name "sec:keymap" +name "sec:International-Keymap-Stuff" \end_inset -International Keymap Stuff + \end_layout \begin_layout Standard @@ -3785,6 +3654,7 @@ status open In doing the revisions on this document in March 2008, I did not look over this stuff, as I do not understand it. It would be good if someone else could do so. + (RH) \end_layout \end_inset @@ -5362,10 +5232,10 @@ Preferences \end_layout \begin_layout Chapter -Installing New Document Classes, Layouts, and Templates +Installing New Document Classes, Layouts, and Templates \begin_inset CommandInset label LatexCommand label -name "chap:textclass" +name "cha:Installing-New-Document" \end_inset @@ -5386,165 +5256,233 @@ Installing New Document Classes In this chapter, we describe the procedures for creating and installing new LyX layout and template files, as well as offer a refresher on correctly installing new LaTeX document classes. - Some definitions: a document class is a LaTeX file (usually ending in -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -.cls -\end_layout - -\end_inset - - or -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -.sty + \end_layout -\end_inset - -) that describes the format of a document such as an article, report, journal - preprint, etc, and all the commands needed to realize that format. - A layout file is a LyX file that corresponds to a LaTeX document class - and that tells LyX how to +\begin_layout Standard +First, let us a say a few words about how one ought to think about the relation + between LyX and LaTeX. + The thing to understand is that, in a certain sense, LyX doesn't know anything + about LaTeX. + Indeed, from LyX's point of view, LaTeX is just one of several \begin_inset Quotes eld \end_inset -draw +backend formats \begin_inset Quotes erd \end_inset - things on the screen to make the display look something like the final - printed page. - More precisely, a layout file describes a -\begin_inset Quotes eld -\end_inset - -text class -\begin_inset Quotes erd -\end_inset + in which it is capable of producing output. + Other such formats are DocBook, plaintext, and XHTML. + LaTeX is, of course, a particularly important format, but very little of + the information LyX has about LaTeX is actually contained in the program + itself. +\begin_inset Foot +status collapsed - which is the internal construct LyX uses to render the screen display. - +\begin_layout Plain Layout +Some commands are sufficiently complex that they are \begin_inset Quotes eld \end_inset -Layout +hardcoded \begin_inset Quotes erd \end_inset - and -\begin_inset Quotes eld -\end_inset + into LyX. + But the developers generally regard this as a Bad Thing. +\end_layout -text class -\begin_inset Quotes erd \end_inset - can be used somewhat interchangeably, but it is better to refer to the - file as the layout, and the thing living in LyX's memory as the text class. - A template file is simply a LyX document that contains a set of predefined - entries for a given document class—entries that are generally required - for that class. - Templates are especially useful for things like journal manuscripts that - are to be submitted electronically. -\end_layout + Rather, that information, even for the standard classes like +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout Section -Installing a new LaTeX package +\begin_layout Plain Layout +article.cls \end_layout -\begin_layout Standard -Some installations may not include a LaTeX package that you would like to - use within LyX. - For example, you might need FoilTeX, a package for preparing slides or - viewgraphs for overhead projectors. - Modern LaTeX distributions like TeXLive (2008 or newer) or MiKTeX provide - a user interface for that. - For example on MiKTeX you start its program -\begin_inset Quotes eld \end_inset -Browse Packages -\begin_inset Quotes erd -\end_inset +, is contained in layout files. + Similarly, LyX itself does not know much about DocBook or XHTML. +\end_layout - to get a list of available packages. - To install one, right click on it or use the installing toolbar button. - When the package you want to install is not in the list, but you have it - in form of a +\begin_layout Standard +You can think of the layout file for a given document class as a translation + manual between LyX constructs---paragraphs with their corresponding styles, + certain sorts of insets, etc---and the corresponding LaTeX, DocBook, or + XHTML constructs. + Almost everything LyX knows about \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -.cls +article.cls \end_layout \end_inset - or +, for example, is contained in the file \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -.sty +article.layout \end_layout \end_inset --file, then copy these files to a subfolder of your LaTeX distribution, - for example to the folder -\family sans -~ -\backslash -tex -\backslash -latex -\family default -. - Then update the file name database of your LaTeX-distribution. - For example on MiKTeX this is done by pressing the button -\family sans -Refresh -\begin_inset space ~ -\end_inset + and in various other files it includes. + For this reason, anyone intending to write layout files should plan to + study the existing files. + A good place to start is with +\begin_inset Flex CharStyle:Code +status collapsed -FNDB -\family default - that you find in MiKTeX's -\begin_inset Quotes eld -\end_inset +\begin_layout Plain Layout +stdsections.inc +\end_layout -Settings -\begin_inset Quotes erd \end_inset - program. - In both cases you need afterwards to reconfigure LyX using the menu -\begin_inset Flex CharStyle:MenuItem +, which is included in +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Tools\SpecialChar \menuseparator -Reconfigure +article.layout \end_layout \end_inset - and then to restart LyX. -\end_layout +, +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout Standard -If your LaTeX distribution doesn't provide a user interface, then you can - follow these steps by using a UNIX/Linux console. +\begin_layout Plain Layout +book.layout \end_layout -\begin_layout Enumerate -Get the package from -\begin_inset CommandInset href +\end_inset + +, and many of the other layout files for document classes. + This file is where sections and the like are defined: +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +stdsections.inc +\end_layout + +\end_inset + + tells LyX how paragraphs that are marked with the Section, Subsection, + etc, styles can be translated into corresponding LaTeX, DocBook, and XHTML + commands and tags. + The +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +article.layout +\end_layout + +\end_inset + + file basically just includes several of these +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +std*.inc +\end_layout + +\end_inset + + files. +\end_layout + +\begin_layout Standard +Defining the LyX--LaTeX correspondence is not the only thing layout files + do, though. + Their other job is to define how the LyX constructs themselves will appear + on-screen. + The fact that layout files have these two jobs is often a source of confusion, + because they are completely separate. + Telling LyX how to translate a certain paragraph style into LaTeX does + not tell LyX how to display it; conversely, telling LyX how to display + a certain paragraph style does not tell LyX how to translate it into LaTeX + (let alone tell LaTeX how to display it). + So, in general, when you define a new LyX construct, you must always do + two quite separate things: (i) +\begin_inset space ~ +\end_inset + +tell LyX how to translate it into LaTeX and (ii) +\begin_inset space ~ +\end_inset + +tell LyX how to display it. +\end_layout + +\begin_layout Standard +Much the same is true, of course, as regards LyX's other backend formats, + though XHTML is in some ways different, because in that case LyX +\emph on +is +\emph default + able, to some extent, to use information about how it should display a + paragraph on the screen to output information (in the form of CSS) about + how the paragraph should be displayed in a browser. + Even in this case, however, the distinction between what LyX does internally + and how things are rendered externally remains in force, and the two can + be controlled separately. + See +\begin_inset CommandInset ref +LatexCommand prettyref +reference "sec:Tags-for-XHTML" + +\end_inset + + for the details. +\end_layout + +\begin_layout Section +Installing new LaTeX files +\end_layout + +\begin_layout Standard +Some installations may not include a LaTeX package or class file that you + would like to use within LyX. + For example, you might need FoilTeX, a package for preparing slides for + overhead projectors. + Modern LaTeX distributions like TeXLive (2008 or newer) or MiKTeX provide + a user interface for installing such packages. + For example, with MiKTeX, you start the program +\begin_inset Quotes eld +\end_inset + +Browse Packages +\begin_inset Quotes erd +\end_inset + + to get a list of available packages. + To install one, right click on it or use the toolbar button to install + it. + +\end_layout + +\begin_layout Standard +If your LaTeX distribution doesn't provide such a `package manager', or + if the file is not available from your distribution, then you can follow + these steps to install it manually. +\end_layout + +\begin_layout Enumerate +Get the package from +\begin_inset CommandInset href LatexCommand href name "CTAN" target "http://www.ctan.org/" @@ -5555,13 +5493,13 @@ target "http://www.ctan.org/" \end_layout \begin_layout Enumerate -You can install this package in several different places. +You can install the package in several different places. If you want it to be available for all users on your system, then you should install it in your `local' TeX tree; if you want (or need) it to be available just for you, then you can install it in your own `user' TeX tree. - Where these should be created, if they do not already exist, depends upon - the details of your system. - To find out, look in the file + Where these trees should be created, if they do not already exist, depends + upon the details of your system. + To find out where they are, look in the file \begin_inset Flex CharStyle:Code status collapsed @@ -5601,7 +5539,7 @@ kpsewhich texmf.cnf \end_inset - The location of the `local' TeX tree is defined by + The location of the `local' TeX tree is defined by the \begin_inset Flex CharStyle:Code status collapsed @@ -5611,18 +5549,19 @@ TEXMFLOCAL \end_inset -; this is usually somewhere like -\begin_inset Flex CharStyle:Code + variable; this is usually somewhere like +\begin_inset Flex URL status collapsed \begin_layout Plain Layout + /usr/local/share/texmf/ \end_layout \end_inset . - The `user' TeX tree is defined by + The location of the `user' TeX tree is defined by \begin_inset Flex CharStyle:Code status collapsed @@ -5632,7 +5571,7 @@ TEXMFHOME \end_inset - and is commonly at + and is commonly \begin_inset Flex CharStyle:Code status collapsed @@ -5644,7 +5583,7 @@ $HOME/texmf/ . (If these variables are not predefined, you can define them.) You'll probably - need root permissions to create or modify the `local' tree; but your `user' + need root permissions to create or modify the `local' tree, but your `user' tree shouldn't have such limitations. \end_layout @@ -5701,52 +5640,45 @@ TEXMF = {$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFMAIN} \begin_inset Newline newline \end_inset -But, again, most of this will -\begin_inset Quotes eld -\end_inset - -just work -\begin_inset Quotes erd -\end_inset - -. +It probably does. \end_layout \begin_layout Enumerate -Create your local -\begin_inset Foot +Your local and user trees +\emph on +must +\emph default + have the same sort of directory structure as your main existing +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -We'll assume henceforth that you're defining `local' TeX tree. - If you're defining a user tree, just adjust as necessary. +texmf \end_layout \end_inset - TeX tree. - You must follow the directory structure of your existing + directory, which will be found at \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -texmf +TEXMFMAIN \end_layout \end_inset - directory, which will be found at + (commonly, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TEXMFMAIN +/usr/share/texmf/ \end_layout \end_inset -. - For example, latex packages should go under +.) For example, latex packages should go under \begin_inset Flex CharStyle:Code status collapsed @@ -5754,281 +5686,345 @@ status collapsed $TEXMFLOCAL/tex/latex/ \end_layout +\end_inset + + or +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +$TEXMFHOME/tex/latex/ +\end_layout + \end_inset . + If you do not put them here, they probably will not work. \end_layout \begin_layout Enumerate -Install the package. - For example, you would unpack the FoilTeX tarball and copy it to +Once your tree is properly set up, you can install the package into an appropria +te location. + If you are lucky, your package will have been provided as a so-called `TDS' + (TeX Directory Structure) zip file. + To install it, you want to unzip it from the top of your tree. + So, for example, you can copy the file \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -$TEXMFLOCAL/tex/latex/foiltex +newpkg.zip \end_layout \end_inset -. - The + to +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +/home/yourname/texmf/ +\end_layout + +\end_inset + + and then, from inside that directory, just run: \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -foiltex +unzip newpkg.zip +\end_layout + +\end_inset + +. + This will extract the needed files and copy them where they need to be. +\begin_inset Newline newline +\end_inset + +If you do not have a TDS file, then you have to do this manually. + For example, you might install the FoilTeX files into +\begin_inset Flex URL +status collapsed + +\begin_layout Plain Layout + +$TEXMFLOCAL/tex/latex/contrib/foiltex +\end_layout + +\end_inset + +. + Why there? The CTAN download directories are themselves organized much + like a TeX tree, and it isn't a bad idea to follow its structure when you + install your own files. + FoilTeX, as it happens, is found at +\begin_inset Flex URL +status collapsed + +\begin_layout Plain Layout + +http://ctan.org/texarchive/macros/latex/contrib/foiltex/ \end_layout \end_inset - directory contains various files. +. + \end_layout \begin_layout Enumerate -Run: +Finally, you must update the database TeX uses to find files. + On MiKTeX, this is done by pressing the button +\family sans +Refresh +\begin_inset space ~ +\end_inset + +FNDB +\family default + that you find in MiKTeX's +\begin_inset Quotes eld +\end_inset + +Settings +\begin_inset Quotes erd +\end_inset + + program. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -texhash +$TEXMFLOCAL/tex/latex/ \end_layout \end_inset . - This should create + Under TeXLive and the like, you should run \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -$TEXMFLOCAL/ls-R +texhash \end_layout \end_inset - amongst others. + from a terminal, with root permissions if necessary. + \end_layout \begin_layout Standard Your package is now installed and available to LaTeX. - To make it available to LyX, you need to create a Layout file, if one is - not already available. - (See the next section.) Once you have a layout file, you need only reconfigure - ( -\begin_inset Flex CharStyle:MenuItem + You can verify this from a terminal by typing ` +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Tools\SpecialChar \menuseparator -Reconfigure +kpsewhich yourfile.ext \end_layout \end_inset -) and then restart LyX. - You should then see your new package—for example +'. + To make LyX aware of it, however, you will need to reconfigure ( \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -slides (FoilTeX) +Tools\SpecialChar \menuseparator +Reconfigure \end_layout \end_inset -—under +) and then restart LyX. + If the new package was a document class, such as FoilTeX again, you will + now see it available under \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout Document\SpecialChar \menuseparator -Settings +Settings\SpecialChar \menuseparator +Document Class \end_layout \end_inset - in the +, in this case as \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Document Class +slides (FoilTeX) \end_layout \end_inset - drop box. - +. +\end_layout + +\begin_layout Standard +What if there isn't a layout file is available for your new document class? + Then, unfortunately, LyX will know nothing about it until you create a + layout file yourself (or get someone else to do it). + That is the topic of the next section. \end_layout \begin_layout Section -Layouts +Types of layout files \end_layout \begin_layout Standard -This section describes how to write and install your own LyX layout files - and walks through the -\begin_inset Flex CharStyle:Code -status collapsed +This section describes the various sorts of LyX files that contain layout + information. + These files describe various paragraph and character styles, determining + how LyX should display them and how they should be translated into LaTeX, + DocBook, XHTML, or whatever output format is being used. + +\end_layout -\begin_layout Plain Layout -article +\begin_layout Standard +We shall try to provide a thorough description of the process of writing + layout files here. + However, there are so many different types of documents supported even + by just LaTeX that we can't hope to cover every different possibility or + problem you might encounter. + The LyX users' list is frequented by people with lots of experience with + layout design who are willing to share what they've learned, so please + feel free to ask questions there. \end_layout +\begin_layout Standard +As you prepare to write a new layout, it is extremely helpful to look at + the layouts distributed with LyX. + If you write a LyX layout for a LaTeX document class that might also be + used by others, or write a module that might be useful to others, then + you should consider posting your layout to the +\begin_inset CommandInset href +LatexCommand href +name "layout section on the LyX wiki" +target "http://wiki.lyx.org/Layouts/Layouts" + \end_inset - text class format as an example. - The -\begin_inset Flex CharStyle:Code + or even to the LyX developers' list, so that it might be included in LyX + itself. +\begin_inset Foot status collapsed \begin_layout Plain Layout -.layout +Note that LyX is licensed under the General Public License, so any material + that is contribued to LyX must be similarly licensed. \end_layout \end_inset - files describe what paragraph and character styles are available for a - given document class and how LyX should display them. - We try to provide a thorough description of the process here; however, - there are so many different types of documents supported by LaTeX classes - that we can't hope to cover every different possibility or problem you - might encounter. - (The LyX users' list is frequented by people with lots of experience with - layout design who are willing to share what they've learned.) + \end_layout -\begin_layout Standard -As you prepare to write a new layout, it is extremely helpful to look at - the example layouts distributed with LyX. - If you use a nice LaTeX document class that might be of interest for others, - too, and have a nice corresponding LyX layout, feel free to contribute - the stuff to us, so we may put it into the distribution. - There is also a -\begin_inset CommandInset href -LatexCommand href -name "section on the LyX wiki" -target "http://wiki.lyx.org/Layouts/Layouts" +\begin_layout Subsection +Layout modules +\begin_inset CommandInset label +LatexCommand label +name "sub:Layout-modules" \end_inset - for this kind of material. + \end_layout \begin_layout Standard -All the tags described in this chapter are case-insensitive; this means - that +We have spoken to this point about `layout files'. + But there are different sorts of files that contain layout information. + Layout files, strictly so called, have the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Style +.layout \end_layout \end_inset -, + extension and provide LyX with information about document classes. + As of LyX 1.6, however, layout information can also be contained in layout + +\emph on +modules +\emph default +, which have the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -style +.module \end_layout \end_inset - and + extension. + Modules are to LaTeX packages much as layouts are to LaTeX classes, and + some modules—such as the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -StYlE +endnotes \end_layout \end_inset - are really the same command. - The possible values are printed in brackets after the feature's name. - The default value if a feature isn't specified inside a text class-description - is typeset -\begin_inset Flex CharStyle:Code + module—specifcally provide support for one package. + In a sense, layout modules are similar to included +\begin_inset Foot status collapsed \begin_layout Plain Layout +These can have any extension, but by convention have the +\begin_inset Flex CharStyle:Code +status collapsed -\emph on -emphasized +\begin_layout Plain Layout +.inc \end_layout \end_inset -. - If the argument has a data type like -\begin_inset Quotes eld -\end_inset + extension. +\end_layout -string -\begin_inset Quotes erd \end_inset - or -\begin_inset Quotes eld -\end_inset + files—files like +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +stdsections.inc +\end_layout -float -\begin_inset Quotes erd \end_inset -, the default is shown like this: +—in that modules are not specific to a given document class but may be used + with many different classes. + The difference is that using an included file with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -float= -\emph on -default +article.cls \end_layout \end_inset -. -\end_layout - -\begin_layout Subsection -\begin_inset CommandInset label -LatexCommand label -name "sub:Layout-modules" - -\end_inset - -Layout modules -\end_layout - -\begin_layout Standard -Similar to layout files, and new with LyX 1.6, are layout -\emph on -modules -\emph default -. - Modules are to LaTeX packages much as layouts are to LaTeX classes, and - some modules—such as the endnotes module—provide support for just such - a package. - In a sense, layout modules are similar to included files—files like -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -stdsections.inc -\end_layout - -\end_inset - -—in that modules are not specific to a given document layout but may be - used with many different layouts. - The difference is that using a layout module does not require editing the - layout file. - Rather, modules are selected in the + requires editing that file. + Modules, by contrast, are selected in the \begin_inset Flex CharStyle:MenuItem status collapsed @@ -6044,153 +6040,24 @@ Settings \begin_layout Standard Building modules is the easiest way to get started with layout editing, - since it can be as simple as adding a single new paragraph or flex inset. + since it can be as simple as adding a single new paragraph style or flex + inset. But modules may, in principle, contain anything a layout file can contain. \end_layout \begin_layout Standard -A module must begin with a line like the following: -\end_layout - -\begin_layout LyX-Code -# -\backslash -DeclareLyXModule[endnotes.sty]{Endnotes} -\end_layout - -\begin_layout Standard -The argument in square brackets is optional: It declares any LaTeX packages - on which the module depends. - The mandatory argument, in curly brackets, is the name of the module, as - it should appear in -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Document\SpecialChar \menuseparator -Settings -\end_layout - -\end_inset - -. - -\end_layout - -\begin_layout Standard -The module declaration should then be followed by lines like the following: -\end_layout - -\begin_layout LyX-Code -#DescriptionBegin -\end_layout - -\begin_layout LyX-Code -#Adds an endnote command, in addition to footnotes. - -\end_layout - -\begin_layout LyX-Code -#You will need to add -\backslash -theendnotes in TeX code where you -\end_layout - -\begin_layout LyX-Code -#want the endnotes to appear. - -\end_layout - -\begin_layout LyX-Code -#DescriptionEnd -\end_layout - -\begin_layout LyX-Code -#Requires: somemodule | othermodule -\end_layout - -\begin_layout LyX-Code -#Excludes: badmodule -\end_layout - -\begin_layout Standard -The description is used in -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Document\SpecialChar \menuseparator -Settings -\end_layout - -\end_inset - - to provide the user with information about what the module does. - The -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -Requires -\end_layout - -\end_inset - - line is used to identify other modules with which this one must be used; - the -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -Excludes -\end_layout - -\end_inset - - line is used to identify modules with which this one may not be used. - Both are optional, and, as shown, multiple modules should be separated - with the pipe symbol: |. - Note that the required modules are treated disjunctively: -\emph on -at least one -\emph default - of the required modules must be used. - Similarly, -\emph on -no -\emph default - excluded module may be used. - Note that modules are identified here by their -\emph on -filenames -\emph default - without the .module extension. - So -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -somemodule -\end_layout - -\end_inset - - is really +After creating a new module and copying it to the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -somemodule.module +layout/ \end_layout \end_inset -. -\end_layout - -\begin_layout Standard -After creating a new module, you will need to reconfigure and then restart - LyX for the module to appear in the menu. + folder, you will need to reconfigure and then restart LyX for the module + to appear in the menu. However, changes you make to the module will be seen immediately, if you open \begin_inset Flex CharStyle:MenuItem @@ -6214,13 +6081,13 @@ OK . \emph on -It is strongly recommended that you save your work before doing so +It is strongly recommended that you save your work before doing this \emph default . In fact, \emph on it is strongly recommended that you not attempt to edit modules while simultaneo -usly working on documents +usly working on actual documents \emph default . Though of course the developers strive to keep LyX stable in such situations, @@ -6228,7 +6095,17 @@ usly working on documents \end_layout \begin_layout Subsection -Supporting new document classes +Layout for +\begin_inset Flex CharStyle:MenuItem +status collapsed + +\begin_layout Plain Layout +.sty +\end_layout + +\end_inset + + files \end_layout \begin_layout Standard @@ -6255,48 +6132,65 @@ status collapsed ) files. Supporting a style file is usually fairly easy. - Supporting a new document class is a bit harder. + Supporting a new class file is a bit harder. + We'll discuss the former in this section and the latter in the next. + Similar remarks apply, of course, if you want to support a new DocBook + DTD. \end_layout -\begin_layout Subsection -A layout for a +\begin_layout Standard +The easier case is the one in which your new document class is provided + as a style file that is to be used in conjunction with an already supported + document class. + For the sake of the example, we'll assume that the style file is called + \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -sty +myclass.sty \end_layout \end_inset - file -\end_layout - -\begin_layout Standard -If your new document class is provided as a style file that is used in conjuncti -on with an existing, supported document class—for the sake of the example, - we'll assume that the style file is called + and that it is meant to be used with \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -myclass.sty +report.cls \end_layout \end_inset - and it is meant to be used with -\begin_inset Flex CharStyle:MenuItem +, which is a standard class. + +\end_layout + +\begin_layout Standard +Start by copying the existing class's layout file into your local directory: +\begin_inset Foot status collapsed \begin_layout Plain Layout -report.cls +Of course, which directory is your local directory will vary by platform, + and LyX allows you to specify your local directory on startup, too, using + the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +-userdir +\end_layout + +\end_inset + + option. \end_layout \end_inset -, which is a standard class—start by copying the existing class's layout - file into your local directory: + \end_layout \begin_layout LyX-Code @@ -6404,571 +6298,511 @@ report in this example—so you can fiddle around with the settings for the different sections if you wish. -\end_layout - -\begin_layout Subsection -Layout for a -\begin_inset Flex CharStyle:MenuItem + The layout information for sections is contained in +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -cls +stdsections.inc \end_layout \end_inset - file +, but you do not need to copy and change this file. + Instead, you can simply add your changes to your layout file, after the + line +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Input stdclass.inc \end_layout -\begin_layout Standard -There are two possibilities here. - One is that the class file is itself based upon an existing document class. - For example, many thesis classes are based upon -\begin_inset Flex CharStyle:MenuItem +\end_inset + +, which itself includes +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -book.cls +stdsections.inc \end_layout \end_inset . - To see whether yours is, look for a line like + For example, you might add these lines: \end_layout \begin_layout LyX-Code - -\backslash -LoadClass{book} +Style Chapter \end_layout -\begin_layout Standard -in the file. - If so, then you may proceed largely as in the previous section, though - the DeclareLaTeXClass line will be different. - If your new class is thesis, and it is based upon book, then the line should - read: -\begin_inset Foot -status collapsed +\begin_layout LyX-Code + Font +\end_layout -\begin_layout Plain Layout -And it will be easiest if you save the file to -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code + Family Sans +\end_layout -\begin_layout Plain Layout -thesis.layout +\begin_layout LyX-Code + EndFont \end_layout -\end_inset +\begin_layout LyX-Code +End +\end_layout -: LyX assumes that the document class has the same name as the layout file. +\begin_layout Standard +to change the font for chapter headings to sans-serif. + This will override (or, in this case, add to) the existing declaration + for the Chapter style. \end_layout -\end_inset +\begin_layout Standard +Your new package may also provide commands or environments not present in + the base class. + In this case, you will want to add these to the layout file. + See +\begin_inset CommandInset ref +LatexCommand ref +reference "sec:TextClass" +\end_inset + for information on how to do so. \end_layout -\begin_layout LyX-Code +\begin_layout Standard +If +\begin_inset Flex CharStyle:MenuItem +status collapsed -\backslash -DeclareLaTeXClass[thesis,book]{thesis} +\begin_layout Plain Layout +myclass.sty \end_layout -\begin_layout Standard -If, on the other hand, the new class is not based upon an existing class, - you will probably have to -\begin_inset Quotes eld \end_inset -roll your own -\begin_inset Quotes erd -\end_inset - - layout. - We strongly suggest copying an existing layout file which uses a similar - LaTeX class and then modifying it, if you can do so. - At least use an existing file as a starting point so you can find out what - items you need to worry about. - Again, the specifics are covered below. -\end_layout - -\begin_layout Section -Declaring a new text class + can be used with several different document classes, and even if it cannot, + you might find it easiest just to write a module that you can load with + the base class. + The simplest possible such module would be: \end_layout -\begin_layout Standard -When it's finally time to get your hands dirty and create or edit your own - layout file, the following sections describe what you're up against. - Our advice is to go slowly, save and test often, listen to soothing music, - and enjoy one or two of your favorite adult beverages; more if you are - getting particularly stuck. - It's really not that hard, except that the multitude of options can become - overwhelming if you try to do to much in one sitting. - Go have another adult beverage, just for good measure. +\begin_layout LyX-Code +# +\backslash +DeclareLyXModule{My Package} \end_layout -\begin_layout Standard -Here we go! +\begin_layout LyX-Code +#DescriptionBegin \end_layout -\begin_layout Standard -Lines in a layout file which begin with a -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -# +\begin_layout LyX-Code +#Support for mypkg.sty. \end_layout +\begin_layout LyX-Code +#DescriptionEnd +\begin_inset Newline newline \end_inset - are comments. - There is one exception to this rule: all layouts should begin with lines - like: + \end_layout \begin_layout LyX-Code +Format 20 +\begin_inset Newline newline +\end_inset + -\size small -#% Do not delete the line below; configure depends on this \end_layout \begin_layout LyX-Code +Preamble +\begin_inset Newline newline +\end_inset -\size small -# + \backslash -DeclareLaTeXClass{article} +usepackage{mypkg} +\begin_inset Newline newline +\end_inset + +EndPreamble \end_layout \begin_layout Standard -The second line is used when you configure LyX. - The layout file is read by the LaTeX script -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -chkconfig.ltx -\end_layout +A more complex module might modify the behavior of some existing constructs + or define some new ones. + Again, see +\begin_inset CommandInset ref +LatexCommand ref +reference "sec:TextClass" \end_inset -, in a special mode where -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -# + for discussion. \end_layout -\end_inset - - is ignored. - The first line is just a LaTeX comment, and the second one contains the - declaration of the text class. - If these lines appear in a file named -\begin_inset Flex CharStyle:Code +\begin_layout Subsection +Layout for +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -article.layout +.cls \end_layout \end_inset -, then they define a text class of name -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -article + files \end_layout -\end_inset - - (the name of the layout file) which uses the LaTeX document class -\begin_inset Flex CharStyle:Code +\begin_layout Standard +There are two possibilities here. + One is that the class file is itself based upon an existing document class. + For example, many thesis classes are based upon +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -article.cls +book.cls \end_layout \end_inset - (the default is to use the same name as the layout). - The string -\begin_inset Quotes eld -\end_inset - -article -\begin_inset Quotes erd -\end_inset - - that appears above is used as a description of the text class in the -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Document\SpecialChar \menuseparator -Settings +. + To see whether yours is, look for a line like \end_layout -\end_inset +\begin_layout LyX-Code - dialog. +\backslash +LoadClass{book} \end_layout \begin_layout Standard -Let's assume that you wrote your own text class that uses the +in the file. + If so, then you may proceed largely as in the previous section, though + the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -article.cls +DeclareLaTeXClass \end_layout \end_inset - document class, but where you changed the appearance of the section headings. - If you put it in a file + line will be different. + If your new class is \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -myarticle.layout +thesis \end_layout \end_inset -, the header of this file should be: -\end_layout - -\begin_layout LyX-Code - -\size small -#% Do not delete the line below; configure depends on this -\end_layout - -\begin_layout LyX-Code - -\size small -# -\backslash -DeclareLaTeXClass[article]{article (with my own headings)} -\end_layout - -\begin_layout Standard -This declares a text class + and it is based upon \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -myarticle +book \end_layout \end_inset -, associated with the LaTeX document class +, then the line should read: +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +And it will be easiest if you save the file to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -article.cls +thesis.layout \end_layout \end_inset - and described as -\begin_inset Quotes eld -\end_inset +: LyX assumes that the document class has the same name as the layout file. + +\end_layout -article (with my own headings) -\begin_inset Quotes erd \end_inset -. - If your text class depends on several packages, you can declare it as: -\end_layout - -\begin_layout LyX-Code -\size small -#% Do not delete the line below; configure depends on this \end_layout \begin_layout LyX-Code -\size small -# \backslash -DeclareLaTeXClass[article,foo.sty]{article (with my own headings)} +DeclareLaTeXClass[thesis,book]{thesis} \end_layout \begin_layout Standard -This indicates that your text class uses the foo.sty package. - Finally, it is also possible to declare classes for DocBook code. - Typical declarations will look like -\end_layout +If, on the other hand, the new class is not based upon an existing class, + you will probably have to +\begin_inset Quotes eld +\end_inset -\begin_layout LyX-Code +roll your own +\begin_inset Quotes erd +\end_inset -\size small -#% Do not delete the line below; configure depends on this + layout. + We strongly suggest copying an existing layout file which uses a similar + LaTeX class and then modifying it, if you can do so. + At least use an existing file as a starting point so you can find out what + items you need to worry about. + Again, the specifics are covered below. \end_layout -\begin_layout LyX-Code +\begin_layout Subsection +Creating templates +\begin_inset CommandInset label +LatexCommand label +name "sub:Creating-Templates" + +\end_inset + -\size small -# -\backslash -DeclareDocBookClass[article]{SGML (DocBook article)} \end_layout \begin_layout Standard -Note that these declarations can also be given an optional parameter declaring - the name of the document class (but not a list). +Once you have written a layout file for a new document class, you might + want to consider writing a +\emph on +template +\emph default + for it, too. + A template acts as a kind of tutorial for your layout, showing how it might + be used, though containing dummy content. + You can of course look at the various templates included with LyX for ideas. \end_layout \begin_layout Standard -So, to be as explicit as possible, the form of the layout declaration is: -\end_layout +Templates are created just like usual documents: using LyX. + The only difference is that usual documents contain all possible settings, + including the font scheme and the paper size. + Usually a user doesn't want a template to overwrite his preferred settings + for such parameters. + For that reason, the designer of a template should remove the corresponding + commands like +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout LyX-Code +\begin_layout Plain Layout -\size small -# \backslash -DeclareLaTeXClass[class,package.sty]{layout description} +font_roman \end_layout -\begin_layout Standard -The class need only be specified if the name of the LaTeX class file and - the name of the layout file are different; if the name of the class file - is not specified, then LyX will simply assume that it is the same as the - name of the layout file. -\end_layout +\end_inset -\begin_layout Standard -When the text class has been modified to your taste, all you have to do - is to copy it either to + or \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LyXDir/layouts/ + +\backslash +papersize \end_layout \end_inset - or to + from the template LyX file. + This can be done with any simple text-editor, for example \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -UserDir/layouts +vi \end_layout \end_inset -, run -\begin_inset Flex CharStyle:MenuItem + or +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Tools\SpecialChar \menuseparator -Reconfigure +notepad \end_layout \end_inset -, exit LyX and restart it. - Then your new text class should be available along with the others. +. + \end_layout \begin_layout Standard -In versions of LyX prior to 1.6, you had to restart LyX to see any changes - you made to your layout files. - As a result, editing layout files could be very time consuming. - Beginning with 1.6, however, you can force a reload of the layout currently - in use by using the LyX function -\begin_inset Flex CharStyle:MenuItem +Put the edited template files you create in +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -layout-reload +UserDir/templates/ \end_layout \end_inset -. - There is no default binding for this function—though, of course, you can - bind it to a key yourself. - If you want to use this function, then, you should simply enter it in the - mini-buffer. - -\emph on -Warning -\emph default -: This is very much an `advanced feature'. - It is -\emph on -strongly -\emph default - recommended that you save your work before using this function. - In fact, it is -\emph on -strongly -\emph default - recommended that you not attempt to edit your layout while simultaneously - working on a document that you care about. - Use a test document. - Syntax errors and the like in your layout file could cause peculiar behavior. - In particular, such errors could cause LyX to regard the current layout - as invalid and to attempt to switch to some other layout. - The LyX team strives to keep LyX stable in such situations, but safe is - better than sorry. -\end_layout - -\begin_layout Subsection -File format -\end_layout - -\begin_layout Standard -The first non-comment line must contain the file format number: -\end_layout - -\begin_layout Description +, copy the ones you use from the global template directory in \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Format +LyXDir/templates/ \end_layout \end_inset - [ -\begin_inset Flex CharStyle:Code + to the same place, and redefine the template path in the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -int +Tools\SpecialChar \menuseparator +Preferences\SpecialChar \menuseparator +Paths \end_layout \end_inset -] This tag was introduced with LyX 1.4.0 (layout files of LyX 1.3.x and earlier - don't have an explicit file format). - The file format that is documented here is format 12. -\end_layout - -\begin_layout Subsection -General text class parameters + dialog. \end_layout \begin_layout Standard -These are the general parameters which describe the form of the entire document: -\end_layout - -\begin_layout Description +Note, by the way, that there is a template which has a particular meaning: + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -AddToPreamble +defaults.lyx \end_layout \end_inset - Adds information to the document preamble. - Must end with -\begin_inset Quotes eld -\end_inset - - -\begin_inset Flex CharStyle:Code +. + This template is loaded every time you create a new document with +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -EndPreamble +File\SpecialChar \menuseparator +New \end_layout \end_inset + in order to provide useful defaults. + To create this template from inside LyX, all you have to do is to open + a document with the correct settings, and use the +\begin_inset Flex CharStyle:MenuItem +status collapsed + +\begin_layout Plain Layout +Save as Document Defaults +\end_layout -\begin_inset Quotes erd \end_inset -. + button. \end_layout -\begin_layout Description +\begin_layout Subsection +Upgrading old layout files +\end_layout + +\begin_layout Standard +The format of layout files changes with each LyX release, so old layout + files need to be converted to the new format. + This process has been automated since LyX 1.4: If LyX reads a layout file + in an older format, it automatically calls the script \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ClassOptions +layout2layout.py \end_layout \end_inset - Describes various global options supported by the document class. - See Section -\begin_inset space ~ -\end_inset - - -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:classoptions" - -\end_inset + to convert it to a temporary file in current format. + The original file is left untouched. + If you use the layout file often, then, you may want to convert it permanently, + so that LyX does not have to do so itself every time. + To do this, you can call the converter manually: +\end_layout - for a description. - Must end with -\begin_inset Quotes eld -\end_inset +\begin_layout LyX-Code +mv myclass.layout myclass.old +\end_layout +\begin_layout LyX-Code +python LyXDir/scripts/layout2layout.py myclass.old myclass.layout +\end_layout +\begin_layout Standard +You need to replace \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -End +LyXDir \end_layout \end_inset + with the name of your LyX system directory, of course. +\end_layout -\begin_inset Quotes erd -\end_inset - -. +\begin_layout Standard +Note that manual conversion does not affect included files, so these will + have to be converted separately. \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout Section +\begin_inset CommandInset label +LatexCommand label +name "sec:TextClass" -\begin_layout Plain Layout -Columns +\end_inset + +The layout file format \end_layout -\end_inset +\begin_layout Standard +When it's finally time to get your hands dirty and create or edit your own + layout file, the following sections describe what you're up against. + Our advice is to go slowly, save and test often, listen to soothing music, + and enjoy one or two of your favorite adult beverages; more if you are + getting particularly stuck. + It's really not that hard, except that the multitude of options can become + overwhelming if you try to do too much in one sitting. + Go have another adult beverage, just for good measure. +\end_layout - [ +\begin_layout Standard +Note that all the tags used in layout files are case-insensitive. + This means that \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -1 +Style \end_layout \end_inset @@ -6978,670 +6812,670 @@ status collapsed status collapsed \begin_layout Plain Layout -2 +style \end_layout \end_inset -] Whether the class should default to having one or two columns. - Can be changed in the -\begin_inset Flex CharStyle:MenuItem + and +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Document\SpecialChar \menuseparator -Settings +StYlE \end_layout \end_inset - dialog. -\end_layout - -\begin_layout Description + are really the same tag. + The possible values are printed in brackets after the feature's name. + The default value if a feature isn't specified inside a text class-description + is typeset \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Counter + +\emph on +emphasized \end_layout \end_inset - This sequence defines a new counter. - See Section -\begin_inset space ~ +. + If the argument has a data type like +\begin_inset Quotes eld \end_inset - -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:counter" - +string +\begin_inset Quotes erd \end_inset - for details. - Must end with + or \begin_inset Quotes eld \end_inset +float +\begin_inset Quotes erd +\end_inset +, the default is shown like this: \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -End +float= +\emph on +default \end_layout \end_inset - -\begin_inset Quotes erd -\end_inset - . \end_layout -\begin_layout Description +\begin_layout Subsection +The Document Class Declaration +\end_layout + +\begin_layout Standard +Lines in a layout file which begin with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -DefaultFont +# \end_layout \end_inset - Sets the default font used to display the document. - See Section -\begin_inset space ~ -\end_inset - - -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:fonts" - -\end_inset - - for how to declare fonts. - Must end with -\begin_inset Quotes eld -\end_inset - - + are comments. + There is one exception to this rule. + All \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndFont +*.layout \end_layout \end_inset + files should begin with a line like: +\end_layout -\begin_inset Quotes erd -\end_inset +\begin_layout LyX-Code -. +\size small +#% Do not delete the line below; configure depends on this \end_layout -\begin_layout Description +\begin_layout LyX-Code + +\size small +# +\backslash +DeclareLaTeXClass{article} +\end_layout + +\begin_layout Standard +The second line is used when you (re)configure LyX. + The layout file is read by the LaTeX script \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -DefaultModule +chkconfig.ltx \end_layout \end_inset - [ +, in a special mode where \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string] +# \end_layout \end_inset - Specifies a module to be included by default with this document class, - which should be specified by filename without the + is ignored. + The first line is just a LaTeX comment, and the second one contains the + declaration of the text class. + If these lines appear in a file named \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -.module +article.layout \end_layout \end_inset - extension. - The user can still remove the module, but it will be active at the outset. - (This applies only when new files are created, or when this class is chosen - for an existing document.) -\end_layout - -\begin_layout Description +, then they define a text class of name \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -DefaultStyle +article \end_layout \end_inset - [ + (the name of the layout file) which uses the LaTeX document class \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +article.cls \end_layout \end_inset -] This is the style that will be assigned to new paragraphs, usually + (the default is to use the same name as the layout). + The string +\begin_inset Quotes eld +\end_inset + +article +\begin_inset Quotes erd +\end_inset + + that appears above is used as a description of the text class in the \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Standard +Document\SpecialChar \menuseparator +Settings \end_layout \end_inset -. - This will default to the first defined style if not given, but you are - highly encouraged to use this directive. + dialog. \end_layout -\begin_layout Description +\begin_layout Standard +Let's assume that you wrote your own text class that uses the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ExcludesModule +article.cls \end_layout \end_inset - [ + document class, but where you changed the appearance of the section headings. + If you put it in a file \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +myarticle.layout \end_layout \end_inset -] Indicates that the module in question—which should be specified by filename - without the -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -.module +, the header of this file should be: \end_layout -\end_inset - - extension—cannot be used with this document class. - This might be used in a journal-specific layout file to prevent, say, the - use of the -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code -\begin_layout Plain Layout -theorems-sec +\size small +#% Do not delete the line below; configure depends on this \end_layout -\end_inset - - module that numbers theorems by section. - This tag may -\emph on -not -\emph default - be used in a module. - Modules have their own way of excluding other modules (see -\begin_inset CommandInset ref -LatexCommand ref -reference "sub:Layout-modules" - -\end_inset +\begin_layout LyX-Code -). +\size small +# +\backslash +DeclareLaTeXClass[article]{article (with my own headings)} \end_layout -\begin_layout Description +\begin_layout Standard +This declares a text class \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Float +myarticle \end_layout \end_inset - Defines a new float. - See Section -\begin_inset space ~ -\end_inset - - -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:floats" - -\end_inset - - for details. - Must end with -\begin_inset Quotes eld -\end_inset - - +, associated with the LaTeX document class \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -End +article.cls \end_layout \end_inset + and described as +\begin_inset Quotes eld +\end_inset +article (with my own headings) \begin_inset Quotes erd \end_inset . + If your text class depends on several packages, you can declare it as: \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code -\begin_layout Plain Layout -Input +\size small +#% Do not delete the line below; configure depends on this \end_layout -\end_inset +\begin_layout LyX-Code - As its name implies, this command allows you to include another layout - definition file within yours to avoid duplicating commands. - Common examples are the standard layout files, for example, +\size small +# +\backslash +DeclareLaTeXClass[article,foo.sty]{article (with my own headings)} +\end_layout + +\begin_layout Standard +This indicates that your text class uses the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -stdclass.inc +foo.sty \end_layout \end_inset -, which contains most of the basic layouts. + package. + Finally, it is also possible to declare classes for DocBook code. + Typical declarations will look like: \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code -\begin_layout Plain Layout -InsetLayout +\size small +#% Do not delete the line below; configure depends on this \end_layout -\end_inset - - This section (re-)defines the layout of an inset. - It can be applied to an existing inset of to a new, user-defined inset, - e. -\begin_inset space \thinspace{} -\end_inset - -g. -\begin_inset space \space{} -\end_inset +\begin_layout LyX-Code -a new character style. - See Section -\begin_inset space ~ -\end_inset +\size small +# +\backslash +DeclareDocBookClass[article]{SGML (DocBook article)} +\end_layout +\begin_layout Standard +Note that these declarations can also be given an optional parameter declaring + the name of the document class (but not a list). +\end_layout -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:charstyle" +\begin_layout Standard +So, to be as explicit as possible, the form of the layout declaration is: +\end_layout -\end_inset +\begin_layout LyX-Code - for more information. - Must end with -\begin_inset Quotes eld -\end_inset +\size small +# +\backslash +DeclareLaTeXClass[class,package.sty]{layout description} +\end_layout +\begin_layout Standard +The class need only be specified if the name of the LaTeX class file and + the name of the layout file are different; if the name of the class file + is not specified, then LyX will simply assume that it is the same as the + name of the layout file. +\end_layout +\begin_layout Standard +When the text class has been modified to your taste, all you have to do + is to copy it either to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -End +LyXDir/layouts/ \end_layout \end_inset - -\begin_inset Quotes erd -\end_inset - -. -\end_layout - -\begin_layout Description + or to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LeftMargin +UserDir/layouts \end_layout \end_inset - A string that indicates the width of the left margin on the screen, for - example, -\begin_inset Quotes eld -\end_inset - -MMMMM -\begin_inset Quotes erd -\end_inset - -. -\end_layout - -\begin_layout Description -\begin_inset Flex CharStyle:Code +, run +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -NoFloat +Tools\SpecialChar \menuseparator +Reconfigure \end_layout \end_inset - This command deletes an existing float. - This is particularly useful when you want to suppress a float that has - be defined in an input file. +, exit LyX and restart. + Then your new text class should be available along with the others. \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code +\begin_layout Standard +Once the layout file is installed, you can edit it and see your changes + without having to reconfigure or to restart LyX. + +\begin_inset Foot status collapsed \begin_layout Plain Layout -NoStyle +In versions of LyX prior to 1.6, this was not true. + As a result, editing layout files was very time consuming, since you had + constantly to restart LyX to see changes. \end_layout \end_inset - This command deletes an existing style. - This is particularly useful when you want to suppress a style that has - be defined in an input file. -\end_layout - -\begin_layout Description -\begin_inset Flex CharStyle:Code + You can force a reload of the current layout by using the LyX function + +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -OutputType +layout-reload \end_layout \end_inset - A string indicating what sort of output documents using this class will - produce. - At present, the options are: `docbook', `latex', and `literate'. +. + There is no default binding for this function—though, of course, you can + bind it to a key yourself. + But you will normally use this function simply by entering it in the mini-buffe +r. + \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code +\begin_layout Standard + +\emph on +Warning +\emph default +: +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout - -\series medium -PageStyle +layout-reload \end_layout \end_inset - [ -\emph on - -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout - + is very much an `advanced feature'. + It is \emph on -plain -\end_layout - -\end_inset - - +strongly \emph default -, -\begin_inset Flex CharStyle:Code + recommended that you save your work before using this function. + In fact, it is +\emph on +strongly +\emph default + recommended that you not attempt to edit layout information while simultaneousl +y working on a document that you care about. + Use a test document. + Syntax errors and the like in your layout file could cause peculiar behavior. + In particular, such errors could cause LyX to regard the current layout + as invalid and to attempt to switch to some other layout. +\begin_inset Foot status collapsed \begin_layout Plain Layout -empty +Really bad syntax errors may even caused LyX to exit. + This is because certain sorts of errors may make LyX unable to read +\emph on +any +\emph default + layout information. + Please be careful. \end_layout \end_inset -, -\begin_inset Flex CharStyle:Code + The LyX team strives to keep LyX stable in such situations, but safe is + better than sorry. +\begin_inset Foot status collapsed \begin_layout Plain Layout -headings +While we're giving advice: make regular backups. + And be nice to your mother. \end_layout \end_inset -] The class default pagestyle. - Can be changed in the -\begin_inset Flex CharStyle:MenuItem -status collapsed -\begin_layout Plain Layout -Document\SpecialChar \menuseparator -Settings \end_layout -\end_inset +\begin_layout Subsection +The Module Declaration +\end_layout - dialog. +\begin_layout Standard +A module must begin with a line like the following: \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code +\begin_layout LyX-Code +# +\backslash +DeclareLyXModule[endnotes.sty]{Endnotes} +\end_layout + +\begin_layout Standard +The mandatory argument, in curly brackets, is the name of the module, as + it should appear in +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Preamble +Document\SpecialChar \menuseparator +Settings \end_layout \end_inset - Sets the preamble for the LaTeX document. - Note that this will completely override any prior -\begin_inset Flex CharStyle:Code +. + The argument in square brackets is optional: It declares any LaTeX packages + on which the module depends. + Please note that only packages about which LyX knows should be listed in + the square brackets. +\begin_inset Foot status collapsed \begin_layout Plain Layout -Preamble +The list of such packages is documented only in the source code. \end_layout \end_inset - or -\begin_inset Flex CharStyle:Code + LyX will not check for arbitrary packages. + It is also possible to use the form +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -AddToPreamble +from->to \end_layout \end_inset - declarations. - Must end with -\begin_inset Quotes eld -\end_inset - - + as an optional argument, which declares that the module can only be used + when there exists a conversion chain between the formats ` \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndPreamble +from \end_layout \end_inset - -\begin_inset Quotes erd -\end_inset - -. -\end_layout - -\begin_layout Description +' and ` \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Provides +to \end_layout \end_inset - [ -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -string +'. \end_layout -\end_inset +\begin_layout Standard +The module declaration should then be followed by lines like the following: +\end_layout -] [ -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code +#DescriptionBegin +\end_layout -\begin_layout Plain Layout +\begin_layout LyX-Code +#Adds an endnote command, in addition to footnotes. + +\end_layout -\emph on -0 +\begin_layout LyX-Code +#You will need to add +\backslash +theendnotes in TeX code where you \end_layout -\end_inset +\begin_layout LyX-Code +#want the endnotes to appear. + +\end_layout -, -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code +#DescriptionEnd +\end_layout -\begin_layout Plain Layout -1 +\begin_layout LyX-Code +#Requires: somemodule | othermodule \end_layout -\end_inset +\begin_layout LyX-Code +#Excludes: badmodule +\end_layout -] Whether the class already provides the feature -\begin_inset Flex CharStyle:Code +\begin_layout Standard +The description is used in +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -string +Document\SpecialChar \menuseparator +Settings \end_layout \end_inset -. - A feature is in general the name of a package ( + to provide the user with information about what the module does. + The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -amsmath +Requires \end_layout \end_inset -, + line is used to identify other modules with which this one must be used; + the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -makeidx +Excludes \end_layout \end_inset -, \SpecialChar \ldots{} -) or a macro ( + line is used to identify modules with which this one may not be used. + Both are optional, and, as shown, multiple modules should be separated + with the pipe symbol: |. + Note that the required modules are treated disjunctively: +\emph on +at least one +\emph default + of the required modules must be used. + Similarly, +\emph on +no +\emph default + excluded module may be used. + Note that modules are identified here by their +\emph on +filenames +\emph default + without the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -url +.module \end_layout \end_inset -, + extension. + So \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -boldsymbol +somemodule \end_layout \end_inset -,\SpecialChar \ldots{} -); the complete list of supported features is unfortunately not documented - outside the LyX source code—but see + is really \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LaTeXFeatures.cpp +somemodule.module \end_layout \end_inset - if you're interested. - -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Help\SpecialChar \menuseparator -LaTeX Configuration +. \end_layout -\end_inset +\begin_layout Subsection +File format +\end_layout - also gives an overview of the supported packages. +\begin_layout Standard +The first non-comment line of any layout file, included file, or module + +\emph on +must +\emph default + contain the file format number: \end_layout \begin_layout Description @@ -7649,7 +7483,7 @@ LaTeX Configuration status collapsed \begin_layout Plain Layout -ProvidesModule +Format \end_layout \end_inset @@ -7659,37 +7493,56 @@ ProvidesModule status collapsed \begin_layout Plain Layout -string +int \end_layout \end_inset -] Indicates that this layout provides the functionality of the module mentioned, - which should be specified by the filename without the -\begin_inset Flex CharStyle:Code -status collapsed +] The format of the layout file. +\end_layout -\begin_layout Plain Layout -.module +\begin_layout Standard +This tag was introduced with LyX 1.4.0. + Layout files from LyX 1.3.x and earlier don't have an explicit file format + and are considered to be of format 1. + The format for the present version of LyX is format 20. + But each version of LyX is capable of reading earlier versions' layout + files, just as they are capable of reading files produced by earlier versions + of LyX. + There is, however, no provision for converting to earlier formats. + So LyX 1.6.x will not read layout files in format 20 but only files in format + 11 or earlier. \end_layout +\begin_layout Subsection +\begin_inset CommandInset label +LatexCommand label +name "sub:General-text-class" + \end_inset - extension. - This will typically be used if the layout includes the module directly, - rather than using the +General text class parameters +\end_layout + +\begin_layout Standard +These are general parameters that govern the behavior of an entire document + class. + (This does +\emph on +not +\emph default + mean that they must appear in \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -DefaultModule +.layout \end_layout \end_inset - tag to indicate that it ought to be used. - It could be used in a module that provided an alternate implementation - of the same functionality. + files rather than in modules. + A module can contain any layout tag.) \end_layout \begin_layout Description @@ -7697,52 +7550,49 @@ DefaultModule status collapsed \begin_layout Plain Layout -Requires +AddToHTMLPreamble \end_layout \end_inset - [ + Adds information that will be output in the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string + \end_layout \end_inset -] Whether the class requires the feature + block when this document class is output to XHTML. + Typically, this would be used to output CSS style information, but it can + be used for anything that can appear in \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string + \end_layout \end_inset . - Multiple features must be separated by commas. - Note that you can only request supported features. -\end_layout + Must end with +\begin_inset Quotes eld +\end_inset + -\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -RightMargin +EndPreamble \end_layout \end_inset - A string that indicates the width of the right margin on the screen, for - example, -\begin_inset Quotes eld -\end_inset -MMMMM \begin_inset Quotes erd \end_inset @@ -7754,75 +7604,31 @@ MMMMM status collapsed \begin_layout Plain Layout -SecNumDepth +AddToPreamble \end_layout \end_inset - Sets which divisions get numbered. - Corresponds to the -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -secnumdepth -\end_layout - -\end_inset - - counter in LaTeX. -\end_layout - -\begin_layout Description -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -Sides -\end_layout - -\end_inset - - [ -\emph on - -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout - -\emph on -1 -\end_layout - + Adds information to the document preamble. + Must end with +\begin_inset Quotes eld \end_inset -\emph default -, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -2 +EndPreamble \end_layout \end_inset -] Whether the class-default should be printing on one or both sides of the - paper. - Can be changed in the -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -Document\SpecialChar \menuseparator -Settings -\end_layout +\begin_inset Quotes erd \end_inset - dialog. +. \end_layout \begin_layout Description @@ -7830,13 +7636,12 @@ Settings status collapsed \begin_layout Plain Layout -Style +ClassOptions \end_layout \end_inset - This sequence defines a new paragraph style. - If the style already exists, it will redefine some of its parameters instead. + Describes various global options supported by the document class. See Section \begin_inset space ~ \end_inset @@ -7844,11 +7649,11 @@ Style \begin_inset CommandInset ref LatexCommand ref -reference "sec:style" +reference "sub:ClassOptions" \end_inset - for details. + for a description. Must end with \begin_inset Quotes eld \end_inset @@ -7875,7 +7680,7 @@ End status collapsed \begin_layout Plain Layout -TitleLatexName +Columns \end_layout \end_inset @@ -7885,107 +7690,125 @@ TitleLatexName status collapsed \begin_layout Plain Layout -string="maketitle" + +\emph on +1 \end_layout \end_inset -] The name of the command or environment to be used with +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TitleLatexType +2 \end_layout \end_inset -. -\end_layout - -\begin_layout Description -\begin_inset Flex CharStyle:Code +] Whether the class should +\emph on +default +\emph default + to having one or two columns. + Can be changed in the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -TitleLatexType +Document\SpecialChar \menuseparator +Settings \end_layout \end_inset - [ + dialog. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -CommandAfter +Counter \end_layout \end_inset -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Environment +string \end_layout \end_inset -] Indicates what kind of markup is used to define the title of a document. - +] This sequence defines the properties for a counter. + If the counter does not yet exist, it is created; if it does exist, it + is modified. + Must end with +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -CommandAfter +End \end_layout \end_inset - means that the macro with name -\begin_inset Flex CharStyle:Code -status collapsed -\begin_layout Plain Layout -TitleLatexName -\end_layout +\begin_inset Quotes erd +\end_inset +. +\begin_inset Newline newline \end_inset - will be inserted after the last layout which has -\begin_inset Quotes eld +See Section +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Counters" + \end_inset + for details on counters. +\end_layout +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InTitle 1 +DefaultFont \end_layout \end_inset - -\begin_inset Quotes erd + Sets the default font used to display the document. + See Section +\begin_inset space ~ \end_inset -. - -\begin_inset Flex CharStyle:Code -status collapsed -\begin_layout Plain Layout -Environment -\end_layout +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Font-description" \end_inset - corresponds to the case where the block of paragraphs which have + for how to declare fonts. + Must end with \begin_inset Quotes eld \end_inset @@ -7994,7 +7817,7 @@ Environment status collapsed \begin_layout Plain Layout -InTitle 1 +EndFont \end_layout \end_inset @@ -8003,74 +7826,79 @@ InTitle 1 \begin_inset Quotes erd \end_inset - should be enclosed into the +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TitleLatexName +DefaultModule \end_layout \end_inset - environment. -\end_layout - -\begin_layout Description + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TocDepth +string] \end_layout \end_inset - Sets which divisions are included in the table of contents. - Corresponds to the + Specifies a module to be included by default with this document class. + The module should be specified by filename without the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -tocdepth +.module \end_layout \end_inset - counter in LaTeX. + extension. + The user can still remove the module, but it will be active at the outset. + (This applies only when new files are created, or when this class is chosen + for an existing document.) \end_layout -\begin_layout Subsection +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ClassOptions +DefaultStyle \end_layout \end_inset - section -\end_layout + [ +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "sec:classoptions" +\begin_layout Plain Layout +string +\end_layout \end_inset -The -\begin_inset Flex CharStyle:Code +] This is the style that will be assigned to new paragraphs, usually +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -ClassOptions +Standard \end_layout \end_inset - section can contain the following entries: +. + This will default to the first defined style if not given, but you are + encouraged to use this directive. \end_layout \begin_layout Description @@ -8078,7 +7906,7 @@ ClassOptions status collapsed \begin_layout Plain Layout -FontSize +ExcludesModule \end_layout \end_inset @@ -8088,31 +7916,48 @@ FontSize status collapsed \begin_layout Plain Layout -string="10|11|12" +string \end_layout \end_inset -] The list of available font sizes for the document's main font, separated - by -\begin_inset Quotes eld -\end_inset +] This tag indicates that the module in question—which should be specified + by filename without the +\begin_inset Flex CharStyle:Code +status collapsed +\begin_layout Plain Layout +.module +\end_layout + +\end_inset + extension—cannot be used with this document class. + This might be used in a journal-specific layout file to prevent, say, the + use of the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -| +theorems-sec \end_layout \end_inset + module that numbers theorems by section. + This tag may +\emph on +not +\emph default + be used in a module. + Modules have their own way of excluding other modules (see +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Layout-modules" -\begin_inset Quotes erd \end_inset -. +). \end_layout \begin_layout Description @@ -8120,21 +7965,39 @@ status collapsed status collapsed \begin_layout Plain Layout -Header +Float \end_layout \end_inset - Used to set the DTD line with XML-based output classes. - E. -\begin_inset space \thinspace{} + Defines a new float. + See Section +\begin_inset space ~ \end_inset -g.: PUBLIC + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Floats" + +\end_inset + + for details. + Must end with \begin_inset Quotes eld \end_inset --//OASIS//DTD DocBook V4.2//EN + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +End +\end_layout + +\end_inset + + \begin_inset Quotes erd \end_inset @@ -8146,90 +8009,97 @@ g.: PUBLIC status collapsed \begin_layout Plain Layout -PageStyle +HTMLPreamble \end_layout \end_inset - [ + Sets the information that will be output in the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string="empty|plain|headings|fancy" + \end_layout \end_inset -] The list of available page styles, separated by -\begin_inset Quotes eld -\end_inset - - + block when this document class is output to XHTML. + Note that this will completely override any prior \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -| +HTMLPreamble \end_layout \end_inset + or +\begin_inset Flex CharStyle:Code +status collapsed -\begin_inset Quotes erd -\end_inset - -. +\begin_layout Plain Layout +AddToHTMLPreamble \end_layout -\begin_layout Description +\end_inset + + declarations. + (Use \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Other +AddToHTMLPreamble \end_layout \end_inset - [ + if you just want to add material to the preamble.) Must end with +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string="" +EndPreamble \end_layout \end_inset -] Some document class options, separated by a comma, that will be added - to the optional part of the + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -documentclass +IfCounter \end_layout \end_inset - command. -\end_layout - -\begin_layout Standard -The + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ClassOptions +string \end_layout \end_inset - section must end with +] Modifies the properties of the given counter. + If the counter does not exist, the section is ignored. + Must end with \begin_inset Quotes eld \end_inset @@ -8248,49 +8118,64 @@ End \end_inset . -\end_layout +\begin_inset Newline newline +\end_inset -\begin_layout Subsection -Paragraph Styles -\end_layout +See Section +\begin_inset space ~ +\end_inset -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "sec:style" + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Counters" \end_inset -A paragraph style description looks like this: -\begin_inset Foot + for details on counters. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Note that this will either define a new layout or modify an existing one. +IfStyle \end_layout \end_inset + [ +\begin_inset Flex CharStyle:Code +status collapsed +\begin_layout Plain Layout +string \end_layout -\begin_layout LyX-Code -Style -\family roman -\emph on -name -\end_layout +\end_inset -\begin_layout LyX-Code - ... -\end_layout +] Modifies the properties of the given paragraph style. + If the style does not exist, the section is ignored. + Must end with +\begin_inset Quotes eld +\end_inset -\begin_layout LyX-Code + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout End \end_layout -\begin_layout Standard -where the following commands are allowed: +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. \end_layout \begin_layout Description @@ -8298,26 +8183,24 @@ where the following commands are allowed: status collapsed \begin_layout Plain Layout -Align +Input \end_layout \end_inset - [ + As its name implies, this command allows you to include another layout + definition file within yours to avoid duplicating commands. + Common examples are the standard layout files, for example, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -block -\emph default -, left, right, center +stdclass.inc \end_layout \end_inset -] Paragraph alignment. +, which contains most of the basic layouts. \end_layout \begin_layout Description @@ -8325,29 +8208,49 @@ block status collapsed \begin_layout Plain Layout -AlignPossible +InsetLayout \end_layout \end_inset - [ + This section (re-)defines the layout of an inset. + It can be applied to an existing inset or to a new, user-defined inset, + e.g., a new character style. + Must end with +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -block -\emph default -, left, right, center +End \end_layout \end_inset -] A comma separated list of permitted alignments. - (Some LaTeX styles prohibit certain alignments, since those wouldn't make - sense. - For example a right-aligned or centered enumeration isn't possible.) + +\begin_inset Quotes erd +\end_inset + +. +\begin_inset Newline newline +\end_inset + +See Section +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Flex-insets-and" + +\end_inset + + for more information. + \end_layout \begin_layout Description @@ -8355,7 +8258,7 @@ block status collapsed \begin_layout Plain Layout -BottomSep +LeftMargin \end_layout \end_inset @@ -8365,25 +8268,30 @@ BottomSep status collapsed \begin_layout Plain Layout -float=0 +string \end_layout \end_inset -] -\begin_inset Foot -status collapsed +] A string that indicates the width of the left margin on the screen, for + example, +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout -Note that a `float' here is a real number, such as: 1.5. -\end_layout +MMMMM +\begin_inset Quotes erd +\end_inset +. + (Note that this is not a `length', like +\begin_inset Quotes eld \end_inset - The vertical space with which the last of a chain of paragraphs with this - layout is separated from the following paragraph. - If the next paragraph has another layout, the separations are not simply - added, but the maximum is taken. +2ex +\begin_inset Quotes erd +\end_inset + +.) \end_layout \begin_layout Description @@ -8391,26 +8299,29 @@ Note that a `float' here is a real number, such as: 1.5. status collapsed \begin_layout Plain Layout -Category +NoFloat \end_layout \end_inset - + This command deletes an existing float. + This is particularly useful when you want to suppress a float that has + been defined in an input file. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -[string] +NoStyle \end_layout \end_inset - The category for this style. - This is used to group related styles in the Layout combobox on the toolbar. - Any string can be used, but you may want to use existing categories with - your own styles. - + This command deletes an existing style. + This is particularly useful when you want to suppress a style that has + be defined in an input file. \end_layout \begin_layout Description @@ -8418,44 +8329,51 @@ status collapsed status collapsed \begin_layout Plain Layout -CommandDepth +OutputFormat \end_layout \end_inset - Depth of XML command. - Used only with XML-type formats. -\end_layout - -\begin_layout Description + A string indicating the file format (as defined in the Preferences dialog) + produced by this class. + It is mainly useful when \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -CopyStyle +OutputType \end_layout \end_inset - -\begin_inset CommandInset label -LatexCommand label -name "des:CopyStyle" + is `literate' and one wants to define a new type of literate document. + This string is reset to `docbook', `latex', or `literate' when the correspondin +g +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +OutputType +\end_layout \end_inset + parameter is encountered. +\end_layout +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -[string] +OutputType \end_layout \end_inset - Copies all the features of an existing style into the current one. - + A string indicating what sort of output documents using this class will + produce. + At present, the options are: `docbook', `latex', and `literate'. \end_layout \begin_layout Description @@ -8463,84 +8381,79 @@ status collapsed status collapsed \begin_layout Plain Layout -DependsOn +PageStyle \end_layout \end_inset - The name of a style whose preamble should be output + [ \emph on -before -\emph default - this one. - This allows to ensure some ordering of the preamble snippets when macros - definitions depend on one another. -\begin_inset Foot + +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Note that, besides that functionality, there is no way to ensure any ordering - of preambles. - The ordering that you see in a given version of LyX may change without - warning in later versions. + +\emph on +plain \end_layout \end_inset -\end_layout - -\begin_layout Description +\emph default +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndLabeltype +empty \end_layout \end_inset - [ +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -No_Label -\emph default -, Box, Filled_Box, Static -\end_layout +headings +\end_layout \end_inset -] The type of label that stands at the end of the paragraph (or sequence - of paragraphs if -\begin_inset Flex CharStyle:Code +] The default pagestyle. + Can be changed in the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -LatexType +Document\SpecialChar \menuseparator +Settings \end_layout \end_inset - is + dialog. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Environment +Preamble \end_layout \end_inset -, + Sets the preamble for the LaTeX document. + Note that this will completely override any prior \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Item_Environment +Preamble \end_layout \end_inset @@ -8550,224 +8463,210 @@ Item_Environment status collapsed \begin_layout Plain Layout -List_Environment +AddToPreamble \end_layout \end_inset -). - + declarations. + (Use \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -No_Label +AddToPreamble \end_layout \end_inset - means + if you just want to add material to the preamble.) Must end with \begin_inset Quotes eld \end_inset -nothing -\begin_inset Quotes erd -\end_inset -, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Box +EndPreamble \end_layout \end_inset - (resp. -\begin_inset Flex CharStyle:Code -status collapsed -\begin_layout Plain Layout -\begin_inset space ~ +\begin_inset Quotes erd \end_inset -Filled_Box +. \end_layout -\end_inset - -) is a white (resp. -\begin_inset space ~ -\end_inset - -black) square suitable for end of proof markers, +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Static +Provides \end_layout \end_inset - is an explicit text string. -\end_layout - -\begin_layout Description + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndLabelString +string \end_layout \end_inset - [ +] [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string="" + +\emph on +0 \end_layout \end_inset -] The string used for a label with a +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Static +1 \end_layout \end_inset - +] Whether the class already provides the feature \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndLabelType +string \end_layout \end_inset . - -\end_layout - -\begin_layout Description + A feature is in general the name of a package ( \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Fill_Bottom +amsmath \end_layout \end_inset - [ +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -0 -\emph default -,1 +makeidx \end_layout \end_inset -] Similar to +, \SpecialChar \ldots{} +) or a macro ( \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Fill_Top +url \end_layout \end_inset -. -\end_layout - -\begin_layout Description +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Fill_Top +boldsymbol \end_layout \end_inset - [ +,\SpecialChar \ldots{} +); the complete list of supported features is unfortunately not documented + outside the LyX source code—but see \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -0 -\emph default -,1 +LaTeXFeatures.cpp \end_layout \end_inset -] With this parameter the + if you're interested. + \begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Fill +Help\SpecialChar \menuseparator +LaTeX Configuration \end_layout \end_inset - value of the -\begin_inset Quotes eld -\end_inset + also gives an overview of the supported packages. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +ProvidesModule +\end_layout -Vertical space above -\begin_inset Quotes erd \end_inset - list of the -\begin_inset Flex CharStyle:MenuItem + [ +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Edit\SpecialChar \menuseparator -Paragraph -\begin_inset space ~ +string +\end_layout + \end_inset -Settings +] Indicates that this layout provides the functionality of the module mentioned, + which should be specified by the filename without the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +.module \end_layout \end_inset - dialog can be set when initializing a paragraph with this style. -\begin_inset Foot + extension. + This will typically be used if the layout includes the module directly, + rather than using the +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -Note from Jean-Marc: -\emph default - I'm not sure that this setting has much use, and it should probably be - removed in later versions. +DefaultModule \end_layout \end_inset - + tag to indicate that it ought to be used. + It could also be used in a module that provided an alternate implementation + of the same functionality. \end_layout \begin_layout Description @@ -8775,50 +8674,45 @@ Note from Jean-Marc: status collapsed \begin_layout Plain Layout -Font +Requires \end_layout \end_inset - The font used for both the text body -\emph on -and -\emph default - the label. - See section -\begin_inset space ~ -\end_inset - + [ +\begin_inset Flex CharStyle:Code +status collapsed -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:fonts" +\begin_layout Plain Layout +string +\end_layout \end_inset -. - Note that defining this font automatically defines the +] Whether the class requires the feature \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelFont +string \end_layout \end_inset - to the same value. - So you should define this one first if you also want to define +. + Multiple features must be separated by commas. + Note that you can only request supported features. + (Again, see \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelFont +LaTeXFeatures.cpp \end_layout \end_inset -. + for a list of these.) \end_layout \begin_layout Description @@ -8826,62 +8720,45 @@ LabelFont status collapsed \begin_layout Plain Layout -FreeSpacing +RightMargin \end_layout \end_inset - -\begin_inset CommandInset label -LatexCommand label -name "des:FreeSpacing" - + A string that indicates the width of the right margin on the screen, for + example, +\begin_inset Quotes eld \end_inset -[ -\emph on - -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout - -\emph on -0 -\end_layout - +MMMMM +\begin_inset Quotes erd \end_inset +. +\end_layout -\emph default -, +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +SecNumDepth \end_layout \end_inset -] Usually LyX doesn't allow you to insert more than one space between words, - since a space is considered as the separation between two words, not a - character or symbol of its own. - This is a very fine thing but sometimes annoying, for example, when typing - program code or plain LaTeX code. - For this reason, + Sets which divisions get numbered. + Corresponds to the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -FreeSpacing +secnumdepth \end_layout \end_inset - can be enabled. - Note that LyX will create protected blanks for the additional blanks when - in another mode than LaTeX-mode. + counter in LaTeX. \end_layout \begin_layout Description @@ -8889,300 +8766,236 @@ FreeSpacing status collapsed \begin_layout Plain Layout -I18NPreamble +Sides \end_layout \end_inset - Language dependent information to be included in the LaTeX preamble when - this style is used. - Note that this will completely override any prior + [ +\emph on + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -I18NPreamble -\end_layout -\end_inset +\emph on +1 +\end_layout - declarations. - Must end with -\begin_inset Quotes eld \end_inset +\emph default +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndI18NPreamble +2 \end_layout \end_inset - -\begin_inset Quotes erd -\end_inset - -. - The contents of this tag will occur once in the LaTeX preamble for each - language used by the document. - Each time, the following substitutions are made: -\end_layout - -\begin_deeper -\begin_layout Itemize -\begin_inset Flex CharStyle:Code +] Whether the class-default should be printing on one or both sides of the + paper. + Can be changed in the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -$$lang +Document\SpecialChar \menuseparator +Settings \end_layout \end_inset - is replaced by the language name (as used by the babel package). + dialog. \end_layout -\begin_layout Itemize -The -\begin_inset Quotes eld -\end_inset - -Function -\begin_inset Quotes erd -\end_inset - - +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -_() +Style \end_layout \end_inset - replaces its argument by the translation of the argument to the current - language. -\end_layout + This sequence defines a paragraph style. + If the style does not yet exist, it is created; if it does exist, its parameter +s are modified. + Must end with +\begin_inset Quotes eld +\end_inset + -\begin_layout Standard -If the style defines text that appears in the typeset document, it may use - \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -I18NPreamble +End \end_layout \end_inset - to support non-english and even multilanguage documents correctly. - The following excerpt (from the -\begin_inset Flex CharStyle:Code -status collapsed -\begin_layout Plain Layout -theorems-ams.inc -\end_layout +\begin_inset Quotes erd +\end_inset +. +\begin_inset Newline newline \end_inset - file) shows how this works: -\end_layout +See Section +\begin_inset space ~ +\end_inset -\begin_layout LyX-Code -Preamble -\end_layout -\begin_layout LyX-Code - -\backslash -providecommand{ -\backslash -claimname}{Claim} -\end_layout +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Paragraph-Styles" -\begin_layout LyX-Code - -\backslash -theoremstyle{remark} -\end_layout +\end_inset -\begin_layout LyX-Code - -\backslash -newtheorem{claim}[thm]{ -\backslash -protect -\backslash -claimname} + for details on paragraph styles. \end_layout -\begin_layout LyX-Code -EndPreamble -\end_layout +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout LyX-Code -I18nPreamble +\begin_layout Plain Layout +TitleLatexName \end_layout -\begin_layout LyX-Code - -\backslash -AtBeginDocument{ -\backslash -ifx -\backslash -LdfInit -\backslash -undefined -\backslash -relax -\backslash -else% -\end_layout +\end_inset -\begin_layout LyX-Code - -\backslash -addto -\backslash -captions$$lang{ -\backslash -renewcommand{ -\backslash -claimname}{_(Claim)}}% -\end_layout + [ +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout LyX-Code - -\backslash -fi} +\begin_layout Plain Layout +string="maketitle" \end_layout -\begin_layout LyX-Code -EndI18nPreamble -\end_layout +\end_inset -\begin_layout Standard -The key to correct translation of the user visible text is the definition - of the command +] The name of the command or environment to be used with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -claimname +TitleLatexType \end_layout \end_inset - in the standard preamble. - This command holds the name of the theorem that will appear in the output. - The +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -I18NPreamble +TitleLatexType \end_layout \end_inset - then uses the commands offered by the babel package to redefine + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -\backslash -claimname +\emph on +CommandAfter \end_layout \end_inset - for each used language. - The +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -ifx -\backslash -LdfInit +Environment \end_layout \end_inset - test ensures that no LaTeX error occurs in documents that do not use babel. - Since LyX loads babel after the style-specific preamble, the whole command - is deferred to the actual start of the document with +] Indicates what kind of markup is used to define the title of a document. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -AtBeginDocument +CommandAfter \end_layout \end_inset -. -\end_layout - -\end_deeper -\begin_layout Description + means that the macro with name \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InnerTag +TitleLatexName \end_layout \end_inset - [[FIXME]] (Used only with XML-type formats.) -\end_layout + will be inserted after the last layout which has +\begin_inset Quotes eld +\end_inset + -\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InTitle +InTitle 1 \end_layout \end_inset + +\begin_inset Quotes erd +\end_inset + +. \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -[1, 0] +Environment \end_layout \end_inset - If 1, marks the layout as being part of a title block (see also the + corresponds to the case where the block of paragraphs which have +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TitleLatexType +InTitle 1 \end_layout \end_inset - and + +\begin_inset Quotes erd +\end_inset + + should be enclosed into the \begin_inset Flex CharStyle:Code status collapsed @@ -9192,7 +9005,7 @@ TitleLatexName \end_inset - global entries). + environment. \end_layout \begin_layout Description @@ -9200,49 +9013,57 @@ TitleLatexName status collapsed \begin_layout Plain Layout -ItemSep +TocDepth \end_layout \end_inset - [ + Sets which divisions are included in the table of contents. + Corresponds to the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -float=0 +tocdepth \end_layout \end_inset -] This provides extra space between paragraphs that have the same layout. - If you put other layouts into an environment, each is separated with the - environment's + counter in LaTeX. +\end_layout + +\begin_layout Subsection \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Parsep +ClassOptions \end_layout \end_inset -. - But the whole items of the environment are additionally separated with - this + section +\begin_inset CommandInset label +LatexCommand label +name "sub:ClassOptions" + +\end_inset + + +\end_layout + +\begin_layout Standard +The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Itemsep +ClassOptions \end_layout \end_inset -. - Note that this is a -\emph on - multiplier. + section can contain the following entries: \end_layout \begin_layout Description @@ -9250,63 +9071,67 @@ Itemsep status collapsed \begin_layout Plain Layout -ItemTag +FontSize \end_layout \end_inset - [[FIXME]] (Used only with XML-type formats.) -\end_layout - -\begin_layout Description + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -KeepEmpty +string="10|11|12" \end_layout \end_inset - -\begin_inset CommandInset label -LatexCommand label -name "des:KeepEmpty" - +] The list of available font sizes for the document's main font, separated + by +\begin_inset Quotes eld \end_inset -[ -\emph on \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -0 +| \end_layout \end_inset -\emph default -, +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +Header \end_layout \end_inset -] Usually LyX does not allow you to leave a paragraph empty, since it would - lead to empty LaTeX output. - There are some cases where this could be desirable however: in a letter - template, the required fields can be provided as empty fields, so that - people do not forget them; in some special classes, a layout can be used - as some kind of break, which does not contain actual text. + Used to set the DTD line with XML-based output classes. + E. +\begin_inset space \thinspace{} +\end_inset + +g.: PUBLIC +\begin_inset Quotes eld +\end_inset + +-//OASIS//DTD DocBook V4.2//EN +\begin_inset Quotes erd +\end_inset + +. \end_layout \begin_layout Description @@ -9314,33 +9139,40 @@ status collapsed status collapsed \begin_layout Plain Layout -LabelBottomsep +PageStyle \end_layout \end_inset - [float=0] The vertical space between the label and the text body. - Only used for labels that are above the text body ( + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Top_Environment +string="empty|plain|headings|fancy" \end_layout \end_inset -, +] The list of available page styles, separated by +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Centered_Top_Environment +| \end_layout \end_inset -). + +\begin_inset Quotes erd +\end_inset + +. \end_layout \begin_layout Description @@ -9348,7 +9180,7 @@ Centered_Top_Environment status collapsed \begin_layout Plain Layout -LabelCounter +Other \end_layout \end_inset @@ -9363,77 +9195,96 @@ string="" \end_inset -] -\begin_inset Newline newline -\end_inset - -The name of the counter for automatic numbering (see Section -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:counter" - -\end_inset - - for details). - This must be given if +] Some document class options, separated by a comma, that will be added + to the optional part of the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Labeltype + +\backslash +documentclass \end_layout \end_inset - is + command. +\end_layout + +\begin_layout Standard +The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Counter +ClassOptions \end_layout \end_inset -. -\end_layout + section must end with +\begin_inset Quotes eld +\end_inset + -\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelFont +End \end_layout \end_inset - The font used for the label. - See section -\begin_inset space ~ + +\begin_inset Quotes erd \end_inset +. +\end_layout -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:fonts" +\begin_layout Subsection +Paragraph Styles +\begin_inset CommandInset label +LatexCommand label +name "sub:Paragraph-Styles" \end_inset -. + \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code +\begin_layout Standard +A paragraph style description looks like this: +\begin_inset Foot status collapsed \begin_layout Plain Layout -LabelIndent +Note that this will either define a new layout or modify an existing one. \end_layout \end_inset - Text that indicates how far a label should be indented. + +\end_layout + +\begin_layout LyX-Code +Style +\family roman +\emph on +name +\end_layout + +\begin_layout LyX-Code + ... +\end_layout + +\begin_layout LyX-Code +End +\end_layout + +\begin_layout Standard +where the following commands are allowed: \end_layout \begin_layout Description @@ -9441,7 +9292,7 @@ LabelIndent status collapsed \begin_layout Plain Layout -Labelsep +Align \end_layout \end_inset @@ -9451,13 +9302,16 @@ Labelsep status collapsed \begin_layout Plain Layout -string="" + +\emph on +block +\emph default +, left, right, center \end_layout \end_inset -] The horizontal space between the label and the text body. - Only used for labels that are not above the text body. +] Paragraph alignment. \end_layout \begin_layout Description @@ -9465,7 +9319,7 @@ string="" status collapsed \begin_layout Plain Layout -LabelString +AlignPossible \end_layout \end_inset @@ -9475,104 +9329,117 @@ LabelString status collapsed \begin_layout Plain Layout -string="" + +\emph on +block +\emph default +, left, right, center \end_layout \end_inset -] The string used for a label with a +] A comma separated list of permitted alignments. + (Some LaTeX styles prohibit certain alignments, since those wouldn't make + sense. + For example a right-aligned or centered enumeration isn't possible.) +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Static +BabelPreamble \end_layout \end_inset - labeltype. - When + Language dependent information to be included in the LaTeX preamble when + this style is used. + Note that this will completely override any prior \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelCounter +BabelPreamble \end_layout \end_inset - is set, this string can be contain the special formatting commands described - in Section -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:counter" - + declarations. + Must end with +\begin_inset Quotes eld \end_inset -. -\begin_inset Foot -status collapsed -\begin_layout Plain Layout -For the sake of backwards compatibility, the string \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -@ -\emph on -style-name -\emph default -@ +EndBabelPreamble \end_layout \end_inset - will be replaced by the expanded -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -LabelString -\end_layout +\begin_inset Quotes erd \end_inset - of style +. + The contents of this tag will occur once in the LaTeX preamble for each + language used by the document. + Each time, the following substitutions are made: +\end_layout + +\begin_deeper +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -style-name +$$lang \end_layout \end_inset -. - This feature is now obsolete and should be replaced by the mechanisms of - Section -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:counter" + is replaced by the language name (as used by the babel package). +\end_layout +\begin_layout Itemize +The +\begin_inset Quotes eld \end_inset -. +Function +\begin_inset Quotes erd +\end_inset + + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +_() \end_layout \end_inset + replaces its argument by the translation of the argument to the current + language. +\end_layout +\begin_layout Standard +This preamble snippet will only be used if the document contains more than + one language and the babel package is used. \end_layout +\end_deeper \begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelStringAppendix +BottomSep \end_layout \end_inset @@ -9582,56 +9449,52 @@ LabelStringAppendix status collapsed \begin_layout Plain Layout -string="" +float=0 \end_layout \end_inset -] This is used inside the appendix instead of -\begin_inset Flex CharStyle:Code +] +\begin_inset Foot status collapsed \begin_layout Plain Layout -LabelString +Note that a `float' here is a real number, such as: 1.5. \end_layout \end_inset -. - Note that every -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -LabelString + The vertical space with which the last of a chain of paragraphs with this + layout is separated from the following paragraph. + If the next paragraph has another layout, the separations are not simply + added, but the maximum is taken. \end_layout -\end_inset - - statement resets +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelStringAppendix +Category \end_layout \end_inset - too. -\end_layout - -\begin_layout Description + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelTag +[string] \end_layout \end_inset - [FIXME] (Used only with XML-type formats.) + The category for this style. + This is used to group related styles in the Layout combobox on the toolbar. + Any string can be used, but you may want to use existing categories with + your own styles. + \end_layout \begin_layout Description @@ -9639,31 +9502,30 @@ LabelTag status collapsed \begin_layout Plain Layout -Labeltype +CommandDepth \end_layout \end_inset - [ + Depth of XML command. + Used only with XML-type formats. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -No_Label -\emph default -, Manual, Static, Top_Environment, -\begin_inset Newline newline -\end_inset - -Centered_Top_Environment, Sensitive, Counter +CopyStyle \end_layout \end_inset -] -\begin_inset Newline newline + +\begin_inset CommandInset label +LatexCommand label +name "des:CopyStyle" + \end_inset @@ -9671,188 +9533,169 @@ Centered_Top_Environment, Sensitive, Counter status collapsed \begin_layout Plain Layout -Manual +[string] \end_layout \end_inset - means the label is the very first word (up to the first real blank). -\begin_inset Foot -status collapsed - -\begin_layout Plain Layout -Use protected spaces if you want more than one word as the label. + Copies all the features of an existing style into the current one. + \end_layout -\end_inset - - +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Static +DependsOn \end_layout \end_inset - means it is defined in the layout (see -\begin_inset Flex CharStyle:Code + The name of a style whose preamble should be output +\emph on +before +\emph default + this one. + This allows to ensure some ordering of the preamble snippets when macros + definitions depend on one another. +\begin_inset Foot status collapsed \begin_layout Plain Layout -LabelString +Note that, besides that functionality, there is no way to ensure any ordering + of preambles. + The ordering that you see in a given version of LyX may change without + warning in later versions. \end_layout \end_inset -). - -\begin_inset Flex CharStyle:Code -status collapsed -\begin_layout Plain Layout -Top_Environment \end_layout -\end_inset - - and +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Centered_Top_Environment +EndLabeltype \end_layout \end_inset - are special cases of + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Static + +\emph on +No_Label +\emph default +, Box, Filled_Box, Static \end_layout \end_inset -. - The label will be printed above the paragraph, but only at the top of an - environment or the top of a chain of paragraphs with this layout. - Usage is for example the -\begin_inset Flex CharStyle:MenuItem +] The type of label that stands at the end of the paragraph (or sequence + of paragraphs if +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Abstract +LatexType \end_layout \end_inset - layout or the -\begin_inset Flex CharStyle:MenuItem + is +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Bibliography +Environment \end_layout \end_inset - layout. - This is also the case for +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Manual +Item_Environment \end_layout \end_inset - labels with latex type + or \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Environment +List_Environment \end_layout \end_inset -, in order to make layouts for theorems work correctly. +). \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Sensitive +No_Label \end_layout \end_inset - is a special case for the caption-labels -\begin_inset Quotes eld -\end_inset - -Figure -\begin_inset Quotes erd -\end_inset - - and + means \begin_inset Quotes eld \end_inset -Table +nothing \begin_inset Quotes erd \end_inset -. - +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Sensitive +Box \end_layout \end_inset - means the (hardcoded) label string depends on the kind of float. - The + (resp. \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Counter -\end_layout - +\begin_inset space ~ \end_inset - label type defines automatically numbered labels. - See Section -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:counter" +Filled_Box +\end_layout \end_inset -. -\end_layout +) is a white (resp. +\begin_inset space ~ +\end_inset -\begin_layout Description +black) square suitable for end of proof markers, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LatexName +Static \end_layout \end_inset - The name of the corresponding LaTeX stuff. - Either the environment or command name. + is an explicit text string. \end_layout \begin_layout Description @@ -9860,389 +9703,372 @@ LatexName status collapsed \begin_layout Plain Layout -LatexParam +EndLabelString \end_layout \end_inset - An optional parameter for the corresponding + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LatexName +string="" \end_layout \end_inset - stuff. - This parameter cannot be changed from within LyX. -\end_layout - -\begin_layout Description +] The string used for a label with a \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LatexType +Static \end_layout \end_inset -\begin_inset CommandInset label -LatexCommand label -name "des:LatexType" - -\end_inset - -[ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -Paragraph -\emph default -, Command, Environment, Item_Environment, +EndLabelType \end_layout \end_inset +. -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -List_Environment \end_layout -\end_inset - -] How the layout should be translated into LaTeX. - +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Paragraph +Fill_Bottom \end_layout \end_inset - means nothing special. - + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Command + +\emph on +0 +\emph default +,1 \end_layout \end_inset - means +] Similar to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash - -\emph on -LatexName -\emph default -{\SpecialChar \ldots{} -} +Fill_Top \end_layout \end_inset - and +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Environment +Fill_Top \end_layout \end_inset - means + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -\backslash -begin{ -\emph on -LatexName -\emph default -}\SpecialChar \ldots{} - -\backslash -end{ \emph on -LatexName +0 \emph default -} +,1 \end_layout \end_inset -. - -\begin_inset Flex CharStyle:Code +] With this parameter the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Item_Environment +Fill \end_layout \end_inset - is the same as -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -Environment -\end_layout + value of the +\begin_inset Quotes eld +\end_inset +Vertical space above +\begin_inset Quotes erd \end_inset -, except that a -\begin_inset Flex CharStyle:Code + list of the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout +Edit\SpecialChar \menuseparator +Paragraph +\begin_inset space ~ +\end_inset -\backslash -item +Settings \end_layout \end_inset - is generated for each paragraph of this environment. - -\begin_inset Flex CharStyle:Code + dialog can be set when initializing a paragraph with this style. +\begin_inset Foot status collapsed \begin_layout Plain Layout -List_Environment + +\emph on +Note from Jean-Marc: +\emph default + I'm not sure that this setting has much use, and it should probably be + removed in later versions. \end_layout \end_inset - is the same as + +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Item_Environment +Font \end_layout \end_inset -, except that + The font used for both the text body +\emph on +and +\emph default + the label. + See section +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Font-description" + +\end_inset + +. + Note that defining this font automatically defines the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelWidthString +LabelFont \end_layout \end_inset - is passed as an argument to the environment. - + to the same value. + So you should define this one first if you also want to define \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelWidthString +LabelFont \end_layout \end_inset - can be defined in the -\begin_inset Flex CharStyle:MenuItem +. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\bar under -L -\bar default -ayout\SpecialChar \menuseparator - -\bar under -P -\bar default -aragraph +FreeSpacing \end_layout \end_inset - dialog. +\begin_inset CommandInset label +LatexCommand label +name "des:FreeSpacing" + +\end_inset + +[ +\emph on + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \emph on -LatexType +0 \end_layout \end_inset - is perhaps a bit misleading, since these rules apply to SGML classes, too. - Visit the SGML class files for specific examples. -\end_layout - -\begin_layout Standard -Putting the last few things together, the LaTeX output will be either: -\end_layout - -\begin_layout LyX-Code - -\backslash -latexname[latexparam]{\SpecialChar \ldots{} -} -\end_layout - -\begin_layout Standard -or: -\end_layout -\begin_layout LyX-Code +\emph default +, +\begin_inset Flex CharStyle:Code +status collapsed -\backslash -begin{latexname}[latexparam] \SpecialChar \ldots{} - -\backslash -end{latexname}. +\begin_layout Plain Layout +1 \end_layout -\begin_layout Standard -depending upon the LaTeX type. -\end_layout +\end_inset -\begin_layout Description +] Usually LyX doesn't allow you to insert more than one space between words, + since a space is considered as the separation between two words, not a + character or symbol of its own. + This is a very fine thing but sometimes annoying, for example, when typing + program code or plain LaTeX code. + For this reason, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LeftMargin +FreeSpacing \end_layout \end_inset - [ + can be enabled. + Note that LyX will create protected blanks for the additional blanks when + in another mode than LaTeX-mode. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string="" +HTML* \end_layout \end_inset -] If you put layouts into environments, the leftmargins are not simply added, - but added with a factor -\begin_inset Formula $\frac{4}{depth+4}$ + These tags are used with XHTML output. + See +\begin_inset CommandInset ref +LatexCommand prettyref +reference "sub:Paragraph-Style-XHTML" + \end_inset . - Note that this parameter is also used when the margin is defined as +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Manual +InnerTag \end_layout \end_inset - or + [[FIXME]] (Used only with XML-type formats.) +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Dynamic +InPreamble \end_layout \end_inset -. - Then it is added to the manual or dynamic margin. -\begin_inset Newline newline -\end_inset - -The argument is passed as a string. - For example -\begin_inset Quotes eld -\end_inset - - \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -MM +[1, 0] \end_layout \end_inset + If 1, marks the layout as to be included in the document preamble rather + than in the document body. + This is useful for document classes that want such information as the title + and author to appear in the preamble. +\end_layout -\begin_inset Quotes erd -\end_inset - - means that the paragraph is indented with the width of -\begin_inset Quotes eld -\end_inset - - +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -MM +InTitle \end_layout \end_inset + +\begin_inset Flex CharStyle:Code +status collapsed -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout +[1, 0] +\end_layout - in the normal font. - You can get a negative width by prefixing the string with -\begin_inset Quotes eld \end_inset - + If 1, marks the layout as being part of a title block (see also the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -- +TitleLatexType \end_layout \end_inset + and +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +TitleLatexName +\end_layout -\begin_inset Quotes erd \end_inset -. - This way was chosen so that the look is the same with each used screen - font. - + global entries). \end_layout \begin_layout Description @@ -10250,7 +10076,7 @@ status collapsed status collapsed \begin_layout Plain Layout -Margin +ItemSep \end_layout \end_inset @@ -10260,249 +10086,258 @@ Margin status collapsed \begin_layout Plain Layout - -\emph on -Static -\emph default -, Manual, Dynamic, First_Dynamic, Right_Address_Box +float=0 \end_layout \end_inset -] -\begin_inset Newline newline -\end_inset - -The kind of margin that the layout has on the left side. - +] This provides extra space between paragraphs that have the same layout. + If you put other layouts into an environment, each is separated with the + environment's \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Static +Parsep \end_layout \end_inset - just means a fixed margin. - +. + But the whole items of the environment are additionally separated with + this \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Manual +Itemsep \end_layout \end_inset - means that the left margin depends on the string entered in the -\begin_inset Flex CharStyle:MenuItem +. + Note that this is a +\emph on + multiplier. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Edit\SpecialChar \menuseparator -Paragraph -\begin_inset space ~ -\end_inset - -Settings +ItemTag \end_layout \end_inset - dialog. - This is used to typeset nice lists without tabulators. - + [[FIXME]] (Used only with XML-type formats.) +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Dynamic +KeepEmpty \end_layout \end_inset - means that the margin depends on the size of the label. - This is used for automatic enumerated headlines. - It is obvious that the headline -\begin_inset Quotes eld -\end_inset + +\begin_inset CommandInset label +LatexCommand label +name "des:KeepEmpty" -5.4.3.2.1 Very long headline -\begin_inset Quotes erd \end_inset - must have a wider left margin (as wide as -\begin_inset Quotes eld -\end_inset +[ +\emph on -5.4.3.2.1 -\begin_inset Quotes erd -\end_inset +\begin_inset Flex CharStyle:Code +status collapsed - plus the space) than -\begin_inset Quotes eld -\end_inset +\begin_layout Plain Layout -3.2 Very long headline -\begin_inset Quotes erd -\end_inset +\emph on +0 +\end_layout -, even if standard -\begin_inset Quotes eld \end_inset -word processors -\begin_inset Quotes erd -\end_inset - are not able to do this. - +\emph default +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -First_Dynamic +1 \end_layout \end_inset - is similar, but only the very first row of the paragraph is dynamic, while - the others are static; this is used, for example, for descriptions. - +] Usually LyX does not allow you to leave a paragraph empty, since it would + lead to empty LaTeX output. + There are some cases where this could be desirable however: in a letter + template, the required fields can be provided as empty fields, so that + people do not forget them; in some special classes, a layout can be used + as some kind of break, which does not contain actual text. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Right_Address_Box +LabelBottomsep \end_layout \end_inset - means the margin is chosen in a way that the longest row of this paragraph - fits to the right margin. - This is used to typeset an address on the right edge of the page. -\end_layout - -\begin_layout Description + [float=0] The vertical space between the label and the text body. + Only used for labels that are above the text body ( \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -NeedProtect +Top_Environment \end_layout \end_inset - [ +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -0 +Centered_Top_Environment \end_layout \end_inset -, +). +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +LabelCounter \end_layout \end_inset -] Whether fragile commands in this layout should be + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -protect +string="" \end_layout \end_inset -'ed. - (Note: This is +] +\begin_inset Newline newline +\end_inset + +The name of the counter for automatic numbering. + +\begin_inset Newline newline +\end_inset + +This \emph on -not +must \emph default - whether this command should itself be protected.) -\end_layout - -\begin_layout Description + be given if \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Newline +LabelType \end_layout \end_inset - [ + is \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -0 +Counter \end_layout \end_inset -, +. + In that case, the counter will be stepped each time the layout appears. + +\begin_inset Newline newline +\end_inset + +This +\emph on +may +\emph default + also be given if \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -1 +LabelType \end_layout \end_inset -] Whether newlines are translated into LaTeX newlines ( + is \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout +Enumerate +\end_layout -\backslash +\end_inset + +, though this case is a bit complicated. + Suppose you declare +\begin_inset Quotes eld +\end_inset -\backslash +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelCounter myenum \end_layout \end_inset -) or not. - The translation can be switched off to allow more comfortable LaTeX editing - inside LyX. -\end_layout -\begin_layout Description +\begin_inset Quotes erd +\end_inset + +. + Then the actual counters used are \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -NextNoIndent +myenumi \end_layout \end_inset - [ +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +myenumii \end_layout \end_inset @@ -10512,35 +10347,59 @@ status collapsed status collapsed \begin_layout Plain Layout - -\emph on -0 +myenumiii \end_layout \end_inset -] Whether the following Paragraph is allowed to indent its very first row. - +, and \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +myenumiv \end_layout \end_inset - means that it is not allowed to do so; +, much as in LaTeX. + These counters must all be declared separately. +\begin_inset Newline newline +\end_inset + +See Section +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Counters" + +\end_inset + + for details on counters. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -0 +LabelFont \end_layout \end_inset - means it could do so if it wants to. + The font used for the label. + See section +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Font-description" + +\end_inset + +. \end_layout \begin_layout Description @@ -10548,13 +10407,12 @@ status collapsed status collapsed \begin_layout Plain Layout -ObsoletedBy +LabelIndent \end_layout \end_inset - Name of a layout that has replaced this layout. - This is used to rename a layout, while keeping backward compatibility. + Text that indicates how far a label should be indented. \end_layout \begin_layout Description @@ -10562,7 +10420,7 @@ ObsoletedBy status collapsed \begin_layout Plain Layout -OptionalArgs +Labelsep \end_layout \end_inset @@ -10572,14 +10430,13 @@ OptionalArgs status collapsed \begin_layout Plain Layout -int=0 +string="" \end_layout \end_inset -] The number of optional arguments that can be used with this layout. - This is useful for things like section headings, and only makes sense with - LaTeX. +] The horizontal space between the label and the text body. + Only used for labels that are not above the text body. \end_layout \begin_layout Description @@ -10587,7 +10444,7 @@ int=0 status collapsed \begin_layout Plain Layout -ParIndent +LabelString \end_layout \end_inset @@ -10602,156 +10459,145 @@ string="" \end_inset -] The indent of the very first line of a paragraph. - The +] The string used for a label with a \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Parindent +Static \end_layout \end_inset - will be fixed for a certain layout. - The exception is Standard layout, since the indentation of a Standard layout - paragraph can be prohibited with + labeltype. + When \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -NextNoIndent +LabelCounter \end_layout \end_inset -. - Also, Standard layout paragraphs inside environments use the -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -Parindent -\end_layout + is set, this string can be contain the special formatting commands described + in Section +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Counters" \end_inset - of the environment, not their native one. - For example, Standard paragraphs inside an enumeration are not indented. -\end_layout +. +\begin_inset Foot +status collapsed -\begin_layout Description +\begin_layout Plain Layout +For the sake of backwards compatibility, the string \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Parsep +@ +\emph on +style-name +\emph default +@ \end_layout \end_inset - [ + will be replaced by the expanded \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -float=0 +LabelString \end_layout \end_inset -] The vertical space between two paragraphs of this layout. -\end_layout - -\begin_layout Description + of style \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Parskip + +\emph on +style-name \end_layout \end_inset - [ -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -float=0 -\end_layout +. + This feature is now obsolete and should be replaced by the mechanisms of + Section +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Counters" \end_inset -] LyX allows the user to choose either -\begin_inset Quotes eld -\end_inset +. +\end_layout -indent -\begin_inset Quotes erd \end_inset - or -\begin_inset Quotes eld -\end_inset -skip -\begin_inset Quotes erd -\end_inset +\end_layout - to typeset a document. - When -\begin_inset Quotes eld -\end_inset +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed -indent -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout +LabelStringAppendix +\end_layout - is chosen, this value is completely ignored. - When -\begin_inset Quotes eld \end_inset -skip -\begin_inset Quotes erd -\end_inset + [ +\begin_inset Flex CharStyle:Code +status collapsed - is chosen, the parindent of a LaTeXtype -\begin_inset Quotes eld -\end_inset +\begin_layout Plain Layout +string="" +\end_layout -Paragraph -\begin_inset Quotes erd \end_inset - layout is ignored and all paragraphs are separated by this parskip argument. - The vertical space is calculated with +] This is used inside the appendix instead of \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -value -\begin_inset space ~ +LabelString +\end_layout + \end_inset -* DefaultHeight +. + Note that every +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelString \end_layout \end_inset - where + statement resets \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -DefaultHeight +LabelStringAppendix \end_layout \end_inset - is the height of a row with the normal font. - This way, the look stays the same with different screen fonts. + too. \end_layout \begin_layout Description @@ -10759,461 +10605,505 @@ DefaultHeight status collapsed \begin_layout Plain Layout -PassThru +LabelTag \end_layout \end_inset - -\begin_inset CommandInset label -LatexCommand label -name "des:PathThru" - -\end_inset - -[ -\emph on + [FIXME] (Used only with XML-type formats.) +\end_layout +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -0 +LabelType \end_layout \end_inset - -\emph default -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 + +\emph on +No_Label +\emph default +, Manual, Static, Top_Environment, Centered_Top_Environment, Counter, Sensitive, + Enumerate, Itemize, Bibliography \end_layout \end_inset -] Whether the contents of this paragraph should be output in raw form, meaning - without special translations that LaTeX would require. +] \end_layout -\begin_layout Description +\begin_deeper +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Preamble +Manual \end_layout \end_inset - -\begin_inset CommandInset label -LatexCommand label -name "des:Preamble" - -\end_inset - -Information to be included in the LaTeX preamble when this style is used. - Used to define macros, load packages, etc., required by this particular - style. - Must end with -\begin_inset Quotes eld + means the label is the very first word (up to the first real blank). + Use protected spaces (like +\begin_inset space ~ \end_inset +that one) if you want more than one word as the label. + +\end_layout +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -EndPreamble +Static \end_layout \end_inset + means the label is simply whatever +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelString +\end_layout -\begin_inset Quotes erd \end_inset -. + declares it to be. + Note that this really is `static'. \end_layout -\begin_layout Description +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Requires +Top_Environment \end_layout \end_inset -[ + and \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +Centered_Top_Environment \end_layout \end_inset -] -\begin_inset CommandInset label -LatexCommand label -name "des:Requires" - -\end_inset - -Whether the layout requires the feature + are special cases of \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +Static \end_layout \end_inset . - See the description of -\begin_inset Flex CharStyle:Code + The label will be printed above the paragraph, but only at the top of an + environment or the top of a chain of paragraphs with this layout. + This might be used with the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Provides +Abstract \end_layout \end_inset - above (page -\begin_inset CommandInset ref -LatexCommand pageref -reference "des:FreeSpacing" - -\end_inset - -) for information on `features'. - + layout, for example. \end_layout -\begin_layout Description +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -RightMargin +Sensitive \end_layout \end_inset - [ -\begin_inset Flex CharStyle:Code -status collapsed + is a special case for the caption-labels +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout -string="" -\end_layout +Figure +\begin_inset Quotes erd +\end_inset + and +\begin_inset Quotes eld \end_inset -] Similar to +Table +\begin_inset Quotes erd +\end_inset + +. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LeftMargin +Sensitive \end_layout \end_inset -. + means the (hardcoded) label string depends on the kind of float: It is + hardcoded to be `FloatType N', where N is the value of the counter associated + with the float. \end_layout -\begin_layout Description +\begin_layout Itemize +The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Spacing +Counter \end_layout \end_inset - [ + label type defines automatically numbered labels. + The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -single -\emph default -, onehalf, double, other +LabelString \end_layout \end_inset - -\emph on -value -\emph default -] This defines what the default spacing should be in the layout. - The arguments + will be expanded to resolve any counter references it contains: For example, + it might be +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -single +Section +\backslash +thechapter. +\backslash +thesection \end_layout \end_inset -, + +\begin_inset Quotes erd +\end_inset + +. + See Section +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Counters" + +\end_inset + + for more information on counters. +\end_layout + +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -onehalf +Enumerate \end_layout \end_inset - and + produces the usual sort of enumeration labels. + At present, it is hardcoded to use Arabic numerals, lowercase letters, + small Roman numerals, and uppercase letters for the four possible depths. +\end_layout + +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -double +Itemize \end_layout \end_inset - correspond respectively to a multiplier value of 1, 1.25 and 1.667. - If you specify the argument + produces various bullets at the different levels. + It is also hardcoded. +\end_layout + +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -other +Bibliography \end_layout \end_inset -, then you should also provide a numerical argument which will be the actual - multiplier value. - Note that, contrary to other parameters, + is used internally by LyX and should be used only with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Spacing +LatexType BibEnvironment \end_layout \end_inset - implies the generation of specific LaTeX code, using the package -\family roman +. +\end_layout +\end_deeper +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -setspace.sty +LangPreamble \end_layout \end_inset -. + Like +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +BabelPreamble \end_layout -\begin_layout Description +\end_inset + +, but this preamble snippet occurs independently from the babel package, + and only for the document language. + Must end with +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TextFont +EndLangPreamble \end_layout \end_inset - The font used for the text body . - See section -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:fonts" +\begin_inset Quotes erd \end_inset . \end_layout -\begin_layout Description +\begin_deeper +\begin_layout Standard +If the style defines text that appears in the typeset document, it may use + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\series medium -TocLevel [int] +LangPreamble \end_layout \end_inset - The level of the style in the table of contents. - This is used for automatic numbering of section headings. -\end_layout - -\begin_layout Description + and \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -TopSep +BabelPreamble \end_layout \end_inset - [ + to support non-english and even multilanguage documents correctly. + The following excerpt (from the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -float=0 +theorems-ams.inc \end_layout \end_inset -] The vertical space with which the very first of a chain of paragraphs - with this layout is separated from the previous paragraph. - If the previous paragraph has another layout, the separations are not simply - added, but the maximum is taken. + file) shows how this works: \end_layout -\begin_layout Subsection -Floats +\begin_layout LyX-Code +Preamble \end_layout -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "sec:floats" - -\end_inset - -Since version 1.3.0 of LyX, it is has been both possible and necessary to - define the floats ( -\begin_inset Flex CharStyle:MenuItem -status collapsed - -\begin_layout Plain Layout -figure +\begin_layout LyX-Code + +\backslash +theoremstyle{remark} \end_layout -\end_inset +\begin_layout LyX-Code + +\backslash +newtheorem{claim}[thm]{ +\backslash +protect +\backslash +claimname} +\end_layout -, -\begin_inset Flex CharStyle:MenuItem -status collapsed +\begin_layout LyX-Code +EndPreamble +\end_layout -\begin_layout Plain Layout -table +\begin_layout LyX-Code +LangPreamble \end_layout -\end_inset +\begin_layout LyX-Code + +\backslash +providecommand{ +\backslash +claimname}{_(Claim)} +\end_layout -, \SpecialChar \ldots{} -) in the text class itself. - Standard floats are included in the file -\begin_inset Flex CharStyle:Code -status collapsed +\begin_layout LyX-Code -\begin_layout Plain Layout -stdfloats.inc \end_layout -\end_inset +\begin_layout LyX-Code +EndLangPreamble +\end_layout -, so you may have to do no more than add +\begin_layout LyX-Code +BabelPreamble \end_layout \begin_layout LyX-Code -Input stdfloats.inc + +\backslash +addto +\backslash +captions$$lang{ +\backslash +renewcommand{ +\backslash +claimname}{_(Claim)}} \end_layout -\begin_layout Standard -to your layout file. - If you want to implement a text class that proposes some other float types - (like the AGU class bundled with LyX), the information below will hopefully - help you: +\begin_layout LyX-Code +EndBabelPreamble \end_layout -\begin_layout Description +\begin_layout Standard +The key to correct translation of the user visible text is the definition + of the command \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Extension + +\backslash +claimname \end_layout \end_inset - [ + in the language preamble. + This command holds the name of the theorem that will appear in the output. + The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +BabelPreamble \end_layout \end_inset -= -\begin_inset Quotes erd -\end_inset + then uses the commands offered by the babel package to redefine +\begin_inset Flex CharStyle:Code +status collapsed +\begin_layout Plain Layout + +\backslash +claimname +\end_layout -\begin_inset Quotes erd \end_inset -] The file name extension of an auxiliary file for the list of figures (or - whatever). - LaTeX writes the captions to this file. + for each used language in multilanguage documents. \end_layout +\end_deeper \begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -GuiName +LatexName \end_layout \end_inset - [ + The name of the corresponding LaTeX stuff. + Either the environment or command name. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +LatexParam \end_layout \end_inset -= -\begin_inset Quotes erd -\end_inset + An optional parameter for the corresponding +\begin_inset Flex CharStyle:Code +status collapsed +\begin_layout Plain Layout +LatexName +\end_layout -\begin_inset Quotes erd \end_inset -] The string that will be used in the menus and also for the caption. + stuff. + This parameter cannot be changed from within LyX. \end_layout \begin_layout Description @@ -11221,634 +11111,648 @@ string status collapsed \begin_layout Plain Layout -LaTeXBuiltin +LatexType \end_layout \end_inset - [ + +\begin_inset CommandInset label +LatexCommand label +name "des:LatexType" + +\end_inset + +[ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout \emph on -0 +Paragraph +\emph default +, Command, Environment, Item_Environment, \end_layout \end_inset -, + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +List_Environment, Bib_Environment \end_layout \end_inset -] Set to +] How the layout should be translated into LaTeX. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +LatexType \end_layout \end_inset - if the float is already defined by the LaTeX document class. - If this is set to -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -0 + is perhaps a bit misleading, since these rules apply to SGML classes, too. + Visit the SGML class files for specific examples. \end_layout \end_inset -, the float will be defined using the LaTeX package + +\end_layout + +\begin_deeper +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -float +Paragraph \end_layout \end_inset -. + means nothing special. + \end_layout -\begin_layout Description +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ListName +Command \end_layout \end_inset - [ + means \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string -\end_layout - -\end_inset -= -\begin_inset Quotes erd -\end_inset +\backslash +\emph on +LatexName +\emph default +{\SpecialChar \ldots{} +} +\end_layout -\begin_inset Quotes erd \end_inset -] The heading used for the list of floats. +. \end_layout -\begin_layout Description +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -NumberWithin +Environment \end_layout \end_inset - [ + means \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string -\end_layout - -\end_inset -= -\begin_inset Quotes erd -\end_inset +\backslash +begin{ +\emph on +LatexName +\emph default +}\SpecialChar \ldots{} +\backslash +end{ +\emph on +LatexName +\emph default +} +\end_layout -\begin_inset Quotes erd \end_inset -] This (optional) argument determines whether floats of this class will - be numbered within some sectional unit of the document. - For example, if within is equal to +. + +\end_layout + +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -chapter +Item_Environment \end_layout \end_inset -, the floats will be numbered within chapters. - -\end_layout - -\begin_layout Description + is the same as \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Placement +Environment \end_layout \end_inset - [ +, except that an \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string -\end_layout -\end_inset +\backslash +item +\end_layout -= -\begin_inset Quotes erd \end_inset + is generated for each paragraph of this environment. + +\end_layout -\begin_inset Quotes erd -\end_inset - -] The default placement for the given class of floats. - The string should be as in standard LaTeX: +\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -t +List_Environment \end_layout \end_inset -, + is the same as \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -b +Item_Environment \end_layout \end_inset -, +, except that \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -p +LabelWidthString \end_layout \end_inset - and + is passed as an argument to the environment. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -h +LabelWidthString \end_layout \end_inset - for top, bottom, page, and here, respectively. -\begin_inset Foot + can be defined in the +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -Note that the order of these letters in the string is irrelevant, like in - LaTeX. + +\bar under +L +\bar default +ayout\SpecialChar \menuseparator + +\bar under +P +\bar default +aragraph \end_layout \end_inset - On top of that there is a new type, -\begin_inset Flex CharStyle:Code -status collapsed + dialog. + +\end_layout -\begin_layout Plain Layout -H +\begin_layout Standard +Putting the last few things together, the LaTeX output will be either: \end_layout -\end_inset +\begin_layout LyX-Code -, which does not really correspond to a float, since it means: put it -\begin_inset Quotes eld -\end_inset +\backslash +latexname[latexparam]{\SpecialChar \ldots{} +} +\end_layout -here -\begin_inset Quotes erd -\end_inset +\begin_layout Standard +or: +\end_layout - and nowhere else. - Note however that the +\begin_layout LyX-Code + +\backslash +begin{latexname}[latexparam] \SpecialChar \ldots{} + +\backslash +end{latexname}. +\end_layout + +\begin_layout Standard +depending upon the LaTeX type. +\end_layout + +\end_deeper +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -H +LeftMargin \end_layout \end_inset - specifier is special and, because of implementation details, cannot be - used in non-built in float types. - If you do not understand what this means, just use -\begin_inset Quotes eld -\end_inset - - + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -tbp +string="" \end_layout \end_inset - -\begin_inset Quotes erd +] If you put layouts into environments, the leftmargins are not simply added, + but added with a factor +\begin_inset Formula $\frac{4}{depth+4}$ \end_inset . -\end_layout - -\begin_layout Description + Note that this parameter is also used when the margin is defined as \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Style +Manual \end_layout \end_inset - [ + or \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +Dynamic \end_layout \end_inset -= -\begin_inset Quotes erd +. + Then it is added to the manual or dynamic margin. + +\begin_inset Newline newline \end_inset - -\begin_inset Quotes erd +The argument is passed as a string. + For example +\begin_inset Quotes eld \end_inset -] The style used when defining the float using + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -newfloat +MM \end_layout \end_inset -. -\end_layout - -\begin_layout Description -\begin_inset Flex CharStyle:Code -status collapsed -\begin_layout Plain Layout -Type -\end_layout +\begin_inset Quotes erd +\end_inset + means that the paragraph is indented with the width of +\begin_inset Quotes eld \end_inset - [ + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +MM \end_layout \end_inset -= -\begin_inset Quotes erd -\end_inset - \begin_inset Quotes erd \end_inset -] The + in the normal font. + You can get a negative width by prefixing the string with \begin_inset Quotes eld \end_inset -type -\begin_inset Quotes erd -\end_inset - of the new class of floats, like program or algorithm. - After the appropriate \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -newfloat +- \end_layout \end_inset -, commands such as + +\begin_inset Quotes erd +\end_inset + +. + This way was chosen so that the look is the same with each used screen + font. + +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -begin{program} +Margin \end_layout \end_inset - or + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -\backslash -end{algorithm*} +\emph on +Static +\emph default +, Manual, Dynamic, First_Dynamic, Right_Address_Box \end_layout \end_inset - will be available. -\end_layout +] +\begin_inset Newline newline +\end_inset -\begin_layout Standard -Note that defining a float with type +The kind of margin that the layout has on the left side. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -type +Static \end_layout \end_inset - automatically defines the corresponding counter with name + just means a fixed margin. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -type +Manual \end_layout \end_inset -. -\end_layout - -\begin_layout Subsection -Flex insets and InsetLayout -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "sec:charstyle" + means that the left margin depends on the string entered in the +\begin_inset Flex CharStyle:MenuItem +status collapsed +\begin_layout Plain Layout +Edit\SpecialChar \menuseparator +Paragraph +\begin_inset space ~ \end_inset -LyX has supported character styles since version 1.4.0; as of version 1.6.0, - these are called Flex insets. - +Settings \end_layout -\begin_layout Standard -Flex insets come in three different kinds: -\end_layout +\end_inset -\begin_layout Itemize -character style ( + dialog. + This is used to typeset nice lists without tabulators. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -CharStyle +Dynamic \end_layout \end_inset -): These define semantic markup corresponding to such LaTeX commands as - -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout + means that the margin depends on the size of the label. + This is used for automatic enumerated headlines. + It is obvious that the headline +\begin_inset Quotes eld +\end_inset -\backslash -noun -\end_layout +5.4.3.2.1 Very long headline +\begin_inset Quotes erd +\end_inset + must have a wider left margin (as wide as +\begin_inset Quotes eld \end_inset - and -\begin_inset Flex CharStyle:Code -status collapsed +5.4.3.2.1 +\begin_inset Quotes erd +\end_inset -\begin_layout Plain Layout + plus the space) than +\begin_inset Quotes eld +\end_inset -\backslash -code -\end_layout +3.2 Very long headline +\begin_inset Quotes erd +\end_inset +, even if standard +\begin_inset Quotes eld \end_inset -. -\end_layout +word processors +\begin_inset Quotes erd +\end_inset -\begin_layout Itemize -user custom ( + are not able to do this. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Custom +First_Dynamic \end_layout \end_inset -): These can be used to define custom collapsible insets, similar to TeX - code, footnote, and the like. - An obvious example is an endnote inset, which is defined in the + is similar, but only the very first row of the paragraph is dynamic, while + the others are static; this is used, for example, for descriptions. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -endnote +Right_Address_Box \end_layout \end_inset - module. + means the margin is chosen in a way that the longest row of this paragraph + fits to the right margin. + This is used to typeset an address on the right edge of the page. \end_layout -\begin_layout Itemize -XML elements ( +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Element +NeedProtect \end_layout \end_inset -): For use with DocBook classes. -\end_layout - -\begin_layout Standard -Flex insets are defined using the + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InsetLayout + +\emph on +0 \end_layout \end_inset - tag, which shall be explained in a moment. -\end_layout - -\begin_layout Standard -The +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InsetLayout +1 \end_layout \end_inset - tag also serves another function: It can be used to customize the general - layout of many different types of insets. - Currently, +] Whether fragile commands in this layout should be \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InsetLayout + +\backslash +protect \end_layout \end_inset - can be used to customize the layout parameters for footnotes, marginal - notes, note insets, TeX code (ERT) insets, branches, listings, indexes, - boxes, tables, algorithms, URLs, and optional arguments, as well as to - define Flex insets. +'ed. + (Note: This is +\emph on +not +\emph default + whether this command should itself be protected.) \end_layout -\begin_layout Standard -The +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InsetLayout +Newline \end_layout \end_inset - definition must begin with a line of the form: -\end_layout - -\begin_layout LyX-Code -InsetLayout -\end_layout - -\begin_layout Standard -Here + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - +0 \end_layout \end_inset - indicates the inset whose layout is being defined, and here there are two - cases. -\end_layout - -\begin_layout Enumerate -The layout for a pre-existing inset is being modified. - In this case, can be +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - + +\emph on +1 \end_layout \end_inset - any one of the following: +] Whether newlines are translated into LaTeX newlines ( \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Algorithm + +\backslash + +\backslash + \end_layout \end_inset -, +) or not. + The translation can be switched off to allow more comfortable LaTeX editing + inside LyX. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Branch +NextNoIndent \end_layout \end_inset -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Box +1 \end_layout \end_inset @@ -11858,217 +11762,293 @@ Box status collapsed \begin_layout Plain Layout -Box:shaded + +\emph on +0 \end_layout \end_inset -, +] Whether the following Paragraph is allowed to indent its very first row. + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ERT +1 \end_layout \end_inset -, + means that it is not allowed to do so; \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Figure +0 \end_layout \end_inset -, + means it could do so if it wants to. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Foot +ObsoletedBy \end_layout \end_inset -, + Name of a layout that has replaced this layout. + This is used to rename a layout, while keeping backward compatibility. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Index +OptionalArgs \end_layout \end_inset -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Info +int=0 \end_layout \end_inset -, +] The number of optional arguments that can be used with this layout. + This is useful for things like section headings, and only makes sense with + LaTeX. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Info:menu +ParIndent \end_layout \end_inset -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Info:shortcut +string="" \end_layout \end_inset -, +] The indent of the very first line of a paragraph. + The \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Info:shortcuts +Parindent \end_layout \end_inset -, + will be fixed for a certain layout. + The exception is Standard layout, since the indentation of a Standard layout + paragraph can be prohibited with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Listings +NextNoIndent \end_layout \end_inset -, +. + Also, Standard layout paragraphs inside environments use the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Marginal +Parindent \end_layout \end_inset -, + of the environment, not their native one. + For example, Standard paragraphs inside an enumeration are not indented. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Note:Comment +Parsep \end_layout \end_inset -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Note:Note +float=0 \end_layout \end_inset -, +] The vertical space between two paragraphs of this layout. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Note:GreyedOut +Parskip \end_layout \end_inset -, + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -OptArg +float=0 \end_layout \end_inset -, +] LyX allows the user to choose either +\begin_inset Quotes eld +\end_inset + +indent +\begin_inset Quotes erd +\end_inset + + or +\begin_inset Quotes eld +\end_inset + +skip +\begin_inset Quotes erd +\end_inset + + to typeset a document. + When +\begin_inset Quotes eld +\end_inset + +indent +\begin_inset Quotes erd +\end_inset + + is chosen, this value is completely ignored. + When +\begin_inset Quotes eld +\end_inset + +skip +\begin_inset Quotes erd +\end_inset + + is chosen, the parindent of a LaTeXtype +\begin_inset Quotes eld +\end_inset + +Paragraph +\begin_inset Quotes erd +\end_inset + + layout is ignored and all paragraphs are separated by this parskip argument. + The vertical space is calculated with \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Table +value +\begin_inset space ~ +\end_inset + +* DefaultHeight \end_layout \end_inset -, or + where \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -URL +DefaultHeight \end_layout \end_inset -. - + is the height of a row with the normal font. + This way, the look stays the same with different screen fonts. \end_layout -\begin_layout Enumerate -The layout for a Flex inset is being defined. - In this case, +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - +PassThru \end_layout \end_inset - can be any valid identifier not used by a pre-existing inset. - Note that the definition of a flex inset must + +\begin_inset CommandInset label +LatexCommand label +name "des:PathThru" + +\end_inset + +[ \emph on - als -\emph default -o include a + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LyXType + +\emph on +0 \end_layout \end_inset - entry. -\end_layout -\begin_layout Standard -The +\emph default +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -InsetLayout +1 \end_layout \end_inset - definition can contain the following entries: +] Whether the contents of this paragraph should be output in raw form, meaning + without special translations that LaTeX would require. \end_layout \begin_layout Description @@ -12076,22 +12056,39 @@ InsetLayout status collapsed \begin_layout Plain Layout -BgColor +Preamble \end_layout \end_inset - The color for the inset's background. - The valid colors are defined in + +\begin_inset CommandInset label +LatexCommand label +name "des:Preamble" + +\end_inset + +Information to be included in the LaTeX preamble when this style is used. + Used to define macros, load packages, etc., required by this particular + style. + Must end with +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -src/ColorCode.h +EndPreamble \end_layout \end_inset + +\begin_inset Quotes erd +\end_inset + . \end_layout @@ -12100,19 +12097,58 @@ src/ColorCode.h status collapsed \begin_layout Plain Layout -CopyStyle +Requires \end_layout \end_inset - As with paragraph styles (see page +[ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + +] +\begin_inset CommandInset label +LatexCommand label +name "des:Requires" + +\end_inset + +Whether the layout requires the feature +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + +. + See the description of +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Provides +\end_layout + +\end_inset + + above (page \begin_inset CommandInset ref -LatexCommand ref -reference "des:CopyStyle" +LatexCommand pageref +reference "des:FreeSpacing" \end_inset -). +) for information on `features'. + \end_layout \begin_layout Description @@ -12120,7 +12156,7 @@ reference "des:CopyStyle" status collapsed \begin_layout Plain Layout -CustomPars +RightMargin \end_layout \end_inset @@ -12130,25 +12166,22 @@ CustomPars status collapsed \begin_layout Plain Layout - -\emph on -0 +string="" \end_layout \end_inset -, +] Similar to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +LeftMargin \end_layout \end_inset -] Indicates whether the user may employ the Paragraph Settings dialog to - customize the paragraph. +. \end_layout \begin_layout Description @@ -12156,86 +12189,96 @@ status collapsed status collapsed \begin_layout Plain Layout -Decoration +Spacing \end_layout \end_inset - can be + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Classic + +\emph on +single +\emph default +, onehalf, double, other \end_layout \end_inset -, + +\emph on +value +\emph default +] This defines what the default spacing should be in the layout. + The arguments \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Minimalistic +single \end_layout \end_inset -, or +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Conglomerate +onehalf \end_layout \end_inset -, describing the rendering style used for the inset's frame and buttons. - Footnotes generally use + and \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Classic +double \end_layout \end_inset -, ERT insets generally + correspond respectively to a multiplier value of 1, 1.25 and 1.667. + If you specify the argument \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Minimalistic +other \end_layout \end_inset -, and character styles +, then you should also provide a numerical argument which will be the actual + multiplier value. + Note that, contrary to other parameters, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Conglomerate +Spacing \end_layout \end_inset -. -\end_layout + implies the generation of specific LaTeX code, using the package +\family roman -\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -End +setspace.sty \end_layout \end_inset - Required at the end of the InsetLayout declarations. +. \end_layout \begin_layout Description @@ -12243,115 +12286,135 @@ End status collapsed \begin_layout Plain Layout -Font +TextFont \end_layout \end_inset - The font used for both the text body -\emph on -and -\emph default - the label. - See section -\begin_inset space ~ -\end_inset - - + The font used for the text body . + See section \begin_inset CommandInset ref LatexCommand ref -reference "sec:fonts" +reference "sub:Font-description" \end_inset . - Note that defining this font automatically defines the +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelFont +TocLevel \end_layout \end_inset - to the same value, so define this first and define + +\series medium + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelFont + +\series medium +[int] \end_layout \end_inset - later if you want them to be different. -\end_layout -\begin_layout Description +\series default + The level of the style in the table of contents. + This is used for automatic numbering of section headings. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -ForceLTR +TopSep \end_layout \end_inset - Force the -\begin_inset Quotes eld -\end_inset + [ +\begin_inset Flex CharStyle:Code +status collapsed -latex -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout +float=0 +\end_layout - language, leading to Left-to-Right (latin) output, e. -\begin_inset space \thinspace{} \end_inset -g. -\begin_inset space \space{} +] The vertical space with which the very first of a chain of paragraphs + with this layout is separated from the previous paragraph. + If the previous paragraph has another layout, the separations are not simply + added, but the maximum is taken. +\end_layout + +\begin_layout Subsection +Floats +\begin_inset CommandInset label +LatexCommand label +name "sub:Floats" + \end_inset -in TeX code or URL. - A kludge. + \end_layout -\begin_layout Description -\begin_inset Flex CharStyle:Code +\begin_layout Standard +Since version 1.3.0 of LyX, it is has been both possible and necessary to + define the floats ( +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout -ForcePlain +figure \end_layout \end_inset - [ -\begin_inset Flex CharStyle:Code +, +\begin_inset Flex CharStyle:MenuItem status collapsed \begin_layout Plain Layout - -\emph on -0 +table \end_layout \end_inset -, +, \SpecialChar \ldots{} +) in the text class itself. + Standard floats are included in the file \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +stdfloats.inc \end_layout \end_inset -] Indicates whether the PlainLayout should be used or, instead, the user - can change the paragraph style used in the inset. +, so you may have to do no more than add +\end_layout + +\begin_layout LyX-Code +Input stdfloats.inc +\end_layout + +\begin_layout Standard +to your layout file. + If you want to implement a text class that proposes some other float types + (like the AGU class bundled with LyX), the information below will hopefully + help you: \end_layout \begin_layout Description @@ -12359,39 +12422,32 @@ status collapsed status collapsed \begin_layout Plain Layout -FreeSpacing +Extension \end_layout \end_inset - As with paragraph styles (see page -\begin_inset CommandInset ref -LatexCommand pageref -reference "des:FreeSpacing" - -\end_inset - -). -\end_layout - -\begin_layout Description + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -KeepEmpty +string \end_layout \end_inset - As with paragraph styles (see page -\begin_inset CommandInset ref -LatexCommand pageref -reference "des:KeepEmpty" += +\begin_inset Quotes erd +\end_inset + +\begin_inset Quotes erd \end_inset -). +] The file name extension of an auxiliary file for the list of figures (or + whatever). + LaTeX writes the captions to this file. \end_layout \begin_layout Description @@ -12399,35 +12455,45 @@ reference "des:KeepEmpty" status collapsed \begin_layout Plain Layout -LabelFont +GuiName \end_layout \end_inset - The font used for the label. - See section -\begin_inset space ~ + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + \end_inset += +\begin_inset Quotes erd +\end_inset -\begin_inset CommandInset ref -LatexCommand ref -reference "sec:fonts" +\begin_inset Quotes erd \end_inset -. - Note that this definition can never appear before +] The string that will be used in the menus and also for the caption. + This is translated to the current language if babel is used. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Font +HTML* \end_layout \end_inset -, lest it be ineffective. + These are used for XHTML output. + See \end_layout \begin_layout Description @@ -12435,61 +12501,65 @@ Font status collapsed \begin_layout Plain Layout -LabelString +LaTeXBuiltin \end_layout \end_inset - What will be displayed on the button or elsewhere as the inset label. - Some inset types (TeX code and Branch) modify this label on the fly. -\end_layout - -\begin_layout Description + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LatexName + +\emph on +0 \end_layout \end_inset - The name of the corresponding LaTeX stuff. - Either the environment or command name. +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 \end_layout -\begin_layout Description +\end_inset + +] Set to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LatexParam +1 \end_layout \end_inset - The optional parameter for the corresponding + if the float is already defined by the LaTeX document class. + If this is set to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LatexName +0 \end_layout \end_inset - stuff, including possible bracket pairs like +, the float will be defined using the LaTeX package \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -[] +float \end_layout \end_inset . - This parameter cannot be changed from within LyX. \end_layout \begin_layout Description @@ -12497,19 +12567,31 @@ status collapsed status collapsed \begin_layout Plain Layout -LatexType +ListName \end_layout \end_inset - As with paragraph styles (see page -\begin_inset CommandInset ref -LatexCommand pageref -reference "des:LatexType" + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout \end_inset -). += +\begin_inset Quotes erd +\end_inset + + +\begin_inset Quotes erd +\end_inset + +] The heading used for the list of floats. + This is translated to the document language. \end_layout \begin_layout Description @@ -12517,148 +12599,2866 @@ reference "des:LatexType" status collapsed \begin_layout Plain Layout -LyxType +NumberWithin \end_layout \end_inset - Can be + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -charstyle +string \end_layout \end_inset -, += +\begin_inset Quotes erd +\end_inset + + +\begin_inset Quotes erd +\end_inset + +] This (optional) argument determines whether floats of this class will + be numbered within some sectional unit of the document. + For example, if within is equal to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -custom +chapter \end_layout \end_inset -, +, the floats will be numbered within chapters. + +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -element +Placement \end_layout \end_inset -, or + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -end +string \end_layout \end_inset - (indicating a dummy definition ending definitions of charstyles, etc). - This entry is required in and is only meaningful for Flex insets. - Among other things, it determines on which menu this inset will appear. -\end_layout += +\begin_inset Quotes erd +\end_inset -\begin_layout Description + +\begin_inset Quotes erd +\end_inset + +] The default placement for the given class of floats. + The string should be as in standard LaTeX: \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -MultiPar +t \end_layout \end_inset - [ +, \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout +b +\end_layout -\emph on -0 +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +p \end_layout \end_inset -, + and \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +h \end_layout \end_inset -] Whether multiple paragraphs are permitted in this inset. - This will also set CustomPars to the same value and ForcePlain to the opposite - value. - These can be reset to other values, if they are used + for top, bottom, page, and here, respectively. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +Note that the order of these letters in the string is irrelevant, like in + LaTeX. +\end_layout + +\end_inset + + On top of that there is a new type, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +H +\end_layout + +\end_inset + +, which does not really correspond to a float, since it means: put it +\begin_inset Quotes eld +\end_inset + +here +\begin_inset Quotes erd +\end_inset + + and nowhere else. + Note however that the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +H +\end_layout + +\end_inset + + specifier is special and, because of implementation details, cannot be + used in non-built in float types. + If you do not understand what this means, just use +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +tbp +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Style +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + += +\begin_inset Quotes erd +\end_inset + + +\begin_inset Quotes erd +\end_inset + +] The style used when defining the float using +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +newfloat +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Type +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + += +\begin_inset Quotes erd +\end_inset + + +\begin_inset Quotes erd +\end_inset + +] The +\begin_inset Quotes eld +\end_inset + +type +\begin_inset Quotes erd +\end_inset + + of the new class of floats, like program or algorithm. + After the appropriate +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +newfloat +\end_layout + +\end_inset + +, commands such as +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +begin{program} +\end_layout + +\end_inset + + or +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +end{algorithm*} +\end_layout + +\end_inset + + will be available. +\end_layout + +\begin_layout Standard +Note that defining a float with type +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + \emph on -after -\emph default - MultiPar. +type +\end_layout + +\end_inset + + automatically defines the corresponding counter with name +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +type +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Flex insets and InsetLayout +\begin_inset CommandInset label +LatexCommand label +name "sub:Flex-insets-and" + +\end_inset + + +\end_layout + +\begin_layout Standard +LyX has supported character styles since version 1.4.0; as of version 1.6.0, + these are called Flex insets. + +\end_layout + +\begin_layout Standard +Flex insets come in three different kinds: +\end_layout + +\begin_layout Itemize +character style ( +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +CharStyle +\end_layout + +\end_inset + +): These define semantic markup corresponding to such LaTeX commands as + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +noun +\end_layout + +\end_inset + + and +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +code +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Itemize +user custom ( +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Custom +\end_layout + +\end_inset + +): These can be used to define custom collapsible insets, similar to TeX + code, footnote, and the like. + An obvious example is an endnote inset, which is defined in the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +endnote +\end_layout + +\end_inset + + module. +\end_layout + +\begin_layout Itemize +XML elements ( +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Element +\end_layout + +\end_inset + +): For use with DocBook classes. +\end_layout + +\begin_layout Standard +Flex insets are defined using the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +InsetLayout +\end_layout + +\end_inset + + tag, which shall be explained in a moment. +\end_layout + +\begin_layout Standard +The +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +InsetLayout +\end_layout + +\end_inset + + tag also serves another function: It can be used to customize the general + layout of many different types of insets. + Currently, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +InsetLayout +\end_layout + +\end_inset + + can be used to customize the layout parameters for footnotes, marginal + notes, note insets, TeX code (ERT) insets, branches, listings, indexes, + boxes, tables, algorithms, URLs, and optional arguments, as well as to + define Flex insets. +\end_layout + +\begin_layout Standard +The +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +InsetLayout +\end_layout + +\end_inset + + definition must begin with a line of the form: +\end_layout + +\begin_layout LyX-Code +InsetLayout +\end_layout + +\begin_layout Standard +Here +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + indicates the inset whose layout is being defined, and here there are two + cases. +\end_layout + +\begin_layout Enumerate +The layout for a pre-existing inset is being modified. + In this case, can be +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + any one of the following: +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Algorithm +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Branch +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Box +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Box:shaded +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +ERT +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Figure +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Foot +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Index +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Info +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Info:menu +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Info:shortcut +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Info:shortcuts +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Listings +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Marginal +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Note:Comment +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Note:Note +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Note:GreyedOut +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +OptArg +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Table +\end_layout + +\end_inset + +, or +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +URL +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Enumerate +The layout for a Flex inset is being defined. + In this case, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + can be any valid identifier not used by a pre-existing inset. + Note that the definition of a flex inset +\emph on +must +\emph default +also include a +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LyXType +\end_layout + +\end_inset + + entry, declaring which type of inset this is. +\end_layout + +\begin_layout Standard +The +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +InsetLayout +\end_layout + +\end_inset + + definition can contain the following entries: +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +BgColor +\end_layout + +\end_inset + + The color for the inset's background. + The valid colors are defined in +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +src/ColorCode.h +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +ContentAsLabel +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Whether to use the content of the inset as the label, when the inset is + closed. + Default is false. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +CopyStyle +\end_layout + +\end_inset + + As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand ref +reference "des:CopyStyle" + +\end_inset + +). +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +CustomPars +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Indicates whether the user may employ the Paragraph Settings dialog to + customize the paragraph. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Decoration +\end_layout + +\end_inset + + can be +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Classic +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Minimalistic +\end_layout + +\end_inset + +, or +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Conglomerate +\end_layout + +\end_inset + +, describing the rendering style used for the inset's frame and buttons. + Footnotes generally use +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Classic +\end_layout + +\end_inset + +, ERT insets generally +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Minimalistic +\end_layout + +\end_inset + +, and character styles +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Conglomerate +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +End +\end_layout + +\end_inset + + Required at the end of the InsetLayout declarations. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Font +\end_layout + +\end_inset + + The font used for both the text body +\emph on +and +\emph default + the label. + See section +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Font-description" + +\end_inset + +. + Note that defining this font automatically defines the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelFont +\end_layout + +\end_inset + + to the same value, so define this first and define +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelFont +\end_layout + +\end_inset + + later if you want them to be different. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +ForceLTR +\end_layout + +\end_inset + + Force the +\begin_inset Quotes eld +\end_inset + +latex +\begin_inset Quotes erd +\end_inset + + language, leading to Left-to-Right (latin) output, e. +\begin_inset space \thinspace{} +\end_inset + +g. +\begin_inset space \space{} +\end_inset + +in TeX code or URL. + A kludge. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +ForcePlain +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Indicates whether the PlainLayout should be used or, instead, the user + can change the paragraph style used in the inset. + Default is false. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +FreeSpacing +\end_layout + +\end_inset + + As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand pageref +reference "des:FreeSpacing" + +\end_inset + +). + Default is false. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +HTML* +\end_layout + +\end_inset + + These tags control XHTML output. + See +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +InToc +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Whether to include the contents of this inset in the strings generated + for the `Outline' pane. + One would not, for example, want the content of a footnote in a section + header to be included in the TOC displayed in the outline, but one would + normally want the content of a character style displayed. + Default is false: not to include. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +KeepEmpty +\end_layout + +\end_inset + + As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand pageref +reference "des:KeepEmpty" + +\end_inset + +). + Default is false. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelFont +\end_layout + +\end_inset + + The font used for the label. + See section +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "sub:Font-description" + +\end_inset + +. + Note that this definition can never appear before +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Font +\end_layout + +\end_inset + +, lest it be ineffective. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelString +\end_layout + +\end_inset + + What will be displayed on the button or elsewhere as the inset label. + Some inset types (TeX code and Branch) modify this label on the fly. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LatexName +\end_layout + +\end_inset + + The name of the corresponding LaTeX stuff. + Either the environment or command name. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LatexParam +\end_layout + +\end_inset + + The optional parameter for the corresponding +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LatexName +\end_layout + +\end_inset + + stuff, including possible bracket pairs like +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +[] +\end_layout + +\end_inset + +. + This parameter cannot be changed from within LyX. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LatexType +\end_layout + +\end_inset + + As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand pageref +reference "des:LatexType" + +\end_inset + +). +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LyxType +\end_layout + +\end_inset + + Can be +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +charstyle +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +custom +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +element +\end_layout + +\end_inset + +, or +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +end +\end_layout + +\end_inset + + (indicating a dummy definition ending definitions of charstyles, etc). + This entry is required in and is only meaningful for Flex insets. + Among other things, it determines on which menu this inset will appear. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +MultiPar +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Whether multiple paragraphs are permitted in this inset. + This will also set +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +CustomPars +\end_layout + +\end_inset + + to the same value and +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +ForcePlain +\end_layout + +\end_inset + + to the opposite value. + These can be reset to other values, if they are used +\emph on +after +\emph default + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +MultiPar +\end_layout + +\end_inset + +. + Default is true. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +NeedProtect +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Whether fragile commands in this layout should be +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +protect +\end_layout + +\end_inset + +'ed. + (Note: This is +\emph on +not +\emph default + whether the command should itself be protected.) Default is false. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +PassThru +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand pageref +reference "des:PathThru" + +\end_inset + +). + Default is false. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Preamble +\end_layout + +\end_inset + + As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand pageref +reference "des:Preamble" + +\end_inset + +). +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Requires +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + +] As with paragraph styles (see page +\begin_inset CommandInset ref +LatexCommand pageref +reference "des:Requires" + +\end_inset + +). +\end_layout + +\begin_layout Subsection +Counters +\begin_inset CommandInset label +LatexCommand label +name "sub:Counters" + +\end_inset + + +\end_layout + +\begin_layout Standard +Since version 1.3.0 of LyX, it is both possible and necessary to define the + counters ( +\begin_inset Flex CharStyle:MenuItem +status collapsed + +\begin_layout Plain Layout +chapter +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:MenuItem +status collapsed + +\begin_layout Plain Layout +figure +\end_layout + +\end_inset + +, \SpecialChar \ldots{} +) in the text class itself. + The standard counters are defined in the file +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +stdcounters.inc +\end_layout + +\end_inset + +, so you may have to do no more than add +\end_layout + +\begin_layout LyX-Code +Input stdcounters.inc +\end_layout + +\begin_layout Standard +to your layout file to get them to work. + But if you want to define custom counters, then you can do so. + The counter declaration must begin with: +\end_layout + +\begin_layout LyX-Code +Counter CounterName +\end_layout + +\begin_layout Standard +where of course ` +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +CounterName +\end_layout + +\end_inset + +' is replaced by the name of the counter. + And it must end with +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +End +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. + The following parameters can also be used: +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelString [string=""] +\end_layout + +\end_inset + + when this is defined, this string defines how the counter is displayed. + Setting this value sets +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelStringAppendix +\end_layout + +\end_inset + + to the same value. + The following special constructs can be used in the string: +\end_layout + +\begin_deeper +\begin_layout Itemize +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +thecounter +\end_layout + +\end_inset + + will be replaced by the expansion of the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelString +\end_layout + +\end_inset + + (or +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelStringAppendix +\end_layout + +\end_inset + +) of the counter +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +counter +\end_layout + +\end_inset + +. + +\end_layout + +\begin_layout Itemize +counter values can be expressed using LaTeX-like macros +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash + +\emph on +numbertype +\emph default +{ +\emph on +counter +\emph default +} +\end_layout + +\end_inset + +, where +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +numbertype +\end_layout + +\end_inset + + can be: +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout + +\family roman +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Actually, the situation is a bit more complicated: any +\family default +\series default +\shape default +\emph default +\bar default + +\size default +\emph on +\noun default +\color inherit +numbertype +\family roman +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off + other than those described below will produce arabic numerals. + It would not be surprising to see this change in the future. +\end_layout + +\end_inset + + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +arabic +\end_layout + +\end_inset + +: 1, 2, 3,\SpecialChar \ldots{} +; +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +alph +\end_layout + +\end_inset + + for lower-case letters: a, b, c, \SpecialChar \ldots{} +; +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Alph +\end_layout + +\end_inset + + for upper-case letters: A, B, C, \SpecialChar \ldots{} +; +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +roman +\end_layout + +\end_inset + + for lower-case roman numerals: i, ii, iii, \SpecialChar \ldots{} +; +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Roman +\end_layout + +\end_inset + + for upper-case roman numerals: I, II, III\SpecialChar \ldots{} +; +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +hebrew +\end_layout + +\end_inset + + for hebrew numerals. +\end_layout + +\end_deeper +\begin_layout Standard +If LabelString is not defined, a default value is constructed as follows: + if the counter has a master counter +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +master +\end_layout + +\end_inset + + (defined via +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Within +\end_layout + +\end_inset + +), the string +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +themaster. +\backslash +arabic{counter} +\end_layout + +\end_inset + + is used; otherwise the string +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\backslash +arabic{counter} +\end_layout + +\end_inset + + is used. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelStringAppendix [string=""] +\end_layout + +\end_inset + + Same as +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LabelString +\end_layout + +\end_inset + +, but for use in the Appendix. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Within +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + += +\begin_inset Quotes erd +\end_inset + + +\begin_inset Quotes erd +\end_inset + +] If this is set to the name of another counter, the present counter will + be reset every time the other one is increased. + For example, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +subsection +\end_layout + +\end_inset + + is numbered inside +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +section +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Font description +\begin_inset CommandInset label +LatexCommand label +name "sub:Font-description" + +\end_inset + + +\end_layout + +\begin_layout Standard +A font description looks like this: +\end_layout + +\begin_layout LyX-Code +Font +\family roman +\emph on +or +\family default +\emph default + LabelFont +\end_layout + +\begin_layout LyX-Code + ... +\end_layout + +\begin_layout LyX-Code +EndFont +\end_layout + +\begin_layout Standard +The following commands are available: +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Color +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +none +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +black +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +white +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +red +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +green +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +blue +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +cyan +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +magenta +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +yellow +\end_layout + +\end_inset + +] +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Family +\end_layout + +\end_inset + + [ +\emph on + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +Roman +\end_layout + +\end_inset + + +\emph default +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Sans +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Typewriter +\end_layout + +\end_inset + +] +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Misc +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + +] Valid arguments are: +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +emph +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +noun +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +underbar +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +no_emph +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +no_noun +\end_layout + +\end_inset + + and +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +no_bar +\end_layout + +\end_inset + +. + Each of these turns on or off the corresponding attribute. + For example, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +emph +\end_layout + +\end_inset + + turns on emphasis, and +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +no_emph +\end_layout + +\end_inset + + turns it off. + +\begin_inset Newline newline +\end_inset + +If the latter seems puzzling, remember that the font settings for the present + context are generally inherited from the surrounding context. + So +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +no_emph +\end_layout + +\end_inset + + would turn off the emphasis that was anyway in effect, say, in a theorem + environment. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Series +\end_layout + +\end_inset + + [ +\emph on + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +Medium +\end_layout + +\end_inset + + +\emph default +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Bold +\end_layout + +\end_inset + +] +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Shape +\end_layout + +\end_inset + + [ +\emph on + +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +Up +\end_layout + +\end_inset + + +\emph default +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Italic +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +SmallCaps +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Slanted +\end_layout + +\end_inset + +] +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Size +\end_layout + +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +tiny +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +small +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout + +\emph on +normal +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +large +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +larger +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +largest +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +huge +\end_layout + +\end_inset + +, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +giant +\end_layout + +\end_inset + +] +\end_layout + +\begin_layout Section +\begin_inset CommandInset label +LatexCommand label +name "sec:Tags-for-XHTML" + +\end_inset + +Tags for XHTML output +\end_layout + +\begin_layout Standard +As with LaTeX or DocBook, the format of LyX's XHTML output is also controlled + by layout information. + In general, LyX provides sensible defaults and, as mentioned earlier, it + will even construct default CSS style rules from the other layout tags. + For example, LyX will attempt to use the information provided in the +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +Font +\end_layout + +\end_inset + + declaration for the Chapter style to write CSS that will appropriately + format chapter headings. +\end_layout + +\begin_layout Standard +In many cases, then, you may not have to do anything at all to get acceptable + XHTML output for your own environments, custom insets, and so forth. + But in some cases you will, and so LyX provides a number of layout tags + that can be used to customize the XHTML and CSS that are generated. +\end_layout + +\begin_layout Standard +Note that there are two tags, +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +HTMLPreamble +\end_layout + +\end_inset + + and +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +AddToHTMLPreamble +\end_layout + +\end_inset + + that may appear outside style and inset declarations. + See +\begin_inset CommandInset ref +LatexCommand prettyref +reference "sub:General-text-class" + +\end_inset + + for details on these. +\end_layout + +\begin_layout Subsection +\begin_inset CommandInset label +LatexCommand label +name "sub:Paragraph-Style-XHTML" + +\end_inset + +Paragraph styles +\end_layout + +\begin_layout Standard +The sort of XHTML LyX outputs for a paragraph depends upon whether we are + dealing with a normal paragraph, a command, or an environment, where this + is itself determined by the contents of the corresponding +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +LaTeXType +\end_layout + +\end_inset + + tag. + +\end_layout + +\begin_layout Standard +For a command or normal paragraph, the output XHTML has the following form: +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout LyX-Code +Label +\end_layout + +\begin_layout LyX-Code +Contents of the paragraph. +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout Standard +The label tags are of course omitted if the paragraph does not have a label. +\end_layout + +\begin_layout Standard +For an environment that is not some sort of list, the XHTML takes this form: +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout LyX-Code +Environment LabelFirst paragraph. +\end_layout + +\begin_layout LyX-Code +Second paragraph. +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout Standard +Note that the label is output only for the first paragraph, as it should + be for a theorem, for example. + +\end_layout + +\begin_layout Standard +For a list, we have one of these forms: +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout LyX-Code +List LabelFirst item. +\end_layout + +\begin_layout LyX-Code +List LabelSecond item. +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout LyX-Code + +\end_layout + +\begin_layout LyX-Code +List LabelFirst item. +\end_layout + +\begin_layout LyX-Code +List LabelSecond item. +\end_layout + +\begin_layout LyX-Code + \end_layout -\begin_layout Description +\begin_layout Standard +Note the different orders of \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -NeedProtect +labeltag \end_layout \end_inset - [ + and \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -0 +itemtag \end_layout \end_inset -, +. + Which order we get depends upon the setting of \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +HTMLLabelFirst \end_layout \end_inset -] Whether fragile commands in this layout should be +: If \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -protect +HTMLLabelFirst \end_layout \end_inset -'ed. - (Note: This is -\emph on -not -\emph default - whether the command should itself be protected.) + is false (the default), you get the first of these, with the label within + the item; if true, you get the second, with the label outside the item. +\end_layout + +\begin_layout Standard +The specific tags and attributes output for each paragraph type can be controlle +d by means of the layout tags we are about to describe. + As mentioned earlier, however, LyX uses sensible defaults for many of these, + so you often may not need to do very much to get good XHTML output. + Think of the available tags as there so you can tweak things to your liking. \end_layout \begin_layout Description @@ -12666,7 +15466,7 @@ not status collapsed \begin_layout Plain Layout -PassThru +HTMLAttr \end_layout \end_inset @@ -12676,166 +15476,162 @@ PassThru status collapsed \begin_layout Plain Layout - -\emph on -0 +string \end_layout \end_inset -, +] Specifies attribute information to be output with the main tag. + For example, +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -1 +class=`mydiv' \end_layout \end_inset -] As with paragraph styles (see page -\begin_inset CommandInset ref -LatexCommand ref -reference "des:PathThru" +\begin_inset Quotes erd +\end_inset + +. + By default, LyX will output +\begin_inset Quotes eld \end_inset -). -\end_layout -\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Preamble +class=`layoutname' \end_layout \end_inset - As with paragraph styles (see page -\begin_inset CommandInset ref -LatexCommand pageref -reference "des:Preamble" +\begin_inset Quotes erd \end_inset -). -\end_layout - -\begin_layout Description +, where \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Requires +layoutname \end_layout \end_inset - [ + is the LyX name of the layout, made lowercase, for example: chapter. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -string +HTMLForceCSS \end_layout \end_inset -] As with paragraph styles (see page -\begin_inset CommandInset ref -LatexCommand pageref -reference "des:Requires" - -\end_inset - -). -\end_layout + [ +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout Subsection -Counters +\begin_layout Plain Layout +0,1 \end_layout -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "sec:counter" - \end_inset -Since version 1.3.0 of LyX, it is both possible and necessary to define the - counters ( -\begin_inset Flex CharStyle:MenuItem +] Whether to output the default CSS information LyX generates for this layout, + even if additional information is explicitly provided via +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -chapter +HTMLStyle \end_layout \end_inset -, -\begin_inset Flex CharStyle:MenuItem +. + Setting this to +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -figure +1 \end_layout \end_inset -, \SpecialChar \ldots{} -) in the text class itself. - The standard counters are defined in the file + allows you to alter or augment the generated CSS, rather than to override + it completely. + Default is \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -stdcounters.inc +0 \end_layout \end_inset -, so you may have to do no more than add +. \end_layout -\begin_layout LyX-Code -Input stdcounters.inc -\end_layout +\begin_layout Description +\begin_inset Flex CharStyle:Code +status collapsed -\begin_layout Standard -to your layout file to get them to work. - But if you want to define custom counters, then you can do so. - The counter declaration must begin with: +\begin_layout Plain Layout +HTMLItem \end_layout -\begin_layout LyX-Code -Counter name +\end_inset + + [ +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +string \end_layout -\begin_layout Standard -where of course `name' is replaced by the name of the counter. - And it must end with -\begin_inset Quotes eld \end_inset - +] The tag to be used for individual paragraphs of environments, replacing + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -End +itemtag \end_layout \end_inset + in the examples above. + Defaults to +\begin_inset Flex CharStyle:Code +status collapsed + +\begin_layout Plain Layout +div +\end_layout -\begin_inset Quotes erd \end_inset . - The following parameters can also be used: \end_layout \begin_layout Description @@ -12843,263 +15639,220 @@ End status collapsed \begin_layout Plain Layout -LabelString [string=""] +HTMLItemAttr \end_layout \end_inset - when this is defined, this string defines how the counter is displayed. - Setting this value sets + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelStringAppendix +string \end_layout \end_inset - to the same value. - The following special constructs can be used in the string: -\end_layout +] Attributes for the item tag. + Defaults to +\begin_inset Quotes eld +\end_inset + -\begin_deeper -\begin_layout Itemize \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -thecounter +class=`layoutname_item' \end_layout \end_inset - will be replaced by the expansion of the -\begin_inset Flex CharStyle:Code -status collapsed - -\begin_layout Plain Layout -LabelString -\end_layout +\begin_inset Quotes erd \end_inset - (or +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -LabelStringAppendix +HTMLLabel \end_layout \end_inset -) of the counter + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -counter +string \end_layout \end_inset -. - -\end_layout - -\begin_layout Itemize -counter values can be expressed using LaTeX-like macros +] The tag to be used for paragraph and item labels, replacing \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash - -\emph on -numbertype -\emph default -{ -\emph on -counter -\emph default -} +labeltag \end_layout \end_inset -, where + in the examples above. + Defaults to \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\emph on -numbertype +span \end_layout \end_inset - can be: -\begin_inset Foot +. +\end_layout + +\begin_layout Description +\begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\family roman -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Actually, the situation is a bit more complicated: any -\family default -\series default -\shape default -\emph default -\bar default - -\size default -\emph on -\noun default -\color inherit -numbertype -\family roman -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off - other than those described below will produce arabic numerals. - It would not be surprising to see this change in the future. +HTMLLabelAttr \end_layout \end_inset - + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -arabic +string \end_layout \end_inset -: 1, 2, 3,\SpecialChar \ldots{} -; +] Attributes for the label tag. + Defaults to +\begin_inset Quotes eld +\end_inset + + \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -alph +class=`layoutname_label' \end_layout \end_inset - for lower-case letters: a, b, c, \SpecialChar \ldots{} -; + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Alph +HTMLLabelFirst \end_layout \end_inset - for upper-case letters: A, B, C, \SpecialChar \ldots{} -; + [ \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -roman +0,1 \end_layout \end_inset - - for lower-case roman numerals: i, ii, iii, \SpecialChar \ldots{} -; + +] Meaningful only for list-like environments, this tag controls whether + the label tag is output before or inside the item tag. + This is used, for example, in the description environment, where we want + ` \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Roman +
\SpecialChar \ldots{} +
\SpecialChar \ldots{} +
\end_layout \end_inset - for upper-case roman numerals: I, II, III\SpecialChar \ldots{} -; +. + Default is \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -hebrew +0 \end_layout \end_inset - for hebrew numerals. +: The label tag is output inside the item tag. \end_layout -\end_deeper -\begin_layout Standard -If LabelString is not defined, a default value is constructed as follows: - if the counter has a master counter +\begin_layout Description \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -master +HTMLPreamble \end_layout \end_inset - (defined via + Information to be output in the \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout -Within + \end_layout \end_inset -), the string + section when this style is used. + This might, for example, be used to include a \begin_inset Flex CharStyle:Code status collapsed \begin_layout Plain Layout - -\backslash -themaster. -\backslash -arabic{counter} +