]> git.lyx.org Git - features.git/blob - src/BufferParams.cpp
Fix CJK preamble.
[features.git] / src / BufferParams.cpp
1 /**
2  * \file BufferParams.cpp
3  * This file is part of LyX, the document processor.
4  * Licence details can be found in the file COPYING.
5  *
6  * \author Alfredo Braunstein
7  * \author Lars Gullik Bjønnes
8  * \author Jean-Marc Lasgouttes
9  * \author John Levon
10  * \author André Pönitz
11  * \author Martin Vermeer
12  *
13  * Full author contact details are available in file CREDITS.
14  */
15
16 #include <config.h>
17
18 #include "BufferParams.h"
19
20 #include "Author.h"
21 #include "LayoutFile.h"
22 #include "BranchList.h"
23 #include "Buffer.h"
24 #include "buffer_funcs.h"
25 #include "Bullet.h"
26 #include "CiteEnginesList.h"
27 #include "Color.h"
28 #include "ColorSet.h"
29 #include "Converter.h"
30 #include "Encoding.h"
31 #include "IndicesList.h"
32 #include "Language.h"
33 #include "LaTeXFeatures.h"
34 #include "LaTeXFonts.h"
35 #include "Length.h"
36 #include "ModuleList.h"
37 #include "Font.h"
38 #include "Lexer.h"
39 #include "LyXRC.h"
40 #include "OutputParams.h"
41 #include "Spacing.h"
42 #include "texstream.h"
43 #include "TexRow.h"
44 #include "VSpace.h"
45 #include "PDFOptions.h"
46
47 #include "frontends/alert.h"
48
49 #include "insets/InsetListingsParams.h"
50
51 #include "support/convert.h"
52 #include "support/debug.h"
53 #include "support/docstream.h"
54 #include "support/FileName.h"
55 #include "support/filetools.h"
56 #include "support/gettext.h"
57 #include "support/Messages.h"
58 #include "support/mutex.h"
59 #include "support/Package.h"
60 #include "support/Translator.h"
61 #include "support/lstrings.h"
62
63 #include <algorithm>
64 #include <sstream>
65
66 using namespace std;
67 using namespace lyx::support;
68
69
70 static char const * const string_paragraph_separation[] = {
71         "indent", "skip", ""
72 };
73
74
75 static char const * const string_quotes_style[] = {
76         "english", "swedish", "german", "polish", "swiss", "danish", "plain",
77         "british", "swedishg", "french", "frenchin", "russian", "cjk", "cjkangle", ""
78 };
79
80
81 static char const * const string_papersize[] = {
82         "default", "custom", "letterpaper", "legalpaper", "executivepaper",
83         "a0paper", "a1paper", "a2paper", "a3paper",     "a4paper", "a5paper",
84         "a6paper", "b0paper", "b1paper", "b2paper","b3paper", "b4paper",
85         "b5paper", "b6paper", "c0paper", "c1paper", "c2paper", "c3paper",
86         "c4paper", "c5paper", "c6paper", "b0j", "b1j", "b2j", "b3j", "b4j", "b5j",
87         "b6j", ""
88 };
89
90
91 static char const * const string_orientation[] = {
92         "portrait", "landscape", ""
93 };
94
95
96 static char const * const tex_graphics[] = {
97         "default", "dvialw", "dvilaser", "dvipdf", "dvipdfm", "dvipdfmx",
98         "dvips", "dvipsone", "dvitops", "dviwin", "dviwindo", "dvi2ps", "emtex",
99         "ln", "oztex", "pctexhp", "pctexps", "pctexwin", "pctex32", "pdftex",
100         "psprint", "pubps", "tcidvi", "textures", "truetex", "vtex", "xdvi",
101         "xetex", "none", ""
102 };
103
104
105
106 namespace lyx {
107
108 // Local translators
109 namespace {
110
111 // Paragraph separation
112 typedef Translator<string, BufferParams::ParagraphSeparation> ParSepTranslator;
113
114
115 ParSepTranslator const init_parseptranslator()
116 {
117         ParSepTranslator translator
118                 (string_paragraph_separation[0], BufferParams::ParagraphIndentSeparation);
119         translator.addPair(string_paragraph_separation[1], BufferParams::ParagraphSkipSeparation);
120         return translator;
121 }
122
123
124 ParSepTranslator const & parseptranslator()
125 {
126         static ParSepTranslator const translator =
127                 init_parseptranslator();
128         return translator;
129 }
130
131
132 // Quotes style
133 typedef Translator<string, InsetQuotesParams::QuoteStyle> QuotesStyleTranslator;
134
135
136 QuotesStyleTranslator const init_quotesstyletranslator()
137 {
138         QuotesStyleTranslator translator
139                 (string_quotes_style[0], InsetQuotesParams::EnglishQuotes);
140         translator.addPair(string_quotes_style[1], InsetQuotesParams::SwedishQuotes);
141         translator.addPair(string_quotes_style[2], InsetQuotesParams::GermanQuotes);
142         translator.addPair(string_quotes_style[3], InsetQuotesParams::PolishQuotes);
143         translator.addPair(string_quotes_style[4], InsetQuotesParams::SwissQuotes);
144         translator.addPair(string_quotes_style[5], InsetQuotesParams::DanishQuotes);
145         translator.addPair(string_quotes_style[6], InsetQuotesParams::PlainQuotes);
146         translator.addPair(string_quotes_style[7], InsetQuotesParams::BritishQuotes);
147         translator.addPair(string_quotes_style[8], InsetQuotesParams::SwedishGQuotes);
148         translator.addPair(string_quotes_style[9], InsetQuotesParams::FrenchQuotes);
149         translator.addPair(string_quotes_style[10], InsetQuotesParams::FrenchINQuotes);
150         translator.addPair(string_quotes_style[11], InsetQuotesParams::RussianQuotes);
151         translator.addPair(string_quotes_style[12], InsetQuotesParams::CJKQuotes);
152         translator.addPair(string_quotes_style[13], InsetQuotesParams::CJKAngleQuotes);
153         return translator;
154 }
155
156
157 QuotesStyleTranslator const & quotesstyletranslator()
158 {
159         static QuotesStyleTranslator const translator =
160                 init_quotesstyletranslator();
161         return translator;
162 }
163
164
165 // Paper size
166 typedef Translator<string, PAPER_SIZE> PaperSizeTranslator;
167
168
169 static PaperSizeTranslator initPaperSizeTranslator()
170 {
171         PaperSizeTranslator translator(string_papersize[0], PAPER_DEFAULT);
172         translator.addPair(string_papersize[1], PAPER_CUSTOM);
173         translator.addPair(string_papersize[2], PAPER_USLETTER);
174         translator.addPair(string_papersize[3], PAPER_USLEGAL);
175         translator.addPair(string_papersize[4], PAPER_USEXECUTIVE);
176         translator.addPair(string_papersize[5], PAPER_A0);
177         translator.addPair(string_papersize[6], PAPER_A1);
178         translator.addPair(string_papersize[7], PAPER_A2);
179         translator.addPair(string_papersize[8], PAPER_A3);
180         translator.addPair(string_papersize[9], PAPER_A4);
181         translator.addPair(string_papersize[10], PAPER_A5);
182         translator.addPair(string_papersize[11], PAPER_A6);
183         translator.addPair(string_papersize[12], PAPER_B0);
184         translator.addPair(string_papersize[13], PAPER_B1);
185         translator.addPair(string_papersize[14], PAPER_B2);
186         translator.addPair(string_papersize[15], PAPER_B3);
187         translator.addPair(string_papersize[16], PAPER_B4);
188         translator.addPair(string_papersize[17], PAPER_B5);
189         translator.addPair(string_papersize[18], PAPER_B6);
190         translator.addPair(string_papersize[19], PAPER_C0);
191         translator.addPair(string_papersize[20], PAPER_C1);
192         translator.addPair(string_papersize[21], PAPER_C2);
193         translator.addPair(string_papersize[22], PAPER_C3);
194         translator.addPair(string_papersize[23], PAPER_C4);
195         translator.addPair(string_papersize[24], PAPER_C5);
196         translator.addPair(string_papersize[25], PAPER_C6);
197         translator.addPair(string_papersize[26], PAPER_JISB0);
198         translator.addPair(string_papersize[27], PAPER_JISB1);
199         translator.addPair(string_papersize[28], PAPER_JISB2);
200         translator.addPair(string_papersize[29], PAPER_JISB3);
201         translator.addPair(string_papersize[30], PAPER_JISB4);
202         translator.addPair(string_papersize[31], PAPER_JISB5);
203         translator.addPair(string_papersize[32], PAPER_JISB6);
204         return translator;
205 }
206
207
208 PaperSizeTranslator const & papersizetranslator()
209 {
210         static PaperSizeTranslator const translator =
211                 initPaperSizeTranslator();
212         return translator;
213 }
214
215
216 // Paper orientation
217 typedef Translator<string, PAPER_ORIENTATION> PaperOrientationTranslator;
218
219
220 PaperOrientationTranslator const init_paperorientationtranslator()
221 {
222         PaperOrientationTranslator translator(string_orientation[0], ORIENTATION_PORTRAIT);
223         translator.addPair(string_orientation[1], ORIENTATION_LANDSCAPE);
224         return translator;
225 }
226
227
228 PaperOrientationTranslator const & paperorientationtranslator()
229 {
230         static PaperOrientationTranslator const translator =
231             init_paperorientationtranslator();
232         return translator;
233 }
234
235
236 // Page sides
237 typedef Translator<int, PageSides> SidesTranslator;
238
239
240 SidesTranslator const init_sidestranslator()
241 {
242         SidesTranslator translator(1, OneSide);
243         translator.addPair(2, TwoSides);
244         return translator;
245 }
246
247
248 SidesTranslator const & sidestranslator()
249 {
250         static SidesTranslator const translator = init_sidestranslator();
251         return translator;
252 }
253
254
255 // LaTeX packages
256 typedef Translator<int, BufferParams::Package> PackageTranslator;
257
258
259 PackageTranslator const init_packagetranslator()
260 {
261         PackageTranslator translator(0, BufferParams::package_off);
262         translator.addPair(1, BufferParams::package_auto);
263         translator.addPair(2, BufferParams::package_on);
264         return translator;
265 }
266
267
268 PackageTranslator const & packagetranslator()
269 {
270         static PackageTranslator const translator =
271                 init_packagetranslator();
272         return translator;
273 }
274
275
276 // Spacing
277 typedef Translator<string, Spacing::Space> SpaceTranslator;
278
279
280 SpaceTranslator const init_spacetranslator()
281 {
282         SpaceTranslator translator("default", Spacing::Default);
283         translator.addPair("single", Spacing::Single);
284         translator.addPair("onehalf", Spacing::Onehalf);
285         translator.addPair("double", Spacing::Double);
286         translator.addPair("other", Spacing::Other);
287         return translator;
288 }
289
290
291 SpaceTranslator const & spacetranslator()
292 {
293         static SpaceTranslator const translator = init_spacetranslator();
294         return translator;
295 }
296
297
298 bool inSystemDir(FileName const & document_dir, string & system_dir)
299 {
300         // A document is assumed to be in a system LyX directory (not
301         // necessarily the system directory of the running instance)
302         // if both "configure.py" and "chkconfig.ltx" are found in
303         // either document_dir/../ or document_dir/../../.
304         // If true, the system directory path is returned in system_dir
305         // with a trailing path separator.
306
307         string const msg = "Checking whether document is in a system dir...";
308
309         string dir = document_dir.absFileName();
310
311         for (int i = 0; i < 2; ++i) {
312                 dir = addPath(dir, "..");
313                 if (!fileSearch(dir, "configure.py").empty() &&
314                     !fileSearch(dir, "chkconfig.ltx").empty()) {
315                         LYXERR(Debug::FILES, msg << " yes");
316                         system_dir = addPath(FileName(dir).realPath(), "");
317                         return true;
318                 }
319         }
320
321         LYXERR(Debug::FILES, msg << " no");
322         system_dir = string();
323         return false;
324 }
325
326 } // namespace
327
328
329 class BufferParams::Impl
330 {
331 public:
332         Impl();
333
334         AuthorList authorlist;
335         BranchList branchlist;
336         Bullet temp_bullets[4];
337         Bullet user_defined_bullets[4];
338         IndicesList indiceslist;
339         Spacing spacing;
340         Length parindent;
341         Length mathindent;
342         /** This is the amount of space used for paragraph_separation "skip",
343          * and for detached paragraphs in "indented" documents.
344          */
345         VSpace defskip;
346         PDFOptions pdfoptions;
347         LayoutFileIndex baseClass_;
348         FormatList exportableFormatList;
349         FormatList viewableFormatList;
350         bool isViewCacheValid;
351         bool isExportCacheValid;
352 };
353
354
355 BufferParams::Impl::Impl()
356         : defskip(VSpace::MEDSKIP), baseClass_(string("")),
357           isViewCacheValid(false), isExportCacheValid(false)
358 {
359         // set initial author
360         // FIXME UNICODE
361         authorlist.record(Author(from_utf8(lyxrc.user_name), from_utf8(lyxrc.user_email)));
362 }
363
364
365 BufferParams::Impl *
366 BufferParams::MemoryTraits::clone(BufferParams::Impl const * ptr)
367 {
368         LBUFERR(ptr);
369         return new BufferParams::Impl(*ptr);
370 }
371
372
373 void BufferParams::MemoryTraits::destroy(BufferParams::Impl * ptr)
374 {
375         delete ptr;
376 }
377
378
379 BufferParams::BufferParams()
380         : pimpl_(new Impl)
381 {
382         setBaseClass(defaultBaseclass());
383         cite_engine_ = "basic";
384         cite_engine_type_ = ENGINE_TYPE_DEFAULT;
385         makeDocumentClass();
386         paragraph_separation = ParagraphIndentSeparation;
387         is_math_indent = false;
388         math_numbering_side = DEFAULT;
389         quotes_style = InsetQuotesParams::EnglishQuotes;
390         dynamic_quotes = false;
391         fontsize = "default";
392
393         /*  PaperLayout */
394         papersize = PAPER_DEFAULT;
395         orientation = ORIENTATION_PORTRAIT;
396         use_geometry = false;
397         biblio_style = string();
398         use_bibtopic = false;
399         multibib = string();
400         use_indices = false;
401         save_transient_properties = true;
402         track_changes = false;
403         output_changes = false;
404         use_default_options = true;
405         maintain_unincluded_children = false;
406         secnumdepth = 3;
407         tocdepth = 3;
408         language = default_language;
409         fontenc = "auto";
410         fonts_roman[0] = "default";
411         fonts_roman[1] = "default";
412         fonts_sans[0] = "default";
413         fonts_sans[1] = "default";
414         fonts_typewriter[0] = "default";
415         fonts_typewriter[1] = "default";
416         fonts_math[0] = "auto";
417         fonts_math[1] = "auto";
418         fonts_default_family = "default";
419         useNonTeXFonts = false;
420         use_microtype = false;
421         use_dash_ligatures = true;
422         fonts_expert_sc = false;
423         fonts_old_figures = false;
424         fonts_sans_scale[0] = 100;
425         fonts_sans_scale[1] = 100;
426         fonts_typewriter_scale[0] = 100;
427         fonts_typewriter_scale[1] = 100;
428         inputenc = "auto";
429         lang_package = "default";
430         graphics_driver = "default";
431         default_output_format = "default";
432         bibtex_command = "default";
433         index_command = "default";
434         sides = OneSide;
435         columns = 1;
436         listings_params = string();
437         pagestyle = "default";
438         suppress_date = false;
439         justification = true;
440         // no color is the default (white)
441         backgroundcolor = lyx::rgbFromHexName("#ffffff");
442         isbackgroundcolor = false;
443         // no color is the default (black)
444         fontcolor = lyx::rgbFromHexName("#000000");
445         isfontcolor = false;
446         // light gray is the default font color for greyed-out notes
447         notefontcolor = lyx::rgbFromHexName("#cccccc");
448         boxbgcolor = lyx::rgbFromHexName("#ff0000");
449         compressed = lyxrc.save_compressed;
450         for (int iter = 0; iter < 4; ++iter) {
451                 user_defined_bullet(iter) = ITEMIZE_DEFAULTS[iter];
452                 temp_bullet(iter) = ITEMIZE_DEFAULTS[iter];
453         }
454         // default index
455         indiceslist().addDefault(B_("Index"));
456         html_be_strict = false;
457         html_math_output = MathML;
458         html_math_img_scale = 1.0;
459         html_css_as_file = false;
460         display_pixel_ratio = 1.0;
461
462         shell_escape = false;
463         output_sync = false;
464         use_refstyle = true;
465         use_minted = false;
466
467         // map current author
468         author_map_[pimpl_->authorlist.get(0).bufferId()] = 0;
469 }
470
471
472 docstring BufferParams::B_(string const & l10n) const
473 {
474         LASSERT(language, return from_utf8(l10n));
475         return getMessages(language->code()).get(l10n);
476 }
477
478
479 BufferParams::Package BufferParams::use_package(std::string const & p) const
480 {
481         PackageMap::const_iterator it = use_packages.find(p);
482         if (it == use_packages.end())
483                 return package_auto;
484         return it->second;
485 }
486
487
488 void BufferParams::use_package(std::string const & p, BufferParams::Package u)
489 {
490         use_packages[p] = u;
491 }
492
493
494 map<string, string> const & BufferParams::auto_packages()
495 {
496         static map<string, string> packages;
497         if (packages.empty()) {
498                 // We could have a race condition here that two threads
499                 // discover an empty map at the same time and want to fill
500                 // it, but that is no problem, since the same contents is
501                 // filled in twice then. Having the locker inside the
502                 // packages.empty() condition has the advantage that we
503                 // don't need the mutex overhead for simple reading.
504                 static Mutex mutex;
505                 Mutex::Locker locker(&mutex);
506                 // adding a package here implies a file format change!
507                 packages["amsmath"] =
508                         N_("The LaTeX package amsmath is only used if AMS formula types or symbols from the AMS math toolbars are inserted into formulas");
509                 packages["amssymb"] =
510                         N_("The LaTeX package amssymb is only used if symbols from the AMS math toolbars are inserted into formulas");
511                 packages["cancel"] =
512                         N_("The LaTeX package cancel is only used if \\cancel commands are used in formulas");
513                 packages["esint"] =
514                         N_("The LaTeX package esint is only used if special integral symbols are inserted into formulas");
515                 packages["mathdots"] =
516                         N_("The LaTeX package mathdots is only used if the command \\iddots is inserted into formulas");
517                 packages["mathtools"] =
518                         N_("The LaTeX package mathtools is only used if some mathematical relations are inserted into formulas");
519                 packages["mhchem"] =
520                         N_("The LaTeX package mhchem is only used if either the command \\ce or \\cf is inserted into formulas");
521                 packages["stackrel"] =
522                         N_("The LaTeX package stackrel is only used if the command \\stackrel with subscript is inserted into formulas");
523                 packages["stmaryrd"] =
524                         N_("The LaTeX package stmaryrd is only used if symbols from the St Mary's Road symbol font for theoretical computer science are inserted into formulas");
525                 packages["undertilde"] =
526                         N_("The LaTeX package undertilde is only used if you use the math frame decoration 'utilde'");
527         }
528         return packages;
529 }
530
531
532 bool BufferParams::useBibtopic() const
533 {
534         if (useBiblatex())
535                 return false;
536         return (use_bibtopic || (!multibib.empty() && multibib != "child"));
537 }
538
539
540 AuthorList & BufferParams::authors()
541 {
542         return pimpl_->authorlist;
543 }
544
545
546 AuthorList const & BufferParams::authors() const
547 {
548         return pimpl_->authorlist;
549 }
550
551
552 void BufferParams::addAuthor(Author a)
553 {
554         author_map_[a.bufferId()] = pimpl_->authorlist.record(a);
555 }
556
557
558 BranchList & BufferParams::branchlist()
559 {
560         return pimpl_->branchlist;
561 }
562
563
564 BranchList const & BufferParams::branchlist() const
565 {
566         return pimpl_->branchlist;
567 }
568
569
570 IndicesList & BufferParams::indiceslist()
571 {
572         return pimpl_->indiceslist;
573 }
574
575
576 IndicesList const & BufferParams::indiceslist() const
577 {
578         return pimpl_->indiceslist;
579 }
580
581
582 Bullet & BufferParams::temp_bullet(lyx::size_type const index)
583 {
584         LASSERT(index < 4, return pimpl_->temp_bullets[0]);
585         return pimpl_->temp_bullets[index];
586 }
587
588
589 Bullet const & BufferParams::temp_bullet(lyx::size_type const index) const
590 {
591         LASSERT(index < 4, return pimpl_->temp_bullets[0]);
592         return pimpl_->temp_bullets[index];
593 }
594
595
596 Bullet & BufferParams::user_defined_bullet(lyx::size_type const index)
597 {
598         LASSERT(index < 4, return pimpl_->temp_bullets[0]);
599         return pimpl_->user_defined_bullets[index];
600 }
601
602
603 Bullet const & BufferParams::user_defined_bullet(lyx::size_type const index) const
604 {
605         LASSERT(index < 4, return pimpl_->temp_bullets[0]);
606         return pimpl_->user_defined_bullets[index];
607 }
608
609
610 Spacing & BufferParams::spacing()
611 {
612         return pimpl_->spacing;
613 }
614
615
616 Spacing const & BufferParams::spacing() const
617 {
618         return pimpl_->spacing;
619 }
620
621
622 PDFOptions & BufferParams::pdfoptions()
623 {
624         return pimpl_->pdfoptions;
625 }
626
627
628 PDFOptions const & BufferParams::pdfoptions() const
629 {
630         return pimpl_->pdfoptions;
631 }
632
633
634 Length const & BufferParams::getMathIndent() const
635 {
636         return pimpl_->mathindent;
637 }
638
639
640 void BufferParams::setMathIndent(Length const & indent)
641 {
642         pimpl_->mathindent = indent;
643 }
644
645
646 Length const & BufferParams::getParIndent() const
647 {
648         return pimpl_->parindent;
649 }
650
651
652 void BufferParams::setParIndent(Length const & indent)
653 {
654         pimpl_->parindent = indent;
655 }
656
657
658 VSpace const & BufferParams::getDefSkip() const
659 {
660         return pimpl_->defskip;
661 }
662
663
664 void BufferParams::setDefSkip(VSpace const & vs)
665 {
666         // DEFSKIP will cause an infinite loop
667         LASSERT(vs.kind() != VSpace::DEFSKIP, return);
668         pimpl_->defskip = vs;
669 }
670
671
672 BufferParams::MathNumber BufferParams::getMathNumber() const
673 {
674         if (math_numbering_side != DEFAULT)
675                 return math_numbering_side;
676         // FIXME: do not hardcode language here
677         else if (language->lang() == "arabic_arabi"
678                  || documentClass().provides("leqno"))
679                 return LEFT;
680         else
681                 return RIGHT;
682 }
683
684
685 string BufferParams::readToken(Lexer & lex, string const & token,
686         FileName const & filepath)
687 {
688         string result;
689
690         if (token == "\\textclass") {
691                 lex.next();
692                 string const classname = lex.getString();
693                 // if there exists a local layout file, ignore the system one
694                 // NOTE: in this case, the textclass (.cls file) is assumed to
695                 // be available.
696                 string tcp;
697                 LayoutFileList & bcl = LayoutFileList::get();
698                 if (!filepath.empty()) {
699                         // If classname is an absolute path, the document is
700                         // using a local layout file which could not be accessed
701                         // by a relative path. In this case the path is correct
702                         // even if the document was moved to a different
703                         // location. However, we will have a problem if the
704                         // document was generated on a different platform.
705                         bool isabsolute = FileName::isAbsolute(classname);
706                         string const classpath = onlyPath(classname);
707                         string const path = isabsolute ? classpath
708                                 : FileName(addPath(filepath.absFileName(),
709                                                 classpath)).realPath();
710                         string const oldpath = isabsolute ? string()
711                                 : FileName(addPath(origin, classpath)).realPath();
712                         tcp = bcl.addLocalLayout(onlyFileName(classname), path, oldpath);
713                 }
714                 // that returns non-empty if a "local" layout file is found.
715                 if (!tcp.empty()) {
716                         result = to_utf8(makeRelPath(from_utf8(onlyPath(tcp)),
717                                                 from_utf8(filepath.absFileName())));
718                         if (result.empty())
719                                 result = ".";
720                         setBaseClass(onlyFileName(tcp));
721                 } else
722                         setBaseClass(onlyFileName(classname));
723                 // We assume that a tex class exists for local or unknown
724                 // layouts so this warning, will only be given for system layouts.
725                 if (!baseClass()->isTeXClassAvailable()) {
726                         docstring const desc =
727                                 translateIfPossible(from_utf8(baseClass()->description()));
728                         docstring const prereqs =
729                                 from_utf8(baseClass()->prerequisites());
730                         docstring const msg =
731                                 bformat(_("The selected document class\n"
732                                                  "\t%1$s\n"
733                                                  "requires external files that are not available.\n"
734                                                  "The document class can still be used, but the\n"
735                                                  "document cannot be compiled until the following\n"
736                                                  "prerequisites are installed:\n"
737                                                  "\t%2$s\n"
738                                                  "See section 3.1.2.2 (Class Availability) of the\n"
739                                                  "User's Guide for more information."), desc, prereqs);
740                         frontend::Alert::warning(_("Document class not available"),
741                                        msg, true);
742                 }
743         } else if (token == "\\save_transient_properties") {
744                 lex >> save_transient_properties;
745         } else if (token == "\\origin") {
746                 lex.eatLine();
747                 origin = lex.getString();
748                 string const sysdirprefix = "/systemlyxdir/";
749                 if (prefixIs(origin, sysdirprefix)) {
750                         string docsys;
751                         if (inSystemDir(filepath, docsys))
752                                 origin.replace(0, sysdirprefix.length() - 1, docsys);
753                         else
754                                 origin.replace(0, sysdirprefix.length() - 1,
755                                         package().system_support().absFileName());
756                 }
757         } else if (token == "\\begin_preamble") {
758                 readPreamble(lex);
759         } else if (token == "\\begin_local_layout") {
760                 readLocalLayout(lex, false);
761         } else if (token == "\\begin_forced_local_layout") {
762                 readLocalLayout(lex, true);
763         } else if (token == "\\begin_modules") {
764                 readModules(lex);
765         } else if (token == "\\begin_removed_modules") {
766                 readRemovedModules(lex);
767         } else if (token == "\\begin_includeonly") {
768                 readIncludeonly(lex);
769         } else if (token == "\\maintain_unincluded_children") {
770                 lex >> maintain_unincluded_children;
771         } else if (token == "\\options") {
772                 lex.eatLine();
773                 options = lex.getString();
774         } else if (token == "\\use_default_options") {
775                 lex >> use_default_options;
776         } else if (token == "\\master") {
777                 lex.eatLine();
778                 master = lex.getString();
779                 if (!filepath.empty() && FileName::isAbsolute(origin)) {
780                         bool const isabs = FileName::isAbsolute(master);
781                         FileName const abspath(isabs ? master : origin + master);
782                         bool const moved = filepath != FileName(origin);
783                         if (moved && abspath.exists()) {
784                                 docstring const path = isabs
785                                         ? from_utf8(master)
786                                         : from_utf8(abspath.realPath());
787                                 docstring const refpath =
788                                         from_utf8(filepath.absFileName());
789                                 master = to_utf8(makeRelPath(path, refpath));
790                         }
791                 }
792         } else if (token == "\\suppress_date") {
793                 lex >> suppress_date;
794         } else if (token == "\\justification") {
795                 lex >> justification;
796         } else if (token == "\\language") {
797                 readLanguage(lex);
798         } else if (token == "\\language_package") {
799                 lex.eatLine();
800                 lang_package = lex.getString();
801         } else if (token == "\\inputencoding") {
802                 lex >> inputenc;
803         } else if (token == "\\graphics") {
804                 readGraphicsDriver(lex);
805         } else if (token == "\\default_output_format") {
806                 lex >> default_output_format;
807         } else if (token == "\\bibtex_command") {
808                 lex.eatLine();
809                 bibtex_command = lex.getString();
810         } else if (token == "\\index_command") {
811                 lex.eatLine();
812                 index_command = lex.getString();
813         } else if (token == "\\fontencoding") {
814                 lex.eatLine();
815                 fontenc = lex.getString();
816         } else if (token == "\\font_roman") {
817                 lex >> fonts_roman[0];
818                 lex >> fonts_roman[1];
819         } else if (token == "\\font_sans") {
820                 lex >> fonts_sans[0];
821                 lex >> fonts_sans[1];
822         } else if (token == "\\font_typewriter") {
823                 lex >> fonts_typewriter[0];
824                 lex >> fonts_typewriter[1];
825         } else if (token == "\\font_math") {
826                 lex >> fonts_math[0];
827                 lex >> fonts_math[1];
828         } else if (token == "\\font_default_family") {
829                 lex >> fonts_default_family;
830         } else if (token == "\\use_non_tex_fonts") {
831                 lex >> useNonTeXFonts;
832         } else if (token == "\\font_sc") {
833                 lex >> fonts_expert_sc;
834         } else if (token == "\\font_osf") {
835                 lex >> fonts_old_figures;
836         } else if (token == "\\font_sf_scale") {
837                 lex >> fonts_sans_scale[0];
838                 lex >> fonts_sans_scale[1];
839         } else if (token == "\\font_tt_scale") {
840                 lex >> fonts_typewriter_scale[0];
841                 lex >> fonts_typewriter_scale[1];
842         } else if (token == "\\font_cjk") {
843                 lex >> fonts_cjk;
844         } else if (token == "\\use_microtype") {
845                 lex >> use_microtype;
846         } else if (token == "\\use_dash_ligatures") {
847                 lex >> use_dash_ligatures;
848         } else if (token == "\\paragraph_separation") {
849                 string parsep;
850                 lex >> parsep;
851                 paragraph_separation = parseptranslator().find(parsep);
852         } else if (token == "\\paragraph_indentation") {
853                 lex.next();
854                 string parindent = lex.getString();
855                 if (parindent == "default")
856                         pimpl_->parindent = Length();
857                 else
858                         pimpl_->parindent = Length(parindent);
859         } else if (token == "\\defskip") {
860                 lex.next();
861                 string const defskip = lex.getString();
862                 pimpl_->defskip = VSpace(defskip);
863                 if (pimpl_->defskip.kind() == VSpace::DEFSKIP)
864                         // that is invalid
865                         pimpl_->defskip = VSpace(VSpace::MEDSKIP);
866         } else if (token == "\\is_math_indent") {
867                 lex >> is_math_indent;
868         } else if (token == "\\math_indentation") {
869                 lex.next();
870                 string mathindent = lex.getString();
871                 if (mathindent == "default")
872                         pimpl_->mathindent = Length();
873                 else
874                         pimpl_->mathindent = Length(mathindent);
875         } else if (token == "\\math_numbering_side") {
876                 string tmp;
877                 lex >> tmp;
878                 if (tmp == "left")
879                         math_numbering_side = LEFT;
880                 else if (tmp == "right")
881                         math_numbering_side = RIGHT;
882                 else
883                         math_numbering_side = DEFAULT;
884         } else if (token == "\\quotes_style") {
885                 string qstyle;
886                 lex >> qstyle;
887                 quotes_style = quotesstyletranslator().find(qstyle);
888         } else if (token == "\\dynamic_quotes") {
889                 lex >> dynamic_quotes;
890         } else if (token == "\\papersize") {
891                 string ppsize;
892                 lex >> ppsize;
893                 papersize = papersizetranslator().find(ppsize);
894         } else if (token == "\\use_geometry") {
895                 lex >> use_geometry;
896         } else if (token == "\\use_package") {
897                 string package;
898                 int use;
899                 lex >> package;
900                 lex >> use;
901                 use_package(package, packagetranslator().find(use));
902         } else if (token == "\\cite_engine") {
903                 lex.eatLine();
904                 cite_engine_ = lex.getString();
905         } else if (token == "\\cite_engine_type") {
906                 string engine_type;
907                 lex >> engine_type;
908                 cite_engine_type_ = theCiteEnginesList.getType(engine_type);
909         } else if (token == "\\biblio_style") {
910                 lex.eatLine();
911                 biblio_style = lex.getString();
912         } else if (token == "\\biblio_options") {
913                 lex.eatLine();
914                 biblio_opts = trim(lex.getString());
915         } else if (token == "\\biblatex_bibstyle") {
916                 lex.eatLine();
917                 biblatex_bibstyle = trim(lex.getString());
918         } else if (token == "\\biblatex_citestyle") {
919                 lex.eatLine();
920                 biblatex_citestyle = trim(lex.getString());
921         } else if (token == "\\use_bibtopic") {
922                 lex >> use_bibtopic;
923         } else if (token == "\\multibib") {
924                 lex >> multibib;
925         } else if (token == "\\use_indices") {
926                 lex >> use_indices;
927         } else if (token == "\\tracking_changes") {
928                 lex >> track_changes;
929         } else if (token == "\\output_changes") {
930                 lex >> output_changes;
931         } else if (token == "\\branch") {
932                 lex.eatLine();
933                 docstring branch = lex.getDocString();
934                 branchlist().add(branch);
935                 while (true) {
936                         lex.next();
937                         string const tok = lex.getString();
938                         if (tok == "\\end_branch")
939                                 break;
940                         Branch * branch_ptr = branchlist().find(branch);
941                         if (tok == "\\selected") {
942                                 lex.next();
943                                 if (branch_ptr)
944                                         branch_ptr->setSelected(lex.getInteger());
945                         }
946                         if (tok == "\\filename_suffix") {
947                                 lex.next();
948                                 if (branch_ptr)
949                                         branch_ptr->setFileNameSuffix(lex.getInteger());
950                         }
951                         if (tok == "\\color") {
952                                 lex.eatLine();
953                                 string color = lex.getString();
954                                 if (branch_ptr)
955                                         branch_ptr->setColor(color);
956                                 // Update also the Color table:
957                                 if (color == "none")
958                                         color = lcolor.getX11Name(Color_background);
959                                 // FIXME UNICODE
960                                 lcolor.setColor(to_utf8(branch), color);
961                         }
962                 }
963         } else if (token == "\\index") {
964                 lex.eatLine();
965                 docstring index = lex.getDocString();
966                 docstring shortcut;
967                 indiceslist().add(index);
968                 while (true) {
969                         lex.next();
970                         string const tok = lex.getString();
971                         if (tok == "\\end_index")
972                                 break;
973                         Index * index_ptr = indiceslist().find(index);
974                         if (tok == "\\shortcut") {
975                                 lex.next();
976                                 shortcut = lex.getDocString();
977                                 if (index_ptr)
978                                         index_ptr->setShortcut(shortcut);
979                         }
980                         if (tok == "\\color") {
981                                 lex.eatLine();
982                                 string color = lex.getString();
983                                 if (index_ptr)
984                                         index_ptr->setColor(color);
985                                 // Update also the Color table:
986                                 if (color == "none")
987                                         color = lcolor.getX11Name(Color_background);
988                                 // FIXME UNICODE
989                                 if (!shortcut.empty())
990                                         lcolor.setColor(to_utf8(shortcut), color);
991                         }
992                 }
993         } else if (token == "\\author") {
994                 lex.eatLine();
995                 istringstream ss(lex.getString());
996                 Author a;
997                 ss >> a;
998                 addAuthor(a);
999         } else if (token == "\\paperorientation") {
1000                 string orient;
1001                 lex >> orient;
1002                 orientation = paperorientationtranslator().find(orient);
1003         } else if (token == "\\backgroundcolor") {
1004                 lex.eatLine();
1005                 backgroundcolor = lyx::rgbFromHexName(lex.getString());
1006                 isbackgroundcolor = true;
1007         } else if (token == "\\fontcolor") {
1008                 lex.eatLine();
1009                 fontcolor = lyx::rgbFromHexName(lex.getString());
1010                 isfontcolor = true;
1011         } else if (token == "\\notefontcolor") {
1012                 lex.eatLine();
1013                 string color = lex.getString();
1014                 notefontcolor = lyx::rgbFromHexName(color);
1015                 lcolor.setColor("notefontcolor", color);
1016         } else if (token == "\\boxbgcolor") {
1017                 lex.eatLine();
1018                 string color = lex.getString();
1019                 boxbgcolor = lyx::rgbFromHexName(color);
1020                 lcolor.setColor("boxbgcolor", color);
1021         } else if (token == "\\paperwidth") {
1022                 lex >> paperwidth;
1023         } else if (token == "\\paperheight") {
1024                 lex >> paperheight;
1025         } else if (token == "\\leftmargin") {
1026                 lex >> leftmargin;
1027         } else if (token == "\\topmargin") {
1028                 lex >> topmargin;
1029         } else if (token == "\\rightmargin") {
1030                 lex >> rightmargin;
1031         } else if (token == "\\bottommargin") {
1032                 lex >> bottommargin;
1033         } else if (token == "\\headheight") {
1034                 lex >> headheight;
1035         } else if (token == "\\headsep") {
1036                 lex >> headsep;
1037         } else if (token == "\\footskip") {
1038                 lex >> footskip;
1039         } else if (token == "\\columnsep") {
1040                 lex >> columnsep;
1041         } else if (token == "\\paperfontsize") {
1042                 lex >> fontsize;
1043         } else if (token == "\\papercolumns") {
1044                 lex >> columns;
1045         } else if (token == "\\listings_params") {
1046                 string par;
1047                 lex >> par;
1048                 listings_params = InsetListingsParams(par).params();
1049         } else if (token == "\\papersides") {
1050                 int psides;
1051                 lex >> psides;
1052                 sides = sidestranslator().find(psides);
1053         } else if (token == "\\paperpagestyle") {
1054                 lex >> pagestyle;
1055         } else if (token == "\\bullet") {
1056                 readBullets(lex);
1057         } else if (token == "\\bulletLaTeX") {
1058                 readBulletsLaTeX(lex);
1059         } else if (token == "\\secnumdepth") {
1060                 lex >> secnumdepth;
1061         } else if (token == "\\tocdepth") {
1062                 lex >> tocdepth;
1063         } else if (token == "\\spacing") {
1064                 string nspacing;
1065                 lex >> nspacing;
1066                 string tmp_val;
1067                 if (nspacing == "other") {
1068                         lex >> tmp_val;
1069                 }
1070                 spacing().set(spacetranslator().find(nspacing), tmp_val);
1071         } else if (token == "\\float_placement") {
1072                 lex >> float_placement;
1073         } else if (token == "\\float_alignment") {
1074                 lex >> float_alignment;
1075
1076         } else if (prefixIs(token, "\\pdf_") || token == "\\use_hyperref") {
1077                 string toktmp = pdfoptions().readToken(lex, token);
1078                 if (!toktmp.empty()) {
1079                         lyxerr << "PDFOptions::readToken(): Unknown token: " <<
1080                                 toktmp << endl;
1081                         return toktmp;
1082                 }
1083         } else if (token == "\\html_math_output") {
1084                 int temp;
1085                 lex >> temp;
1086                 html_math_output = static_cast<MathOutput>(temp);
1087         } else if (token == "\\html_be_strict") {
1088                 lex >> html_be_strict;
1089         } else if (token == "\\html_css_as_file") {
1090                 lex >> html_css_as_file;
1091         } else if (token == "\\html_math_img_scale") {
1092                 lex >> html_math_img_scale;
1093         } else if (token == "\\html_latex_start") {
1094                 lex.eatLine();
1095                 html_latex_start = lex.getString();
1096         } else if (token == "\\html_latex_end") {
1097                 lex.eatLine();
1098                 html_latex_end = lex.getString();
1099         } else if (token == "\\output_sync") {
1100                 lex >> output_sync;
1101         } else if (token == "\\output_sync_macro") {
1102                 lex >> output_sync_macro;
1103         } else if (token == "\\use_refstyle") {
1104                 lex >> use_refstyle;
1105         } else if (token == "\\use_minted") {
1106                 lex >> use_minted;
1107         } else {
1108                 lyxerr << "BufferParams::readToken(): Unknown token: " <<
1109                         token << endl;
1110                 return token;
1111         }
1112
1113         return result;
1114 }
1115
1116
1117 namespace {
1118         // Quote argument if it contains spaces
1119         string quoteIfNeeded(string const & str) {
1120                 if (contains(str, ' '))
1121                         return "\"" + str + "\"";
1122                 return str;
1123         }
1124 } // namespace
1125
1126
1127 void BufferParams::writeFile(ostream & os, Buffer const * buf) const
1128 {
1129         // The top of the file is written by the buffer.
1130         // Prints out the buffer info into the .lyx file given by file
1131
1132         os << "\\save_transient_properties "
1133            << convert<string>(save_transient_properties) << '\n';
1134
1135         // the document directory (must end with a path separator)
1136         // realPath() is used to resolve symlinks, while addPath(..., "")
1137         // ensures a trailing path separator.
1138         string docsys;
1139         string filepath = addPath(buf->fileName().onlyPath().realPath(), "");
1140         string const sysdir = inSystemDir(FileName(filepath), docsys) ? docsys
1141                         : addPath(package().system_support().realPath(), "");
1142         string const relpath =
1143                 to_utf8(makeRelPath(from_utf8(filepath), from_utf8(sysdir)));
1144         if (!prefixIs(relpath, "../") && !FileName::isAbsolute(relpath))
1145                 filepath = addPath("/systemlyxdir", relpath);
1146         else if (!save_transient_properties || !lyxrc.save_origin)
1147                 filepath = "unavailable";
1148         os << "\\origin " << quoteIfNeeded(filepath) << '\n';
1149
1150         // the textclass
1151         os << "\\textclass "
1152            << quoteIfNeeded(buf->includedFilePath(addName(buf->layoutPos(),
1153                                                 baseClass()->name()), "layout"))
1154            << '\n';
1155
1156         // then the preamble
1157         if (!preamble.empty()) {
1158                 // remove '\n' from the end of preamble
1159                 docstring const tmppreamble = rtrim(preamble, "\n");
1160                 os << "\\begin_preamble\n"
1161                    << to_utf8(tmppreamble)
1162                    << "\n\\end_preamble\n";
1163         }
1164
1165         // the options
1166         if (!options.empty()) {
1167                 os << "\\options " << options << '\n';
1168         }
1169
1170         // use the class options defined in the layout?
1171         os << "\\use_default_options "
1172            << convert<string>(use_default_options) << "\n";
1173
1174         // the master document
1175         if (!master.empty()) {
1176                 os << "\\master " << master << '\n';
1177         }
1178
1179         // removed modules
1180         if (!removed_modules_.empty()) {
1181                 os << "\\begin_removed_modules" << '\n';
1182                 list<string>::const_iterator it = removed_modules_.begin();
1183                 list<string>::const_iterator en = removed_modules_.end();
1184                 for (; it != en; ++it)
1185                         os << *it << '\n';
1186                 os << "\\end_removed_modules" << '\n';
1187         }
1188
1189         // the modules
1190         if (!layout_modules_.empty()) {
1191                 os << "\\begin_modules" << '\n';
1192                 LayoutModuleList::const_iterator it = layout_modules_.begin();
1193                 LayoutModuleList::const_iterator en = layout_modules_.end();
1194                 for (; it != en; ++it)
1195                         os << *it << '\n';
1196                 os << "\\end_modules" << '\n';
1197         }
1198
1199         // includeonly
1200         if (!included_children_.empty()) {
1201                 os << "\\begin_includeonly" << '\n';
1202                 list<string>::const_iterator it = included_children_.begin();
1203                 list<string>::const_iterator en = included_children_.end();
1204                 for (; it != en; ++it)
1205                         os << *it << '\n';
1206                 os << "\\end_includeonly" << '\n';
1207         }
1208         os << "\\maintain_unincluded_children "
1209            << convert<string>(maintain_unincluded_children) << '\n';
1210
1211         // local layout information
1212         docstring const local_layout = getLocalLayout(false);
1213         if (!local_layout.empty()) {
1214                 // remove '\n' from the end
1215                 docstring const tmplocal = rtrim(local_layout, "\n");
1216                 os << "\\begin_local_layout\n"
1217                    << to_utf8(tmplocal)
1218                    << "\n\\end_local_layout\n";
1219         }
1220         docstring const forced_local_layout = getLocalLayout(true);
1221         if (!forced_local_layout.empty()) {
1222                 // remove '\n' from the end
1223                 docstring const tmplocal = rtrim(forced_local_layout, "\n");
1224                 os << "\\begin_forced_local_layout\n"
1225                    << to_utf8(tmplocal)
1226                    << "\n\\end_forced_local_layout\n";
1227         }
1228
1229         // then the text parameters
1230         if (language != ignore_language)
1231                 os << "\\language " << language->lang() << '\n';
1232         os << "\\language_package " << lang_package
1233            << "\n\\inputencoding " << inputenc
1234            << "\n\\fontencoding " << fontenc
1235            << "\n\\font_roman \"" << fonts_roman[0]
1236            << "\" \"" << fonts_roman[1] << '"'
1237            << "\n\\font_sans \"" << fonts_sans[0]
1238            << "\" \"" << fonts_sans[1] << '"'
1239            << "\n\\font_typewriter \"" << fonts_typewriter[0]
1240            << "\" \"" << fonts_typewriter[1] << '"'
1241            << "\n\\font_math \"" << fonts_math[0]
1242            << "\" \"" << fonts_math[1] << '"'
1243            << "\n\\font_default_family " << fonts_default_family
1244            << "\n\\use_non_tex_fonts " << convert<string>(useNonTeXFonts)
1245            << "\n\\font_sc " << convert<string>(fonts_expert_sc)
1246            << "\n\\font_osf " << convert<string>(fonts_old_figures)
1247            << "\n\\font_sf_scale " << fonts_sans_scale[0]
1248            << ' ' << fonts_sans_scale[1]
1249            << "\n\\font_tt_scale " << fonts_typewriter_scale[0]
1250            << ' ' << fonts_typewriter_scale[1]
1251            << '\n';
1252         if (!fonts_cjk.empty()) {
1253                 os << "\\font_cjk " << fonts_cjk << '\n';
1254         }
1255         os << "\\use_microtype " << convert<string>(use_microtype) << '\n';
1256         os << "\\use_dash_ligatures " << convert<string>(use_dash_ligatures) << '\n';
1257         os << "\\graphics " << graphics_driver << '\n';
1258         os << "\\default_output_format " << default_output_format << '\n';
1259         os << "\\output_sync " << output_sync << '\n';
1260         if (!output_sync_macro.empty())
1261                 os << "\\output_sync_macro \"" << output_sync_macro << "\"\n";
1262         os << "\\bibtex_command " << bibtex_command << '\n';
1263         os << "\\index_command " << index_command << '\n';
1264
1265         if (!float_placement.empty())
1266                 os << "\\float_placement " << float_placement << '\n';
1267         if (!float_alignment.empty())
1268                 os << "\\float_alignment " << float_alignment << '\n';
1269         os << "\\paperfontsize " << fontsize << '\n';
1270
1271         spacing().writeFile(os);
1272         pdfoptions().writeFile(os);
1273
1274         os << "\\papersize " << string_papersize[papersize]
1275            << "\n\\use_geometry " << convert<string>(use_geometry);
1276         map<string, string> const & packages = auto_packages();
1277         for (map<string, string>::const_iterator it = packages.begin();
1278              it != packages.end(); ++it)
1279                 os << "\n\\use_package " << it->first << ' '
1280                    << use_package(it->first);
1281
1282         os << "\n\\cite_engine ";
1283
1284         if (!cite_engine_.empty())
1285                 os << cite_engine_;
1286         else
1287                 os << "basic";
1288
1289         os << "\n\\cite_engine_type " << theCiteEnginesList.getTypeAsString(cite_engine_type_);
1290
1291         if (!biblio_style.empty())
1292                 os << "\n\\biblio_style " << biblio_style;
1293         if (!biblio_opts.empty())
1294                 os << "\n\\biblio_options " << biblio_opts;
1295         if (!biblatex_bibstyle.empty())
1296                 os << "\n\\biblatex_bibstyle " << biblatex_bibstyle;
1297         if (!biblatex_citestyle.empty())
1298                 os << "\n\\biblatex_citestyle " << biblatex_citestyle;
1299         if (!multibib.empty())
1300                 os << "\n\\multibib " << multibib;
1301
1302         os << "\n\\use_bibtopic " << convert<string>(use_bibtopic)
1303            << "\n\\use_indices " << convert<string>(use_indices)
1304            << "\n\\paperorientation " << string_orientation[orientation]
1305            << "\n\\suppress_date " << convert<string>(suppress_date)
1306            << "\n\\justification " << convert<string>(justification)
1307            << "\n\\use_refstyle " << use_refstyle
1308            << "\n\\use_minted " << use_minted
1309            << '\n';
1310         if (isbackgroundcolor == true)
1311                 os << "\\backgroundcolor " << lyx::X11hexname(backgroundcolor) << '\n';
1312         if (isfontcolor == true)
1313                 os << "\\fontcolor " << lyx::X11hexname(fontcolor) << '\n';
1314         if (notefontcolor != lyx::rgbFromHexName("#cccccc"))
1315                 os << "\\notefontcolor " << lyx::X11hexname(notefontcolor) << '\n';
1316         if (boxbgcolor != lyx::rgbFromHexName("#ff0000"))
1317                 os << "\\boxbgcolor " << lyx::X11hexname(boxbgcolor) << '\n';
1318
1319         BranchList::const_iterator it = branchlist().begin();
1320         BranchList::const_iterator end = branchlist().end();
1321         for (; it != end; ++it) {
1322                 os << "\\branch " << to_utf8(it->branch())
1323                    << "\n\\selected " << it->isSelected()
1324                    << "\n\\filename_suffix " << it->hasFileNameSuffix()
1325                    << "\n\\color " << lyx::X11hexname(it->color())
1326                    << "\n\\end_branch"
1327                    << "\n";
1328         }
1329
1330         IndicesList::const_iterator iit = indiceslist().begin();
1331         IndicesList::const_iterator iend = indiceslist().end();
1332         for (; iit != iend; ++iit) {
1333                 os << "\\index " << to_utf8(iit->index())
1334                    << "\n\\shortcut " << to_utf8(iit->shortcut())
1335                    << "\n\\color " << lyx::X11hexname(iit->color())
1336                    << "\n\\end_index"
1337                    << "\n";
1338         }
1339
1340         if (!paperwidth.empty())
1341                 os << "\\paperwidth "
1342                    << VSpace(paperwidth).asLyXCommand() << '\n';
1343         if (!paperheight.empty())
1344                 os << "\\paperheight "
1345                    << VSpace(paperheight).asLyXCommand() << '\n';
1346         if (!leftmargin.empty())
1347                 os << "\\leftmargin "
1348                    << VSpace(leftmargin).asLyXCommand() << '\n';
1349         if (!topmargin.empty())
1350                 os << "\\topmargin "
1351                    << VSpace(topmargin).asLyXCommand() << '\n';
1352         if (!rightmargin.empty())
1353                 os << "\\rightmargin "
1354                    << VSpace(rightmargin).asLyXCommand() << '\n';
1355         if (!bottommargin.empty())
1356                 os << "\\bottommargin "
1357                    << VSpace(bottommargin).asLyXCommand() << '\n';
1358         if (!headheight.empty())
1359                 os << "\\headheight "
1360                    << VSpace(headheight).asLyXCommand() << '\n';
1361         if (!headsep.empty())
1362                 os << "\\headsep "
1363                    << VSpace(headsep).asLyXCommand() << '\n';
1364         if (!footskip.empty())
1365                 os << "\\footskip "
1366                    << VSpace(footskip).asLyXCommand() << '\n';
1367         if (!columnsep.empty())
1368                 os << "\\columnsep "
1369                          << VSpace(columnsep).asLyXCommand() << '\n';
1370         os << "\\secnumdepth " << secnumdepth
1371            << "\n\\tocdepth " << tocdepth
1372            << "\n\\paragraph_separation "
1373            << string_paragraph_separation[paragraph_separation];
1374         if (!paragraph_separation)
1375                 os << "\n\\paragraph_indentation "
1376                    << (getParIndent().empty() ? "default" : getParIndent().asString());
1377         else
1378                 os << "\n\\defskip " << getDefSkip().asLyXCommand();
1379         os << "\n\\is_math_indent " << is_math_indent;
1380         if (is_math_indent)
1381                 os << "\n\\math_indentation "
1382                    << (getMathIndent().empty() ? "default" : getMathIndent().asString());
1383         os << "\n\\math_numbering_side ";
1384         switch(math_numbering_side) {
1385         case LEFT:
1386                 os << "left";
1387                 break;
1388         case RIGHT:
1389                 os << "right";
1390                 break;
1391         case DEFAULT:
1392                 os << "default";
1393         }
1394         os << "\n\\quotes_style "
1395            << string_quotes_style[quotes_style]
1396            << "\n\\dynamic_quotes " << dynamic_quotes
1397            << "\n\\papercolumns " << columns
1398            << "\n\\papersides " << sides
1399            << "\n\\paperpagestyle " << pagestyle << '\n';
1400         if (!listings_params.empty())
1401                 os << "\\listings_params \"" <<
1402                         InsetListingsParams(listings_params).encodedString() << "\"\n";
1403         for (int i = 0; i < 4; ++i) {
1404                 if (user_defined_bullet(i) != ITEMIZE_DEFAULTS[i]) {
1405                         if (user_defined_bullet(i).getFont() != -1) {
1406                                 os << "\\bullet " << i << " "
1407                                    << user_defined_bullet(i).getFont() << " "
1408                                    << user_defined_bullet(i).getCharacter() << " "
1409                                    << user_defined_bullet(i).getSize() << "\n";
1410                         }
1411                         else {
1412                                 // FIXME UNICODE
1413                                 os << "\\bulletLaTeX " << i << " \""
1414                                    << lyx::to_ascii(user_defined_bullet(i).getText())
1415                                    << "\"\n";
1416                         }
1417                 }
1418         }
1419
1420         os << "\\tracking_changes "
1421            << (save_transient_properties ? convert<string>(track_changes) : "false")
1422            << '\n';
1423
1424         os << "\\output_changes "
1425            << (save_transient_properties ? convert<string>(output_changes) : "false")
1426            << '\n';
1427
1428         os << "\\html_math_output " << html_math_output << '\n'
1429            << "\\html_css_as_file " << html_css_as_file << '\n'
1430            << "\\html_be_strict " << convert<string>(html_be_strict) << '\n';
1431
1432         if (html_math_img_scale != 1.0)
1433                 os << "\\html_math_img_scale " << convert<string>(html_math_img_scale) << '\n';
1434         if (!html_latex_start.empty())
1435                 os << "\\html_latex_start " << html_latex_start << '\n';
1436         if (!html_latex_end.empty())
1437                  os << "\\html_latex_end " << html_latex_end << '\n';
1438
1439         os << pimpl_->authorlist;
1440 }
1441
1442
1443 void BufferParams::validate(LaTeXFeatures & features) const
1444 {
1445         features.require(documentClass().requires());
1446
1447         if (columns > 1 && language->rightToLeft())
1448                 features.require("rtloutputdblcol");
1449
1450         if (output_changes) {
1451                 bool dvipost    = LaTeXFeatures::isAvailable("dvipost");
1452                 bool xcolorulem = LaTeXFeatures::isAvailable("ulem") &&
1453                                   LaTeXFeatures::isAvailable("xcolor");
1454
1455                 switch (features.runparams().flavor) {
1456                 case OutputParams::LATEX:
1457                 case OutputParams::DVILUATEX:
1458                         if (dvipost) {
1459                                 features.require("ct-dvipost");
1460                                 features.require("dvipost");
1461                         } else if (xcolorulem) {
1462                                 features.require("ct-xcolor-ulem");
1463                                 features.require("ulem");
1464                                 features.require("xcolor");
1465                         } else {
1466                                 features.require("ct-none");
1467                         }
1468                         break;
1469                 case OutputParams::LUATEX:
1470                 case OutputParams::PDFLATEX:
1471                 case OutputParams::XETEX:
1472                         if (xcolorulem) {
1473                                 features.require("ct-xcolor-ulem");
1474                                 features.require("ulem");
1475                                 features.require("xcolor");
1476                                 // improves color handling in PDF output
1477                                 features.require("pdfcolmk");
1478                         } else {
1479                                 features.require("ct-none");
1480                         }
1481                         break;
1482                 default:
1483                         break;
1484                 }
1485         }
1486
1487         // Floats with 'Here definitely' as default setting.
1488         if (float_placement.find('H') != string::npos)
1489                 features.require("float");
1490
1491         for (PackageMap::const_iterator it = use_packages.begin();
1492              it != use_packages.end(); ++it) {
1493                 if (it->first == "amsmath") {
1494                         // AMS Style is at document level
1495                         if (it->second == package_on ||
1496                             features.isProvided("amsmath"))
1497                                 features.require(it->first);
1498                 } else if (it->second == package_on)
1499                         features.require(it->first);
1500         }
1501
1502         // Document-level line spacing
1503         if (spacing().getSpace() != Spacing::Single && !spacing().isDefault())
1504                 features.require("setspace");
1505
1506         // the bullet shapes are buffer level not paragraph level
1507         // so they are tested here
1508         for (int i = 0; i < 4; ++i) {
1509                 if (user_defined_bullet(i) == ITEMIZE_DEFAULTS[i])
1510                         continue;
1511                 int const font = user_defined_bullet(i).getFont();
1512                 if (font == 0) {
1513                         int const c = user_defined_bullet(i).getCharacter();
1514                         if (c == 16
1515                             || c == 17
1516                             || c == 25
1517                             || c == 26
1518                             || c == 31) {
1519                                 features.require("latexsym");
1520                         }
1521                 } else if (font == 1) {
1522                         features.require("amssymb");
1523                 } else if (font >= 2 && font <= 5) {
1524                         features.require("pifont");
1525                 }
1526         }
1527
1528         if (pdfoptions().use_hyperref) {
1529                 features.require("hyperref");
1530                 // due to interferences with babel and hyperref, the color package has to
1531                 // be loaded after hyperref when hyperref is used with the colorlinks
1532                 // option, see http://www.lyx.org/trac/ticket/5291
1533                 if (pdfoptions().colorlinks)
1534                         features.require("color");
1535         }
1536         if (!listings_params.empty()) {
1537                 // do not test validity because listings_params is
1538                 // supposed to be valid
1539                 string par =
1540                         InsetListingsParams(listings_params).separatedParams(true);
1541                 // we can't support all packages, but we should load the color package
1542                 if (par.find("\\color", 0) != string::npos)
1543                         features.require("color");
1544         }
1545
1546         // some languages are only available via polyglossia
1547         if (features.hasPolyglossiaExclusiveLanguages())
1548                 features.require("polyglossia");
1549
1550         if (useNonTeXFonts && fontsMath() != "auto")
1551                 features.require("unicode-math");
1552
1553         if (use_microtype)
1554                 features.require("microtype");
1555
1556         if (!language->requires().empty())
1557                 features.require(language->requires());
1558 }
1559
1560
1561 bool BufferParams::writeLaTeX(otexstream & os, LaTeXFeatures & features,
1562                               FileName const & filepath) const
1563 {
1564         // http://www.tug.org/texmf-dist/doc/latex/base/fixltx2e.pdf
1565         // !! To use the Fix-cm package, load it before \documentclass, and use the command
1566         // \RequirePackage to do so, rather than the normal \usepackage
1567         // Do not try to load any other package before the document class, unless you
1568         // have a thorough understanding of the LATEX internals and know exactly what you
1569         // are doing!
1570         if (features.mustProvide("fix-cm"))
1571                 os << "\\RequirePackage{fix-cm}\n";
1572         // Likewise for fixltx2e. If other packages conflict with this policy,
1573         // treat it as a package bug (and report it!)
1574         // See http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/4407
1575         if (features.mustProvide("fixltx2e"))
1576                 os << "\\RequirePackage{fixltx2e}\n";
1577
1578         os << "\\documentclass";
1579
1580         DocumentClass const & tclass = documentClass();
1581
1582         ostringstream clsoptions; // the document class options.
1583
1584         if (tokenPos(tclass.opt_fontsize(),
1585                      '|', fontsize) >= 0) {
1586                 // only write if existing in list (and not default)
1587                 clsoptions << fontsize << "pt,";
1588         }
1589
1590         // all paper sizes except of A4, A5, B5 and the US sizes need the
1591         // geometry package
1592         bool nonstandard_papersize = papersize != PAPER_DEFAULT
1593                 && papersize != PAPER_USLETTER
1594                 && papersize != PAPER_USLEGAL
1595                 && papersize != PAPER_USEXECUTIVE
1596                 && papersize != PAPER_A4
1597                 && papersize != PAPER_A5
1598                 && papersize != PAPER_B5;
1599
1600         if (!use_geometry) {
1601                 switch (papersize) {
1602                 case PAPER_A4:
1603                         clsoptions << "a4paper,";
1604                         break;
1605                 case PAPER_USLETTER:
1606                         clsoptions << "letterpaper,";
1607                         break;
1608                 case PAPER_A5:
1609                         clsoptions << "a5paper,";
1610                         break;
1611                 case PAPER_B5:
1612                         clsoptions << "b5paper,";
1613                         break;
1614                 case PAPER_USEXECUTIVE:
1615                         clsoptions << "executivepaper,";
1616                         break;
1617                 case PAPER_USLEGAL:
1618                         clsoptions << "legalpaper,";
1619                         break;
1620                 case PAPER_DEFAULT:
1621                 case PAPER_A0:
1622                 case PAPER_A1:
1623                 case PAPER_A2:
1624                 case PAPER_A3:
1625                 case PAPER_A6:
1626                 case PAPER_B0:
1627                 case PAPER_B1:
1628                 case PAPER_B2:
1629                 case PAPER_B3:
1630                 case PAPER_B4:
1631                 case PAPER_B6:
1632                 case PAPER_C0:
1633                 case PAPER_C1:
1634                 case PAPER_C2:
1635                 case PAPER_C3:
1636                 case PAPER_C4:
1637                 case PAPER_C5:
1638                 case PAPER_C6:
1639                 case PAPER_JISB0:
1640                 case PAPER_JISB1:
1641                 case PAPER_JISB2:
1642                 case PAPER_JISB3:
1643                 case PAPER_JISB4:
1644                 case PAPER_JISB5:
1645                 case PAPER_JISB6:
1646                 case PAPER_CUSTOM:
1647                         break;
1648                 }
1649         }
1650
1651         // if needed
1652         if (sides != tclass.sides()) {
1653                 switch (sides) {
1654                 case OneSide:
1655                         clsoptions << "oneside,";
1656                         break;
1657                 case TwoSides:
1658                         clsoptions << "twoside,";
1659                         break;
1660                 }
1661         }
1662
1663         // if needed
1664         if (columns != tclass.columns()) {
1665                 if (columns == 2)
1666                         clsoptions << "twocolumn,";
1667                 else
1668                         clsoptions << "onecolumn,";
1669         }
1670
1671         if (!use_geometry
1672             && orientation == ORIENTATION_LANDSCAPE)
1673                 clsoptions << "landscape,";
1674
1675         if (is_math_indent)
1676                 clsoptions << "fleqn,";
1677
1678         switch(math_numbering_side) {
1679         case LEFT:
1680                 clsoptions << "leqno,";
1681                 break;
1682         case RIGHT:
1683                 clsoptions << "reqno,";
1684                 features.require("amsmath");
1685                 break;
1686         case DEFAULT:
1687                 break;
1688         }
1689
1690         // language should be a parameter to \documentclass
1691         if (language->babel() == "hebrew"
1692             && default_language->babel() != "hebrew")
1693                 // This seems necessary
1694                 features.useLanguage(default_language);
1695
1696         ostringstream language_options;
1697         bool const use_babel = features.useBabel() && !features.isProvided("babel");
1698         bool const use_polyglossia = features.usePolyglossia();
1699         bool const global = lyxrc.language_global_options;
1700         if (features.useBabel() || (use_polyglossia && global)) {
1701                 language_options << features.getBabelLanguages();
1702                 if (!language->babel().empty()) {
1703                         if (!language_options.str().empty())
1704                                 language_options << ',';
1705                         language_options << language->babel();
1706                 }
1707                 if (global && !features.needBabelLangOptions()
1708                     && !language_options.str().empty())
1709                         clsoptions << language_options.str() << ',';
1710         }
1711
1712         // the predefined options from the layout
1713         if (use_default_options && !tclass.options().empty())
1714                 clsoptions << tclass.options() << ',';
1715
1716         // the user-defined options
1717         if (!options.empty()) {
1718                 clsoptions << options << ',';
1719         }
1720
1721         string strOptions(clsoptions.str());
1722         if (!strOptions.empty()) {
1723                 strOptions = rtrim(strOptions, ",");
1724                 // FIXME UNICODE
1725                 os << '[' << from_utf8(strOptions) << ']';
1726         }
1727
1728         os << '{' << from_ascii(tclass.latexname()) << "}\n";
1729         // end of \documentclass defs
1730
1731         // if we use fontspec or newtxmath, we have to load the AMS packages here
1732         string const ams = features.loadAMSPackages();
1733         bool const ot1 = (main_font_encoding() == "default" || main_font_encoding() == "OT1");
1734         bool const use_newtxmath =
1735                 theLaTeXFonts().getLaTeXFont(from_ascii(fontsMath())).getUsedPackage(
1736                         ot1, false, false) == "newtxmath";
1737         if ((useNonTeXFonts || use_newtxmath) && !ams.empty())
1738                 os << from_ascii(ams);
1739
1740         if (useNonTeXFonts) {
1741                 if (!features.isProvided("fontspec"))
1742                         os << "\\usepackage{fontspec}\n";
1743                 if (features.mustProvide("unicode-math")
1744                     && features.isAvailable("unicode-math"))
1745                         os << "\\usepackage{unicode-math}\n";
1746         }
1747
1748         // load CJK support package before font selection
1749         // (see autotests/export/latex/CJK/micro-sign_utf8-cjk-libertine.lyx)
1750         if (!useNonTeXFonts && encoding().package() != Encoding::none && inputenc != "utf8x"
1751                 && (encoding().package() == Encoding::CJK || features.mustProvide("CJK"))) {
1752                 if (inputenc == "utf8-cjk" || inputenc == "utf8")
1753                         os << "\\usepackage{CJKutf8}\n";
1754                 else
1755                         os << "\\usepackage[encapsulated]{CJK}\n";
1756         }
1757
1758         // font selection must be done before loading fontenc.sty
1759         string const fonts = loadFonts(features);
1760         if (!fonts.empty())
1761                 os << from_utf8(fonts);
1762
1763         if (fonts_default_family != "default")
1764                 os << "\\renewcommand{\\familydefault}{\\"
1765                    << from_ascii(fonts_default_family) << "}\n";
1766
1767         // set font encoding
1768         // XeTeX and LuaTeX (with OS fonts) do not need fontenc
1769         if (!useNonTeXFonts && !features.isProvided("fontenc")
1770             && main_font_encoding() != "default") {
1771                 // get main font encodings
1772                 vector<string> fontencs = font_encodings();
1773                 // get font encodings of secondary languages
1774                 features.getFontEncodings(fontencs);
1775                 if (!fontencs.empty()) {
1776                         os << "\\usepackage["
1777                            << from_ascii(getStringFromVector(fontencs))
1778                            << "]{fontenc}\n";
1779                 }
1780         }
1781
1782         // handle inputenc etc.
1783         writeEncodingPreamble(os, features);
1784
1785         // includeonly
1786         if (!features.runparams().includeall && !included_children_.empty()) {
1787                 os << "\\includeonly{";
1788                 list<string>::const_iterator it = included_children_.begin();
1789                 list<string>::const_iterator en = included_children_.end();
1790                 bool first = true;
1791                 for (; it != en; ++it) {
1792                         string incfile = *it;
1793                         FileName inc = makeAbsPath(incfile, filepath.absFileName());
1794                         string mangled = DocFileName(changeExtension(inc.absFileName(), ".tex")).
1795                         mangledFileName();
1796                         if (!features.runparams().nice)
1797                                 incfile = mangled;
1798                         // \includeonly doesn't want an extension
1799                         incfile = changeExtension(incfile, string());
1800                         incfile = support::latex_path(incfile);
1801                         if (!incfile.empty()) {
1802                                 if (!first)
1803                                         os << ",";
1804                                 os << from_utf8(incfile);
1805                         }
1806                         first = false;
1807                 }
1808                 os << "}\n";
1809         }
1810
1811         if (!features.isProvided("geometry")
1812             && (use_geometry || nonstandard_papersize)) {
1813                 odocstringstream ods;
1814                 if (!getGraphicsDriver("geometry").empty())
1815                         ods << getGraphicsDriver("geometry");
1816                 if (orientation == ORIENTATION_LANDSCAPE)
1817                         ods << ",landscape";
1818                 switch (papersize) {
1819                 case PAPER_CUSTOM:
1820                         if (!paperwidth.empty())
1821                                 ods << ",paperwidth="
1822                                    << from_ascii(paperwidth);
1823                         if (!paperheight.empty())
1824                                 ods << ",paperheight="
1825                                    << from_ascii(paperheight);
1826                         break;
1827                 case PAPER_USLETTER:
1828                         ods << ",letterpaper";
1829                         break;
1830                 case PAPER_USLEGAL:
1831                         ods << ",legalpaper";
1832                         break;
1833                 case PAPER_USEXECUTIVE:
1834                         ods << ",executivepaper";
1835                         break;
1836                 case PAPER_A0:
1837                         ods << ",a0paper";
1838                         break;
1839                 case PAPER_A1:
1840                         ods << ",a1paper";
1841                         break;
1842                 case PAPER_A2:
1843                         ods << ",a2paper";
1844                         break;
1845                 case PAPER_A3:
1846                         ods << ",a3paper";
1847                         break;
1848                 case PAPER_A4:
1849                         ods << ",a4paper";
1850                         break;
1851                 case PAPER_A5:
1852                         ods << ",a5paper";
1853                         break;
1854                 case PAPER_A6:
1855                         ods << ",a6paper";
1856                         break;
1857                 case PAPER_B0:
1858                         ods << ",b0paper";
1859                         break;
1860                 case PAPER_B1:
1861                         ods << ",b1paper";
1862                         break;
1863                 case PAPER_B2:
1864                         ods << ",b2paper";
1865                         break;
1866                 case PAPER_B3:
1867                         ods << ",b3paper";
1868                         break;
1869                 case PAPER_B4:
1870                         ods << ",b4paper";
1871                         break;
1872                 case PAPER_B5:
1873                         ods << ",b5paper";
1874                         break;
1875                 case PAPER_B6:
1876                         ods << ",b6paper";
1877                         break;
1878                 case PAPER_C0:
1879                         ods << ",c0paper";
1880                         break;
1881                 case PAPER_C1:
1882                         ods << ",c1paper";
1883                         break;
1884                 case PAPER_C2:
1885                         ods << ",c2paper";
1886                         break;
1887                 case PAPER_C3:
1888                         ods << ",c3paper";
1889                         break;
1890                 case PAPER_C4:
1891                         ods << ",c4paper";
1892                         break;
1893                 case PAPER_C5:
1894                         ods << ",c5paper";
1895                         break;
1896                 case PAPER_C6:
1897                         ods << ",c6paper";
1898                         break;
1899                 case PAPER_JISB0:
1900                         ods << ",b0j";
1901                         break;
1902                 case PAPER_JISB1:
1903                         ods << ",b1j";
1904                         break;
1905                 case PAPER_JISB2:
1906                         ods << ",b2j";
1907                         break;
1908                 case PAPER_JISB3:
1909                         ods << ",b3j";
1910                         break;
1911                 case PAPER_JISB4:
1912                         ods << ",b4j";
1913                         break;
1914                 case PAPER_JISB5:
1915                         ods << ",b5j";
1916                         break;
1917                 case PAPER_JISB6:
1918                         ods << ",b6j";
1919                         break;
1920                 case PAPER_DEFAULT:
1921                         break;
1922                 }
1923                 docstring const g_options = trim(ods.str(), ",");
1924                 os << "\\usepackage";
1925                 if (!g_options.empty())
1926                         os << '[' << g_options << ']';
1927                 os << "{geometry}\n";
1928                 // output this only if use_geometry is true
1929                 if (use_geometry) {
1930                         os << "\\geometry{verbose";
1931                         if (!topmargin.empty())
1932                                 os << ",tmargin=" << from_ascii(Length(topmargin).asLatexString());
1933                         if (!bottommargin.empty())
1934                                 os << ",bmargin=" << from_ascii(Length(bottommargin).asLatexString());
1935                         if (!leftmargin.empty())
1936                                 os << ",lmargin=" << from_ascii(Length(leftmargin).asLatexString());
1937                         if (!rightmargin.empty())
1938                                 os << ",rmargin=" << from_ascii(Length(rightmargin).asLatexString());
1939                         if (!headheight.empty())
1940                                 os << ",headheight=" << from_ascii(Length(headheight).asLatexString());
1941                         if (!headsep.empty())
1942                                 os << ",headsep=" << from_ascii(Length(headsep).asLatexString());
1943                         if (!footskip.empty())
1944                                 os << ",footskip=" << from_ascii(Length(footskip).asLatexString());
1945                         if (!columnsep.empty())
1946                                 os << ",columnsep=" << from_ascii(Length(columnsep).asLatexString());
1947                         os << "}\n";
1948                 }
1949         } else if (orientation == ORIENTATION_LANDSCAPE
1950                    || papersize != PAPER_DEFAULT) {
1951                 features.require("papersize");
1952         }
1953
1954         if (tokenPos(tclass.opt_pagestyle(), '|', pagestyle) >= 0) {
1955                 if (pagestyle == "fancy")
1956                         os << "\\usepackage{fancyhdr}\n";
1957                 os << "\\pagestyle{" << from_ascii(pagestyle) << "}\n";
1958         }
1959
1960         // only output when the background color is not default
1961         if (isbackgroundcolor == true) {
1962                 // only require color here, the background color will be defined
1963                 // in LaTeXFeatures.cpp to avoid interferences with the LaTeX
1964                 // package pdfpages
1965                 features.require("color");
1966                 features.require("pagecolor");
1967         }
1968
1969         // only output when the font color is not default
1970         if (isfontcolor == true) {
1971                 // only require color here, the font color will be defined
1972                 // in LaTeXFeatures.cpp to avoid interferences with the LaTeX
1973                 // package pdfpages
1974                 features.require("color");
1975                 features.require("fontcolor");
1976         }
1977
1978         // Only if class has a ToC hierarchy
1979         if (tclass.hasTocLevels()) {
1980                 if (secnumdepth != tclass.secnumdepth()) {
1981                         os << "\\setcounter{secnumdepth}{"
1982                            << secnumdepth
1983                            << "}\n";
1984                 }
1985                 if (tocdepth != tclass.tocdepth()) {
1986                         os << "\\setcounter{tocdepth}{"
1987                            << tocdepth
1988                            << "}\n";
1989                 }
1990         }
1991
1992         if (paragraph_separation) {
1993                 // when skip separation
1994                 switch (getDefSkip().kind()) {
1995                 case VSpace::SMALLSKIP:
1996                         os << "\\setlength{\\parskip}{\\smallskipamount}\n";
1997                         break;
1998                 case VSpace::MEDSKIP:
1999                         os << "\\setlength{\\parskip}{\\medskipamount}\n";
2000                         break;
2001                 case VSpace::BIGSKIP:
2002                         os << "\\setlength{\\parskip}{\\bigskipamount}\n";
2003                         break;
2004                 case VSpace::LENGTH:
2005                         os << "\\setlength{\\parskip}{"
2006                            << from_utf8(getDefSkip().length().asLatexString())
2007                            << "}\n";
2008                         break;
2009                 default: // should never happen // Then delete it.
2010                         os << "\\setlength{\\parskip}{\\medskipamount}\n";
2011                         break;
2012                 }
2013                 os << "\\setlength{\\parindent}{0pt}\n";
2014         } else {
2015                 // when separation by indentation
2016                 // only output something when a width is given
2017                 if (!getParIndent().empty()) {
2018                         os << "\\setlength{\\parindent}{"
2019                            << from_utf8(getParIndent().asLatexString())
2020                            << "}\n";
2021                 }
2022         }
2023
2024         if (is_math_indent) {
2025                 // when formula indentation
2026                 // only output something when it is not the default
2027                 if (!getMathIndent().empty()) {
2028                         os << "\\setlength{\\mathindent}{"
2029                            << from_utf8(getMathIndent().asString())
2030                            << "}\n";
2031                 }
2032         }
2033
2034         // Now insert the LyX specific LaTeX commands...
2035         features.resolveAlternatives();
2036         features.expandMultiples();
2037
2038         if (output_sync) {
2039                 if (!output_sync_macro.empty())
2040                         os << from_utf8(output_sync_macro) +"\n";
2041                 else if (features.runparams().flavor == OutputParams::LATEX)
2042                         os << "\\usepackage[active]{srcltx}\n";
2043                 else if (features.runparams().flavor == OutputParams::PDFLATEX)
2044                         os << "\\synctex=-1\n";
2045         }
2046
2047         // The package options (via \PassOptionsToPackage)
2048         os << from_ascii(features.getPackageOptions());
2049
2050         // due to interferences with babel and hyperref, the color package has to
2051         // be loaded (when it is not already loaded) before babel when hyperref
2052         // is used with the colorlinks option, see
2053         // http://www.lyx.org/trac/ticket/5291
2054         // we decided therefore to load color always before babel, see
2055         // http://www.mail-archive.com/lyx-devel@lists.lyx.org/msg144349.html
2056         os << from_ascii(features.getColorOptions());
2057
2058         // If we use hyperref, jurabib, japanese or varioref,
2059         // we have to call babel before
2060         if (use_babel
2061             && (features.isRequired("jurabib")
2062                 || features.isRequired("hyperref")
2063                 || features.isRequired("varioref")
2064                 || features.isRequired("japanese"))) {
2065                         os << features.getBabelPresettings();
2066                         // FIXME UNICODE
2067                         os << from_utf8(babelCall(language_options.str(),
2068                                                   features.needBabelLangOptions())) + '\n';
2069                         os << features.getBabelPostsettings();
2070         }
2071
2072         // The optional packages;
2073         os << from_ascii(features.getPackages());
2074
2075         // Additional Indices
2076         if (features.isRequired("splitidx")) {
2077                 IndicesList::const_iterator iit = indiceslist().begin();
2078                 IndicesList::const_iterator iend = indiceslist().end();
2079                 for (; iit != iend; ++iit) {
2080                         os << "\\newindex{";
2081                         os << escape(iit->shortcut());
2082                         os << "}\n";
2083                 }
2084         }
2085
2086         // Line spacing
2087         os << from_utf8(spacing().writePreamble(features.isProvided("SetSpace")));
2088
2089         // PDF support.
2090         // * Hyperref manual: "Make sure it comes last of your loaded
2091         //   packages, to give it a fighting chance of not being over-written,
2092         //   since its job is to redefine many LaTeX commands."
2093         // * Email from Heiko Oberdiek: "It is usually better to load babel
2094         //   before hyperref. Then hyperref has a chance to detect babel.
2095         // * Has to be loaded before the "LyX specific LaTeX commands" to
2096         //   avoid errors with algorithm floats.
2097         // use hyperref explicitly if it is required
2098         if (features.isRequired("hyperref")) {
2099                 OutputParams tmp_params = features.runparams();
2100                 pdfoptions().writeLaTeX(tmp_params, os,
2101                                         features.isProvided("hyperref"));
2102                 // correctly break URLs with hyperref and dvi/ps output
2103                 if (features.runparams().hyperref_driver == "dvips"
2104                     && features.isAvailable("breakurl"))
2105                         os << "\\usepackage{breakurl}\n";
2106         } else if (features.isRequired("nameref"))
2107                 // hyperref loads this automatically
2108                 os << "\\usepackage{nameref}\n";
2109
2110         // bibtopic needs to be loaded after hyperref.
2111         // the dot provides the aux file naming which LyX can detect.
2112         if (features.mustProvide("bibtopic"))
2113                 os << "\\usepackage[dot]{bibtopic}\n";
2114
2115         // Will be surrounded by \makeatletter and \makeatother when not empty
2116         otexstringstream atlyxpreamble;
2117
2118         // Some macros LyX will need
2119         {
2120                 TexString tmppreamble = features.getMacros();
2121                 if (!tmppreamble.str.empty())
2122                         atlyxpreamble << "\n%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% "
2123                                          "LyX specific LaTeX commands.\n"
2124                                       << move(tmppreamble)
2125                                       << '\n';
2126         }
2127         // the text class specific preamble
2128         {
2129                 docstring tmppreamble = features.getTClassPreamble();
2130                 if (!tmppreamble.empty())
2131                         atlyxpreamble << "%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% "
2132                                          "Textclass specific LaTeX commands.\n"
2133                                       << tmppreamble
2134                                       << '\n';
2135         }
2136         // suppress date if selected
2137         // use \@ifundefined because we cannot be sure that every document class
2138         // has a \date command
2139         if (suppress_date)
2140                 atlyxpreamble << "\\@ifundefined{date}{}{\\date{}}\n";
2141
2142         /* the user-defined preamble */
2143         if (!containsOnly(preamble, " \n\t")) {
2144                 // FIXME UNICODE
2145                 atlyxpreamble << "%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% "
2146                                  "User specified LaTeX commands.\n";
2147
2148                 // Check if the user preamble contains uncodable glyphs
2149                 odocstringstream user_preamble;
2150                 docstring uncodable_glyphs;
2151                 Encoding const * const enc = features.runparams().encoding;
2152                 if (enc) {
2153                         for (size_t n = 0; n < preamble.size(); ++n) {
2154                                 char_type c = preamble[n];
2155                                 if (!enc->encodable(c)) {
2156                                         docstring const glyph(1, c);
2157                                         LYXERR0("Uncodable character '"
2158                                                 << glyph
2159                                                 << "' in user preamble!");
2160                                         uncodable_glyphs += glyph;
2161                                         if (features.runparams().dryrun) {
2162                                                 user_preamble << "<" << _("LyX Warning: ")
2163                                                    << _("uncodable character") << " '";
2164                                                 user_preamble.put(c);
2165                                                 user_preamble << "'>";
2166                                         }
2167                                 } else
2168                                         user_preamble.put(c);
2169                         }
2170                 } else
2171                         user_preamble << preamble;
2172
2173                 // On BUFFER_VIEW|UPDATE, warn user if we found uncodable glyphs
2174                 if (!features.runparams().dryrun && !uncodable_glyphs.empty()) {
2175                         frontend::Alert::warning(
2176                                 _("Uncodable character in user preamble"),
2177                                 support::bformat(
2178                                   _("The user preamble of your document contains glyphs "
2179                                     "that are unknown in the current document encoding "
2180                                     "(namely %1$s).\nThese glyphs are omitted "
2181                                     " from the output, which may result in "
2182                                     "incomplete output."
2183                                     "\n\nPlease select an appropriate "
2184                                     "document encoding\n"
2185                                     "(such as utf8) or change the "
2186                                     "preamble code accordingly."),
2187                                   uncodable_glyphs));
2188                 }
2189                 atlyxpreamble << user_preamble.str() << '\n';
2190         }
2191
2192         // footmisc must be loaded after setspace
2193         // Load it here to avoid clashes with footmisc loaded in the user
2194         // preamble. For that reason we also pass the options via
2195         // \PassOptionsToPackage in getPreamble() and not here.
2196         if (features.mustProvide("footmisc"))
2197                 atlyxpreamble << "\\usepackage{footmisc}\n";
2198
2199         // subfig loads internally the LaTeX package "caption". As
2200         // caption is a very popular package, users will load it in
2201         // the preamble. Therefore we must load subfig behind the
2202         // user-defined preamble and check if the caption package was
2203         // loaded or not. For the case that caption is loaded before
2204         // subfig, there is the subfig option "caption=false". This
2205         // option also works when a koma-script class is used and
2206         // koma's own caption commands are used instead of caption. We
2207         // use \PassOptionsToPackage here because the user could have
2208         // already loaded subfig in the preamble.
2209         if (features.mustProvide("subfig"))
2210                 atlyxpreamble << "\\@ifundefined{showcaptionsetup}{}{%\n"
2211                                  " \\PassOptionsToPackage{caption=false}{subfig}}\n"
2212                                  "\\usepackage{subfig}\n";
2213
2214         // Itemize bullet settings need to be last in case the user
2215         // defines their own bullets that use a package included
2216         // in the user-defined preamble -- ARRae
2217         // Actually it has to be done much later than that
2218         // since some packages like frenchb make modifications
2219         // at \begin{document} time -- JMarc
2220         docstring bullets_def;
2221         for (int i = 0; i < 4; ++i) {
2222                 if (user_defined_bullet(i) != ITEMIZE_DEFAULTS[i]) {
2223                         if (bullets_def.empty())
2224                                 bullets_def += "\\AtBeginDocument{\n";
2225                         bullets_def += "  \\def\\labelitemi";
2226                         switch (i) {
2227                                 // `i' is one less than the item to modify
2228                         case 0:
2229                                 break;
2230                         case 1:
2231                                 bullets_def += 'i';
2232                                 break;
2233                         case 2:
2234                                 bullets_def += "ii";
2235                                 break;
2236                         case 3:
2237                                 bullets_def += 'v';
2238                                 break;
2239                         }
2240                         bullets_def += '{' +
2241                                 user_defined_bullet(i).getText()
2242                                 + "}\n";
2243                 }
2244         }
2245
2246         if (!bullets_def.empty())
2247                 atlyxpreamble << bullets_def << "}\n\n";
2248
2249         if (!atlyxpreamble.empty())
2250                 os << "\n\\makeatletter\n"
2251                    << atlyxpreamble.release()
2252                    << "\\makeatother\n\n";
2253
2254         // We try to load babel late, in case it interferes with other packages.
2255         // Jurabib, hyperref, varioref, bicaption, menukeys and listings (bug 8995)
2256         // have to be called after babel, though.
2257         if (use_babel && !features.isRequired("jurabib")
2258             && !features.isRequired("hyperref")
2259             && !features.isRequired("varioref")
2260             && !features.isRequired("japanese")) {
2261                 os << features.getBabelPresettings();
2262                 // FIXME UNICODE
2263                 os << from_utf8(babelCall(language_options.str(),
2264                                           features.needBabelLangOptions())) + '\n';
2265                 os << features.getBabelPostsettings();
2266         }
2267         if (features.isRequired("bicaption"))
2268                 os << "\\usepackage{bicaption}\n";
2269         if (!listings_params.empty()
2270             || features.mustProvide("listings")
2271             || features.mustProvide("minted")) {
2272                 if (use_minted)
2273                         os << "\\usepackage{minted}\n";
2274                 else
2275                         os << "\\usepackage{listings}\n";
2276         }
2277         string lst_params = listings_params;
2278         // If minted, do not output the language option (bug 11203)
2279         if (use_minted && contains(lst_params, "language=")) {
2280                 vector<string> opts =
2281                         getVectorFromString(lst_params, ",", false);
2282                 for (size_t i = 0; i < opts.size(); ++i) {
2283                         if (prefixIs(opts[i], "language="))
2284                                 opts.erase(opts.begin() + i--);
2285                 }
2286                 lst_params = getStringFromVector(opts, ",");
2287         }
2288         if (!lst_params.empty()) {
2289                 if (use_minted)
2290                         os << "\\setminted{";
2291                 else
2292                         os << "\\lstset{";
2293                 // do not test validity because listings_params is
2294                 // supposed to be valid
2295                 string par =
2296                         InsetListingsParams(lst_params).separatedParams(true);
2297                 os << from_utf8(par);
2298                 os << "}\n";
2299         }
2300
2301         // xunicode only needs to be loaded if tipa is used
2302         // (the rest is obsoleted by the new TU encoding).
2303         // It needs to be loaded at least after amsmath, amssymb,
2304         // esint and the other packages that provide special glyphs
2305         if (features.mustProvide("tipa") && useNonTeXFonts
2306             && !features.isProvided("xunicode")) {
2307                 // The package officially only supports XeTeX, but also works
2308                 // with LuaTeX. Thus we work around its XeTeX test.
2309                 if (features.runparams().flavor != OutputParams::XETEX) {
2310                         os << "% Pretend to xunicode that we are XeTeX\n"
2311                            << "\\def\\XeTeXpicfile{}\n";
2312                 }
2313                 os << "\\usepackage{xunicode}\n";
2314         }
2315
2316         // covington must be loaded after beamerarticle
2317         if (features.isRequired("covington"))
2318             os << "\\usepackage{covington}\n";
2319
2320         // Polyglossia must be loaded last ...
2321         if (use_polyglossia) {
2322                 // call the package
2323                 os << "\\usepackage{polyglossia}\n";
2324                 // set the main language
2325                 os << "\\setdefaultlanguage";
2326                 if (!language->polyglossiaOpts().empty())
2327                         os << "[" << from_ascii(language->polyglossiaOpts()) << "]";
2328                 os << "{" << from_ascii(language->polyglossia()) << "}\n";
2329                 // now setup the other languages
2330                 set<string> const polylangs =
2331                         features.getPolyglossiaLanguages();
2332                 for (set<string>::const_iterator mit = polylangs.begin();
2333                      mit != polylangs.end() ; ++mit) {
2334                         // We do not output the options here; they are output in
2335                         // the language switch commands. This is safer if multiple
2336                         // varieties are used.
2337                         if (*mit == language->polyglossia())
2338                                 continue;
2339                         os << "\\setotherlanguage";
2340                         os << "{" << from_ascii(*mit) << "}\n";
2341                 }
2342         }
2343
2344         // ... but before biblatex (see #7065)
2345         if (features.mustProvide("biblatex")
2346             && !features.isProvided("biblatex-natbib")
2347             && !features.isProvided("natbib-internal")
2348             && !features.isProvided("natbib")
2349             && !features.isProvided("jurabib")) {
2350                 string delim = "";
2351                 string opts;
2352                 os << "\\usepackage";
2353                 if (!biblatex_bibstyle.empty()
2354                     && (biblatex_bibstyle == biblatex_citestyle)) {
2355                         opts = "style=" + biblatex_bibstyle;
2356                         delim = ",";
2357                 } else {
2358                         if (!biblatex_bibstyle.empty()) {
2359                                 opts = "bibstyle=" + biblatex_bibstyle;
2360                                 delim = ",";
2361                         }
2362                         if (!biblatex_citestyle.empty()) {
2363                                 opts += delim + "citestyle=" + biblatex_citestyle;
2364                                 delim = ",";
2365                         }
2366                 }
2367                 if (!multibib.empty() && multibib != "child") {
2368                         opts += delim + "refsection=" + multibib;
2369                         delim = ",";
2370                 }
2371                 if (bibtexCommand() == "bibtex8"
2372                     || prefixIs(bibtexCommand(), "bibtex8 ")) {
2373                         opts += delim + "backend=bibtex8";
2374                         delim = ",";
2375                 } else if (bibtexCommand() == "bibtex"
2376                            || prefixIs(bibtexCommand(), "bibtex ")) {
2377                         opts += delim + "backend=bibtex";
2378                         delim = ",";
2379                 }
2380                 if (!bib_encoding.empty() && encodings.fromLyXName(bib_encoding)) {
2381                         opts += delim + "bibencoding="
2382                                 + encodings.fromLyXName(bib_encoding)->latexName();
2383                         delim = ",";
2384                 }
2385                 if (!biblio_opts.empty())
2386                         opts += delim + biblio_opts;
2387                 if (!opts.empty())
2388                         os << "[" << opts << "]";
2389                 os << "{biblatex}\n";
2390         }
2391
2392
2393         // Load custom language package here
2394         if (features.langPackage() == LaTeXFeatures::LANG_PACK_CUSTOM) {
2395                 if (lang_package == "default")
2396                         os << from_utf8(lyxrc.language_custom_package);
2397                 else
2398                         os << from_utf8(lang_package);
2399                 os << '\n';
2400         }
2401
2402         // Since menukeys uses catoptions, which does some heavy changes on key-value options,
2403         // it is recommended to load menukeys as the last package (even after hyperref)
2404         if (features.isRequired("menukeys"))
2405                 os << "\\usepackage{menukeys}\n";
2406
2407         docstring const i18npreamble =
2408                 features.getTClassI18nPreamble(use_babel, use_polyglossia,
2409                                                use_minted);
2410         if (!i18npreamble.empty())
2411                 os << i18npreamble + '\n';
2412
2413         return use_babel;
2414 }
2415
2416
2417 void BufferParams::useClassDefaults()
2418 {
2419         DocumentClass const & tclass = documentClass();
2420
2421         sides = tclass.sides();
2422         columns = tclass.columns();
2423         pagestyle = tclass.pagestyle();
2424         use_default_options = true;
2425         // Only if class has a ToC hierarchy
2426         if (tclass.hasTocLevels()) {
2427                 secnumdepth = tclass.secnumdepth();
2428                 tocdepth = tclass.tocdepth();
2429         }
2430 }
2431
2432
2433 bool BufferParams::hasClassDefaults() const
2434 {
2435         DocumentClass const & tclass = documentClass();
2436
2437         return sides == tclass.sides()
2438                 && columns == tclass.columns()
2439                 && pagestyle == tclass.pagestyle()
2440                 && use_default_options
2441                 && secnumdepth == tclass.secnumdepth()
2442                 && tocdepth == tclass.tocdepth();
2443 }
2444
2445
2446 DocumentClass const & BufferParams::documentClass() const
2447 {
2448         return *doc_class_;
2449 }
2450
2451
2452 DocumentClassConstPtr BufferParams::documentClassPtr() const
2453 {
2454         return doc_class_;
2455 }
2456
2457
2458 void BufferParams::setDocumentClass(DocumentClassConstPtr tc)
2459 {
2460         // evil, but this function is evil
2461         doc_class_ = const_pointer_cast<DocumentClass>(tc);
2462         invalidateConverterCache();
2463 }
2464
2465
2466 bool BufferParams::setBaseClass(string const & classname, string const & path)
2467 {
2468         LYXERR(Debug::TCLASS, "setBaseClass: " << classname);
2469         LayoutFileList & bcl = LayoutFileList::get();
2470         if (!bcl.haveClass(classname)) {
2471                 docstring s =
2472                         bformat(_("The layout file:\n"
2473                                 "%1$s\n"
2474                                 "could not be found. A default textclass with default\n"
2475                                 "layouts will be used. LyX will not be able to produce\n"
2476                                 "correct output."),
2477                         from_utf8(classname));
2478                 frontend::Alert::error(_("Document class not found"), s);
2479                 bcl.addEmptyClass(classname);
2480         }
2481
2482         bool const success = bcl[classname].load(path);
2483         if (!success) {
2484                 docstring s =
2485                         bformat(_("Due to some error in it, the layout file:\n"
2486                                 "%1$s\n"
2487                                 "could not be loaded. A default textclass with default\n"
2488                                 "layouts will be used. LyX will not be able to produce\n"
2489                                 "correct output."),
2490                         from_utf8(classname));
2491                 frontend::Alert::error(_("Could not load class"), s);
2492                 bcl.addEmptyClass(classname);
2493         }
2494
2495         pimpl_->baseClass_ = classname;
2496         layout_modules_.adaptToBaseClass(baseClass(), removed_modules_);
2497         return true;
2498 }
2499
2500
2501 LayoutFile const * BufferParams::baseClass() const
2502 {
2503         if (LayoutFileList::get().haveClass(pimpl_->baseClass_))
2504                 return &(LayoutFileList::get()[pimpl_->baseClass_]);
2505         else
2506                 return 0;
2507 }
2508
2509
2510 LayoutFileIndex const & BufferParams::baseClassID() const
2511 {
2512         return pimpl_->baseClass_;
2513 }
2514
2515
2516 void BufferParams::makeDocumentClass(bool const clone)
2517 {
2518         if (!baseClass())
2519                 return;
2520
2521         invalidateConverterCache();
2522         LayoutModuleList mods;
2523         LayoutModuleList::iterator it = layout_modules_.begin();
2524         LayoutModuleList::iterator en = layout_modules_.end();
2525         for (; it != en; ++it)
2526                 mods.push_back(*it);
2527
2528         doc_class_ = getDocumentClass(*baseClass(), mods, cite_engine_, clone);
2529
2530         TextClass::ReturnValues success = TextClass::OK;
2531         if (!forced_local_layout_.empty())
2532                 success = doc_class_->read(to_utf8(forced_local_layout_),
2533                                            TextClass::MODULE);
2534         if (!local_layout_.empty() &&
2535             (success == TextClass::OK || success == TextClass::OK_OLDFORMAT))
2536                 success = doc_class_->read(to_utf8(local_layout_), TextClass::MODULE);
2537         if (success != TextClass::OK && success != TextClass::OK_OLDFORMAT) {
2538                 docstring const msg = _("Error reading internal layout information");
2539                 frontend::Alert::warning(_("Read Error"), msg);
2540         }
2541 }
2542
2543
2544 bool BufferParams::layoutModuleCanBeAdded(string const & modName) const
2545 {
2546         return layout_modules_.moduleCanBeAdded(modName, baseClass());
2547 }
2548
2549
2550 docstring BufferParams::getLocalLayout(bool forced) const
2551 {
2552         if (forced)
2553                 return from_utf8(doc_class_->forcedLayouts());
2554         else
2555                 return local_layout_;
2556 }
2557
2558
2559 void BufferParams::setLocalLayout(docstring const & layout, bool forced)
2560 {
2561         if (forced)
2562                 forced_local_layout_ = layout;
2563         else
2564                 local_layout_ = layout;
2565 }
2566
2567
2568 bool BufferParams::addLayoutModule(string const & modName)
2569 {
2570         LayoutModuleList::const_iterator it = layout_modules_.begin();
2571         LayoutModuleList::const_iterator end = layout_modules_.end();
2572         for (; it != end; ++it)
2573                 if (*it == modName)
2574                         return false;
2575         layout_modules_.push_back(modName);
2576         return true;
2577 }
2578
2579
2580 string BufferParams::bufferFormat() const
2581 {
2582         return documentClass().outputFormat();
2583 }
2584
2585
2586 bool BufferParams::isExportable(string const & format, bool need_viewable) const
2587 {
2588         FormatList const & formats = exportableFormats(need_viewable);
2589         FormatList::const_iterator fit = formats.begin();
2590         FormatList::const_iterator end = formats.end();
2591         for (; fit != end ; ++fit) {
2592                 if ((*fit)->name() == format)
2593                         return true;
2594         }
2595         return false;
2596 }
2597
2598
2599 FormatList const & BufferParams::exportableFormats(bool only_viewable) const
2600 {
2601         FormatList & cached = only_viewable ?
2602                         pimpl_->viewableFormatList : pimpl_->exportableFormatList;
2603         bool & valid = only_viewable ?
2604                         pimpl_->isViewCacheValid : pimpl_->isExportCacheValid;
2605         if (valid)
2606                 return cached;
2607
2608         vector<string> const backs = backends();
2609         set<string> excludes;
2610         if (useNonTeXFonts) {
2611                 excludes.insert("latex");
2612                 excludes.insert("pdflatex");
2613         }
2614         FormatList result =
2615                 theConverters().getReachable(backs[0], only_viewable, true, excludes);
2616         for (vector<string>::const_iterator it = backs.begin() + 1;
2617              it != backs.end(); ++it) {
2618                 FormatList r = theConverters().getReachable(*it, only_viewable,
2619                                 false, excludes);
2620                 result.insert(result.end(), r.begin(), r.end());
2621         }
2622         sort(result.begin(), result.end(), Format::formatSorter);
2623         cached = result;
2624         valid = true;
2625         return cached;
2626 }
2627
2628
2629 vector<string> BufferParams::backends() const
2630 {
2631         vector<string> v;
2632         string const buffmt = bufferFormat();
2633
2634         // FIXME: Don't hardcode format names here, but use a flag
2635         if (buffmt == "latex") {
2636                 if (encoding().package() == Encoding::japanese)
2637                         v.push_back("platex");
2638                 else {
2639                         if (!useNonTeXFonts) {
2640                                 v.push_back("pdflatex");
2641                                 v.push_back("latex");
2642                         }
2643                         v.push_back("xetex");
2644                         v.push_back("luatex");
2645                         v.push_back("dviluatex");
2646                 }
2647         } else {
2648                 string rbuffmt = buffmt;
2649                 // If we use an OutputFormat in Japanese docs,
2650                 // we need special format in order to get the path
2651                 // via pLaTeX (#8823)
2652                 if (documentClass().hasOutputFormat()
2653                     && encoding().package() == Encoding::japanese)
2654                         rbuffmt += "-ja";
2655                 v.push_back(rbuffmt);
2656         }
2657
2658         v.push_back("xhtml");
2659         v.push_back("text");
2660         v.push_back("lyx");
2661         return v;
2662 }
2663
2664
2665 OutputParams::FLAVOR BufferParams::getOutputFlavor(string const & format) const
2666 {
2667         string const dformat = (format.empty() || format == "default") ?
2668                 getDefaultOutputFormat() : format;
2669         DefaultFlavorCache::const_iterator it =
2670                 default_flavors_.find(dformat);
2671
2672         if (it != default_flavors_.end())
2673                 return it->second;
2674
2675         OutputParams::FLAVOR result = OutputParams::LATEX;
2676
2677         // FIXME It'd be better not to hardcode this, but to do
2678         //       something with formats.
2679         if (dformat == "xhtml")
2680                 result = OutputParams::HTML;
2681         else if (dformat == "text")
2682                 result = OutputParams::TEXT;
2683         else if (dformat == "lyx")
2684                 result = OutputParams::LYX;
2685         else if (dformat == "pdflatex")
2686                 result = OutputParams::PDFLATEX;
2687         else if (dformat == "xetex")
2688                 result = OutputParams::XETEX;
2689         else if (dformat == "luatex")
2690                 result = OutputParams::LUATEX;
2691         else if (dformat == "dviluatex")
2692                 result = OutputParams::DVILUATEX;
2693         else {
2694                 // Try to determine flavor of default output format
2695                 vector<string> backs = backends();
2696                 if (find(backs.begin(), backs.end(), dformat) == backs.end()) {
2697                         // Get shortest path to format
2698                         Graph::EdgePath path;
2699                         for (auto const & bvar : backs) {
2700                                 Graph::EdgePath p = theConverters().getPath(bvar, dformat);
2701                                 if (!p.empty() && (path.empty() || p.size() < path.size())) {
2702                                         path = p;
2703                                 }
2704                         }
2705                         if (!path.empty())
2706                                 result = theConverters().getFlavor(path);
2707                 }
2708         }
2709         // cache this flavor
2710         default_flavors_[dformat] = result;
2711         return result;
2712 }
2713
2714
2715 string BufferParams::getDefaultOutputFormat() const
2716 {
2717         if (!default_output_format.empty()
2718             && default_output_format != "default")
2719                 return default_output_format;
2720         if (isDocBook()) {
2721                 FormatList const & formats = exportableFormats(true);
2722                 if (formats.empty())
2723                         return string();
2724                 // return the first we find
2725                 return formats.front()->name();
2726         }
2727         if (encoding().package() == Encoding::japanese)
2728                 return lyxrc.default_platex_view_format;
2729         if (useNonTeXFonts)
2730                 return lyxrc.default_otf_view_format;
2731         return lyxrc.default_view_format;
2732 }
2733
2734 Font const BufferParams::getFont() const
2735 {
2736         FontInfo f = documentClass().defaultfont();
2737         if (fonts_default_family == "rmdefault")
2738                 f.setFamily(ROMAN_FAMILY);
2739         else if (fonts_default_family == "sfdefault")
2740                 f.setFamily(SANS_FAMILY);
2741         else if (fonts_default_family == "ttdefault")
2742                 f.setFamily(TYPEWRITER_FAMILY);
2743         return Font(f, language);
2744 }
2745
2746
2747 InsetQuotesParams::QuoteStyle BufferParams::getQuoteStyle(string const & qs) const
2748 {
2749         return quotesstyletranslator().find(qs);
2750 }
2751
2752
2753 bool BufferParams::isLatex() const
2754 {
2755         return documentClass().outputType() == LATEX;
2756 }
2757
2758
2759 bool BufferParams::isLiterate() const
2760 {
2761         return documentClass().outputType() == LITERATE;
2762 }
2763
2764
2765 bool BufferParams::isDocBook() const
2766 {
2767         return documentClass().outputType() == DOCBOOK;
2768 }
2769
2770
2771 void BufferParams::readPreamble(Lexer & lex)
2772 {
2773         if (lex.getString() != "\\begin_preamble")
2774                 lyxerr << "Error (BufferParams::readPreamble):"
2775                         "consistency check failed." << endl;
2776
2777         preamble = lex.getLongString(from_ascii("\\end_preamble"));
2778 }
2779
2780
2781 void BufferParams::readLocalLayout(Lexer & lex, bool forced)
2782 {
2783         string const expected = forced ? "\\begin_forced_local_layout" :
2784                                          "\\begin_local_layout";
2785         if (lex.getString() != expected)
2786                 lyxerr << "Error (BufferParams::readLocalLayout):"
2787                         "consistency check failed." << endl;
2788
2789         if (forced)
2790                 forced_local_layout_ =
2791                         lex.getLongString(from_ascii("\\end_forced_local_layout"));
2792         else
2793                 local_layout_ = lex.getLongString(from_ascii("\\end_local_layout"));
2794 }
2795
2796
2797 bool BufferParams::setLanguage(string const & lang)
2798 {
2799         Language const *new_language = languages.getLanguage(lang);
2800         if (!new_language) {
2801                 // Language lang was not found
2802                 return false;
2803         }
2804         language = new_language;
2805         return true;
2806 }
2807
2808
2809 void BufferParams::readLanguage(Lexer & lex)
2810 {
2811         if (!lex.next()) return;
2812
2813         string const tmptok = lex.getString();
2814
2815         // check if tmptok is part of tex_babel in tex-defs.h
2816         if (!setLanguage(tmptok)) {
2817                 // Language tmptok was not found
2818                 language = default_language;
2819                 lyxerr << "Warning: Setting language `"
2820                        << tmptok << "' to `" << language->lang()
2821                        << "'." << endl;
2822         }
2823 }
2824
2825
2826 void BufferParams::readGraphicsDriver(Lexer & lex)
2827 {
2828         if (!lex.next())
2829                 return;
2830
2831         string const tmptok = lex.getString();
2832         // check if tmptok is part of tex_graphics in tex_defs.h
2833         int n = 0;
2834         while (true) {
2835                 string const test = tex_graphics[n++];
2836
2837                 if (test == tmptok) {
2838                         graphics_driver = tmptok;
2839                         break;
2840                 }
2841                 if (test.empty()) {
2842                         lex.printError(
2843                                 "Warning: graphics driver `$$Token' not recognized!\n"
2844                                 "         Setting graphics driver to `default'.\n");
2845                         graphics_driver = "default";
2846                         break;
2847                 }
2848         }
2849 }
2850
2851
2852 void BufferParams::readBullets(Lexer & lex)
2853 {
2854         if (!lex.next())
2855                 return;
2856
2857         int const index = lex.getInteger();
2858         lex.next();
2859         int temp_int = lex.getInteger();
2860         user_defined_bullet(index).setFont(temp_int);
2861         temp_bullet(index).setFont(temp_int);
2862         lex >> temp_int;
2863         user_defined_bullet(index).setCharacter(temp_int);
2864         temp_bullet(index).setCharacter(temp_int);
2865         lex >> temp_int;
2866         user_defined_bullet(index).setSize(temp_int);
2867         temp_bullet(index).setSize(temp_int);
2868 }
2869
2870
2871 void BufferParams::readBulletsLaTeX(Lexer & lex)
2872 {
2873         // The bullet class should be able to read this.
2874         if (!lex.next())
2875                 return;
2876         int const index = lex.getInteger();
2877         lex.next(true);
2878         docstring const temp_str = lex.getDocString();
2879
2880         user_defined_bullet(index).setText(temp_str);
2881         temp_bullet(index).setText(temp_str);
2882 }
2883
2884
2885 void BufferParams::readModules(Lexer & lex)
2886 {
2887         if (!lex.eatLine()) {
2888                 lyxerr << "Error (BufferParams::readModules):"
2889                                 "Unexpected end of input." << endl;
2890                 return;
2891         }
2892         while (true) {
2893                 string mod = lex.getString();
2894                 if (mod == "\\end_modules")
2895                         break;
2896                 addLayoutModule(mod);
2897                 lex.eatLine();
2898         }
2899 }
2900
2901
2902 void BufferParams::readRemovedModules(Lexer & lex)
2903 {
2904         if (!lex.eatLine()) {
2905                 lyxerr << "Error (BufferParams::readRemovedModules):"
2906                                 "Unexpected end of input." << endl;
2907                 return;
2908         }
2909         while (true) {
2910                 string mod = lex.getString();
2911                 if (mod == "\\end_removed_modules")
2912                         break;
2913                 removed_modules_.push_back(mod);
2914                 lex.eatLine();
2915         }
2916         // now we want to remove any removed modules that were previously
2917         // added. normally, that will be because default modules were added in
2918         // setBaseClass(), which gets called when \textclass is read at the
2919         // start of the read.
2920         list<string>::const_iterator rit = removed_modules_.begin();
2921         list<string>::const_iterator const ren = removed_modules_.end();
2922         for (; rit != ren; ++rit) {
2923                 LayoutModuleList::iterator const mit = layout_modules_.begin();
2924                 LayoutModuleList::iterator const men = layout_modules_.end();
2925                 LayoutModuleList::iterator found = find(mit, men, *rit);
2926                 if (found == men)
2927                         continue;
2928                 layout_modules_.erase(found);
2929         }
2930 }
2931
2932
2933 void BufferParams::readIncludeonly(Lexer & lex)
2934 {
2935         if (!lex.eatLine()) {
2936                 lyxerr << "Error (BufferParams::readIncludeonly):"
2937                                 "Unexpected end of input." << endl;
2938                 return;
2939         }
2940         while (true) {
2941                 string child = lex.getString();
2942                 if (child == "\\end_includeonly")
2943                         break;
2944                 included_children_.push_back(child);
2945                 lex.eatLine();
2946         }
2947 }
2948
2949
2950 string BufferParams::paperSizeName(PapersizePurpose purpose) const
2951 {
2952         switch (papersize) {
2953         case PAPER_DEFAULT:
2954                 // could be anything, so don't guess
2955                 return string();
2956         case PAPER_CUSTOM: {
2957                 if (purpose == XDVI && !paperwidth.empty() &&
2958                     !paperheight.empty()) {
2959                         // heightxwidth<unit>
2960                         string first = paperwidth;
2961                         string second = paperheight;
2962                         if (orientation == ORIENTATION_LANDSCAPE)
2963                                 first.swap(second);
2964                         // cut off unit.
2965                         return first.erase(first.length() - 2)
2966                                 + "x" + second;
2967                 }
2968                 return string();
2969         }
2970         case PAPER_A0:
2971                 // dvips and dvipdfm do not know this
2972                 if (purpose == DVIPS || purpose == DVIPDFM)
2973                         return string();
2974                 return "a0";
2975         case PAPER_A1:
2976                 if (purpose == DVIPS || purpose == DVIPDFM)
2977                         return string();
2978                 return "a1";
2979         case PAPER_A2:
2980                 if (purpose == DVIPS || purpose == DVIPDFM)
2981                         return string();
2982                 return "a2";
2983         case PAPER_A3:
2984                 return "a3";
2985         case PAPER_A4:
2986                 return "a4";
2987         case PAPER_A5:
2988                 return "a5";
2989         case PAPER_A6:
2990                 if (purpose == DVIPS || purpose == DVIPDFM)
2991                         return string();
2992                 return "a6";
2993         case PAPER_B0:
2994                 if (purpose == DVIPS || purpose == DVIPDFM)
2995                         return string();
2996                 return "b0";
2997         case PAPER_B1:
2998                 if (purpose == DVIPS || purpose == DVIPDFM)
2999                         return string();
3000                 return "b1";
3001         case PAPER_B2:
3002                 if (purpose == DVIPS || purpose == DVIPDFM)
3003                         return string();
3004                 return "b2";
3005         case PAPER_B3:
3006                 if (purpose == DVIPS || purpose == DVIPDFM)
3007                         return string();
3008                 return "b3";
3009         case PAPER_B4:
3010                 // dvipdfm does not know this
3011                 if (purpose == DVIPDFM)
3012                         return string();
3013                 return "b4";
3014         case PAPER_B5:
3015                 if (purpose == DVIPDFM)
3016                         return string();
3017                 return "b5";
3018         case PAPER_B6:
3019                 if (purpose == DVIPS || purpose == DVIPDFM)
3020                         return string();
3021                 return "b6";
3022         case PAPER_C0:
3023                 if (purpose == DVIPS || purpose == DVIPDFM)
3024                         return string();
3025                 return "c0";
3026         case PAPER_C1:
3027                 if (purpose == DVIPS || purpose == DVIPDFM)
3028                         return string();
3029                 return "c1";
3030         case PAPER_C2:
3031                 if (purpose == DVIPS || purpose == DVIPDFM)
3032                         return string();
3033                 return "c2";
3034         case PAPER_C3:
3035                 if (purpose == DVIPS || purpose == DVIPDFM)
3036                         return string();
3037                 return "c3";
3038         case PAPER_C4:
3039                 if (purpose == DVIPS || purpose == DVIPDFM)
3040                         return string();
3041                 return "c4";
3042         case PAPER_C5:
3043                 if (purpose == DVIPS || purpose == DVIPDFM)
3044                         return string();
3045                 return "c5";
3046         case PAPER_C6:
3047                 if (purpose == DVIPS || purpose == DVIPDFM)
3048                         return string();
3049                 return "c6";
3050         case PAPER_JISB0:
3051                 if (purpose == DVIPS || purpose == DVIPDFM)
3052                         return string();
3053                 return "jisb0";
3054         case PAPER_JISB1:
3055                 if (purpose == DVIPS || purpose == DVIPDFM)
3056                         return string();
3057                 return "jisb1";
3058         case PAPER_JISB2:
3059                 if (purpose == DVIPS || purpose == DVIPDFM)
3060                         return string();
3061                 return "jisb2";
3062         case PAPER_JISB3:
3063                 if (purpose == DVIPS || purpose == DVIPDFM)
3064                         return string();
3065                 return "jisb3";
3066         case PAPER_JISB4:
3067                 if (purpose == DVIPS || purpose == DVIPDFM)
3068                         return string();
3069                 return "jisb4";
3070         case PAPER_JISB5:
3071                 if (purpose == DVIPS || purpose == DVIPDFM)
3072                         return string();
3073                 return "jisb5";
3074         case PAPER_JISB6:
3075                 if (purpose == DVIPS || purpose == DVIPDFM)
3076                         return string();
3077                 return "jisb6";
3078         case PAPER_USEXECUTIVE:
3079                 // dvipdfm does not know this
3080                 if (purpose == DVIPDFM)
3081                         return string();
3082                 return "foolscap";
3083         case PAPER_USLEGAL:
3084                 return "legal";
3085         case PAPER_USLETTER:
3086         default:
3087                 if (purpose == XDVI)
3088                         return "us";
3089                 return "letter";
3090         }
3091 }
3092
3093
3094 string const BufferParams::dvips_options() const
3095 {
3096         string result;
3097
3098         // If the class loads the geometry package, we do not know which
3099         // paper size is used, since we do not set it (bug 7013).
3100         // Therefore we must not specify any argument here.
3101         // dvips gets the correct paper size via DVI specials in this case
3102         // (if the class uses the geometry package correctly).
3103         if (documentClass().provides("geometry"))
3104                 return result;
3105
3106         if (use_geometry
3107             && papersize == PAPER_CUSTOM
3108             && !lyxrc.print_paper_dimension_flag.empty()
3109             && !paperwidth.empty()
3110             && !paperheight.empty()) {
3111                 // using a custom papersize
3112                 result = lyxrc.print_paper_dimension_flag;
3113                 result += ' ' + paperwidth;
3114                 result += ',' + paperheight;
3115         } else {
3116                 string const paper_option = paperSizeName(DVIPS);
3117                 if (!paper_option.empty() && (paper_option != "letter" ||
3118                     orientation != ORIENTATION_LANDSCAPE)) {
3119                         // dvips won't accept -t letter -t landscape.
3120                         // In all other cases, include the paper size
3121                         // explicitly.
3122                         result = lyxrc.print_paper_flag;
3123                         result += ' ' + paper_option;
3124                 }
3125         }
3126         if (orientation == ORIENTATION_LANDSCAPE &&
3127             papersize != PAPER_CUSTOM)
3128                 result += ' ' + lyxrc.print_landscape_flag;
3129         return result;
3130 }
3131
3132
3133 string const BufferParams::main_font_encoding() const
3134 {
3135         if (font_encodings().empty()) {
3136                 if (ascii_lowercase(language->fontenc(*this)) == "none")
3137                         return "none";
3138                 return "default";
3139         }
3140         return font_encodings().back();
3141 }
3142
3143
3144 vector<string> const BufferParams::font_encodings() const
3145 {
3146         string doc_fontenc = (fontenc == "auto") ? string() : fontenc;
3147
3148         vector<string> fontencs;
3149
3150         // "default" means "no explicit font encoding"
3151         if (doc_fontenc != "default") {
3152                 if (!doc_fontenc.empty())
3153                         // If we have a custom setting, we use only that!
3154                         return getVectorFromString(doc_fontenc);
3155                 if (!language->fontenc(*this).empty()
3156                     && ascii_lowercase(language->fontenc(*this)) != "none") {
3157                         vector<string> fencs = getVectorFromString(language->fontenc(*this));
3158                         for (auto & fe : fencs) {
3159                                 if (find(fontencs.begin(), fontencs.end(), fe) == fontencs.end())
3160                                         fontencs.push_back(fe);
3161                         }
3162                 }
3163         }
3164
3165         return fontencs;
3166 }
3167
3168
3169 string BufferParams::babelCall(string const & lang_opts, bool const langoptions) const
3170 {
3171         // suppress the babel call if there is no BabelName defined
3172         // for the document language in the lib/languages file and if no
3173         // other languages are used (lang_opts is then empty)
3174         if (lang_opts.empty())
3175                 return string();
3176         // either a specific language (AsBabelOptions setting in
3177         // lib/languages) or the prefs require the languages to
3178         // be submitted to babel itself (not the class).
3179         if (langoptions)
3180                 return "\\usepackage[" + lang_opts + "]{babel}";
3181         return "\\usepackage{babel}";
3182 }
3183
3184
3185 docstring BufferParams::getGraphicsDriver(string const & package) const
3186 {
3187         docstring result;
3188
3189         if (package == "geometry") {
3190                 if (graphics_driver == "dvips"
3191                     || graphics_driver == "dvipdfm"
3192                     || graphics_driver == "pdftex"
3193                     || graphics_driver == "vtex")
3194                         result = from_ascii(graphics_driver);
3195                 else if (graphics_driver == "dvipdfmx")
3196                         result = from_ascii("dvipdfm");
3197         }
3198
3199         return result;
3200 }
3201
3202
3203 void BufferParams::writeEncodingPreamble(otexstream & os,
3204                                          LaTeXFeatures & features) const
3205 {
3206         // XeTeX/LuaTeX: (see also #9740)
3207         // With Unicode fonts we use utf8-plain without encoding package.
3208         // With TeX fonts, we cannot use utf8-plain, but "inputenc" fails.
3209         // XeTeX must use ASCII encoding (see Buffer.cpp),
3210         //  for LuaTeX, we load "luainputenc" (see below).
3211         if (useNonTeXFonts || features.runparams().flavor == OutputParams::XETEX)
3212                 return;
3213
3214         if (inputenc == "auto") {
3215                 string const doc_encoding =
3216                         language->encoding()->latexName();
3217                 Encoding::Package const package =
3218                         language->encoding()->package();
3219
3220                 // Create list of inputenc options:
3221                 set<string> encoding_set;
3222                 // luainputenc fails with more than one encoding
3223                 if (!features.runparams().isFullUnicode()) // if we reach this point, this means LuaTeX with TeX fonts
3224                         // list all input encodings used in the document
3225                         encoding_set = features.getEncodingSet(doc_encoding);
3226
3227                 // If the "japanese" package (i.e. pLaTeX) is used,
3228                 // inputenc must be omitted.
3229                 // see http://www.mail-archive.com/lyx-devel@lists.lyx.org/msg129680.html
3230                 if ((!encoding_set.empty() || package == Encoding::inputenc)
3231                     && !features.isRequired("japanese")
3232                     && !features.isProvided("inputenc")) {
3233                         os << "\\usepackage[";
3234                         set<string>::const_iterator it = encoding_set.begin();
3235                         set<string>::const_iterator const end = encoding_set.end();
3236                         if (it != end) {
3237                                 os << from_ascii(*it);
3238                                 ++it;
3239                         }
3240                         for (; it != end; ++it)
3241                                 os << ',' << from_ascii(*it);
3242                         if (package == Encoding::inputenc) {
3243                                 if (!encoding_set.empty())
3244                                         os << ',';
3245                                 os << from_ascii(doc_encoding);
3246                         }
3247                         if (features.runparams().flavor == OutputParams::LUATEX
3248                             || features.runparams().flavor == OutputParams::DVILUATEX)
3249                                 os << "]{luainputenc}\n";
3250                         else
3251                                 os << "]{inputenc}\n";
3252                 }
3253         } else if (inputenc != "default") {
3254                 switch (encoding().package()) {
3255                 case Encoding::none:
3256                 case Encoding::CJK:
3257                 case Encoding::japanese:
3258                         if (encoding().iconvName() != "UTF-8")
3259                           // don't default to [utf8]{inputenc} with TeXLive >= 18
3260                           os << "\\ifdefined\\UseRawInputEncoding\n"
3261                                  << "  \\UseRawInputEncoding\\fi\n";
3262                         break;
3263                 case Encoding::inputenc:
3264                         // do not load inputenc if japanese is used
3265                         // or if the class provides inputenc
3266                         if (features.isRequired("japanese")
3267                             || features.isProvided("inputenc"))
3268                                 break;
3269                         os << "\\usepackage[" << from_ascii(encoding().latexName());
3270                         if (features.runparams().flavor == OutputParams::LUATEX
3271                             || features.runparams().flavor == OutputParams::DVILUATEX)
3272                                 os << "]{luainputenc}\n";
3273                         else
3274                                 os << "]{inputenc}\n";
3275                         break;
3276                 }
3277         }
3278         if (inputenc == "default" or features.isRequired("japanese")) {
3279                 // don't default to [utf8]{inputenc} with TeXLive >= 18
3280                 os << "\\ifdefined\\UseRawInputEncoding\n";
3281                 os << "  \\UseRawInputEncoding\\fi\n";
3282         }
3283 }
3284
3285
3286 string const BufferParams::parseFontName(string const & name) const
3287 {
3288         string mangled = name;
3289         size_t const idx = mangled.find('[');
3290         if (idx == string::npos || idx == 0)
3291                 return mangled;
3292         else
3293                 return mangled.substr(0, idx - 1);
3294 }
3295
3296
3297 string const BufferParams::loadFonts(LaTeXFeatures & features) const
3298 {
3299         if (fontsRoman() == "default" && fontsSans() == "default"
3300             && fontsTypewriter() == "default"
3301             && (fontsMath() == "default" || fontsMath() == "auto"))
3302                 //nothing to do
3303                 return string();
3304
3305         ostringstream os;
3306
3307         /* Fontspec (XeTeX, LuaTeX): we provide GUI support for oldstyle
3308          * numbers (Numbers=OldStyle) and sf/tt scaling. The Ligatures=TeX/
3309          * Mapping=tex-text option assures TeX ligatures (such as "--")
3310          * are resolved. Note that tt does not use these ligatures.
3311          * TODO:
3312          *    -- add more GUI options?
3313          *    -- add more fonts (fonts for other scripts)
3314          *    -- if there's a way to find out if a font really supports
3315          *       OldStyle, enable/disable the widget accordingly.
3316         */
3317         if (useNonTeXFonts && features.isAvailable("fontspec")) {
3318                 // "Mapping=tex-text" and "Ligatures=TeX" are equivalent.
3319                 // However, until v.2 (2010/07/11) fontspec only knew
3320                 // Mapping=tex-text (for XeTeX only); then "Ligatures=TeX"
3321                 // was introduced for both XeTeX and LuaTeX (LuaTeX
3322                 // didn't understand "Mapping=tex-text", while XeTeX
3323                 // understood both. With most recent versions, both
3324                 // variants are understood by both engines. However,
3325                 // we want to provide support for at least TeXLive 2009
3326                 // (for XeTeX; LuaTeX is only supported as of v.2)
3327                 string const texmapping =
3328                         (features.runparams().flavor == OutputParams::XETEX) ?
3329                         "Mapping=tex-text" : "Ligatures=TeX";
3330                 if (fontsRoman() != "default") {
3331                         os << "\\setmainfont[" << texmapping;
3332                         if (fonts_old_figures)
3333                                 os << ",Numbers=OldStyle";
3334                         os << "]{" << parseFontName(fontsRoman()) << "}\n";
3335                 }
3336                 if (fontsSans() != "default") {
3337                         string const sans = parseFontName(fontsSans());
3338                         if (fontsSansScale() != 100)
3339                                 os << "\\setsansfont[Scale="
3340                                    << float(fontsSansScale()) / 100
3341                                    << "," << texmapping << "]{"
3342                                    << sans << "}\n";
3343                         else
3344                                 os << "\\setsansfont[" << texmapping << "]{"
3345                                    << sans << "}\n";
3346                 }
3347                 if (fontsTypewriter() != "default") {
3348                         string const mono = parseFontName(fontsTypewriter());
3349                         if (fontsTypewriterScale() != 100)
3350                                 os << "\\setmonofont[Scale="
3351                                    << float(fontsTypewriterScale()) / 100
3352                                    << "]{"
3353                                    << mono << "}\n";
3354                         else
3355                                 os << "\\setmonofont{"
3356                                    << mono << "}\n";
3357                 }
3358                 return os.str();
3359         }
3360
3361         // Tex Fonts
3362         bool const ot1 = (main_font_encoding() == "default" || main_font_encoding() == "OT1");
3363         bool const dryrun = features.runparams().dryrun;
3364         bool const complete = (fontsSans() == "default" && fontsTypewriter() == "default");
3365         bool const nomath = (fontsMath() == "default");
3366
3367         // ROMAN FONTS
3368         os << theLaTeXFonts().getLaTeXFont(from_ascii(fontsRoman())).getLaTeXCode(
3369                 dryrun, ot1, complete, fonts_expert_sc, fonts_old_figures,
3370                 nomath);
3371
3372         // SANS SERIF
3373         os << theLaTeXFonts().getLaTeXFont(from_ascii(fontsSans())).getLaTeXCode(
3374                 dryrun, ot1, complete, fonts_expert_sc, fonts_old_figures,
3375                 nomath, fontsSansScale());
3376
3377         // MONOSPACED/TYPEWRITER
3378         os << theLaTeXFonts().getLaTeXFont(from_ascii(fontsTypewriter())).getLaTeXCode(
3379                 dryrun, ot1, complete, fonts_expert_sc, fonts_old_figures,
3380                 nomath, fontsTypewriterScale());
3381
3382         // MATH
3383         os << theLaTeXFonts().getLaTeXFont(from_ascii(fontsMath())).getLaTeXCode(
3384                 dryrun, ot1, complete, fonts_expert_sc, fonts_old_figures,
3385                 nomath);
3386
3387         return os.str();
3388 }
3389
3390
3391 Encoding const & BufferParams::encoding() const
3392 {
3393         // Main encoding for LaTeX output.
3394         //
3395         // Exception: XeTeX with 8-bit TeX fonts requires ASCII (see #9740).
3396         // As the "flavor" is only known once export started, this
3397         // cannot be handled here. Instead, runparams.encoding is set
3398         // to ASCII in Buffer::makeLaTeXFile (for export)
3399         // and Buffer::writeLaTeXSource (for preview).
3400         if (useNonTeXFonts)
3401                 return *(encodings.fromLyXName("utf8-plain"));
3402         if (inputenc == "auto" || inputenc == "default")
3403                 return *language->encoding();
3404         Encoding const * const enc = encodings.fromLyXName(inputenc);
3405         if (enc)
3406                 return *enc;
3407         LYXERR0("Unknown inputenc value `" << inputenc
3408                << "'. Using `auto' instead.");
3409         return *language->encoding();
3410 }
3411
3412
3413 string const & BufferParams::defaultBiblioStyle() const
3414 {
3415         if (!biblio_style.empty())
3416                 return biblio_style;
3417
3418         map<string, string> const & bs = documentClass().defaultBiblioStyle();
3419         auto cit = bs.find(theCiteEnginesList.getTypeAsString(citeEngineType()));
3420         if (cit != bs.end())
3421                 return cit->second;
3422         else
3423                 return empty_string();
3424 }
3425
3426
3427 bool const & BufferParams::fullAuthorList() const
3428 {
3429         return documentClass().fullAuthorList();
3430 }
3431
3432
3433 string BufferParams::getCiteAlias(string const & s) const
3434 {
3435         vector<string> commands =
3436                 documentClass().citeCommands(citeEngineType());
3437         // If it is a real command, don't treat it as an alias
3438         if (find(commands.begin(), commands.end(), s) != commands.end())
3439                 return string();
3440         map<string,string> aliases = documentClass().citeCommandAliases();
3441         if (aliases.find(s) != aliases.end())
3442                 return aliases[s];
3443         return string();
3444 }
3445
3446
3447 vector<string> BufferParams::citeCommands() const
3448 {
3449         static CitationStyle const default_style;
3450         vector<string> commands =
3451                 documentClass().citeCommands(citeEngineType());
3452         if (commands.empty())
3453                 commands.push_back(default_style.name);
3454         return commands;
3455 }
3456
3457
3458 vector<CitationStyle> BufferParams::citeStyles() const
3459 {
3460         static CitationStyle const default_style;
3461         vector<CitationStyle> styles =
3462                 documentClass().citeStyles(citeEngineType());
3463         if (styles.empty())
3464                 styles.push_back(default_style);
3465         return styles;
3466 }
3467
3468
3469 string const BufferParams::bibtexCommand() const
3470 {
3471         // Return document-specific setting if available
3472         if (bibtex_command != "default")
3473                 return bibtex_command;
3474
3475         // If we have "default" in document settings, consult the prefs
3476         // 1. Japanese (uses a specific processor)
3477         if (encoding().package() == Encoding::japanese) {
3478                 if (lyxrc.jbibtex_command != "automatic")
3479                         // Return the specified program, if "automatic" is not set
3480                         return lyxrc.jbibtex_command;
3481                 else if (!useBiblatex()) {
3482                         // With classic BibTeX, return pbibtex, jbibtex, bibtex
3483                         if (lyxrc.jbibtex_alternatives.find("pbibtex") != lyxrc.jbibtex_alternatives.end())
3484                                 return "pbibtex";
3485                         if (lyxrc.jbibtex_alternatives.find("jbibtex") != lyxrc.jbibtex_alternatives.end())
3486                                 return "jbibtex";
3487                         return "bibtex";
3488                 }
3489         }
3490         // 2. All other languages
3491         else if (lyxrc.bibtex_command != "automatic")
3492                 // Return the specified program, if "automatic" is not set
3493                 return lyxrc.bibtex_command;
3494
3495         // 3. Automatic: find the most suitable for the current cite framework
3496         if (useBiblatex()) {
3497                 // For Biblatex, we prefer biber (also for Japanese)
3498                 // and fall back to bibtex8 and, as last resort, bibtex
3499                 if (lyxrc.bibtex_alternatives.find("biber") != lyxrc.bibtex_alternatives.end())
3500                         return "biber";
3501                 else if (lyxrc.bibtex_alternatives.find("bibtex8") != lyxrc.bibtex_alternatives.end())
3502                         return "bibtex8";
3503         }
3504         return "bibtex";
3505 }
3506
3507
3508 bool BufferParams::useBiblatex() const
3509 {
3510         return theCiteEnginesList[citeEngine()]->getCiteFramework() == "biblatex";
3511 }
3512
3513
3514 void BufferParams::invalidateConverterCache() const
3515 {
3516         pimpl_->isExportCacheValid = false;
3517         pimpl_->isViewCacheValid = false;
3518 }
3519
3520
3521 // We shouldn't need to reset the params here, since anything
3522 // we need will be recopied.
3523 void BufferParams::copyForAdvFR(const BufferParams & bp)
3524 {
3525         string const & lang = bp.language->lang();
3526         setLanguage(lang);
3527         layout_modules_ = bp.layout_modules_;
3528         string const & doc_class = bp.documentClass().name();
3529         setBaseClass(doc_class);
3530 }
3531
3532 } // namespace lyx