src/tex2lyx/Context.h

   1 // -*- C++ -*-
   2 /**
   3  * \file Context.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Jean-Marc Lasgouttes
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef CONTEXT_H
  13 #define CONTEXT_H
  14
  15 #include "TextClass.h"
  16
  17 #include <iosfwd>
  18
  19
  20 namespace lyx {
  21
  22
  23 /*!
  24  * Small helper struct that holds font properties.
  25  * The names are in LyX language, not LaTeX.
  26  * We don't use Font, because it pulls in a lot of dependencies and has
  27  * more strings than needed (e.g. font family error1 etc.).
  28  * If more font related stuff is needed, it might be good to change to
  29  * Font.
  30  */
  31 class TeXFont {
  32 public:
  33         TeXFont()
  34         {
  35                 init();
  36         }
  37         void init()
  38         {
  39                 size = "normal";
  40                 family = "default";
  41                 series = "default";
  42                 shape = "default";
  43         }
  44         std::string size;
  45         std::string family;
  46         std::string series;
  47         std::string shape;
  48 };
  49
  50
  51 bool operator==(TeXFont const &, TeXFont const &);
  52
  53
  54 inline bool operator!=(TeXFont const & f1, TeXFont const & f2)
  55 {
  56         return !operator==(f1, f2);
  57 }
  58
  59
  60 /// Output changed font parameters if \p oldfont and \p newfont differ
  61 void output_font_change(std::ostream & os, TeXFont const & oldfont,
  62                         TeXFont const & newfont);
  63
  64
  65 /*!
  66  * A helper struct.
  67  *
  68  * Every bit of text has a corresponding context.
  69  * Usage: Parsing begins with a global context. A new context is opened for
  70  * every new LaTeX group, e.g. at the beginning of a new environment.
  71  * The old context is used again after the group is closed.
  72  *
  73  * Since not all paragraph parameters in LyX have the same scoping as their
  74  * LaTeX counterpart we may have to transfer context properties (e. g. the
  75  * font) from and to the parent context.
  76  */
  77 class Context {
  78 public:
  79         Context(bool need_layout_,
  80                 TextClass const & textclass_,
  81                 LayoutPtr layout_ = LayoutPtr(),
  82                 LayoutPtr parent_layout_= LayoutPtr(),
  83                 TeXFont font_ = TeXFont());
  84         ~Context();
  85
  86         /// Output a \\begin_layout if requested
  87         void check_layout(std::ostream & os);
  88
  89         /// Output a \\end_layout if needed
  90         void check_end_layout(std::ostream & os);
  91
  92         /// Output a \\begin_deeper if needed
  93         void check_deeper(std::ostream & os);
  94
  95         /// Output a \\end_deeper if needed
  96         void check_end_deeper(std::ostream & os);
  97
  98         /// dump content on stream (for debugging purpose), with
  99         /// description \c desc.
 100         void dump(std::ostream &, std::string const & desc = "context") const;
 101
 102         /// Are we just beginning a new paragraph?
 103         bool atParagraphStart() const { return need_layout; }
 104
 105         /// Begin an item in a list environment
 106         void set_item();
 107
 108         /// Start a new paragraph
 109         void new_paragraph(std::ostream & os);
 110
 111         /// Add extra stuff if not already there
 112         void add_extra_stuff(std::string const &);
 113
 114         /// Do we need to output some \\begin_layout command before the
 115         /// next characters?
 116         bool need_layout;
 117         /// Do we need to output some \\end_layout command
 118         bool need_end_layout;
 119         /// We may need to add something after this \\begin_layout command
 120         std::string extra_stuff;
 121         /// If there has been an \\begin_deeper, we'll need a matching
 122         /// \\end_deeper
 123         bool need_end_deeper;
 124         /// If we are in an itemize-like environment, we need an \item
 125         /// for each paragraph, otherwise this has to be a deeper
 126         /// paragraph.
 127         bool has_item;
 128         /// we are handling a standard paragraph in an itemize-like
 129         /// environment
 130         bool deeper_paragraph;
 131         /*!
 132          * Inside of unknown environments we may not allow font and layout
 133          * changes.
 134          * Otherwise things like
 135          * \\large\\begin{foo}\\huge bar\\end{foo}
 136          * would not work.
 137          */
 138         bool new_layout_allowed;
 139         /// Did we output anything yet in any context?
 140         static bool empty;
 141
 142         /// The textclass of the document. Could actually be a global variable
 143         TextClass const & textclass;
 144         /// The layout of the current paragraph
 145         LayoutPtr layout;
 146         /// The layout of the outer paragraph (for environment layouts)
 147         LayoutPtr parent_layout;
 148         /// font attributes of this context
 149         TeXFont font;
 150         /// font attributes of normal text
 151         static TeXFont normalfont;
 152 };
 153
 154
 155 } // namespace lyx
 156
 157 #endif