// -*- C++ -*-
-/* This file is part of
- * ======================================================
- *
- * LyX, The Document Processor
- *
- * Copyright (C) 1995 1996 Matthias Ettrich
- * and the LyX Team.
+/**
+ * \file bufferparams.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Lars Gullik Bjønnes
+ * \author Jean-Marc Lasgouttes
+ * \author John Levon
+ * \author André Pönitz
*
- *======================================================*/
+ * Full author contact details are available in file CREDITS.
+ */
-#ifndef _BUFFERPARAMS_H
-#define _BUFFERPARAMS_H
+#ifndef BUFFERPARAMS_H
+#define BUFFERPARAMS_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "lyxtextclass.h"
+#include "paper.h"
-#include "LString.h"
-#include "lyxlex.h"
-#include "vspace.h"
-#include "Spacing.h"
-#include "Bullet.h"
#include "insets/insetquotes.h"
-/**
- This class contains all the parameters for this a buffer uses. Some
- work needs to be done on this class to make it nice. Now everything
- is in public.
- */
+#include "support/copied_ptr.h"
+#include "support/types.h"
+
+#include <vector>
+
+
+namespace lyx {
+
+class AuthorList;
+class BranchList;
+class Bullet;
+class Encoding;
+class LyXLex;
+class LatexFeatures;
+class Spacing;
+class TexRow;
+class VSpace;
+class Language;
+
+
+namespace biblio {
+
+enum CiteEngine {
+ ENGINE_BASIC,
+ ENGINE_NATBIB_AUTHORYEAR,
+ ENGINE_NATBIB_NUMERICAL,
+ ENGINE_JURABIB
+};
+
+class CiteEngine_enum {
+ CiteEngine val_;
+public:
+ CiteEngine_enum(CiteEngine val) : val_(val) {}
+ operator CiteEngine() const{ return val_; }
+};
+
+} // namespace biblio
+
+
+/** Buffer parameters.
+ * This class contains all the parameters for this a buffer uses. Some
+ * work needs to be done on this class to make it nice. Now everything
+ * is in public.
+ */
class BufferParams {
public:
- //@Man: Constructors and Deconstructors
- //@{
+ ///
+ enum PARSEP {
+ ///
+ PARSEP_INDENT,
+ ///
+ PARSEP_SKIP
+ };
///
BufferParams();
- // ///
- //BufferParams(const BufferParams&);
- //@}
+ ~BufferParams();
+
+ /// read a header token, if unrecognised, return it or an unknown class name
+ std::string const readToken(LyXLex & lex, std::string const & token);
- /// Dummy destructor to shut up gcc
- virtual ~BufferParams() {}
-
///
- void writeFile(FILE *);
+ void writeFile(std::ostream &) const;
+ /** \returns true if the babel package is used (interogates
+ * the BufferParams and a LyXRC variable).
+ * This returned value can then be passed to the insets...
+ */
+ bool writeLaTeX(odocstream &, LaTeXFeatures &, TexRow &) const;
///
void useClassDefaults();
///
- VSpace getDefSkip() const { return defskip; }
+ bool hasClassDefaults() const;
///
- void setDefSkip(VSpace vs) { defskip = vs; }
-
+ VSpace const & getDefSkip() const;
+
+ ///
+ void setDefSkip(VSpace const & vs);
+
/** Wether paragraphs are separated by using a indent like in
- articles or by using a little skip like in letters.
- */
- char paragraph_separation; // add approp. signedness
+ * articles or by using a little skip like in letters.
+ */
+ PARSEP paragraph_separation;
///
- InsetQuotes::quote_language quotes_language;
+ InsetQuotes::quote_language quotes_language;
///
- InsetQuotes::quote_times quotes_times;
+ InsetQuotes::quote_times quotes_times;
///
- LString fontsize;
+ std::string fontsize;
///
- signed char textclass;
+ textclass_type textclass;
+ ///
+ LyXTextClass const & getLyXTextClass() const;
+
+ /// returns the main font for the buffer (document)
+ LyXFont const getFont() const;
/* this are for the PaperLayout */
- ///
- char papersize; /* the general papersize (papersize2 or paperpackage */ // add approp. signedness
- ///
- char papersize2; /* the selected Geometry papersize */ // add approp. signedness
- ///
- char paperpackage; /* a special paperpackage .sty-file */ // add approp. signedness
- ///
- char orientation; // add approp. signedness
- ///
- bool use_geometry;
- ///
- LString paperwidth;
- ///
- LString paperheight;
- ///
- LString leftmargin;
- ///
- LString topmargin;
- ///
- LString rightmargin;
- ///
- LString bottommargin;
- ///
- LString headheight;
- ///
- LString headsep;
- ///
- LString footskip;
-
- /* some LaTeX options */
- /// The graphics driver
- LString graphicsDriver;
+ /// the papersize
+ PAPER_SIZE papersize;
+ ///
+ PAPER_ORIENTATION orientation;
+ /// use custom margins
+ bool use_geometry;
+ ///
+ std::string paperwidth;
+ ///
+ std::string paperheight;
///
- LString fonts;
+ std::string leftmargin;
///
- Spacing spacing;
+ std::string topmargin;
///
- signed char secnumdepth;
+ std::string rightmargin;
///
- signed char tocdepth;
+ std::string bottommargin;
///
- LString language;
+ std::string headheight;
///
- LString inputenc;
+ std::string headsep;
///
- LString preamble;
+ std::string footskip;
+
+ /* some LaTeX options */
+ /// The graphics driver
+ std::string graphicsDriver;
+ /// the rm font
+ std::string fontsRoman;
+ /// the sf font
+ std::string fontsSans;
+ /// the tt font
+ std::string fontsTypewriter;
+ /// the default family (rm, sf, tt)
+ std::string fontsDefaultFamily;
+ /// use expert Small Caps
+ bool fontsSC;
+ /// use Old Style Figures
+ bool fontsOSF;
+ /// the scale factor of the sf font
+ int fontsSansScale;
+ /// the scale factor of the tt font
+ int fontsTypewriterScale;
+ ///
+ Spacing & spacing();
+ Spacing const & spacing() const;
///
- LString options;
+ int secnumdepth;
///
- LString float_placement;
+ int tocdepth;
///
- char columns; // add approp. signedness
+ Language const * language;
+ /// BranchList:
+ BranchList & branchlist();
+ BranchList const & branchlist() const;
+ /**
+ * The input encoding for LaTeX. This can be one of
+ * - auto: find out the input encoding from the used languages
+ * - default: Don't load the inputenc package and hope that it will
+ * work (unlikely). The encoding is an unspecified 8bit encoding,
+ * the interpretation is up to the LaTeX compiler. Because we need
+ * a rule how to create this from our internal UCS4 encoded
+ * document contents we treat this as latin1 internally.
+ * - any encoding supported by the inputenc package
+ * The encoding of the LyX file is always utf8 and has nothing to
+ * do with this setting.
+ */
+ std::string inputenc;
+ /// The main encoding used by this buffer for LaTeX output.
+ /// Individual pieces of text can use different encodings.
+ Encoding const & encoding() const;
///
- char sides; // add approp. signedness
+ std::string preamble;
///
- LString pagestyle;
+ std::string options;
///
- Bullet temp_bullets[4];
+ std::string float_placement;
///
- Bullet user_defined_bullets[4];
+ unsigned int columns;
///
- void Copy(BufferParams const &p);
+ LyXTextClass::PageSides sides;
///
- virtual void readPreamble(LyXLex &);
+ std::string pagestyle;
+ /// \param index should lie in the range 0 <= \c index <= 3.
+ Bullet & temp_bullet(size_type index);
+ Bullet const & temp_bullet(size_type index) const;
+ /// \param index should lie in the range 0 <= \c index <= 3.
+ Bullet & user_defined_bullet(size_type index);
+ Bullet const & user_defined_bullet(size_type index) const;
///
- virtual void readLanguage(LyXLex &);
+ void readPreamble(LyXLex &);
///
- virtual void readGraphicsDriver(LyXLex &);
- /// do we allow accents on all chars in this buffer
- bool allowAccents;
+ void readLanguage(LyXLex &);
///
- bool use_amsmath;
+ void readGraphicsDriver(LyXLex &);
+ ///
+ void readBullets(LyXLex &);
+ ///
+ void readBulletsLaTeX(LyXLex &);
+
+ /// Whether to load a package such as amsmath or esint.
+ /// The enum values must not be changed (file format!)
+ enum Package {
+ /// Don't load the package. For experts only.
+ package_off = 0,
+ /// Load the package if needed (recommended)
+ package_auto = 1,
+ /// Always load the package (e.g. if the document contains
+ /// some ERT that needs the package)
+ package_on = 2
+ };
+ /// Whether and how to load amsmath
+ Package use_amsmath;
+ /// Whether and how to load esint
+ Package use_esint;
+ ///
+ biblio::CiteEngine cite_engine;
+ ///
+ bool use_bibtopic;
+ /// revision tracking for this buffer ?
+ bool trackChanges;
+ /** This param decides whether change tracking marks should be output
+ * (using the dvipost package) or if the current "state" of the
+ * document should be output instead. Since dvipost needs dvi
+ * specials, it only works with dvi/ps output (the param will be
+ * ignored with other output flavors and disabled when dvipost is
+ * not installed).
+ */
+ bool outputChanges;
/// Time ago we agreed that this was a buffer property [ale990407]
- LString parentname;
-protected:
-private:
+ std::string parentname;
+ ///
+ bool compressed;
+
+ /// the author list for the document
+ AuthorList & authors();
+ AuthorList const & authors() const;
+
+ /// map of the file's author IDs to buffer author IDs
+ std::vector<unsigned int> author_map;
///
- friend class Buffer;
- /** This is the amount of space used for paragraph_separation "skip",
- and for detached paragraphs in "indented" documents. */
- VSpace defskip;
+ std::string const dvips_options() const;
+ ///
+ std::string const paperSizeName() const;
+ ///
+ std::string const babelCall(std::string const & lang_opts) const;
+ /// set up the document fonts
+ std::string const loadFonts(LaTeXFeatures & features, std::string const & rm,
+ std::string const & sf, std::string const & tt,
+ bool const & sc, bool const & osf,
+ int const & sfscale, int const & ttscale) const;
+ /// path of the current buffer
+ std::string filepath;
+
+private:
+ /** Use the Pimpl idiom to hide those member variables that would otherwise
+ * drag in other header files.
+ */
+ class Impl;
+ class MemoryTraits {
+ public:
+ static Impl * clone(Impl const *);
+ static void destroy(Impl *);
+ };
+ support::copied_ptr<Impl, MemoryTraits> pimpl_;
};
+} // namespace lyx
+
#endif