#define OUTPUT_XHTML_H
#include "support/docstream.h"
+#include "support/strfwd.h"
#include <deque>
#include <vector>
// 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 {
///
- StartTag(std::string const & tag) : tag_(tag) {}
+ explicit StartTag(std::string const & tag) : tag_(tag) {}
///
- StartTag(std::string const & tag, std::string const & attr,
+ explicit StartTag(std::string const & tag, std::string const & attr,
bool keepempty = false)
: tag_(tag), attr_(attr), keepempty_(keepempty) {}
/// <tag_ attr_>
struct EndTag {
///
- EndTag(std::string tag) : tag_(tag) {}
+ explicit EndTag(std::string tag) : tag_(tag) {}
/// </tag_>
docstring asEndTag() const;
///
};
-// Tags like <img />
+/// Tags like <img />
+/// Attributes will be escaped automatically and so should NOT
+/// be escaped before passing to the constructor.
struct CompTag {
///
- CompTag(std::string const & tag, std::string const & attr)
+ 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;
///
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_;
TagDeque pending_tags_;
/// remembers the history, so we can make sure we nest properly.
TagStack tag_stack_;
+ ///
+ bool nextraw_;
};
///
docstring escapeChar(char_type c);
/// converts a string to a form safe for links, etc
docstring htmlize(docstring const & str);
+/// cleans \param str for use as an atttribute by replacing
+/// all non-alnum by "_"
+docstring cleanAttr(docstring const & str);
+///
+std::string escapeChar(char c);
+///
+std::string htmlize(std::string const & str);
+///
+std::string cleanAttr(std::string const & str);
// to be removed
/// \return true if tag was opened, false if not