src/tex2lyx/tex2lyx.h

   1 // -*- C++ -*-
   2 /**
   3  * \file tex2lyx.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author André Pönitz
   8  * \author Jean-Marc Lasgouttes
   9  *
  10  * Full author contact details are available in file CREDITS.
  11  */
  12
  13 #ifndef TEX2LYX_H
  14 #define TEX2LYX_H
  15
  16 #include "texparser.h"
  17 #include "lyxtextclass.h"
  18
  19 #include <iosfwd>
  20 #include <string>
  21 #include <vector>
  22 #include <map>
  23
  24 class Context;
  25
  26 /// in preamble.C
  27 LyXTextClass const parse_preamble(Parser & p, std::ostream & os, std::string const & forceclass);
  28
  29 /// used packages with options
  30 extern std::map<std::string, std::vector<std::string> > used_packages;
  31
  32
  33 /// in text.C
  34 std::string translate_len(std::string const &);
  35
  36 void parse_text(Parser & p, std::ostream & os, unsigned flags, bool outer,
  37                 Context & context);
  38
  39 /*!
  40  * Parses a subdocument, usually useful in insets (whence the name).
  41  *
  42  * It ignores \c context.need_layout and \c context.need_end_layout and
  43  * starts and ends always a new layout.
  44  * Therefore this may only be used to parse text in insets or table cells.
  45  */
  46 void parse_text_in_inset(Parser & p, std::ostream & os, unsigned flags,
  47                          bool outer, Context const & context);
  48
  49
  50 /// in math.C
  51 void parse_math(Parser & p, std::ostream & os, unsigned flags, mode_type mode);
  52
  53
  54 /// in table.C
  55 void handle_tabular(Parser & p, std::ostream & os, bool is_long_tabular,
  56                     Context & context);
  57
  58
  59 /// in tex2lyx.C
  60 std::string const trim(std::string const & a, char const * p = " \t\n\r");
  61
  62 void split(std::string const & s, std::vector<std::string> & result,
  63         char delim = ',');
  64 std::string join(std::vector<std::string> const & input,
  65         char const * delim);
  66
  67 bool is_math_env(std::string const & name);
  68 char const * const * is_known(std::string const &, char const * const *);
  69
  70 /*!
  71  * Adds the command \p command to the list of known commands.
  72  * \param o1 first optional parameter to the latex command \newcommand
  73  * (with brackets), or the empty string if there were no optional arguments.
  74  * \param o2 wether \newcommand had a second optional parameter
  75  */
  76 void add_known_command(std::string const & command, std::string const & o1,
  77                        bool o2);
  78
  79 // Access to environment stack
  80 extern std::vector<std::string> active_environments;
  81 std::string active_environment();
  82
  83 enum ArgumentType {
  84         required,
  85         verbatim,
  86         optional
  87 };
  88
  89 typedef std::map<std::string, std::vector<ArgumentType> > CommandMap;
  90
  91 /// Known TeX commands with arguments that get parsed into ERT.
  92 extern CommandMap known_commands;
  93 /// Known TeX environments with arguments that get parsed into ERT.
  94 extern CommandMap known_environments;
  95 /// Known TeX math environments with arguments that get parsed into LyX mathed.
  96 extern CommandMap known_math_environments;
  97 ///
  98 extern bool noweb_mode;
  99
 100 /// path of the master .tex file
 101 extern std::string getMasterFilePath();
 102 /// path of the currently processed .tex file
 103 extern std::string getParentFilePath();
 104
 105
 106 /*!
 107  *  Reads tex input from \a infilename and writes lyx output to \a outfilename.
 108  *  Uses some common settings for the preamble, so this should only
 109  *  be used more than once for included documents.
 110  *  Caution: Overwrites the existing preamble settings if the new document
 111  *  contains a preamble.
 112  *  \return true if the conversion was successful, else false.
 113  */
 114 bool tex2lyx(std::string const & infilename, std::string const & outfilename);
 115
 116 #endif