sharg 1.0.0
THE argument parser for bio-c++ tools.
•All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages Concepts
format_html.hpp
Go to the documentation of this file.
1// --------------------------------------------------------------------------------------------------------
2// Copyright (c) 2006-2022, Knut Reinert & Freie Universität Berlin
3// Copyright (c) 2016-2022, Knut Reinert & MPI für molekulare Genetik
4// This file may be used, modified and/or redistributed under the terms of the 3-clause BSD-License
5// shipped with this file and also available at: https://github.com/seqan/sharg-parser/blob/main/LICENSE.md
6// --------------------------------------------------------------------------------------------------------
7
13#pragma once
14
15#include <sharg/detail/format_base.hpp>
16
17namespace sharg::detail
18{
19
32class format_html : public format_help_base<format_html>
33{
35 using base_type = format_help_base<format_html>;
36
38 friend base_type;
39
40public:
44 format_html() = default;
45 format_html(format_html const & pf) = default;
46 format_html & operator=(format_html const & pf) = default;
47 format_html(format_html &&) = default;
48 format_html & operator=(format_html &&) = default;
49 ~format_html() = default;
50
52 format_html(std::vector<std::string> const & names, bool const advanced = false) : base_type{names, advanced} {};
54
55private:
57 void maybe_close_list()
58 {
59 if (is_dl)
60 {
61 std::cout << "</dl>\n";
62 is_dl = false;
63 }
64 }
65
67 void maybe_close_paragraph()
68 {
69 if (is_p)
70 {
71 std::cout << "</p>\n";
72 is_p = false;
73 }
74 }
75
77 void print_header()
78 {
79 // Print HTML boilerplate header.
80 std::cout << "<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01//EN\" "
81 << "http://www.w3.org/TR/html4/strict.dtd\">\n"
82 << "<html lang=\"en\">\n"
83 << "<head>\n"
84 << "<meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\">\n"
85 << "<title>" << escape_special_xml_chars(meta.app_name) << " &mdash; "
86 << escape_special_xml_chars(meta.short_description) << "</title>\n"
87 << "</head>\n"
88 << "<body>\n";
89
90 std::cout << "<h1>" << to_html(meta.app_name) << "</h1>\n"
91 << "<div>" << to_html(meta.short_description) << "</div>\n";
92 }
93
97 void print_section(std::string const & title)
98 {
99 // SEQAN_ASSERT_NOT_MSG(isDl && isP, "Current <dl> and <p> are mutually exclusive.");
100 maybe_close_list();
101 maybe_close_paragraph();
102 std::cout << "<h2>" << to_html(title) << "</h2>\n";
103 }
104
108 void print_subsection(std::string const & title)
109 {
110 // SEQAN_ASSERT_NOT_MSG(isDl && isP, "Current <dl> and <p> are mutually exclusive.");
111 maybe_close_list();
112 maybe_close_paragraph();
113 std::cout << "<h3>" << to_html(title) << "</h3>\n";
114 }
115
121 void print_line(std::string const & text, bool line_is_paragraph)
122 {
123 // SEQAN_ASSERT_NOT_MSG(isDl && isP, "Current <dl> and <p> are mutually exclusive.");
124 maybe_close_list();
125 if (!is_p) // open parapgraph
126 {
127 std::cout << "<p>\n";
128 is_p = true;
129 }
130 std::cout << to_html(text) << "\n";
131 if (line_is_paragraph)
132 maybe_close_paragraph();
133 else
134 std::cout << "<br>\n";
135 }
136
146 void print_list_item(std::string const & term, std::string const & desc)
147 {
148 // SEQAN_ASSERT_NOT_MSG(isDl && isP, "Current <dl> and <p> are mutually exclusive.");
149 maybe_close_paragraph();
150
151 if (!is_dl)
152 {
153 std::cout << "<dl>\n";
154 is_dl = true;
155 }
156 std::cout << "<dt>" << to_html(term) << "</dt>\n"
157 << "<dd>" << to_html(desc) << "</dd>\n";
158 }
159
161 void print_footer()
162 {
163 maybe_close_paragraph();
164
165 // Print HTML boilerplate footer.
166 std::cout << "</body></html>";
167 }
168
173 std::string to_html(std::string const & input)
174 {
175 std::string buffer = escape_special_xml_chars(input);
176 std::string result;
177 std::vector<std::string> open_tags; // acts as a stack of html tags
178
179 for (auto it = input.begin(); it != input.end(); ++it)
180 {
181 if (*it == '\\')
182 {
183 // Handle escape sequence, we interpret only "\-", "\fI", and "\fB".
184 ++it;
185 assert(!(it == input.end()));
186 if (*it == '-')
187 {
188 result.push_back(*it);
189 }
190 else if (*it == 'f')
191 {
192 ++it;
193 assert(!(it == input.end()));
194 if (*it == 'I')
195 {
196 open_tags.push_back("em");
197 result.append("<em>");
198 }
199 else if (*it == 'B')
200 {
201 open_tags.push_back("strong");
202 result.append("<strong>");
203 }
204 else if (*it == 'P')
205 {
206 assert(!open_tags.empty());
207 result.append("</");
208 result.append(open_tags.back());
209 result.append(">");
210 open_tags.pop_back();
211 }
212 else
213 {
214 result.append("\\f");
215 result.push_back(*it);
216 }
217 }
218 else
219 {
220 result.push_back('\\');
221 result.push_back(*it);
222 }
223 }
224 else
225 {
226 result.push_back(*it);
227 }
228 }
229
230 return result;
231 }
232
237 std::string in_bold(std::string const & str)
238 {
239 return "<strong>" + str + "</strong>";
240 }
241
243 bool is_dl{false};
245 bool is_p{false};
246};
247
248} // namespace sharg::detail
std::string::append
T append(T... args)
std::vector::back
T back(T... args)
std::string::begin
T begin(T... args)
std::vector::empty
T empty(T... args)
std::string::end
T end(T... args)
format_base.hpp
Provides the format_base struct containing all helper functions that are needed in all formats.
std::vector::pop_back
T pop_back(T... args)
std::string::push_back
T push_back(T... args)