1 /* PSPP - a program for statistical analysis.
2 Copyright (C) 1997-9, 2000, 2009, 2010, 2011, 2012, 2013, 2014, 2017,
3 2020 Free Software Foundation, Inc.
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation, either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
28 #include "data/file-name.h"
29 #include "data/file-handle-def.h"
30 #include "libpspp/assertion.h"
31 #include "libpspp/cast.h"
32 #include "libpspp/compiler.h"
33 #include "libpspp/i18n.h"
34 #include "libpspp/message.h"
35 #include "libpspp/version.h"
37 #include "output/cairo-chart.h"
39 #include "output/chart-item.h"
40 #include "output/driver-provider.h"
41 #include "output/message-item.h"
42 #include "output/options.h"
43 #include "output/output-item-provider.h"
44 #include "output/table-provider.h"
45 #include "output/table-item.h"
46 #include "output/text-item.h"
48 #include "gl/minmax.h"
49 #include "gl/xalloc.h"
52 #define _(msgid) gettext (msgid)
54 /* This file uses TABLE_HORZ and TABLE_VERT enough to warrant abbreviating. */
60 struct output_driver driver;
65 struct file_handle *handle;
66 char *chart_file_name;
76 static const struct output_driver_class html_driver_class;
78 static void html_output_table (struct html_driver *, const struct table_item *);
79 static void escape_string (FILE *file, const char *text,
80 const char *space, const char *newline);
81 static void print_title_tag (FILE *file, const char *name,
84 static struct html_driver *
85 html_driver_cast (struct output_driver *driver)
87 assert (driver->class == &html_driver_class);
88 return UP_CAST (driver, struct html_driver, driver);
91 static struct driver_option *
92 opt (struct output_driver *d, struct string_map *options, const char *key,
93 const char *default_value)
95 return driver_option_get (d, options, key, default_value);
99 put_header (struct html_driver *html)
101 fputs ("<!doctype html>\n", html->file);
102 fprintf (html->file, "<html");
103 char *ln = get_language ();
105 fprintf (html->file, " lang=\"%s\"", ln);
107 fprintf (html->file, ">\n");
108 fputs ("<head>\n", html->file);
109 print_title_tag (html->file, "title", _("PSPP Output"));
110 fprintf (html->file, "<meta name=\"generator\" content=\"%s\">\n", version);
111 fputs ("<meta http-equiv=\"content-type\" "
112 "content=\"text/html; charset=utf-8\">\n", html->file);
119 " background: white;\n"
121 " padding: 0em 12em 0em 3em;\n"
125 " margin: 0pt 0pt 0pt 0em\n"
128 " text-indent: 1.5em;\n"
131 " font-size: 150%;\n"
132 " margin-left: -1.33em\n"
135 " font-size: 125%;\n"
136 " font-weight: bold;\n"
137 " margin-left: -.8em\n"
140 " font-size: 100%;\n"
141 " font-weight: bold;\n"
142 " margin-left: -.5em }\n"
144 " font-size: 100%;\n"
145 " margin-left: 0em\n"
147 "h1, h2, h3, h4, h5, h6 {\n"
148 " font-family: sans-serif;\n"
155 " font-family: sans-serif\n"
158 " border-collapse: collapse;\n"
159 " margin-bottom: 1em\n"
162 " text-align: left\n"
164 "th { font-weight: normal }\n"
178 fputs ("</head>\n", html->file);
179 fputs ("<body>\n", html->file);
182 static struct output_driver *
183 html_create (struct file_handle *fh, enum settings_output_devices device_type,
184 struct string_map *o)
186 struct output_driver *d;
187 struct html_driver *html;
189 html = xzalloc (sizeof *html);
191 output_driver_init (&html->driver, &html_driver_class, fh_get_file_name (fh),
193 html->bare = parse_boolean (opt (d, o, "bare", "false"));
194 html->css = parse_boolean (opt (d, o, "css", "true"));
195 html->borders = parse_boolean (opt (d, o, "borders", "true"));
198 html->chart_file_name = parse_chart_file_name (opt (d, o, "charts",
199 fh_get_file_name (fh)));
203 html->bg = parse_color (opt (d, o, "background-color", "#FFFFFFFFFFFF"));
204 html->fg = parse_color (opt (d, o, "foreground-color", "#000000000000"));
206 html->file = fn_open (html->handle, "w");
207 if (html->file == NULL)
209 msg_error (errno, _("error opening output file `%s'"), fh_get_file_name (html->handle));
219 output_driver_destroy (d);
223 /* Emits <NAME>CONTENT</NAME> to the output, escaping CONTENT as
224 necessary for HTML. */
226 print_title_tag (FILE *file, const char *name, const char *content)
230 fprintf (file, "<%s>", name);
231 escape_string (file, content, " ", " - ");
232 fprintf (file, "</%s>\n", name);
237 html_destroy (struct output_driver *driver)
239 struct html_driver *html = html_driver_cast (driver);
241 if (html->file != NULL)
247 "<!-- end of file -->\n");
248 fn_close (html->handle, html->file);
250 free (html->chart_file_name);
251 fh_unref (html->handle);
256 html_submit (struct output_driver *driver,
257 const struct output_item *output_item)
259 struct html_driver *html = html_driver_cast (driver);
261 if (is_table_item (output_item))
263 struct table_item *table_item = to_table_item (output_item);
264 html_output_table (html, table_item);
267 else if (is_chart_item (output_item) && html->chart_file_name != NULL)
269 struct chart_item *chart_item = to_chart_item (output_item);
272 file_name = xr_draw_png_chart (chart_item, html->chart_file_name,
277 if (file_name != NULL)
279 const char *title = chart_item_get_title (chart_item);
280 fprintf (html->file, "<img src=\"%s\" alt=\"chart: %s\">",
281 file_name, title ? title : _("No description"));
285 #endif /* HAVE_CAIRO */
286 else if (is_text_item (output_item))
288 struct text_item *text_item = to_text_item (output_item);
289 const char *s = text_item_get_text (text_item);
291 switch (text_item_get_type (text_item))
293 case TEXT_ITEM_PAGE_TITLE:
296 case TEXT_ITEM_TITLE:
298 int level = MIN (5, output_get_group_level ()) + 1;
299 char tag[3] = { 'H', level + '1', '\0' };
300 print_title_tag (html->file, tag, s);
304 case TEXT_ITEM_SYNTAX:
305 fprintf (html->file, "<pre class=\"syntax\">");
306 escape_string (html->file, s, " ", "<br>");
307 fprintf (html->file, "</pre>\n");
311 fprintf (html->file, "<p>");
312 escape_string (html->file, s, " ", "<br>");
313 fprintf (html->file, "</p>\n");
317 else if (is_message_item (output_item))
319 const struct message_item *message_item = to_message_item (output_item);
320 char *s = msg_to_string (message_item_get_msg (message_item));
321 fprintf (html->file, "<p>");
322 escape_string (html->file, s, " ", "<br>");
323 fprintf (html->file, "</p>\n");
328 /* Write TEXT to file F, escaping characters as necessary for HTML. Spaces are
329 replaced by SPACE, which should be " " or " " New-lines are replaced by
330 NEWLINE, which might be "<BR>" or "\n" or something else appropriate. */
332 escape_string (FILE *file, const char *text,
333 const char *space, const char *newline)
343 fputs (newline, file);
346 fputs ("&", file);
349 fputs ("<", file);
352 fputs (">", file);
358 fputs (""", file);
368 escape_tag (FILE *file, const char *tag,
369 const char *text, const char *space, const char *newline)
374 fprintf (file, "<%s>", tag);
375 escape_string (file, text, space, newline);
376 fprintf (file, "</%s>", tag);
380 border_to_css (int border)
384 case TABLE_STROKE_NONE:
387 case TABLE_STROKE_SOLID:
390 case TABLE_STROKE_DASHED:
393 case TABLE_STROKE_THICK:
394 return "thick solid";
396 case TABLE_STROKE_THIN:
399 case TABLE_STROKE_DOUBLE:
415 style_start (struct css_style *cs, FILE *file)
417 *cs = (struct css_style) {
424 style_end (struct css_style *cs)
426 if (cs->n_styles > 0)
427 fputs ("'", cs->file);
431 put_style (struct css_style *st, const char *name, const char *value)
433 bool first = !st->n_styles++;
434 fprintf (st->file, "%s%s: %s", first ? " style='" : "; ", name, value);
438 format_color (const struct cell_color color,
439 const struct cell_color default_color,
440 char *buf, size_t bufsize)
442 bool retval = !cell_color_equal (&color, &default_color);
445 if (color.alpha == 255)
446 snprintf (buf, bufsize, "#%02x%02x%02x", color.r, color.g, color.b);
448 snprintf (buf, bufsize, "rgba(%d, %d, %d, %.3f)",
449 color.r, color.g, color.b, color.alpha / 255.0);
455 put_border (struct css_style *st, int style, const struct cell_color *color,
456 const char *border_name)
458 const char *css = border_to_css (style);
461 if (st->n_styles++ > 0)
462 fputs ("; ", st->file);
463 fprintf (st->file, "border-%s: %s", border_name, css);
466 if (format_color (*color, (struct cell_color) CELL_COLOR_BLACK,
468 fprintf (st->file, " %s", buf);
473 put_tfoot (struct html_driver *html, const struct table *t, bool *tfoot)
477 fputs ("<tfoot>\n", html->file);
478 fputs ("<tr>\n", html->file);
479 fprintf (html->file, "<td colspan=%d>\n", t->n[H]);
483 fputs ("\n<br>", html->file);
487 html_put_footnote_markers (struct html_driver *html,
488 struct footnote **footnotes,
493 fputs ("<sup>", html->file);
494 for (size_t i = 0; i < n_footnotes; i++)
496 const struct footnote *f = footnotes[i];
499 putc (',', html->file);
500 escape_string (html->file, f->marker, " ", "<br>");
502 fputs ("</sup>", html->file);
507 html_put_table_item_text (struct html_driver *html,
508 const struct table_item_text *text)
510 escape_string (html->file, text->content, " ", "<br>");
511 html_put_footnote_markers (html, text->footnotes, text->n_footnotes);
515 html_put_table_cell_text (struct html_driver *html,
516 const struct table_cell *cell)
518 const char *s = cell->text;
519 if (cell->options & TAB_FIX)
520 escape_tag (html->file, "tt", s, " ", "<br>");
523 s += strspn (s, CC_SPACES);
524 escape_string (html->file, s, " ", "<br>");
527 if (cell->n_subscripts)
529 fputs ("<sub>", html->file);
530 for (size_t i = 0; i < cell->n_subscripts; i++)
533 putc (',', html->file);
534 escape_string (html->file, cell->subscripts[i],
537 fputs ("</sub>", html->file);
539 html_put_footnote_markers (html, cell->footnotes, cell->n_footnotes);
543 html_put_table_item_layers (struct html_driver *html,
544 const struct table_item_layers *layers)
546 for (size_t i = 0; i < layers->n_layers; i++)
549 fputs ("<br>\n", html->file);
551 const struct table_item_layer *layer = &layers->layers[i];
552 escape_string (html->file, layer->content, " ", "<br>");
553 html_put_footnote_markers (html, layer->footnotes, layer->n_footnotes);
558 html_output_table (struct html_driver *html, const struct table_item *item)
560 const struct table *t = table_item_get_table (item);
564 fputs ("<table", html->file);
567 fputs (" title=\"", html->file);
568 escape_string (html->file, item->notes, " ", "\n");
569 putc ('"', html->file);
571 fputs (">\n", html->file);
573 const struct table_item_text *caption = table_item_get_caption (item);
576 put_tfoot (html, t, &tfoot);
577 html_put_table_item_text (html, caption);
580 size_t n_footnotes = table_collect_footnotes (item, &f);
582 for (size_t i = 0; i < n_footnotes; i++)
584 put_tfoot (html, t, &tfoot);
585 escape_tag (html->file, "sup", f[i]->marker, " ", "<br>");
586 escape_string (html->file, f[i]->content, " ", "<br>");
591 fputs ("</td>\n", html->file);
592 fputs ("</tr>\n", html->file);
593 fputs ("</tfoot>\n", html->file);
596 const struct table_item_text *title = table_item_get_title (item);
597 const struct table_item_layers *layers = table_item_get_layers (item);
600 fputs ("<caption>", html->file);
602 html_put_table_item_text (html, title);
604 fputs ("<br>\n", html->file);
606 html_put_table_item_layers (html, layers);
607 fputs ("</caption>\n", html->file);
610 fputs ("<tbody>\n", html->file);
612 for (y = 0; y < t->n[V]; y++)
616 fputs ("<tr>\n", html->file);
617 for (x = 0; x < t->n[H];)
619 struct table_cell cell;
622 table_get_cell (t, x, y, &cell);
623 if (x != cell.d[TABLE_HORZ][0] || y != cell.d[TABLE_VERT][0])
626 /* output <td> or <th> tag. */
627 bool is_header = (y < t->h[V][0]
628 || y >= t->n[V] - t->h[V][1]
630 || x >= t->n[H] - t->h[H][1]);
631 tag = is_header ? "th" : "td";
632 fprintf (html->file, "<%s", tag);
634 struct css_style style;
635 style_start (&style, html->file);
636 enum table_halign halign = table_halign_interpret (
637 cell.style->cell_style.halign, cell.options & TAB_NUMERIC);
641 case TABLE_HALIGN_RIGHT:
642 put_style (&style, "text-align", "right");
644 case TABLE_HALIGN_CENTER:
645 put_style (&style, "text-align", "center");
652 if (cell.options & TAB_ROTATE)
653 put_style (&style, "writing-mode", "sideways-lr");
655 if (cell.style->cell_style.valign != TABLE_VALIGN_TOP)
657 put_style (&style, "vertical-align",
658 (cell.style->cell_style.valign == TABLE_VALIGN_BOTTOM
659 ? "bottom" : "middle"));
662 const struct font_style *fs = &cell.style->font_style;
664 if (format_color (fs->bg[y % 2],
665 (struct cell_color) CELL_COLOR_WHITE,
666 bgcolor, sizeof bgcolor))
667 put_style (&style, "background", bgcolor);
670 if (format_color (fs->fg[y % 2],
671 (struct cell_color) CELL_COLOR_BLACK,
672 fgcolor, sizeof fgcolor))
673 put_style (&style, "color", fgcolor);
677 put_style (&style, "font-family", "\"");
678 escape_string (html->file, fs->typeface, " ", "\n");
679 putc ('"', html->file);
682 put_style (&style, "font-weight", "bold");
684 put_style (&style, "font-style", "italic");
686 put_style (&style, "text-decoration", "underline");
690 snprintf (buf, sizeof buf, "%dpt", fs->size);
691 put_style (&style, "font-size", buf);
694 int colspan = table_cell_colspan (&cell);
695 int rowspan = table_cell_rowspan (&cell);
700 struct cell_color color;
702 int top = table_get_rule (t, TABLE_VERT, x, y, &color);
703 put_border (&style, top, &color, "top");
705 if (y + rowspan == t->n[V])
707 int bottom = table_get_rule (t, TABLE_VERT, x, y + rowspan,
709 put_border (&style, bottom, &color, "bottom");
712 int left = table_get_rule (t, TABLE_HORZ, x, y, &color);
713 put_border (&style, left, &color, "left");
715 if (x + colspan == t->n[H])
717 int right = table_get_rule (t, TABLE_HORZ, x + colspan, y,
719 put_border (&style, right, &color, "right");
725 fprintf (html->file, " colspan=\"%d\"", colspan);
728 fprintf (html->file, " rowspan=\"%d\"", rowspan);
730 putc ('>', html->file);
732 html_put_table_cell_text (html, &cell);
734 /* output </th> or </td>. */
735 fprintf (html->file, "</%s>\n", tag);
738 x = cell.d[TABLE_HORZ][1];
740 fputs ("</tr>\n", html->file);
743 fputs ("</tbody>\n", html->file);
744 fputs ("</table>\n\n", html->file);
747 struct output_driver_factory html_driver_factory =
748 { "html", "pspp.html", html_create };
750 static const struct output_driver_class html_driver_class =