From: Uwe Stöhr Date: Thu, 6 Jan 2011 02:17:54 +0000 (+0000) Subject: EmbeddedObjects.lyx: description of new support for \includeonly , many thanks Jürgen! X-Git-Tag: 2.0.0~1173 X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=69463d7f1350891406c7afd2ba89e7227a09af8c;p=features.git EmbeddedObjects.lyx: description of new support for \includeonly , many thanks Jürgen! git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@37124 a592a061-630c-0410-9148-cb99ea01b6c8 --- diff --git a/lib/doc/EmbeddedObjects.lyx b/lib/doc/EmbeddedObjects.lyx index df934fa1b1..1a9681f7dd 100644 --- a/lib/doc/EmbeddedObjects.lyx +++ b/lib/doc/EmbeddedObjects.lyx @@ -1,4 +1,4 @@ -#LyX 2.0.0beta2 created this file. For more info see http://www.lyx.org/ +#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/ \lyxformat 410 \begin_document \begin_header @@ -32572,13 +32572,21 @@ Files ! Include \end_layout \begin_layout Standard -Child documents are used when you have a long document consisting of several +Child documents are used if you have a long document consisting of several larger parts or sections. For maintenance it is often useful and sometimes even required to split - the document in several files that can be revised separately. - The different documents are then the so called child documents and a master - document connects them to print the full document or parts of it. - A child documents inherits elements of its master, for example the LaTeX + the document into several files that can be revised separately. + The different documents are then the so called +\begin_inset Quotes eld +\end_inset + +child documents +\begin_inset Quotes erd +\end_inset + +, and a master document connects them to print the full document or parts + of it. + A child document inherits elements of its master, for example the LaTeX preamble, the bibliography, and labels for cross-references. \end_layout @@ -32623,7 +32631,7 @@ Documents \end_layout \begin_layout Description -Include You can include LyX and LaTeX-documents. +Include You can include LyX- and LaTeX-documents. When you press the \family sans Load @@ -32671,7 +32679,7 @@ reference "sub:External-Subsection-1" \end_inset - +. \end_layout \begin_layout Standard @@ -32683,54 +32691,6 @@ The preamble of the child document is ignored; only the preamble of the a page break. \end_layout -\begin_layout Standard -If you are only working on a certain chapter of a large document and want - to save compiling time, you can put each included file into a branch. -\begin_inset Foot -status collapsed - -\begin_layout Plain Layout -Branches are described in section -\emph on -Branches -\emph default - of the LyX -\emph on -Userguide -\emph default -. -\end_layout - -\end_inset - - By enabling/disabling branches you can decide what included files will - appear in the output. -\end_layout - -\begin_layout Standard -\begin_inset Note Greyedout -status open - -\begin_layout Plain Layout - -\series bold -Note: -\series default - Due to a bug in LyX the LaTeX command -\series bold - -\backslash -includeonly -\series default - can currently not be used as an alternative to decide what files should - be included. -\end_layout - -\end_inset - - -\end_layout - \begin_layout Standard \begin_inset Note Greyedout status open @@ -32740,8 +32700,8 @@ status open \series bold Note: \series default - When you have included a LyX- or LaTeX-file, you are warned when you export/vie -w the document in case the child document uses another document class than + If you have included a LyX- or LaTeX-file, you are warned when you export/view + the document in case the child document uses another document class than the master document as this will lead to unexpected outputs. \end_layout @@ -32786,13 +32746,13 @@ Graphics \end_layout \begin_layout Itemize -The LaTeX-command -\series bold - -\backslash -includeonly -\series default - cannot be used. +You cannot exclude Input files via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. \end_layout \end_deeper @@ -32812,7 +32772,7 @@ filename "DummyDocument2.lyx" \end_layout \begin_layout Description -Verbatim With this method every text file can be included. +Verbatim With this method any text file can be included. The file is shown in the output with its source code; no command used in the text is invoked. You can use the option @@ -32866,7 +32826,7 @@ filename "DummyTextDocument.txt" \begin_inset VSpace bigskip \end_inset -Here is a child document inserted as Verbatim using the + Here is a child document inserted as Verbatim using the \family sans Mark spaces in output \family default @@ -32942,6 +32902,84 @@ Note: \end_layout +\begin_layout Standard +If you want to view/export only selected children of your master document, + either because you want to save compiling time or because you want to distribut +e single chapters of the book you are just writing, you can exclude children + from the output. + This is done via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. + You can exclude\SpecialChar \slash{} +include children by double-clicking on the +\family sans +include to output +\family default + column of the respective child document in the list (note that this only + works for documents embedded via +\begin_inset Quotes eld +\end_inset + +Include +\begin_inset Quotes erd +\end_inset + +, not with +\begin_inset Quotes eld +\end_inset + +Input +\begin_inset Quotes erd +\end_inset + +). + If the option +\family sans +Maintain counters and references +\family default + is enabled, LyX will assure that all page numbers, references etc. +\begin_inset space ~ +\end_inset + +are correct as if the whole document was processed. + This is useful if you want the selected sub-documents to look exactly as + in the context of the whole document. + However, LyX needs to process the whole document in the background for + this feature. + So if you want to save compile time and if counters and references do not + need to be correct, disable this checkbox. +\end_layout + +\begin_layout Standard +Alternatively, you can put each included file into a branch. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +Branches are described in section +\emph on +Branches +\emph default + of the LyX +\emph on +Userguide +\emph default +. +\end_layout + +\end_inset + + By enabling\SpecialChar \slash{} +disabling branches you can decide which included files will + appear in the output. + This has the advantage that it also works with Input'ed sub-documents. + However, counters and references will not be maintained with this approach. +\end_layout + \begin_layout Chapter Program Code Listings \begin_inset CommandInset label diff --git a/lib/doc/de/EmbeddedObjects.lyx b/lib/doc/de/EmbeddedObjects.lyx index 28a89a3b13..6f582f66d8 100644 --- a/lib/doc/de/EmbeddedObjects.lyx +++ b/lib/doc/de/EmbeddedObjects.lyx @@ -1,4 +1,4 @@ -#LyX 2.0.0beta2 created this file. For more info see http://www.lyx.org/ +#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/ \lyxformat 410 \begin_document \begin_header @@ -32756,54 +32756,6 @@ Include und enden mit einem Seitenumbruch. \end_layout -\begin_layout Standard -Wenn Sie nur an einem Kapitel eines großen Dokuments arbeiten und Zeit sparen - wollen, können Sie eingefügte Dateien in einen Zweig setzen. -\begin_inset Foot -status collapsed - -\begin_layout Plain Layout -Zweige sind im Kapitel -\emph on -Zweige -\emph default - des LyX -\emph on -Benutzerhandbuchs -\emph default - erklärt. -\end_layout - -\end_inset - - Durch das de/aktivieren der Zweige können Sie festlegen, welche eingefügte - Dateien in der Ausgabe erscheinen. -\end_layout - -\begin_layout Standard -\begin_inset Note Greyedout -status open - -\begin_layout Plain Layout - -\series bold -Achtung: -\series default - Aufgrund eines Fehlers in LyX kann der LaTeX-Befehl -\series bold - -\backslash -includeonly -\series default - momentan nicht als Alternative benutzt werden um festzulegen, welche eingefügte - Dateien in der Ausgabe erscheinen. -\end_layout - -\end_inset - - -\end_layout - \begin_layout Standard \begin_inset Note Greyedout status open @@ -32883,13 +32835,17 @@ An \end_layout \begin_layout Itemize -Der LaTeX-Befehl -\series bold - -\backslash -includeonly -\series default - kann nicht benutzt werden. +Unterdokumente, die per +\family sans +Input +\family default + eingebunden werden, können nicht über das Menü +\family sans +Dokument\SpecialChar \menuseparator +Einstellungen\SpecialChar \menuseparator +Unterdokumente +\family default + ausgeschlossen werden. \end_layout \end_deeper @@ -33090,6 +33046,90 @@ Bemerkung: \end_layout +\begin_layout Standard + +\lang english +If you want to view/export only selected children of your master document, + either because you want to save compiling time or because you want to distribut +e single chapters of the book you are just writing, you can exclude children + from the output. + +\lang ngerman +Dies geschieht über das Menü +\family sans +Dokument\SpecialChar \menuseparator +Einstellungen\SpecialChar \menuseparator +Unterdokumente +\family default +. + +\lang english +You can exclude\SpecialChar \slash{} +include children by double-clicking on the +\family sans +include to output +\family default + column of the respective child document in the list (note that this only + works for documents embedded via +\begin_inset Quotes eld +\end_inset + +Include +\begin_inset Quotes erd +\end_inset + +, not with +\begin_inset Quotes eld +\end_inset + +Input +\begin_inset Quotes erd +\end_inset + +). + If the option +\family sans +Maintain counters and references +\family default + is enabled, LyX will assure that all page numbers, references etc. +\begin_inset space ~ +\end_inset + +are correct as if the whole document was processed. + This is useful if you want the selected sub-documents to look exactly as + in the context of the whole document. + However, LyX needs to process the whole document in the background for + this feature. + So if you want to save compile time and if counters and references do not + need to be correct, disable this checkbox. +\end_layout + +\begin_layout Standard +Alternativ, können Sie eingefügte Dateien in einen Zweig setzen. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +Zweige sind im Kapitel +\emph on +Zweige +\emph default + des LyX +\emph on +Benutzerhandbuchs +\emph default + erklärt. +\end_layout + +\end_inset + + Durch das de/aktivieren der Zweige können Sie festlegen, welche eingefügte + Dateien in der Ausgabe erscheinen. + Dies hat den Vorteil, dass es auch bei Input-Einfügungen funktioniert. + Jedoch können bei dieser Methode Zähler und Referenzen nicht aktuell gehalten + werden. +\end_layout + \begin_layout Chapter Programm-Code-Listen \begin_inset CommandInset label diff --git a/lib/doc/es/EmbeddedObjects.lyx b/lib/doc/es/EmbeddedObjects.lyx index 27c7ae795e..e4665d161f 100644 --- a/lib/doc/es/EmbeddedObjects.lyx +++ b/lib/doc/es/EmbeddedObjects.lyx @@ -1,4 +1,4 @@ -#LyX 2.0.0beta2 created this file. For more info see http://www.lyx.org/ +#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/ \lyxformat 410 \begin_document \begin_header @@ -32214,55 +32214,6 @@ El preámbulo del documento hijo se ignora, sólo se utiliza el preámbulo con un salto de página. \end_layout -\begin_layout Standard -En caso de estar trabajando solo en un capítulo determinado de un documento - extenso, y con el fin de ahorrar tiempo de compilación, se puede poner - cada archivo incluido en una rama. -\begin_inset Foot -status collapsed - -\begin_layout Plain Layout -Las ramas se describen en la sección -\emph on - Ramas -\emph default - de la -\emph on -Guía del usuario -\emph default - de LyX. -\end_layout - -\end_inset - - Habilitando/deshabilitando las ramas puedes decidir qué archivos incluidos - aparecerán en la salida. -\end_layout - -\begin_layout Standard -\begin_inset Note Greyedout -status open - -\begin_layout Plain Layout - -\series bold -Nota: -\series default - Debido a un fallo de LyX, el comando LaTeX -\series bold - -\backslash -includeonly -\series default - no se puede usar por el momento como alternativa para decidir qué archivos - deberían ser incluidos. -\end_layout - -\end_inset - - -\end_layout - \begin_layout Standard \begin_inset Note Greyedout status open @@ -32324,12 +32275,14 @@ Gráficos \end_layout \begin_layout Itemize -No se puede utilizar el comando LaTeX -\series bold -\backslash -includeonly -\series default +\lang english +You cannot exclude Input files via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default . \end_layout @@ -32502,6 +32455,91 @@ Nota: \end_layout +\begin_layout Standard + +\lang english +If you want to view/export only selected children of your master document, + either because you want to save compiling time or because you want to distribut +e single chapters of the book you are just writing, you can exclude children + from the output. + This is done via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. + You can exclude\SpecialChar \slash{} +include children by double-clicking on the +\family sans +include to output +\family default + column of the respective child document in the list (note that this only + works for documents embedded via +\begin_inset Quotes eld +\end_inset + +Include +\begin_inset Quotes erd +\end_inset + +, not with +\begin_inset Quotes eld +\end_inset + +Input +\begin_inset Quotes erd +\end_inset + +). + If the option +\family sans +Maintain counters and references +\family default + is enabled, LyX will assure that all page numbers, references etc. +\begin_inset space ~ +\end_inset + +are correct as if the whole document was processed. + This is useful if you want the selected sub-documents to look exactly as + in the context of the whole document. + However, LyX needs to process the whole document in the background for + this feature. + So if you want to save compile time and if counters and references do not + need to be correct, disable this checkbox. +\end_layout + +\begin_layout Standard + +\lang english +Alternatively +\lang spanish +, se puede poner cada archivo incluido en una rama. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +Las ramas se describen en la sección +\emph on + Ramas +\emph default + de la +\emph on +Guía del usuario +\emph default + de LyX. +\end_layout + +\end_inset + + Habilitando/deshabilitando las ramas puedes decidir qué archivos incluidos + aparecerán en la salida. + +\lang english +This has the advantage that it also works with Input'ed sub-documents. + However, counters and references will not be maintained with this approach. +\end_layout + \begin_layout Chapter Listado de programa \begin_inset CommandInset label diff --git a/lib/doc/fr/EmbeddedObjects.lyx b/lib/doc/fr/EmbeddedObjects.lyx index b85a5fea62..3d8e6de69c 100644 --- a/lib/doc/fr/EmbeddedObjects.lyx +++ b/lib/doc/fr/EmbeddedObjects.lyx @@ -33358,56 +33358,6 @@ Le préambule du sous-document est tout simplement ignoré, seul le préambule suivis par un saut de page. \end_layout -\begin_layout Standard -Si vous travaillez uniquement sur un chapitre particulier d'un document - important et que vous voulez optimiser le temps de compilation, vous pouvez - inclure chaque fichier dans une branche -\begin_inset Foot -status open - -\begin_layout Plain Layout -Les branches sont décrites dans la section -\emph on -Branches -\emph default - du -\emph on -Guide de l'utilisateur -\emph default - de LyX. -\end_layout - -\end_inset - -. - En activant ou désactivant une branche, vous pouvez décider les fichiers - inclus qui doivent apparaître dans la sortie imprimée. -\end_layout - -\begin_layout Standard -\begin_inset Note Greyedout -status open - -\begin_layout Plain Layout - -\series bold -Note: -\series default - À cause d'un bug de LyX, la commande -\series bold - -\backslash -includeonly -\series default - ne peut actuellement pas être utilisée comme solution alternative pour - décider quels sont les fichiers qui doivent être inclus. -\end_layout - -\end_inset - - -\end_layout - \begin_layout Standard \begin_inset Note Greyedout status open @@ -33470,13 +33420,15 @@ Graphique \end_layout \begin_layout Itemize -La commande LaTeX -\series bold -\backslash -includeonly -\series default - ne peut pas être utilisée. +\lang english +You cannot exclude Input files via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. \end_layout \end_deeper @@ -33646,6 +33598,92 @@ Note: \end_layout +\begin_layout Standard + +\lang english +If you want to view/export only selected children of your master document, + either because you want to save compiling time or because you want to distribut +e single chapters of the book you are just writing, you can exclude children + from the output. + This is done via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. + You can exclude\SpecialChar \slash{} +include children by double-clicking on the +\family sans +include to output +\family default + column of the respective child document in the list (note that this only + works for documents embedded via +\begin_inset Quotes eld +\end_inset + +Include +\begin_inset Quotes erd +\end_inset + +, not with +\begin_inset Quotes eld +\end_inset + +Input +\begin_inset Quotes erd +\end_inset + +). + If the option +\family sans +Maintain counters and references +\family default + is enabled, LyX will assure that all page numbers, references etc. +\begin_inset space ~ +\end_inset + +are correct as if the whole document was processed. + This is useful if you want the selected sub-documents to look exactly as + in the context of the whole document. + However, LyX needs to process the whole document in the background for + this feature. + So if you want to save compile time and if counters and references do not + need to be correct, disable this checkbox. +\end_layout + +\begin_layout Standard + +\lang english +Alternatively +\lang french +, vous pouvez inclure chaque fichier dans une branche +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +Les branches sont décrites dans la section +\emph on +Branches +\emph default + du +\emph on +Guide de l'utilisateur +\emph default + de LyX. +\end_layout + +\end_inset + +. + En activant ou désactivant une branche, vous pouvez décider les fichiers + inclus qui doivent apparaître dans la sortie imprimée. + +\lang english +This has the advantage that it also works with Input'ed sub-documents. + However, counters and references will not be maintained with this approach. +\end_layout + \begin_layout Chapter Listings de Code Source \begin_inset CommandInset label diff --git a/lib/doc/ja/EmbeddedObjects.lyx b/lib/doc/ja/EmbeddedObjects.lyx index 9022ab0280..cfa2fc9bbc 100644 --- a/lib/doc/ja/EmbeddedObjects.lyx +++ b/lib/doc/ja/EmbeddedObjects.lyx @@ -1,4 +1,4 @@ -#LyX 2.0.0beta2 created this file. For more info see http://www.lyx.org/ +#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/ \lyxformat 410 \begin_document \begin_header @@ -30600,51 +30600,6 @@ reference "sub:外部文書の第1小節" は、新規頁から始まるように挿入され、改頁して終わります。 \end_layout -\begin_layout Standard -大きな文書のうち、特定の章だけの作業を行っている際に、コンパイル時間を短縮したい場合、取り込んだファイルの各々を派生枝の中に入れる方法があります -\begin_inset Foot -status open - -\begin_layout Plain Layout -派生枝は、LyX -\emph on -ユーザーの手引き -\emph default -の -\emph on -派生枝 -\emph default -の節に説明されています。 -\end_layout - -\end_inset - -。派生枝を有効化したり無効化したりすることによって、取り込んだファイルのどれを出力に表示させるかを決めることができます。 -\end_layout - -\begin_layout Standard -\begin_inset Note Greyedout -status open - -\begin_layout Plain Layout - -\series bold -【註】 -\series default -LyXのバグにより、どのファイルを取り込むかを決める他の方法として、現在のところ、LaTeXコマンドの -\series bold - -\backslash -includeonly -\series default -を使用することはできません。 -\end_layout - -\end_inset - - -\end_layout - \begin_layout Standard \begin_inset Note Greyedout status open @@ -30686,13 +30641,15 @@ Inputファイルは、LyX設定の操作性 \end_layout \begin_layout Itemize -LaTeXコマンドの -\series bold -\backslash -includeonly -\series default -は使用することができません。 +\lang english +You cannot exclude Input files via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. \end_layout \end_deeper @@ -30838,6 +30795,92 @@ status open \end_layout +\begin_layout Standard + +\lang english +If you want to view/export only selected children of your master document, + either because you want to save compiling time or because you want to distribut +e single chapters of the book you are just writing, you can exclude children + from the output. + This is done via the menu +\family sans +Document\SpecialChar \menuseparator +Settings\SpecialChar \menuseparator +Child Documents +\family default +. + You can exclude\SpecialChar \slash{} +include children by double-clicking on the +\family sans +include to output +\family default + column of the respective child document in the list (note that this only + works for documents embedded via +\begin_inset Quotes eld +\end_inset + +Include +\begin_inset Quotes erd +\end_inset + +, not with +\begin_inset Quotes eld +\end_inset + +Input +\begin_inset Quotes erd +\end_inset + +). + If the option +\family sans +Maintain counters and references +\family default + is enabled, LyX will assure that all page numbers, references etc. +\begin_inset space ~ +\end_inset + +are correct as if the whole document was processed. + This is useful if you want the selected sub-documents to look exactly as + in the context of the whole document. + However, LyX needs to process the whole document in the background for + this feature. + So if you want to save compile time and if counters and references do not + need to be correct, disable this checkbox. +\end_layout + +\begin_layout Standard + +\lang english +Alternatively, you can put each included file into a branch. +\lang japanese + +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +派生枝は、LyX +\emph on +ユーザーの手引き +\emph default +の +\emph on +派生枝 +\emph default +の節に説明されています。 +\end_layout + +\end_inset + + +\lang english + By enabling\SpecialChar \slash{} +disabling branches you can decide which included files will + appear in the output. + This has the advantage that it also works with Input'ed sub-documents. + However, counters and references will not be maintained with this approach. +\end_layout + \begin_layout Chapter プログラムコードリスト \begin_inset CommandInset label