X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fxml.h;h=5478a66361d8fe099d70a030967a556634c9a662;hb=9d8a45b5c055ef49e45c34ba0d751a0256d97e15;hp=c7f1e5076e2a5b3cde5601b45c828976df72d795;hpb=3883b85f49054c109cb8a9a293721a5e41edb68d;p=lyx.git diff --git a/src/xml.h b/src/xml.h index c7f1e5076e..5478a66361 100644 --- a/src/xml.h +++ b/src/xml.h @@ -38,93 +38,93 @@ struct CR; class XMLStream { public: - /// - explicit XMLStream(odocstream & os): os_(os), escape_(ESCAPE_ALL) {} - /// - odocstream & os() { return os_; } - /// - // int & tab() { return tab_; } - /// closes any font tags that are eligible to be closed, - /// i.e., last on the tag_stack_. - /// \return false if there are open font tags we could not close. - /// because they are "blocked" by open non-font tags on the stack. - bool closeFontTags(); - /// sets a mark so we know what tags to close at the end. - /// normally called at the start of a paragraph. - void startDivision(bool keep_empty); - /// clears the mark set by previous method. - /// there should not be any other tags open before it on the stack, - /// but if there are, we will close them. - void endDivision(); - /// - XMLStream & operator<<(docstring const &); - /// - XMLStream & operator<<(const char *); - /// - XMLStream & operator<<(char_type); - /// - XMLStream & operator<<(int); - /// - XMLStream & operator<<(char); - /// - XMLStream & operator<<(xml::StartTag const &); - /// - XMLStream & operator<<(xml::EndTag const &); - /// - XMLStream & operator<<(xml::CompTag const &); - /// - XMLStream & operator<<(xml::ParTag const &); - /// - XMLStream & operator<<(xml::FontTag const &); - /// - XMLStream & operator<<(xml::CR const &); - /// - enum EscapeSettings { - ESCAPE_NONE, - ESCAPE_AND, // meaning & - ESCAPE_ALL // meaning <, >, &, at present - }; - /// Sets what we are going to escape on the NEXT write. - /// Everything is reset for the next time. - XMLStream & operator<<(EscapeSettings); - /// This routine is for debugging the tag stack, etc. Code - /// for it is disabled by default, however, so you will need - /// to enable it if you want to use it. - void dumpTagStack(std::string const & msg); - /// - bool isTagOpen(xml::StartTag const &, int maxdepth = -1) const; - /// - bool isTagOpen(xml::EndTag const &, int maxdepth = -1) const; - /// - bool isTagPending(xml::StartTag const &, int maxdepth = -1) const; + /// + explicit XMLStream(odocstream & os): os_(os), escape_(ESCAPE_ALL) {} + /// + odocstream & os() { return os_; } + /// + // int & tab() { return tab_; } + /// closes any font tags that are eligible to be closed, + /// i.e., last on the tag_stack_. + /// \return false if there are open font tags we could not close. + /// because they are "blocked" by open non-font tags on the stack. + bool closeFontTags(); + /// sets a mark so we know what tags to close at the end. + /// normally called at the start of a paragraph. + void startDivision(bool keep_empty); + /// clears the mark set by previous method. + /// there should not be any other tags open before it on the stack, + /// but if there are, we will close them. + void endDivision(); + /// + XMLStream & operator<<(docstring const &); + /// + XMLStream & operator<<(const char *); + /// + XMLStream & operator<<(char_type); + /// + XMLStream & operator<<(int); + /// + XMLStream & operator<<(char); + /// + XMLStream & operator<<(xml::StartTag const &); + /// + XMLStream & operator<<(xml::EndTag const &); + /// + XMLStream & operator<<(xml::CompTag const &); + /// + XMLStream & operator<<(xml::ParTag const &); + /// + XMLStream & operator<<(xml::FontTag const &); + /// + XMLStream & operator<<(xml::CR const &); + /// + enum EscapeSettings { + ESCAPE_NONE, + ESCAPE_AND, // meaning & + ESCAPE_ALL // meaning <, >, &, at present + }; + /// Sets what we are going to escape on the NEXT write. + /// Everything is reset for the next time. + XMLStream & operator<<(EscapeSettings); + /// This routine is for debugging the tag stack, etc. Code + /// for it is disabled by default, however, so you will need + /// to enable it if you want to use it. + void dumpTagStack(std::string const & msg); + /// + bool isTagOpen(xml::StartTag const &, int maxdepth = -1) const; + /// + bool isTagOpen(xml::EndTag const &, int maxdepth = -1) const; + /// + bool isTagPending(xml::StartTag const &, int maxdepth = -1) const; private: - /// - void clearTagDeque(); - /// - void writeError(std::string const &) const; - /// - void writeError(docstring const &) const; - /// - odocstream & os_; - /// - EscapeSettings escape_; - // What we would really like to do here is simply use a - // deque. But we want to store both StartTags and - // sub-classes thereof on this stack, which means we run into the - // so-called polymorphic class problem with the STL. We therefore have - // to use a deque, which leads to the question who will - // own these pointers and how they will be deleted, so we use shared - // pointers. - /// - typedef std::shared_ptr TagPtr; - typedef std::deque TagDeque; - /// - template - TagPtr makeTagPtr(T const & tag) { return std::make_shared(tag); } - /// - TagDeque pending_tags_; - /// - TagDeque tag_stack_; + /// + void clearTagDeque(); + /// + void writeError(std::string const &) const; + /// + void writeError(docstring const &) const; + /// + odocstream & os_; + /// + EscapeSettings escape_; + // What we would really like to do here is simply use a + // deque. But we want to store both StartTags and + // sub-classes thereof on this stack, which means we run into the + // so-called polymorphic class problem with the STL. We therefore have + // to use a deque, which leads to the question who will + // own these pointers and how they will be deleted, so we use shared + // pointers. + /// + typedef std::shared_ptr TagPtr; + typedef std::deque TagDeque; + /// + template + TagPtr makeTagPtr(T const & tag) { return std::make_shared(tag); } + /// + TagDeque pending_tags_; + /// + TagDeque tag_stack_; }; namespace xml { @@ -160,69 +160,69 @@ struct EndFontTag; /// be escaped before being passed to the constructor. struct StartTag { - /// - explicit StartTag(std::string const & tag) : tag_(from_ascii(tag)), keepempty_(false) {} - /// - explicit StartTag(docstring const & tag) : tag_(tag), keepempty_(false) {} - /// - explicit StartTag(docstring const & tag, docstring const & attr, - bool keepempty = false) - : tag_(tag), attr_(attr), keepempty_(keepempty) {} - /// - explicit StartTag(std::string const & tag, std::string const & attr, - bool keepempty = false) - : tag_(from_ascii(tag)), attr_(from_ascii(attr)), keepempty_(keepempty) {} - /// - explicit StartTag(std::string const & tag, docstring const & attr, - bool keepempty = false) - : tag_(from_ascii(tag)), attr_(attr), keepempty_(keepempty) {} - /// - virtual ~StartTag() {} - /// - virtual docstring writeTag() const; - /// - virtual docstring writeEndTag() const; - /// - virtual FontTag const * asFontTag() const { return nullptr; } - /// - virtual bool operator==(StartTag const & rhs) const - { return tag_ == rhs.tag_; } - /// - virtual bool operator!=(StartTag const & rhs) const - { return !(*this == rhs); } - /// - virtual bool operator==(FontTag const & rhs) const; - /// - docstring tag_; - /// - docstring attr_; - /// whether to keep things like "" or discard them - /// you would want this for td, e.g, but maybe not for a div - bool keepempty_; + /// + explicit StartTag(std::string const & tag) : tag_(from_ascii(tag)), keepempty_(false) {} + /// + explicit StartTag(docstring const & tag) : tag_(tag), keepempty_(false) {} + /// + explicit StartTag(docstring const & tag, docstring const & attr, + bool keepempty = false) + : tag_(tag), attr_(attr), keepempty_(keepempty) {} + /// + explicit StartTag(std::string const & tag, std::string const & attr, + bool keepempty = false) + : tag_(from_ascii(tag)), attr_(from_ascii(attr)), keepempty_(keepempty) {} + /// + explicit StartTag(std::string const & tag, docstring const & attr, + bool keepempty = false) + : tag_(from_ascii(tag)), attr_(attr), keepempty_(keepempty) {} + /// + virtual ~StartTag() {} + /// + virtual docstring writeTag() const; + /// + virtual docstring writeEndTag() const; + /// + virtual FontTag const * asFontTag() const { return nullptr; } + /// + virtual bool operator==(StartTag const & rhs) const + { return tag_ == rhs.tag_; } + /// + virtual bool operator!=(StartTag const & rhs) const + { return !(*this == rhs); } + /// + virtual bool operator==(FontTag const & rhs) const; + /// + docstring tag_; + /// + docstring attr_; + /// whether to keep things like "" or discard them + /// you would want this for td, e.g, but maybe not for a div + bool keepempty_; }; /// struct EndTag { - /// - explicit EndTag(std::string tag) : tag_(from_ascii(tag)) {} - /// - explicit EndTag(docstring tag) : tag_(tag) {} - /// - virtual ~EndTag() {} - /// - virtual docstring writeEndTag() const; - /// - bool operator==(StartTag const & rhs) const - { return tag_ == rhs.tag_; } - /// - bool operator!=(StartTag const & rhs) const - { return !(*this == rhs); } - /// - virtual EndFontTag const * asFontTag() const { return 0; } - /// - docstring tag_; + /// + explicit EndTag(std::string tag) : tag_(from_ascii(tag)) {} + /// + explicit EndTag(docstring tag) : tag_(tag) {} + /// + virtual ~EndTag() {} + /// + virtual docstring writeEndTag() const; + /// + bool operator==(StartTag const & rhs) const + { return tag_ == rhs.tag_; } + /// + bool operator!=(StartTag const & rhs) const + { return !(*this == rhs); } + /// + virtual EndFontTag const * asFontTag() const { return 0; } + /// + docstring tag_; }; @@ -231,18 +231,18 @@ struct EndTag /// be escaped before being passed to the constructor. struct CompTag { - /// - explicit CompTag(std::string const & tag) - : tag_(tag) {} - /// - explicit CompTag(std::string const & tag, std::string const & attr) - : tag_(tag), attr_(attr) {} - /// - docstring writeTag() const; - /// - std::string tag_; - /// - std::string attr_; + /// + explicit CompTag(std::string const & tag) + : tag_(tag) {} + /// + explicit CompTag(std::string const & tag, std::string const & attr) + : tag_(tag), attr_(attr) {} + /// + docstring writeTag() const; + /// + std::string tag_; + /// + std::string attr_; }; @@ -250,84 +250,84 @@ struct CompTag /// parid is only used for HTML output; XML is supposed to use attr for this. struct ParTag : public StartTag { - /// - explicit ParTag(std::string const & tag, const std::string & attr): StartTag(tag, from_utf8(attr)) {} - /// - ~ParTag() {} + /// + explicit ParTag(std::string const & tag, const std::string & attr): StartTag(tag, from_utf8(attr)) {} + /// + ~ParTag() {} }; /// enum FontTypes { - // ranges - FT_EMPH, - FT_NOUN, - FT_UBAR, - FT_DBAR, - FT_WAVE, - FT_SOUT, - FT_XOUT, - // bold - FT_BOLD, - // shapes - FT_UPRIGHT, - FT_ITALIC, - FT_SLANTED, - FT_SMALLCAPS, - // families - FT_ROMAN, - FT_SANS, - FT_TYPE, - // sizes - FT_SIZE_TINY, - FT_SIZE_SCRIPT, - FT_SIZE_FOOTNOTE, - FT_SIZE_SMALL, - FT_SIZE_NORMAL, - FT_SIZE_LARGE, - FT_SIZE_LARGER, - FT_SIZE_LARGEST, - FT_SIZE_HUGE, - FT_SIZE_HUGER, - FT_SIZE_INCREASE, - FT_SIZE_DECREASE - - // When updating this list, also update fontToTag in both output_docbook.cpp and output_xhtml.cpp, - // fontToRole in output_docbook.cpp, and fontToAttribute in output_xhtml.cpp. + // ranges + FT_EMPH, + FT_NOUN, + FT_UBAR, + FT_DBAR, + FT_WAVE, + FT_SOUT, + FT_XOUT, + // bold + FT_BOLD, + // shapes + FT_UPRIGHT, + FT_ITALIC, + FT_SLANTED, + FT_SMALLCAPS, + // families + FT_ROMAN, + FT_SANS, + FT_TYPE, + // sizes + FT_SIZE_TINY, + FT_SIZE_SCRIPT, + FT_SIZE_FOOTNOTE, + FT_SIZE_SMALL, + FT_SIZE_NORMAL, + FT_SIZE_LARGE, + FT_SIZE_LARGER, + FT_SIZE_LARGEST, + FT_SIZE_HUGE, + FT_SIZE_HUGER, + FT_SIZE_INCREASE, + FT_SIZE_DECREASE + + // When updating this list, also update fontToTag in both output_docbook.cpp and output_xhtml.cpp, + // fontToRole in output_docbook.cpp, and fontToAttribute in output_xhtml.cpp. }; /// struct FontTag : public StartTag { - /// - FontTag(docstring const & tag, FontTypes type): StartTag(tag), font_type_(type) {} - /// - FontTag(std::string const & tag, FontTypes type): StartTag(from_utf8(tag)), font_type_(type) {} - /// - FontTag(docstring const & tag, docstring const & attr, FontTypes type): StartTag(tag, attr), font_type_(type) {} - /// - FontTag(std::string const & tag, std::string const & attr, FontTypes type): StartTag(from_utf8(tag), from_utf8(attr)), font_type_(type) {} - /// - FontTag const * asFontTag() const override { return this; } - /// - bool operator==(StartTag const &) const override; - /// - FontTypes font_type_; + /// + FontTag(docstring const & tag, FontTypes type): StartTag(tag), font_type_(type) {} + /// + FontTag(std::string const & tag, FontTypes type): StartTag(from_utf8(tag)), font_type_(type) {} + /// + FontTag(docstring const & tag, docstring const & attr, FontTypes type): StartTag(tag, attr), font_type_(type) {} + /// + FontTag(std::string const & tag, std::string const & attr, FontTypes type): StartTag(from_utf8(tag), from_utf8(attr)), font_type_(type) {} + /// + FontTag const * asFontTag() const override { return this; } + /// + bool operator==(StartTag const &) const override; + /// + FontTypes font_type_; }; /// struct EndFontTag : public EndTag { - /// - EndFontTag(docstring const & tag, FontTypes type): EndTag(tag), font_type_(type) {} - /// - EndFontTag(std::string const & tag, FontTypes type): EndTag(from_utf8(tag)), font_type_(type) {} - /// - EndFontTag const * asFontTag() const override { return this; } - /// - FontTypes font_type_; + /// + EndFontTag(docstring const & tag, FontTypes type): EndTag(tag), font_type_(type) {} + /// + EndFontTag(std::string const & tag, FontTypes type): EndTag(from_utf8(tag)), font_type_(type) {} + /// + EndFontTag const * asFontTag() const override { return this; } + /// + FontTypes font_type_; };