autotests/export/docbook/Development.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- This DocBook file was created by LyX 2.4.0dev
   3   See http://www.lyx.org/ for more information -->
   4 <article xml:lang="en_US" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:m="http://www.w3.org/1998/Math/MathML" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.2">
   5 <title>Developing LyX</title>
   6 <subtitle>Version 2.3.x</subtitle>
   7 <section>
   8 <title>File formats</title>
   9 <section xml:id="sec.When-is-an-0">
  10 <title>When is an update of the .lyx file format number needed?</title>
  11 <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>
  12 <blockquote>
  13 <para>Whenever there is the danger that a previous version of LyX cannot open a file using the new feature, a file format update is needed.</para>
  14 </blockquote>
  15 <para>The file format change allows lyx2lyx rules to implement backwards compatibility. Below you can find a list of reasons for file format updates with explanations:</para>
  16 <variablelist>
  17 <varlistentry>
  18 <term>New&#xA0;document&#xA0;setting</term>
  19
  20 <listitem>
  21 <para> Whenever you introduce a new setting that is stored in the document header, a file format update is needed.</para>
  22 </listitem>
  23 </varlistentry>
  24 <varlistentry>
  25 <term>Removed&#xA0;document&#xA0;setting</term>
  26
  27 <listitem>
  28 <para> If a certain setting becomes obsolete and gets removed, a file format update is needed.</para>
  29 </listitem>
  30 </varlistentry>
  31 <varlistentry>
  32 <term>New&#xA0;valid&#xA0;value&#xA0;for&#xA0;an&#xA0;existing&#xA0;setting,</term>
  33
  34 <listitem>
  35 <para> e.&#x2009;g.</para>
  36 <variablelist>
  37 <varlistentry>
  38 <term>Automatically&#xA0;loaded&#xA0;math&#xA0;package</term>
  39
  40 <listitem>
  41 <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>
  42 </listitem>
  43 </varlistentry>
  44 <varlistentry>
  45 <term>New&#xA0;language</term>
  46
  47 <listitem>
  48 <para> that is stored in \language. </para>
  49 </listitem>
  50 </varlistentry>
  51 </variablelist>
  52 </listitem>
  53 <varlistentry>
  54 <term>New&#xA0;inset</term>
  55
  56 <listitem>
  57 <para> Of course a new inset requires a file format update.</para>
  58 </listitem>
  59 </varlistentry>
  60 <varlistentry>
  61 <term>New&#xA0;style</term>
  62
  63 <listitem>
  64 <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>
  65 </listitem>
  66 </varlistentry>
  67 <varlistentry>
  68 <term>Removed&#xA0;style</term>
  69
  70 <listitem>
  71 <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>
  72 </listitem>
  73 </varlistentry>
  74 <!-- Output Error: Closing tag `variablelist' when other tags are open, namely: -->
  75 <!-- Output Error: varlistentry -->
  76 </varlistentry></variablelist>
  77 <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>
  78 <para>If you are still unsure, please ask on the development list.</para>
  79 <section xml:id="par.export-test-output-formats-1">
  80 <title>Output formats</title>
  81 <para>The following output formats are currently tested for each sample document:</para>
  82 <variablelist>
  83 <varlistentry>
  84 <term>LyX:</term>
  85
  86 <listitem>
  87
  88 <variablelist>
  89 <varlistentry>
  90 <term>lyx16</term>
  91
  92 <listitem>
  93 <para> LyX 1.6 file format (lyx2lyx)</para>
  94 </listitem>
  95 </varlistentry>
  96 <varlistentry>
  97 <term>lyx21</term>
  98
  99 <listitem>
 100 <para> LyX 2.1 file format (lyx2lyx)</para>
 101 </listitem>
 102 </varlistentry>
 103 <varlistentry>
 104 <term>xhtml</term>
 105
 106 <listitem>
 107 <para> LyXHTML (native LyX HTML export)</para>
 108 </listitem>
 109 </varlistentry>
 110 </variablelist>
 111 </listitem>
 112 <varlistentry>
 113 <term>LyX&#xA0;+&#xA0;LaTeX:</term>
 114
 115 <listitem>
 116
 117 <variablelist>
 118 <varlistentry>
 119 <term>dvi</term>
 120
 121 <listitem>
 122 <para> DVI (8-bit latex)</para>
 123 </listitem>
 124 </varlistentry>
 125 <varlistentry>
 126 <term>dvi3_texF</term>
 127
 128 <listitem>
 129 <para> DVI (LuaTeX with 8-bit TeX fonts)</para>
 130 </listitem>
 131 </varlistentry>
 132 <varlistentry>
 133 <term>dvi3_systemF</term>
 134
 135 <listitem>
 136 <para> DVI (LuaTeX with Unicode fonts)</para>
 137 </listitem>
 138 </varlistentry>
 139 <varlistentry>
 140 <term>pdf2</term>
 141
 142 <listitem>
 143 <para> PDF (pdflatex)</para>
 144 </listitem>
 145 </varlistentry>
 146 <varlistentry>
 147 <term>pdf4_texF</term>
 148
 149 <listitem>
 150 <para> PDF (XeTeX with 8-bit TeX fonts)</para>
 151 </listitem>
 152 </varlistentry>
 153 <varlistentry>
 154 <term>pdf4_systemF</term>
 155
 156 <listitem>
 157 <para> PDF (XeTeX with Unicode fonts)</para>
 158 </listitem>
 159 </varlistentry>
 160 <varlistentry>
 161 <term>pdf5_texF</term>
 162
 163 <listitem>
 164 <para> PDF (LuaTeX with 8-bit TeX fonts)</para>
 165 </listitem>
 166 </varlistentry>
 167 <varlistentry>
 168 <term>pdf5_systemF</term>
 169
 170 <listitem>
 171 <para> PDF (LuaTeX with Unicode fonts)</para>
 172 </listitem>
 173 </varlistentry>
 174 </variablelist>
 175 </listitem>
 176 <varlistentry>
 177 <term>LyX&#xA0;+&#xA0;LaTeX&#xA0;+&#xA0;postprocessing:</term>
 178
 179 <listitem>
 180
 181 <variablelist>
 182 <varlistentry>
 183 <term>pdf</term>
 184
 185 <listitem>
 186 <para> DVI -&gt; PS (dvips) -&gt; PDF (ps2pdf)</para>
 187 </listitem>
 188 </varlistentry>
 189 <varlistentry>
 190 <term>pdf3</term>
 191
 192 <listitem>
 193 <para> DVI -&gt; PDF (dvipdfm)</para>
 194 </listitem>
 195 </varlistentry>
 196 </variablelist>
 197 </listitem>
 198 <varlistentry>
 199 <term>not&#xA0;tested:</term>
 200
 201 <listitem>
 202 <para> (or only if set as default output format in the document source)</para>
 203 <variablelist>
 204 <varlistentry>
 205 <term>latex</term>
 206
 207 <listitem>
 208 <para> LaTeX (plain)</para>
 209 </listitem>
 210 </varlistentry>
 211 <varlistentry>
 212 <term>luatex</term>
 213
 214 <listitem>
 215 <para> LaTeX (LuaTeX)</para>
 216 </listitem>
 217 </varlistentry>
 218 <varlistentry>
 219 <term>dviluatex</term>
 220
 221 <listitem>
 222 <para> LaTeX (dviluatex)</para>
 223 </listitem>
 224 </varlistentry>
 225 <varlistentry>
 226 <term>pdflatex</term>
 227
 228 <listitem>
 229 <para> LaTeX (pdflatex)</para>
 230 </listitem>
 231 </varlistentry>
 232 <varlistentry>
 233 <term>platex</term>
 234
 235 <listitem>
 236 <para> LaTeX (pLaTeX)</para>
 237 </listitem>
 238 </varlistentry>
 239 <varlistentry>
 240 <term>xetex</term>
 241
 242 <listitem>
 243 <para> LaTeX (XeTeX) </para>
 244 </listitem>
 245 </varlistentry>
 246 <varlistentry>
 247 <term>eps3</term>
 248
 249 <listitem>
 250 <para> EPS (encapsulated Postscript) (cropped)</para>
 251 </listitem>
 252 </varlistentry>
 253 <varlistentry>
 254 <term>ps</term>
 255
 256 <listitem>
 257 <para> DVI -&gt; Postscript (dvips)</para>
 258 </listitem>
 259 </varlistentry>
 260 <varlistentry>
 261 <term>odf</term>
 262
 263 <listitem>
 264
 265 </listitem>
 266 </varlistentry>
 267 <varlistentry>
 268 <term>text</term>
 269
 270 <listitem>
 271 <para> (nor text2, ..., text4)</para>
 272 </listitem>
 273 </varlistentry>
 274 <varlistentry>
 275 <term>textparagraph</term>
 276
 277 <listitem>
 278
 279 </listitem>
 280 </varlistentry>
 281 <varlistentry>
 282 <term>word</term>
 283
 284 <listitem>
 285
 286 </listitem>
 287 </varlistentry>
 288 <varlistentry>
 289 <term>word2</term>
 290
 291 <listitem>
 292
 293 </listitem>
 294 </varlistentry>
 295 <varlistentry>
 296 <term>wordhtml</term>
 297
 298 <listitem>
 299
 300 </listitem>
 301 </varlistentry>
 302 </variablelist>
 303 </listitem>
 304 <!-- Output Error: Closing tag `variablelist' when other tags are open, namely: -->
 305 <!-- Output Error: varlistentry -->
 306 </varlistentry><!-- Output Error: varlistentry -->
 307 </varlistentry><!-- Output Error: varlistentry -->
 308 </varlistentry><!-- Output Error: varlistentry -->
 309 </varlistentry></variablelist>
 310 </section>
 311 </section>
 312 </section>
 313
 314 </article>