X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fmathed%2FMathStream.h;h=153e7df3c584404a43b68ebae48db36a6ba2edce;hb=d9082639080b9de993742bd352f92e5183058cf5;hp=7da9a9b9f9177d0949a6a1c71f4ac8e0b3d750ba;hpb=8cd4ef18c865bbffb38664025c869362bf4ce5d1;p=lyx.git diff --git a/src/mathed/MathStream.h b/src/mathed/MathStream.h index 7da9a9b9f9..153e7df3c5 100644 --- a/src/mathed/MathStream.h +++ b/src/mathed/MathStream.h @@ -12,17 +12,18 @@ #ifndef MATH_MATHMLSTREAM_H #define MATH_MATHMLSTREAM_H -#include "support/strfwd.h" - #include "InsetMath.h" -// FIXME: Move to individual insets -#include "MetricsInfo.h" + +#include "TexRow.h" +#include "texstream.h" + +#include "support/Changer.h" +#include "support/strfwd.h" namespace lyx { class Encoding; -class InsetMath; class MathAtom; class MathData; @@ -30,7 +31,7 @@ class MathData; // LaTeX/LyX // -class WriteStream { +class TeXMathStream { public: /// enum OutputType { @@ -39,12 +40,17 @@ public: wsPreview }; /// - WriteStream(odocstream & os, bool fragile, bool latex, OutputType output, - Encoding const * encoding = 0); + enum UlemCmdType { + NONE, + UNDERLINE, + STRIKEOUT + }; /// - explicit WriteStream(odocstream & os); + explicit TeXMathStream(otexrowstream & os, bool fragile = false, + bool latex = false, OutputType output = wsDefault, + Encoding const * encoding = nullptr); /// - ~WriteStream(); + ~TeXMathStream(); /// int line() const { return line_; } /// @@ -54,7 +60,9 @@ public: /// OutputType output() const { return output_; } /// - odocstream & os() { return os_; } + otexrowstream & os() { return os_; } + /// + TexRow & texrow() { return os_.texrow(); } /// bool & firstitem() { return firstitem_; } /// @@ -63,10 +71,22 @@ public: void canBreakLine(bool breakline) { canbreakline_ = breakline; } /// tell whether we can write an immediately following newline char bool canBreakLine() const { return canbreakline_; } + /// record whether we have to take care for striking out display math + void strikeoutMath(bool mathsout) { mathsout_ = mathsout; } + /// tell whether we have to take care for striking out display math + bool strikeoutMath() const { return mathsout_; } + /// record which ulem command type we are inside + void ulemCmd(UlemCmdType ulemcmd) { ulemcmd_ = ulemcmd; } + /// tell which ulem command type we are inside + UlemCmdType ulemCmd() const { return ulemcmd_; } /// writes space if next thing is isalpha() - void pendingSpace(bool how); + void pendingSpace(bool space); /// writes space if next thing is isalpha() bool pendingSpace() const { return pendingspace_; } + /// write braces if a space is pending and next char is [ + void useBraces(bool braces); + /// write braces if a space is pending and next char is [ + bool useBraces() const { return usebraces_; } /// tell whether to write the closing brace of \ensuremath void pendingBrace(bool brace); /// tell whether to write the closing brace of \ensuremath @@ -83,57 +103,78 @@ public: void asciiOnly(bool ascii); /// tell whether to use only ascii chars when producing latex code bool asciiOnly() const { return ascii_; } + /// tell whether we are in a MathClass inset + void inMathClass(bool mathclass) { mathclass_ = mathclass; }; + /// tell whether we are in a MathClass inset + bool inMathClass() const { return mathclass_; } /// LaTeX encoding Encoding const * encoding() const { return encoding_; } + + /// Temporarily change the TexRow information about the outer row entry. + Changer changeRowEntry(TexRow::RowEntry entry); + /// TexRow::starts the innermost outer math inset + /// returns true if the outer row entry will appear at this line + bool startOuterRow(); private: /// - odocstream & os_; + otexrowstream & os_; /// do we have to write \\protect sometimes - bool fragile_; + bool fragile_ = false; /// are we at the beginning of an MathData? - bool firstitem_; + bool firstitem_ = false; /// are we writing to .tex? - int latex_; + int latex_ = false; /// output type (default, source preview, instant preview)? - OutputType output_; + OutputType output_ = wsDefault; /// do we have a space pending? - bool pendingspace_; + bool pendingspace_ = false; + /// do we have to write braces when a space is pending and [ follows? + bool usebraces_ = false; /// do we have a brace pending? - bool pendingbrace_; + bool pendingbrace_ = false; /// are we in text mode when producing latex code? - bool textmode_; + bool textmode_ = false; /// are we allowed to switch mode when producing latex code? - bool locked_; + bool locked_ = false; /// should we use only ascii chars when producing latex code? - bool ascii_; + bool ascii_ = false; /// are we allowed to output an immediately following newline? - bool canbreakline_; - /// - int line_; - /// - Encoding const * encoding_; + bool canbreakline_ = true; + /// should we take care for striking out display math? + bool mathsout_ = false; + /// what ulem command are we inside (none, underline, strikeout)? + UlemCmdType ulemcmd_ = NONE; + /// + int line_ = 0; + /// + Encoding const * encoding_ = nullptr; + /// Row entry we are in + TexRow::RowEntry row_entry_ = TexRow::row_none; + /// whether we are in a MathClass inset + bool mathclass_ = false; }; /// -WriteStream & operator<<(WriteStream &, MathAtom const &); +TeXMathStream & operator<<(TeXMathStream &, MathAtom const &); /// -WriteStream & operator<<(WriteStream &, MathData const &); +TeXMathStream & operator<<(TeXMathStream &, MathData const &); /// -WriteStream & operator<<(WriteStream &, docstring const &); +TeXMathStream & operator<<(TeXMathStream &, docstring const &); /// -WriteStream & operator<<(WriteStream &, char const * const); +TeXMathStream & operator<<(TeXMathStream &, char const * const); /// -WriteStream & operator<<(WriteStream &, char); +TeXMathStream & operator<<(TeXMathStream &, char); /// -WriteStream & operator<<(WriteStream &, int); +TeXMathStream & operator<<(TeXMathStream &, int); /// -WriteStream & operator<<(WriteStream &, unsigned int); +TeXMathStream & operator<<(TeXMathStream &, unsigned int); -/// ensure math mode, possibly by opening \ensuremath -bool ensureMath(WriteStream & os, bool needs_math_mode = true, bool macro = false); +/// ensure correct mode, possibly by opening \ensuremath or \lyxmathsym +bool ensureMath(TeXMathStream & os, bool needs_mathmode = true, + bool macro = false, bool textmode_macro = false); -/// ensure the requested mode, possibly by closing \ensuremath -int ensureMode(WriteStream & os, InsetMath::mode_type mode, bool locked, bool ascii); +/// ensure the requested mode, possibly by closing \ensuremath or \lyxmathsym +int ensureMode(TeXMathStream & os, InsetMath::mode_type mode, bool locked, bool ascii); /** @@ -141,6 +182,8 @@ int ensureMode(WriteStream & os, InsetMath::mode_type mode, bool locked, bool as * * A local variable of this type can be used to either ensure math mode * or delay the writing of a pending brace when outputting LaTeX. + * A LyX InsetMathMacro is always assumed needing a math mode environment, while + * no assumption is made for macros defined through \newcommand or \def. * * Example 1: * @@ -159,28 +202,40 @@ int ensureMode(WriteStream & os, InsetMath::mode_type mode, bool locked, bool as * * Example 3: * - * MathEnsurer ensurer(os, needs_math_mode, true); + * MathEnsurer ensurer(os, needs_mathmode, true, textmode_macro); + * + * This form is mainly used for math macros as they are treated specially. + * In essence, the macros defined in the lib/symbols file and tagged as + * textmode will be enclosed in \lyxmathsym if they appear in a math mode + * environment, while macros defined in the preamble or ERT are left as is. + * The third parameter must be set to true and the fourth parameter has also + * to be specified. Only the following 3 different cases are handled. + * + * When the needs_mathmode parameter is true the behavior is as in Example 1. + * This is the case for a LyX InsetMathMacro or a macro not tagged as textmode. + * + * When the needs_mathmode and textmode_macro parameters are both false the + * macro is left in the same (text or math mode) environment it was entered. + * This is because it is assumed that the macro was designed for that mode + * and we have no way to tell the contrary. + * This is the case for macros defined by using \newcommand or \def in ERT. * - * The third parameter is set to true only for a user defined macro, which - * needs special handling. When it is a MathMacro, the needs_math_mode - * parameter is true and the behavior is as in Example 1. When the - * needs_math_mode parameter is false (not a MathMacro) and the macro - * was entered in a text box and we are in math mode, the mode is reset - * to text. This is because the macro was probably designed for text mode - * (given that it was entered in text mode and we have no way to tell the - * contrary). + * When the needs_mathmode parameter is false while textmode_macro is true the + * macro will be enclosed in \lyxmathsym if it appears in a math mode environment. + * This is the case for the macros tagged as textmode in lib/symbols. */ class MathEnsurer { public: /// - explicit MathEnsurer(WriteStream & os, bool needs_math_mode = true, bool macro = false) - : os_(os), brace_(ensureMath(os, needs_math_mode, macro)) {} + explicit MathEnsurer(TeXMathStream & os, bool needs_mathmode = true, + bool macro = false, bool textmode_macro = false) + : os_(os), brace_(ensureMath(os, needs_mathmode, macro, textmode_macro)) {} /// ~MathEnsurer() { os_.pendingBrace(brace_); } private: /// - WriteStream & os_; + TeXMathStream & os_; /// bool brace_; }; @@ -225,8 +280,8 @@ class ModeSpecifier { public: /// - explicit ModeSpecifier(WriteStream & os, InsetMath::mode_type mode, - bool locked = false, bool ascii = false) + explicit ModeSpecifier(TeXMathStream & os, InsetMath::mode_type mode, + bool locked = false, bool ascii = false) : os_(os), oldmodes_(ensureMode(os, mode, locked, ascii)) {} /// ~ModeSpecifier() @@ -237,7 +292,7 @@ public: } private: /// - WriteStream & os_; + TeXMathStream & os_; /// int oldmodes_; }; @@ -248,10 +303,12 @@ private: // MathML // + +/// Start tag. class MTag { public: /// - MTag(char const * const tag, std::string attr = "") + MTag(char const * const tag, std::string const & attr = std::string()) : tag_(tag), attr_(attr) {} /// char const * const tag_; @@ -259,12 +316,27 @@ public: std::string attr_; }; + +/// End tag. class ETag { public: /// - ETag(char const * const tag) : tag_(tag) {} + explicit ETag(char const * const tag) : tag_(tag) {} + /// + char const * const tag_; +}; + + +/// Compound tag (no content, directly closed). +class CTag { +public: + /// + CTag(char const * const tag, std::string const & attr = "") + : tag_(tag), attr_(attr) {} /// char const * const tag_; + /// + std::string attr_; }; @@ -275,10 +347,10 @@ public: class MathExportException : public std::exception {}; -class MathStream { +class MathMLStream { public: - /// - explicit MathStream(odocstream & os); + /// Builds a stream proxy for os; the MathML namespace is given by xmlns (supposed to be already defined elsewhere in the document). + explicit MathMLStream(odocstream & os, std::string const & xmlns = "", bool xmlMode = false); /// void cr(); /// @@ -288,7 +360,7 @@ public: /// int & tab() { return tab_; } /// - friend MathStream & operator<<(MathStream &, char const *); + friend MathMLStream & operator<<(MathMLStream &, char const *); /// void defer(docstring const &); /// @@ -297,11 +369,17 @@ public: docstring deferred() const; /// bool inText() const { return in_text_; } -private: /// - void setTextMode() { in_text_ = true; } + std::string xmlns() const { return xmlns_; } /// - void setMathMode() { in_text_ = false; } + bool xmlMode() const { return xml_mode_; } + /// Returns the tag name prefixed by the name space if needed. + std::string namespacedTag(std::string const & tag) const { + return (xmlns().empty() ? "" : xmlns() + ":") + tag; + } +private: + /// + void setTextMode(bool t) { in_text_ = t; } /// odocstream & os_; /// @@ -313,51 +391,43 @@ private: /// odocstringstream deferred_; /// + std::string xmlns_; + /// + bool xml_mode_; + /// friend class SetMode; }; /// -MathStream & operator<<(MathStream &, MathAtom const &); +MathMLStream & operator<<(MathMLStream &, MathAtom const &); /// -MathStream & operator<<(MathStream &, MathData const &); +MathMLStream & operator<<(MathMLStream &, MathData const &); /// -MathStream & operator<<(MathStream &, docstring const &); +MathMLStream & operator<<(MathMLStream &, docstring const &); /// -MathStream & operator<<(MathStream &, char const *); +MathMLStream & operator<<(MathMLStream &, char const *); /// -MathStream & operator<<(MathStream &, char); +MathMLStream & operator<<(MathMLStream &, char); /// -MathStream & operator<<(MathStream &, char_type); +MathMLStream & operator<<(MathMLStream &, char_type); /// -MathStream & operator<<(MathStream &, MTag const &); +MathMLStream & operator<<(MathMLStream &, MTag const &); /// -MathStream & operator<<(MathStream &, ETag const &); +MathMLStream & operator<<(MathMLStream &, ETag const &); +/// +MathMLStream & operator<<(MathMLStream &, CTag const &); /// A simpler version of ModeSpecifier, for MathML -// FIXME There are still problems here with nesting, at least -// potentially. The problem is that true nesting of text mode isn't -// actually possible. I.e., we can't have: -// -// So we have to have: -// -// instead, where the last is really a continuation of the first. -// We'll need some kind of stack to remember all that. class SetMode { public: /// - explicit SetMode(MathStream & os, bool text, std::string const & attrs); - /// - explicit SetMode(MathStream & os, bool text); + explicit SetMode(MathMLStream & ms, bool text); /// ~SetMode(); private: /// - void init(bool, std::string const &); - /// - MathStream & os_; - /// - bool opened_; + MathMLStream & ms_; /// bool was_text_; }; @@ -387,9 +457,7 @@ public: bool inText() const { return in_text_; } private: /// - void setTextMode() { in_text_ = true; } - /// - void setMathMode() { in_text_ = false; } + void setTextMode(bool t) { in_text_ = t; } /// odocstream & os_; /// @@ -424,20 +492,14 @@ HtmlStream & operator<<(HtmlStream &, ETag const &); class SetHTMLMode { public: - /// - explicit SetHTMLMode(HtmlStream & os, bool text, std::string attrs); /// explicit SetHTMLMode(HtmlStream & os, bool text); /// ~SetHTMLMode(); private: - /// - void init(bool, std::string const &); /// HtmlStream & os_; /// - bool opened_; - /// bool was_text_; }; @@ -599,6 +661,9 @@ OctaveStream & operator<<(OctaveStream &, char); /// OctaveStream & operator<<(OctaveStream &, int); + +docstring convertDelimToXMLEscape(docstring const & name, bool xmlmode); + } // namespace lyx #endif