-\layout Standard
-
-So, all in all, LyX has information about a number of different programs
- to use behind the scenes in order to realize all of this machinery.
- This information, in fact, is exactly what is contained in the templates.
- To each template, there is associated a list of command lines that are
- used to invoke applications, convert the original file to the produced
- file, and more.
- This mechanism allows the advanced user to extend the capabilities of LyX
- without fiddling with the source code.
- It requires some footwork to define all the different commands and flags,
- but luckily, the LyX team did all the hard work and specified these for
- you.
-\layout Standard
-
-But before the trees grow into the skies, we have to admit that we did take
- one tiny short-cut.
- Since you can produce many different kinds of files to go with each exported
- format, one could also expect that it would be possible to preview each
- product.
- The LyX team decided against this in order to keep the user interface simple.
- Instead of providing a button for each exported file format, we decided
- to introduce the concept of the primary file format and just have one button.
- When you press
-\family sans
-View
-\family default
-\SpecialChar ~
-
-\family sans
-result
-\family default
- in the external material dialog, you will get a view of the produced file
- in the primary file format.
- And the primary file format is specified by your document class.
- For most document classes, the primary file format is LaTeX, but for the
- DocBook document classes, the primary file format is DocBook.
- So, when you view the produced file, keep in mind that it will only be
- a preview of what the main result will be.
- If you want to see how other exported formats turn out, you have to export
- them and preview them by hand.
-\layout Section
-
-The external material dialog
-\layout Standard
-
-You insert external material from the
-\family sans
-\bar under
-I
-\bar default
-nsert
-\family default
- menu.
- When you do this, a button is inserted into your document, and the external
- material dialog is shown.
- This dialog allows you to describe exactly what material should be included,
- and also how it should be included.
- Furthermore, it provides access to the external applications to either
- view, edit or produce the material that is used in the resulting file.
-\layout Standard
-
-At the top of this dialog, there is a drop-down list where you can chose
- which template should be used.
- Just below the template drop-down, there's a text area with a short blurb
- about the chosen template that should help you use it.
- Most often, it will provide a short description of the template, and a
- few hints on how to parameterize the use of it.
- Further down, you'll find a filename input field along with a
-\begin_inset Quotes eld
-\end_inset
-
-Browse
-\begin_inset Quotes erd
-\end_inset
-
- button that allows you to chose which file should be included with the
- standard file browser.
- Thus this field specifies the original file.
- Since the produced file is automatically generated when needed, there is
- no need to give access to it in the user interface.
-\layout Standard
-
-At the bottom of the dialog, you'll find a general input box called
-\family sans
-Parameters
-\family default
-.
- This box is generally used to parameterize the specific template.
- The specific use should be covered in the help blurb associated with the
- template, but it typically allows you to define variations on how the produced
- file should be generated.
-\layout Standard
-
-At the right side of the dialog, you'll find three buttons:
-\family sans
-Edit
-\family default
-\SpecialChar ~
-
-\family sans
-file
-\family default
-,
-\family sans
-View
-\family default
-\SpecialChar ~
-
-\family sans
-result
-\family default
-, and
-\family sans
-Update
-\family default
-\SpecialChar ~
-
-\family sans
-result
-\family default
-.
- These in turn allow you to edit your original file with the appropriate
- editing application, view the produced file as included in the primary
- format document, and finally force an update of the resulting material
- in the primary format.
- Normally, the
-\family sans
-Update
-\family default
-\SpecialChar ~
-
-\family sans
-result
-\family default
- button will be disabled, because most templates are configured to automatically
- update the produced file when needed.
- In those cases, there is no need to force the production of a new produced
- file.
- However, some templates are configured to not be automatically producing
- the residual product, because the cost of producing the produced file might
- be so large that it would be a pain to do it all the time.
- Those types are known as
-\emph on
-manual
-\emph default
- external material.
- In those cases, you can use the button to force the production of the produced
- file exactly when you need it, and thus control the amount of work that
- is done.
- In fact, it is
-\emph on
-your
-\emph default
- responsibility to do this to keep the produced files current at all times:
- before printing, before exporting, before viewing, etc.
- At some time in the future, it might be possible that LyX will help you
- with this task.Any changes in the template, filename or parameters are actually
- applied whenever you press
-\family sans
-Edit file
-\family default
-,
-\family sans
-View
-\family default
-\SpecialChar ~
-
-\family sans
-result
-\family default
- or
-\family sans
-Update
-\family default
-\SpecialChar ~