]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Customization.lyx
CMake export tests now correctly check return code
[lyx.git] / lib / doc / Customization.lyx
index 0c171316ea9dbb4438e2bc27133a6a2085bea091..2cb56dc7f7d6bdc34d6c5dc39a042c3ea7954e60 100644 (file)
@@ -193,7 +193,13 @@ type "mailto:"
 \begin_inset Newline newline
 \end_inset
 
-Version 2.0.x 
+Version 2.
+\change_deleted -712698321 1357054389
+0
+\change_inserted -712698321 1357054389
+1
+\change_unchanged
+.x 
 \end_layout
 
 \begin_layout Standard
@@ -934,7 +940,14 @@ configure.py
 \end_layout
 
 \begin_layout Subsection
-Other files needing a line or two...
+Other files needing a line or two
+\change_deleted -712698321 1357054454
+...
+\change_inserted -712698321 1357054454
+\SpecialChar \ldots{}
+
+\change_unchanged
+
 \end_layout
 
 \begin_layout Labeling
@@ -992,6 +1005,28 @@ languages
 \end_inset
 
  this file contains a list of all the languages currently supported by LyX.
+\change_inserted -712698321 1357054565
+
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted -712698321 1357054669
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1357054669
+latexfonts
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ contains information about the supported fonts.
 \change_inserted -195340706 1334775793
 
 \end_layout
@@ -1024,6 +1059,29 @@ reference "sub:I18n"
 \end_inset
 
 ).
+\change_inserted -712698321 1357054494
+
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted -712698321 1357054554
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1357054508
+unicodesymbols
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ this file contains information about unicode-encoded glyphs and the way
+ they are supported by LyX via LaTeX.
 \change_unchanged
 
 \end_layout
@@ -6728,7 +6786,11 @@ to change the font for chapter headings to sans-serif.
 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 
+ See section
+\begin_inset space ~
+\end_inset
+
+
 \begin_inset CommandInset ref
 LatexCommand ref
 reference "sec:TextClass"
@@ -6778,7 +6840,7 @@ DeclareLyXModule{My Package}
 \end_layout
 
 \begin_layout LyX-Code
-Format 21
+Format 35
 \begin_inset Newline newline
 \end_inset
 
@@ -6802,7 +6864,11 @@ EndPreamble
 \begin_layout Standard
 A more complex module might modify the behavior of some existing constructs
  or define some new ones.
- Again, see 
+ Again, see section
+\begin_inset space ~
+\end_inset
+
+
 \begin_inset CommandInset ref
 LatexCommand ref
 reference "sec:TextClass"
@@ -7007,7 +7073,6 @@ notepad
 \end_inset
 
 .
 \end_layout
 
 \begin_layout Standard
@@ -7092,8 +7157,8 @@ Upgrading old layout files
 \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 
If LyX reads a layout file in an older format, it automatically calls the
+ script 
 \begin_inset Flex Code
 status collapsed
 
@@ -7110,16 +7175,50 @@ layout2layout.py
  To do this, you can call the converter manually:
 \end_layout
 
-\begin_layout LyX-Code
-mv myclass.layout myclass.old
+\begin_layout Enumerate
+rename the file 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+myclass.layout
 \end_layout
 
-\begin_layout LyX-Code
+\end_inset
+
+ to 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+myclass.old
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+Call the command
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
 python LyXDir/scripts/layout2layout.py myclass.old myclass.layout
 \end_layout
 
-\begin_layout Standard
-You need to replace 
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+where 
 \begin_inset Flex Code
 status collapsed
 
@@ -7129,7 +7228,7 @@ LyXDir
 
 \end_inset
 
with the name of your LyX system directory, of course.
is the name of your LyX system directory.
 \end_layout
 
 \begin_layout Standard
@@ -7148,14 +7247,12 @@ The layout file format
 \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 too much in one sitting.
- Go have another adult beverage, just for good measure.
+The following sections describe how layout files are structured and written.
+ Our advice is to go slowly, save and test often.
+ It is really not that hard, except that the multitude of options can become
+ overwhelming, especially if you try to check out too many at once.
+ It becomes easier if you use existing layouts of LyX as examples/reference
+ or if you modify an existing layout to your needs.
 \end_layout
 
 \begin_layout Standard
@@ -7191,9 +7288,8 @@ StYlE
 \end_inset
 
  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 
+ The possible arguments are printed in brackets after the tag's name.
+ The default argument is typeset 
 \begin_inset Flex Code
 status collapsed
 
@@ -7943,18 +8039,6 @@ Modules
 .
  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
-The list of such packages is documented only in the source code.
-\end_layout
-
-\end_inset
-
- LyX will not check for arbitrary packages.
  It is also possible to use the form 
 \begin_inset Flex MenuItem
 status collapsed
@@ -8085,11 +8169,7 @@ at least one
 no
 \emph default
  excluded module may be used.
- Note that modules are identified here by their 
-\emph on
-filenames
-\emph default
- without the 
+ Note that modules are identified here by their filenames without the 
 \begin_inset Flex Code
 status collapsed
 
@@ -12726,6 +12806,33 @@ Sensitive
  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.
+ For the case that a caption is inserted outside of a float 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+LabelString
+\end_layout
+
+\end_inset
+
+ should be set to e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g
+\begin_inset space \space{}
+\end_inset
+
+
+\begin_inset Quotes eld
+\end_inset
+
+Senseless!
+\begin_inset Quotes erd
+\end_inset
+
+.
 \end_layout
 
 \begin_layout Description
@@ -13237,8 +13344,8 @@ Environment
 
 \end_inset
 
- but adds additionally the necessary mandatory argument to the begin statement
- of the bibliography environment:
+ but adds additionally the necessary mandatory argument (the longest label)
to the begin statement of the bibliography environment:
 \begin_inset Newline newline
 \end_inset
 
@@ -13255,6 +13362,16 @@ begin{thebibliography}{99}
 \end_inset
 
  It is therefore only useful for bibliography environments.
+ The default longest label 
+\begin_inset Quotes eld
+\end_inset
+
+99
+\begin_inset Quotes erd
+\end_inset
+
+ can be changed by the user in the paragraph settings of a bibliography
+ item.
 \end_layout
 
 \begin_layout Standard