4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
8 * \author Jean-Marc Lasgouttes
10 * Full author contact details are available in file CREDITS.
17 #include "TextClass.h"
27 namespace support { class FileName; }
29 /// Simple support for frontend::Alert::warning().
32 void warning(docstring const & title, docstring const & message,
39 /// A trivial subclass, just to give us a public default constructor
40 class TeX2LyXDocClass : public DocumentClass
43 void setName(std::string const & name) { name_ = name; }
47 void parse_preamble(Parser & p, std::ostream & os,
48 std::string const & forceclass, TeX2LyXDocClass & tc);
49 /// Translate babel language name to LyX language name
50 extern std::string babel2lyx(std::string const & language);
52 /// used packages with options
53 extern std::map<std::string, std::vector<std::string> > used_packages;
54 extern const char * const modules_placeholder;
55 extern std::string h_inputencoding;
56 extern std::string h_paragraph_separation;
59 std::string translate_len(std::string const &);
61 void parse_text(Parser & p, std::ostream & os, unsigned flags, bool outer,
65 * Parses a subdocument, usually useful in insets (whence the name).
67 * It ignores \c context.need_layout and \c context.need_end_layout and
68 * starts and ends always a new layout.
69 * Therefore this may only be used to parse text in insets or table cells.
71 void parse_text_in_inset(Parser & p, std::ostream & os, unsigned flags,
72 bool outer, Context const & context,
73 InsetLayout const * layout = 0);
77 void parse_math(Parser & p, std::ostream & os, unsigned flags, mode_type mode);
81 void handle_tabular(Parser & p, std::ostream & os, bool is_long_tabular,
86 std::string const trimSpaceAndEol(std::string const & a);
88 void split(std::string const & s, std::vector<std::string> & result,
90 std::string join(std::vector<std::string> const & input,
93 bool is_math_env(std::string const & name);
94 char const * const * is_known(std::string const &, char const * const *);
97 * Adds the command \p command to the list of known commands.
98 * \param o1 first optional parameter to the latex command \\newcommand
99 * (with brackets), or the empty string if there were no optional arguments.
100 * \param o2 wether \\newcommand had a second optional parameter.
101 * If \p definition is not empty the command is assumed to be from the LyX
102 * preamble and added to possible_textclass_commands.
104 void add_known_command(std::string const & command, std::string const & o1,
105 bool o2, docstring const & definition = docstring());
106 extern void add_known_environment(std::string const & environment,
107 std::string const & o1, bool o2, docstring const & beg,
108 docstring const & end);
109 extern Layout const * findLayoutWithoutModule(TextClass const & textclass,
110 std::string const & name, bool command);
111 extern InsetLayout const * findInsetLayoutWithoutModule(
112 TextClass const & textclass, std::string const & name, bool command);
114 * Check whether a module provides command (if \p command is true) or
115 * environment (if \p command is false) \p name, and add the module to the
116 * list of used modules if yes.
118 extern bool checkModule(std::string const & name, bool command);
119 // Access to environment stack
120 extern std::vector<std::string> active_environments;
121 std::string active_environment();
133 FullCommand(std::vector<ArgumentType> const & a, docstring const & d)
135 std::vector<ArgumentType> args;
139 class FullEnvironment {
142 FullEnvironment(std::vector<ArgumentType> const & a,
143 docstring const & b, docstring const & e)
144 : args(a), beg(b), end(e) {}
145 std::vector<ArgumentType> args;
150 typedef std::map<std::string, std::vector<ArgumentType> > CommandMap;
151 typedef std::map<std::string, FullCommand> FullCommandMap;
152 typedef std::map<std::string, FullEnvironment> FullEnvironmentMap;
154 /// Known TeX commands with arguments that get parsed into ERT.
155 extern CommandMap known_commands;
156 /// Known TeX environments with arguments that get parsed into ERT.
157 extern CommandMap known_environments;
158 /// Known TeX math environments with arguments that get parsed into LyX mathed.
159 extern CommandMap known_math_environments;
160 /// Commands that might be defined by the document class or modules
161 extern FullCommandMap possible_textclass_commands;
162 /// Environments that might be defined by the document class or modules
163 extern FullEnvironmentMap possible_textclass_environments;
165 extern bool noweb_mode;
166 /// Did we recognize any pdflatex-only construct?
167 extern bool pdflatex;
168 /// LyX format that is created by tex2lyx
169 extern int const LYX_FORMAT;
171 /// path of the master .tex file
172 extern std::string getMasterFilePath();
173 /// path of the currently processed .tex file
174 extern std::string getParentFilePath();
178 * Reads tex input from \a infilename and writes lyx output to \a outfilename.
179 * The (latex) encoding can be provided as \a encoding.
180 * Uses some common settings for the preamble, so this should only
181 * be used more than once for included documents.
182 * Caution: Overwrites the existing preamble settings if the new document
183 * contains a preamble.
184 * \return true if the conversion was successful, else false.
186 bool tex2lyx(std::string const & infilename,
187 support::FileName const & outfilename,
188 std::string const & encoding);