]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Customization.lyx
doc files: port recent changes to trunk
[lyx.git] / lib / doc / Customization.lyx
index 63dd0bcd4412da4f2652114aafbb782856b25cf3..b27589413474ff16263a67834e9853270bd84cf1 100644 (file)
@@ -46,8 +46,8 @@ logicalmkup
 \end_modules
 \maintain_unincluded_children false
 \begin_local_layout
-Format 7
-InsetLayout CharStyle:MenuItem
+Format 35
+InsetLayout Flex:MenuItem
 LyxType               charstyle
 LabelString           menu
 LatexType             command
@@ -231,7 +231,7 @@ on, installing new LaTeX classes and LyX layouts, etc.
 
 \begin_layout Standard
 \begin_inset Branch OutDated
-status open
+status collapsed
 
 \begin_layout Standard
 Information from previous versions of this document that now seems to be
@@ -6208,6 +6208,98 @@ usly working on actual documents
  syntax errors and the like in your module file could cause strange behavior.
 \end_layout
 
+\begin_layout Subsubsection
+Local Layout
+\end_layout
+
+\begin_layout Standard
+Modules are to LyX as packages are to LaTeX.
+ Sometimes, however, you find yourself wanting a specific inset or character
+ style just for one document and writing a module that will also be available
+ to other documents makes little sense.
+ What you need is LyX's 
+\begin_inset Quotes eld
+\end_inset
+
+Local Layout
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+You will find it under 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Local Layout
+\family default
+.
+ The large text box allows you to enter anything that you might enter in
+ a layout file or module.
+ You can think of a document's local layout, in fact, as a module that belongs
+ just to it.
+ So, in particular, you must enter a 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\end_layout
+
+\end_inset
+
+ tag.
+ Any format is acceptable, but one would normally use the format current
+ at the time.
+ (In LyX 2.0, the current layout format is 35.) You should be aware that local
+ layout is not supported by versions of LyX prior to 1.6, so you should not
+ use it if you want to be able to export your document to LyX 1.5 or earlier
+ (without, that is, losing the local layout information).
+ If you wish to be able to export to 1.6---local layout is supported in 1.6,
+ though there is no UI for it---then you should use format 11 and, of course,
+ use only layout constructs that were available in LyX 1.6.
+\end_layout
+
+\begin_layout Standard
+When you have entered something in the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Local Layout
+\end_layout
+
+\end_inset
+
+ pane, LyX will enable the 
+\begin_inset Quotes eld
+\end_inset
+
+Validate
+\begin_inset Quotes erd
+\end_inset
+
+ button at the bottom.
+ Clicking this button will cause LyX to determine whether what you have
+ entered is valid layout information for the chosen format.
+ LyX will report the result but, unfortunately, will not tell you what errors
+ there might have been.
+ These will be written to the terminal, however, if LyX is started from
+ a terminal.
+ You will not be permitted to save your local layout until you have entered
+ something valid.
+\end_layout
+
+\begin_layout Standard
+The warnings at the end of the previous section apply here, too.
+ Do not play with local layout while you are actually working, especially
+ if you have not saved your document.
+ That said, using local layout with a test document can be a very convenient
+ way to try out layout ideas, or even to start developing a module.
+\end_layout
+
 \begin_layout Subsection
 Layout for 
 \begin_inset Flex MenuItem
@@ -11719,28 +11811,29 @@ status collapsed
 
 \end_inset
 
-] Whether the following Paragraph is allowed to indent its very first row.
+] If set to true, and if 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-1
+DefaultStyle
 \end_layout
 
 \end_inset
 
- means that it is not allowed to do so; 
+ (usually 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-0
+Standard
 \end_layout
 
 \end_inset
 
- means it could do so if it wants to.
+) paragraphs are being indented, then the indentation of such a paragraph
+ following one of this type will be suppressed.
+ (So this will not affect the display of non-default paragraphs.)
 \end_layout
 
 \begin_layout Description