|
|
@ -6,7 +6,7 @@
|
|
|
|
<subtitle>Version 2.3.x</subtitle>
|
|
|
|
<subtitle>Version 2.3.x</subtitle>
|
|
|
|
<section>
|
|
|
|
<section>
|
|
|
|
<title>File formats</title>
|
|
|
|
<title>File formats</title>
|
|
|
|
<section xml:id="sec.When-is-an-0">
|
|
|
|
<section xml:id="sec.When-is-an">
|
|
|
|
<title>When is an update of the .lyx file format number needed?</title>
|
|
|
|
<title>When is an update of the .lyx file format number needed?</title>
|
|
|
|
<para>When you are working on a new feature you may ask yourself whether it needs an update of the .lyx file format number. Whether an update is needed or not is not always obvious. Rule of thumb: </para>
|
|
|
|
<para>When you are working on a new feature you may ask yourself whether it needs an update of the .lyx file format number. Whether an update is needed or not is not always obvious. Rule of thumb: </para>
|
|
|
|
<blockquote>
|
|
|
|
<blockquote>
|
|
|
@ -17,30 +17,30 @@
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>New document setting</term>
|
|
|
|
<term>New document setting</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> Whenever you introduce a new setting that is stored in the document header, a file format update is needed.</para>
|
|
|
|
<para>Whenever you introduce a new setting that is stored in the document header, a file format update is needed.</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>Removed document setting</term>
|
|
|
|
<term>Removed document setting</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> If a certain setting becomes obsolete and gets removed, a file format update is needed.</para>
|
|
|
|
<para>If a certain setting becomes obsolete and gets removed, a file format update is needed.</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>New valid value for an existing setting,</term>
|
|
|
|
<term>New valid value for an existing setting,</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> e. g.</para>
|
|
|
|
<para>e. g.</para>
|
|
|
|
<variablelist>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>Automatically loaded math package</term>
|
|
|
|
<term>Automatically loaded math package</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> The reason for this is that there is no true ERT inset for math formulas: Each command is parsed, and if a user happens to define a local command with the same name as a command that triggers an automatic load of a package, they need to be able to switch off the automatic loading of that package. This switch is stored by the use_package header setting.</para>
|
|
|
|
<para>The reason for this is that there is no true ERT inset for math formulas: Each command is parsed, and if a user happens to define a local command with the same name as a command that triggers an automatic load of a package, they need to be able to switch off the automatic loading of that package. This switch is stored by the use_package header setting.</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>New language</term>
|
|
|
|
<term>New language</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> that is stored in \language. </para>
|
|
|
|
<para>that is stored in \language. </para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</variablelist>
|
|
|
@ -49,49 +49,49 @@
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>New inset</term>
|
|
|
|
<term>New inset</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> Of course a new inset requires a file format update.</para>
|
|
|
|
<para>Of course a new inset requires a file format update.</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>New style</term>
|
|
|
|
<term>New style</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> If a new style or inset layout is added to any layout file or module shipped with LyX, then a new file format is needed in the master (development) branch. It is possible to backport new styles to the stable version without a file format change.</para>
|
|
|
|
<para>If a new style or inset layout is added to any layout file or module shipped with LyX, then a new file format is needed in the master (development) branch. It is possible to backport new styles to the stable version without a file format change.</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>Removed style</term>
|
|
|
|
<term>Removed style</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> If a style or inset layout is removed in any layout file or module shipped with LyX, a new file format is required.</para>
|
|
|
|
<para>If a style or inset layout is removed in any layout file or module shipped with LyX, a new file format is required.</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</variablelist>
|
|
|
|
<para>However, <emphasis role='bold'>new</emphasis> layouts and modules do <emphasis role='bold'>not</emphasis> require a file format update (changed 03/16). </para>
|
|
|
|
<para>However, <emphasis role='bold'>new</emphasis> layouts and modules do <emphasis role='bold'>not</emphasis> require a file format update (changed 03/16). </para>
|
|
|
|
<para>If you are still unsure, please ask on the development list.</para>
|
|
|
|
<para>If you are still unsure, please ask on the development list.</para>
|
|
|
|
<section xml:id="par.export-test-output-formats-1">
|
|
|
|
<section xml:id="par.export-test-output-formats">
|
|
|
|
<title>Output formats</title>
|
|
|
|
<title>Output formats</title>
|
|
|
|
<para>The following output formats are currently tested for each sample document:</para>
|
|
|
|
<para>The following output formats are currently tested for each sample document:</para>
|
|
|
|
<variablelist>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>LyX:</term>
|
|
|
|
<term>LyX:</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
|
|
|
|
<para />
|
|
|
|
<variablelist>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>lyx16</term>
|
|
|
|
<term>lyx16</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LyX 1.6 file format (lyx2lyx)</para>
|
|
|
|
<para>LyX 1.6 file format (lyx2lyx)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>lyx21</term>
|
|
|
|
<term>lyx21</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LyX 2.1 file format (lyx2lyx)</para>
|
|
|
|
<para>LyX 2.1 file format (lyx2lyx)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>xhtml</term>
|
|
|
|
<term>xhtml</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LyXHTML (native LyX HTML export)</para>
|
|
|
|
<para>LyXHTML (native LyX HTML export)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</variablelist>
|
|
|
@ -100,54 +100,54 @@
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>LyX + LaTeX:</term>
|
|
|
|
<term>LyX + LaTeX:</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
|
|
|
|
<para />
|
|
|
|
<variablelist>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>dvi</term>
|
|
|
|
<term>dvi</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> DVI (8-bit latex)</para>
|
|
|
|
<para>DVI (8-bit latex)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>dvi3_texF</term>
|
|
|
|
<term>dvi3_texF</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> DVI (LuaTeX with 8-bit TeX fonts)</para>
|
|
|
|
<para>DVI (LuaTeX with 8-bit TeX fonts)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>dvi3_systemF</term>
|
|
|
|
<term>dvi3_systemF</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> DVI (LuaTeX with Unicode fonts)</para>
|
|
|
|
<para>DVI (LuaTeX with Unicode fonts)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf2</term>
|
|
|
|
<term>pdf2</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> PDF (pdflatex)</para>
|
|
|
|
<para>PDF (pdflatex)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf4_texF</term>
|
|
|
|
<term>pdf4_texF</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> PDF (XeTeX with 8-bit TeX fonts)</para>
|
|
|
|
<para>PDF (XeTeX with 8-bit TeX fonts)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf4_systemF</term>
|
|
|
|
<term>pdf4_systemF</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> PDF (XeTeX with Unicode fonts)</para>
|
|
|
|
<para>PDF (XeTeX with Unicode fonts)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf5_texF</term>
|
|
|
|
<term>pdf5_texF</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> PDF (LuaTeX with 8-bit TeX fonts)</para>
|
|
|
|
<para>PDF (LuaTeX with 8-bit TeX fonts)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf5_systemF</term>
|
|
|
|
<term>pdf5_systemF</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> PDF (LuaTeX with Unicode fonts)</para>
|
|
|
|
<para>PDF (LuaTeX with Unicode fonts)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</variablelist>
|
|
|
@ -156,18 +156,18 @@
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>LyX + LaTeX + postprocessing:</term>
|
|
|
|
<term>LyX + LaTeX + postprocessing:</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
|
|
|
|
<para />
|
|
|
|
<variablelist>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf</term>
|
|
|
|
<term>pdf</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> DVI -> PS (dvips) -> PDF (ps2pdf)</para>
|
|
|
|
<para>DVI -> PS (dvips) -> PDF (ps2pdf)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdf3</term>
|
|
|
|
<term>pdf3</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> DVI -> PDF (dvipdfm)</para>
|
|
|
|
<para>DVI -> PDF (dvipdfm)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</variablelist>
|
|
|
@ -176,90 +176,90 @@
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>not tested:</term>
|
|
|
|
<term>not tested:</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> (or only if set as default output format in the document source)</para>
|
|
|
|
<para>(or only if set as default output format in the document source)</para>
|
|
|
|
<variablelist>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>latex</term>
|
|
|
|
<term>latex</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LaTeX (plain)</para>
|
|
|
|
<para>LaTeX (plain)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>luatex</term>
|
|
|
|
<term>luatex</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LaTeX (LuaTeX)</para>
|
|
|
|
<para>LaTeX (LuaTeX)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>dviluatex</term>
|
|
|
|
<term>dviluatex</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LaTeX (dviluatex)</para>
|
|
|
|
<para>LaTeX (dviluatex)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>pdflatex</term>
|
|
|
|
<term>pdflatex</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LaTeX (pdflatex)</para>
|
|
|
|
<para>LaTeX (pdflatex)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>platex</term>
|
|
|
|
<term>platex</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LaTeX (pLaTeX)</para>
|
|
|
|
<para>LaTeX (pLaTeX)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>xetex</term>
|
|
|
|
<term>xetex</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> LaTeX (XeTeX) </para>
|
|
|
|
<para>LaTeX (XeTeX) </para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>eps3</term>
|
|
|
|
<term>eps3</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> EPS (encapsulated Postscript) (cropped)</para>
|
|
|
|
<para>EPS (encapsulated Postscript) (cropped)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>ps</term>
|
|
|
|
<term>ps</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> DVI -> Postscript (dvips)</para>
|
|
|
|
<para>DVI -> Postscript (dvips)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>odf</term>
|
|
|
|
<term>odf</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> </para>
|
|
|
|
<para />
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>text</term>
|
|
|
|
<term>text</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> (nor text2, ..., text4)</para>
|
|
|
|
<para>(nor text2, ..., text4)</para>
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>textparagraph</term>
|
|
|
|
<term>textparagraph</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> </para>
|
|
|
|
<para />
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>word</term>
|
|
|
|
<term>word</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> </para>
|
|
|
|
<para />
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>word2</term>
|
|
|
|
<term>word2</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> </para>
|
|
|
|
<para />
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<varlistentry>
|
|
|
|
<term>wordhtml</term>
|
|
|
|
<term>wordhtml</term>
|
|
|
|
<listitem>
|
|
|
|
<listitem>
|
|
|
|
<para> </para>
|
|
|
|
<para />
|
|
|
|
</listitem>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</variablelist>
|
|
|
@ -269,5 +269,4 @@
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
|
|
</article>
|
|
|
|
</article>
|