From 8c129b4a2900b0108539b31d17ec335807c3fa39 Mon Sep 17 00:00:00 2001 From: Richard Heck Date: Sat, 16 Apr 2011 14:16:35 +0000 Subject: [PATCH] Local Layout Docs Again git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@38414 a592a061-630c-0410-9148-cb99ea01b6c8 --- lib/doc/Customization.lyx | 117 +++++++++++++++++++++++++++++++++++++- 1 file changed, 116 insertions(+), 1 deletion(-) diff --git a/lib/doc/Customization.lyx b/lib/doc/Customization.lyx index 138f45108b..ae58459228 100644 --- a/lib/doc/Customization.lyx +++ b/lib/doc/Customization.lyx @@ -134,11 +134,12 @@ End \papercolumns 1 \papersides 2 \paperpagestyle headings -\tracking_changes false +\tracking_changes true \output_changes false \html_math_output 0 \html_css_as_file 0 \html_be_strict true +\author 1414654397 "Richard Heck" \end_header \begin_body @@ -6206,6 +6207,120 @@ usly working on actual documents . Though of course the developers strive to keep LyX stable in such situations, syntax errors and the like in your module file could cause strange behavior. +\change_inserted 1414654397 1302962370 + +\end_layout + +\begin_layout Subsubsection + +\change_inserted 1414654397 1302962375 +Local Layout +\end_layout + +\begin_layout Standard + +\change_inserted 1414654397 1302962524 +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 + +\change_inserted 1414654397 1302963263 +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 + +\change_inserted 1414654397 1302962556 +Format +\change_unchanged + +\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 + +\change_inserted 1414654397 1302963275 +When you have entered something in the +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted 1414654397 1302963275 +Local Layout +\change_unchanged + +\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 + +\change_inserted 1414654397 1302963364 +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. +\change_unchanged + \end_layout \begin_layout Subsection -- 2.39.2