+class Text;
+
+// Inspiration for the *Tag structs and for XHTMLStream
+// came from MathStream and its cousins.
+
+/// Attributes will be escaped automatically and so should NOT
+/// be escaped before passing to the constructor.
+struct StartTag {
+ ///
+ explicit StartTag(std::string const & tag) : tag_(tag) {}
+ ///
+ explicit StartTag(std::string const & tag, std::string const & attr,
+ bool keepempty = false)
+ : tag_(tag), attr_(attr), keepempty_(keepempty) {}
+ /// <tag_ attr_>
+ docstring asTag() const;
+ /// </tag_>
+ docstring asEndTag() const;
+ ///
+ std::string tag_;
+ ///
+ std::string attr_;
+ /// whether to keep things like "<tag></tag>" 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_(tag) {}
+ /// </tag_>
+ docstring asEndTag() const;
+ ///
+ std::string tag_;
+};
+
+
+/// Tags like <img />
+/// Attributes will be escaped automatically and so should NOT
+/// be escaped before passing 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) {}
+ /// <tag_ attr_ />
+ docstring asTag() const;
+ ///
+ std::string tag_;
+ ///
+ std::string attr_;
+};
+
+
+class XHTMLStream {
+public:
+ ///
+ explicit XHTMLStream(odocstream & os);
+ ///
+ void cr();
+ ///
+ 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();
+ ///
+ XHTMLStream & operator<<(docstring const &);
+ ///
+ XHTMLStream & operator<<(const char *);
+ ///
+ XHTMLStream & operator<<(char_type);
+ ///
+ XHTMLStream & operator<<(StartTag const &);
+ ///
+ XHTMLStream & operator<<(EndTag const &);
+ ///
+ XHTMLStream & operator<<(CompTag const &);
+ /// A trivial struct that functions as a stream modifier.
+ /// << NextRaw() causes the next string-like thing sent to the
+ /// stream not to be escaped.
+ struct NextRaw {};
+ ///
+ XHTMLStream & operator<<(NextRaw const &);
+private:
+ ///
+ void clearTagDeque();
+ ///
+ bool isTagOpen(std::string const &);
+ ///
+ void writeError(std::string const &);
+ ///
+ odocstream & os_;
+ ///
+ // int tab_;
+ ///
+ typedef std::deque<StartTag> TagDeque;
+ ///
+ typedef std::vector<StartTag> TagStack;
+ /// holds start tags until we know there is content in them.
+ TagDeque pending_tags_;
+ /// remembers the history, so we can make sure we nest properly.
+ TagStack tag_stack_;
+ ///
+ bool nextraw_;
+};