/*========================================================================= Program: CMake - Cross-Platform Makefile Generator Module: $RCSfile$ Language: C++ Date: $Date$ Version: $Revision$ Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved. See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details. This software is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the above copyright notices for more information. =========================================================================*/ #include "cmDocumentationFormatterHTML.h" #include "cmDocumentationSection.h" //---------------------------------------------------------------------------- static bool cmDocumentationIsHyperlinkChar(char c) { // This is not a complete list but works for CMake documentation. return ((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') || c == '-' || c == '.' || c == '/' || c == '~' || c == '@' || c == ':' || c == '_' || c == '&' || c == '?' || c == '='); } //---------------------------------------------------------------------------- static void cmDocumentationPrintHTMLChar(std::ostream& os, char c) { // Use an escape sequence if necessary. std::map escapes; escapes['<'] = "<"; escapes['>'] = ">"; escapes['&'] = "&"; escapes['\n'] = "
"; if (escapes.find(c) == escapes.end()) { // No escape sequence is needed. os << c; return; } os << escapes[c]; return; } //---------------------------------------------------------------------------- const char* cmDocumentationPrintHTMLLink(std::ostream& os, const char* begin) { // Look for the end of the link. const char* end = begin; while(cmDocumentationIsHyperlinkChar(*end)) { ++end; } // Print the hyperlink itself. os << ""; // The name of the hyperlink is the text itself. for(const char* c = begin; c != end; ++c) { cmDocumentationPrintHTMLChar(os, *c); } os << ""; // Return the position at which to continue scanning the input // string. return end; } cmDocumentationFormatterHTML::cmDocumentationFormatterHTML() :cmDocumentationFormatter() { } void cmDocumentationFormatterHTML ::PrintSection(std::ostream& os, const cmDocumentationSection §ion, const char* name) { if(name) { os << "

" << name << "

\n"; } const std::vector &entries = section.GetEntries(); for(std::vector::const_iterator op = entries.begin(); op != entries.end();) { if(op->Name.size()) { os << "
    \n"; for(;op != entries.end() && op->Name.size(); ++op) { os << "
  • \n"; if(op->Name.size()) { os << " "; this->PrintHTMLEscapes(os, op->Name.c_str()); os << ": "; } this->PrintHTMLEscapes(os, op->Brief.c_str()); if(op->Full.size()) { os << "
    \n "; this->PrintFormatted(os, op->Full.c_str()); } os << "\n"; os << "
  • \n"; } os << "
\n"; } else { this->PrintFormatted(os, op->Brief.c_str()); os << "\n"; ++op; } } } void cmDocumentationFormatterHTML::PrintPreformatted(std::ostream& os, const char* text) { os << "
";
  this->PrintHTMLEscapes(os, text);
  os << "
\n "; } void cmDocumentationFormatterHTML::PrintParagraph(std::ostream& os, const char* text) { os << "

"; this->PrintHTMLEscapes(os, text); } //---------------------------------------------------------------------------- void cmDocumentationFormatterHTML::PrintHeader(const char* /*name*/, std::ostream& os) { os << "\n"; } //---------------------------------------------------------------------------- void cmDocumentationFormatterHTML::PrintFooter(std::ostream& os) { os << "\n"; } //---------------------------------------------------------------------------- void cmDocumentationFormatterHTML::PrintHTMLEscapes(std::ostream& os, const char* text) { // Hyperlink prefixes. static const char* hyperlinks[] = {"http://", "ftp://", "mailto:", 0}; // Print each character. for(const char* p = text; *p;) { // Handle hyperlinks specially to make them active. bool found_hyperlink = false; for(const char** h = hyperlinks; !found_hyperlink && *h; ++h) { if(strncmp(p, *h, strlen(*h)) == 0) { p = cmDocumentationPrintHTMLLink(os, p); found_hyperlink = true; } } // Print other characters normally. if(!found_hyperlink) { cmDocumentationPrintHTMLChar(os, *p++); } } }