OSDN Git Service

BugTrack/2420 Simplify AutoTicketLink script: DOM to JSON
[pukiwiki/pukiwiki.git] / lib / html.php
1 <?php
2 // PukiWiki - Yet another WikiWikiWeb clone.
3 // html.php
4 // Copyright
5 //   2002-2017 PukiWiki Development Team
6 //   2001-2002 Originally written by yu-ji
7 // License: GPL v2 or (at your option) any later version
8 //
9 // HTML-publishing related functions
10
11 // Show page-content
12 function catbody($title, $page, $body)
13 {
14         global $vars, $arg, $defaultpage, $whatsnew, $help_page, $hr;
15         global $attach_link, $related_link, $cantedit, $function_freeze;
16         global $search_word_color, $_msg_word, $foot_explain, $note_hr, $head_tags;
17         global $javascript, $nofollow;
18         global $_LANG, $_LINK, $_IMAGE;
19         global $auth_type, $auth_user;
20
21         global $pkwk_dtd;     // XHTML 1.1, XHTML1.0, HTML 4.01 Transitional...
22         global $page_title;   // Title of this site
23         global $do_backup;    // Do backup or not
24         global $modifier;     // Site administrator's  web page
25         global $modifierlink; // Site administrator's name
26
27         $script = get_base_uri();
28         $enable_login = false;
29         $enable_logout = false;
30         if (AUTH_TYPE_FORM === $auth_type || AUTH_TYPE_EXTERNAL === $auth_type ||
31                 AUTH_TYPE_SAML === $auth_type) {
32                 if ($auth_user) {
33                         $enable_logout = true;
34                 } else {
35                         $enable_login = true;
36                 }
37         } else if (AUTH_TYPE_BASIC === $auth_type) {
38                 if ($auth_user) {
39                         $enable_logout = true;
40                 }
41         }
42         if (! file_exists(SKIN_FILE) || ! is_readable(SKIN_FILE))
43                 die_message('SKIN_FILE is not found');
44
45         $_LINK = $_IMAGE = array();
46
47         $_page  = isset($vars['page']) ? $vars['page'] : '';
48         $r_page = pagename_urlencode($_page);
49
50         // Canonical URL
51         $canonical_url = get_page_uri($_page, PKWK_URI_ABSOLUTE);
52
53         // Set $_LINK for skin
54         $_LINK['add']      = "$script?cmd=add&amp;page=$r_page";
55         $_LINK['backup']   = "$script?cmd=backup&amp;page=$r_page";
56         $_LINK['copy']     = "$script?plugin=template&amp;refer=$r_page";
57         $_LINK['diff']     = "$script?cmd=diff&amp;page=$r_page";
58         $_LINK['edit']     = "$script?cmd=edit&amp;page=$r_page";
59         $_LINK['filelist'] = "$script?cmd=filelist";
60         $_LINK['freeze']   = "$script?cmd=freeze&amp;page=$r_page";
61         $_LINK['help']     = get_page_uri($help_page);
62         $_LINK['list']     = "$script?cmd=list";
63         $_LINK['new']      = "$script?plugin=newpage&amp;refer=$r_page";
64         $_LINK['rdf']      = "$script?cmd=rss&amp;ver=1.0";
65         $_LINK['recent']   = get_page_uri($whatsnew);
66         $_LINK['reload']   = get_page_uri($_page);
67         $_LINK['rename']   = "$script?plugin=rename&amp;refer=$r_page";
68         $_LINK['rss']      = "$script?cmd=rss";
69         $_LINK['rss10']    = "$script?cmd=rss&amp;ver=1.0"; // Same as 'rdf'
70         $_LINK['rss20']    = "$script?cmd=rss&amp;ver=2.0";
71         $_LINK['search']   = "$script?cmd=search";
72         $_LINK['top']      = get_page_uri($defaultpage);
73         $_LINK['unfreeze'] = "$script?cmd=unfreeze&amp;page=$r_page";
74         $_LINK['upload']   = "$script?plugin=attach&amp;pcmd=upload&amp;page=$r_page";
75         $_LINK['canonical_url'] = $canonical_url;
76         $login_link = "#LOGIN_ERROR"; // dummy link that is not used
77         switch ($auth_type) {
78                 case AUTH_TYPE_FORM:
79                         $login_link = "$script?plugin=loginform&pcmd=login&page=$r_page";
80                         break;
81                 case AUTH_TYPE_EXTERNAL:
82                 case AUTH_TYPE_SAML:
83                         $login_link = get_auth_external_login_url($_page, $_LINK['reload']);
84                         break;
85         }
86         $_LINK['login']    = htmlsc($login_link);
87         $_LINK['logout']   = "$script?plugin=loginform&amp;pcmd=logout&amp;page=$r_page";
88
89         // Compat: Skins for 1.4.4 and before
90         $link_add       = & $_LINK['add'];
91         $link_new       = & $_LINK['new'];      // New!
92         $link_edit      = & $_LINK['edit'];
93         $link_diff      = & $_LINK['diff'];
94         $link_top       = & $_LINK['top'];
95         $link_list      = & $_LINK['list'];
96         $link_filelist  = & $_LINK['filelist'];
97         $link_search    = & $_LINK['search'];
98         $link_whatsnew  = & $_LINK['recent'];
99         $link_backup    = & $_LINK['backup'];
100         $link_help      = & $_LINK['help'];
101         $link_trackback = ''; // Removed (compat)
102         $link_rdf       = & $_LINK['rdf'];              // New!
103         $link_rss       = & $_LINK['rss'];
104         $link_rss10     = & $_LINK['rss10'];            // New!
105         $link_rss20     = & $_LINK['rss20'];            // New!
106         $link_freeze    = & $_LINK['freeze'];
107         $link_unfreeze  = & $_LINK['unfreeze'];
108         $link_upload    = & $_LINK['upload'];
109         $link_template  = & $_LINK['copy'];
110         $link_refer     = ''; // Removed (compat)
111         $link_rename    = & $_LINK['rename'];
112
113         // Init flags
114         $is_page = (is_pagename($_page) && ! arg_check('backup') && $_page != $whatsnew);
115         $is_read = (arg_check('read') && is_page($_page));
116         $is_freeze = is_freeze($_page);
117
118         // Last modification date (string) of the page
119         $lastmodified = $is_read ?  format_date(get_filetime($_page)) .
120                 ' ' . get_pg_passage($_page, FALSE) : '';
121
122         // List of attached files to the page
123         $show_attaches = $is_read || arg_check('edit');
124         $attaches = ($attach_link && $show_attaches && exist_plugin_action('attach')) ?
125                 attach_filelist() : '';
126
127         // List of related pages
128         $related  = ($related_link && $is_read) ? make_related($_page) : '';
129
130         // List of footnotes
131         ksort($foot_explain, SORT_NUMERIC);
132         $notes = ! empty($foot_explain) ? $note_hr . join("\n", $foot_explain) : '';
133
134         // Tags will be inserted into <head></head>
135         $head_tag = ! empty($head_tags) ? join("\n", $head_tags) ."\n" : '';
136
137         // 1.3.x compat
138         // Last modification date (UNIX timestamp) of the page
139         $fmt = $is_read ? get_filetime($_page) + LOCALZONE : 0;
140
141         // Output nofollow / noindex regardless os skin file
142         if (!$is_read || $nofollow) {
143                 if (!headers_sent()) {
144                         header("X-Robots-Tag: noindex,nofollow");
145                 }
146         }
147
148         // Send Canonical URL for Search Engine Optimization
149         if ($is_read && !headers_sent()) {
150                 header("Link: <$canonical_url>; rel=\"canonical\"");
151         }
152
153         // Search words
154         if ($search_word_color && isset($vars['word'])) {
155                 $body = '<div class="small">' . $_msg_word . htmlsc($vars['word']) .
156                         '</div>' . $hr . "\n" . $body;
157
158                 // BugTrack2/106: Only variables can be passed by reference from PHP 5.0.5
159                 // with array_splice(), array_flip()
160                 $words = preg_split('/\s+/', $vars['word'], -1, PREG_SPLIT_NO_EMPTY);
161                 $words = array_splice($words, 0, 10); // Max: 10 words
162                 $words = array_flip($words);
163
164                 $keys = array();
165                 foreach ($words as $word=>$id) $keys[$word] = strlen($word);
166                 arsort($keys, SORT_NUMERIC);
167                 $keys = get_search_words(array_keys($keys), TRUE);
168                 $id = 0;
169                 foreach ($keys as $key=>$pattern) {
170                         $s_key    = htmlsc($key);
171                         $pattern  = '/' .
172                                 '<textarea[^>]*>.*?<\/textarea>' .      // Ignore textareas
173                                 '|' . '<[^>]*>' .                       // Ignore tags
174                                 '|' . '&[^;]+;' .                       // Ignore entities
175                                 '|' . '(' . $pattern . ')' .            // $matches[1]: Regex for a search word
176                                 '/sS';
177                         $decorate_Nth_word = create_function(
178                                 '$matches',
179                                 'return (isset($matches[1])) ? ' .
180                                         '\'<strong class="word' .
181                                                 $id .
182                                         '">\' . $matches[1] . \'</strong>\' : ' .
183                                         '$matches[0];'
184                         );
185                         $body  = preg_replace_callback($pattern, $decorate_Nth_word, $body);
186                         $notes = preg_replace_callback($pattern, $decorate_Nth_word, $notes);
187                         ++$id;
188                 }
189         }
190
191         // Embed Scripting data
192         $html_scripting_data = get_html_scripting_data();
193
194         // Compat: 'HTML convert time' without time about MenuBar and skin
195         $taketime = elapsedtime();
196
197         require(SKIN_FILE);
198 }
199
200 /**
201  * Get data used by JavaScript modules
202  */
203 function get_html_scripting_data()
204 {
205         global $ticket_link_sites;
206         if (!isset($ticket_link_sites) || !is_array($ticket_link_sites)) {
207                 return '';
208         }
209         $is_utf8 = (bool)defined('PKWK_UTF8_ENABLE');
210         // Require: PHP 5.4+
211         $json_enabled = defined('JSON_UNESCAPED_UNICODE');
212         if (!$json_enabled) {
213                 $empty_data = <<<EOS
214 <div id="pukiwiki-site-properties" style="display:none;">
215 </div>
216 EOS;
217                 return $empty_data;
218         }
219         // Site basic Properties
220         $props = array(
221                 'is_utf8' => $is_utf8,
222                 'json_enabled' => $json_enabled,
223                 'base_uri_pathname' => get_base_uri(PKWK_URI_ROOT),
224                 'base_uri_absolute' => get_base_uri(PKWK_URI_ABSOLUTE)
225         );
226         $props_json = htmlsc(json_encode($props, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
227         $site_props = <<<EOS
228 <div data-key="site-props" data-value="$props_json"></div>
229 EOS;
230         // AutoTicketLink
231         $filtered_ticket_link_sites = array();
232         foreach ($ticket_link_sites as $s) {
233                 if (!preg_match('/^([a-zA-Z0-9]+)([\.\-][a-zA-Z0-9]+)*$/', $s['key'])) {
234                         continue;
235                 }
236                 array_push($filtered_ticket_link_sites, $s);
237         }
238         $h_ticket_link_sites = htmlsc(json_encode($filtered_ticket_link_sites,
239                 JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
240         $ticketlink_data = <<<EOS
241 <input type="hidden" class="ticketlink-def" value="$h_ticket_link_sites" />
242 EOS;
243         $data = <<<EOS
244 <div id="pukiwiki-site-properties" style="display:none;">
245 $site_props
246 $ticketlink_data
247 </div>
248 EOS;
249         return $data;
250 }
251
252 // Show 'edit' form
253 function edit_form($page, $postdata, $digest = FALSE, $b_template = TRUE)
254 {
255         global $vars, $rows, $cols, $hr, $function_freeze;
256         global $_btn_preview, $_btn_repreview, $_btn_update, $_btn_cancel, $_msg_help;
257         global $whatsnew, $_btn_template, $_btn_load, $load_template_func;
258         global $notimeupdate;
259         global $_title_list, $_label_template_pages;
260         global $rule_page;
261
262         $script = get_base_uri();
263         // Newly generate $digest or not
264         if ($digest === FALSE) $digest = md5(join('', get_source($page)));
265
266         $refer = $template = '';
267  
268         // Add plugin
269         $addtag = $add_top = '';
270         if(isset($vars['add'])) {
271                 global $_btn_addtop;
272                 $addtag  = '<input type="hidden" name="add"    value="true" />';
273                 $add_top = isset($vars['add_top']) ? ' checked="checked"' : '';
274                 $add_top = '<input type="checkbox" name="add_top" ' .
275                         'id="_edit_form_add_top" value="true"' . $add_top . ' />' . "\n" .
276                         '  <label for="_edit_form_add_top">' .
277                                 '<span class="small">' . $_btn_addtop . '</span>' .
278                         '</label>';
279         }
280
281         if($load_template_func && $b_template) {
282                 $tpage_names = array(); // Pages marked as template
283                 $template_page = ':config/Templates';
284                 $page_max = 100;
285                 foreach(get_source($template_page) as $_templates) {
286                         $m = array();
287                         if (! preg_match('#\-\s*\[\[([^\[\]]+)\]\]#', $_templates, $m)) continue;
288                         $tpage = preg_replace('#^./#', "$template_page/", $m[1]);
289                         if (! is_page($tpage)) continue;
290                         $tpage_names[] = $tpage;
291                 }
292                 $page_names = array();
293                 foreach(get_existpages() as $_page) {
294                         if ($_page == $whatsnew || check_non_list($_page) ||
295                                 !is_page_readable($_page))
296                                 continue;
297                         if (preg_match('/template/i', $_page)) {
298                                 $tpage_names[] = $_page;
299                         } else {
300                                 if (count($page_names) >= $page_max) continue;
301                                 $page_names[] = $_page;
302                         }
303                 }
304                 $tpage_names2 = array_values(array_unique($tpage_names));
305                 natcasesort($tpage_names2);
306                 natcasesort($page_names);
307                 $tpages = array(); // Template pages
308                 $npages = array(); // Normal pages
309                 foreach($tpage_names2 as $p) {
310                         $ps = htmlsc($p);
311                         $tpages[] = '   <option value="' . $ps . '">' . $ps . '</option>';
312                 }
313                 foreach($page_names as $p) {
314                         $ps = htmlsc($p);
315                         $npages[] = '   <option value="' . $ps . '">' . $ps . '</option>';
316                 }
317                 if (count($page_names) === $page_max) {
318                         $npages[] = '   <option value="">...</option>';
319                 }
320                 $s_tpages  = join("\n", $tpages);
321                 $s_npages  = join("\n", $npages);
322                 $template = <<<EOD
323   <select name="template_page">
324    <option value="">-- $_btn_template --</option>
325    <optgroup label="$_label_template_pages">
326 $s_tpages
327    </optgroup>
328    <optgroup label="$_title_list">
329 $s_npages
330    </optgroup>
331   </select>
332   <input type="submit" name="template" value="$_btn_load" accesskey="r" />
333   <br />
334 EOD;
335
336                 if (isset($vars['refer']) && $vars['refer'] != '')
337                         $refer = '[[' . strip_bracket($vars['refer']) . ']]' . "\n\n";
338         }
339
340         $r_page      = rawurlencode($page);
341         $s_page      = htmlsc($page);
342         $s_digest    = htmlsc($digest);
343         $s_postdata  = htmlsc($refer . $postdata);
344         $s_original  = isset($vars['original']) ? htmlsc($vars['original']) : $s_postdata;
345         $b_preview   = isset($vars['preview']); // TRUE when preview
346         $btn_preview = $b_preview ? $_btn_repreview : $_btn_preview;
347
348         // Checkbox 'do not change timestamp'
349         $add_notimestamp = '';
350         if ($notimeupdate != 0) {
351                 global $_btn_notchangetimestamp;
352                 $checked_time = isset($vars['notimestamp']) ? ' checked="checked"' : '';
353                 // Only for administrator
354                 if ($notimeupdate == 2) {
355                         $add_notimestamp = '   ' .
356                                 '<input type="password" name="pass" size="12" />' . "\n";
357                 }
358                 $add_notimestamp = '<input type="checkbox" name="notimestamp" ' .
359                         'id="_edit_form_notimestamp" value="true"' . $checked_time . ' />' . "\n" .
360                         '   ' . '<label for="_edit_form_notimestamp"><span class="small">' .
361                         $_btn_notchangetimestamp . '</span></label>' . "\n" .
362                         $add_notimestamp .
363                         '&nbsp;';
364         }
365
366         // 'margin-bottom', 'float:left', and 'margin-top'
367         // are for layout of 'cancel button'
368         $body = <<<EOD
369 <div class="edit_form">
370  <form action="$script" method="post" style="margin-bottom:0px;">
371 $template
372   $addtag
373   <input type="hidden" name="cmd"    value="edit" />
374   <input type="hidden" name="page"   value="$s_page" />
375   <input type="hidden" name="digest" value="$s_digest" />
376   <textarea name="msg" rows="$rows" cols="$cols">$s_postdata</textarea>
377   <br />
378   <div style="float:left;">
379    <input type="submit" name="preview" value="$btn_preview" accesskey="p" />
380    <input type="submit" name="write"   value="$_btn_update" accesskey="s" />
381    $add_top
382    $add_notimestamp
383   </div>
384   <textarea name="original" rows="1" cols="1" style="display:none">$s_original</textarea>
385  </form>
386  <form action="$script" method="post" style="margin-top:0px;">
387   <input type="hidden" name="cmd"    value="edit" />
388   <input type="hidden" name="page"   value="$s_page" />
389   <input type="submit" name="cancel" value="$_btn_cancel" accesskey="c" />
390  </form>
391 </div>
392 EOD;
393
394         $body .= '<ul><li><a href="' .
395                 get_page_uri($rule_page) .
396                 '" target="_blank">' . $_msg_help . '</a></li></ul>';
397         return $body;
398 }
399
400 // Related pages
401 function make_related($page, $tag = '')
402 {
403         global $vars, $rule_related_str, $related_str;
404
405         $script = get_base_uri();
406         prepare_links_related($page);
407         $links = links_get_related($page);
408
409         if ($tag) {
410                 ksort($links, SORT_STRING);             // Page name, alphabetical order
411         } else {
412                 arsort($links, SORT_NUMERIC);   // Last modified date, newer
413         }
414
415         $_links = array();
416         foreach ($links as $page=>$lastmod) {
417                 if (check_non_list($page)) continue;
418
419                 $page_uri = get_page_uri($page);
420                 $s_page   = htmlsc($page);
421                 $passage  = get_passage($lastmod);
422                 $_links[] = $tag ?
423                         '<a href="' . $page_uri . '" title="' .
424                         $s_page . ' ' . $passage . '">' . $s_page . '</a>' :
425                         '<a href="' . $page_uri . '">' .
426                         $s_page . '</a>' . $passage;
427         }
428         if (empty($_links)) return ''; // Nothing
429
430         if ($tag == 'p') { // From the line-head
431                 $style  = sprintf(pkwk_list_attrs_template(), 1, 1);
432                 $retval =  "\n" . '<ul' . $style . '>' . "\n" .
433                         '<li>' . join($rule_related_str, $_links) . '</li>' . "\n" .
434                         '</ul>' . "\n";
435         } else if ($tag) {
436                 $retval = join($rule_related_str, $_links);
437         } else {
438                 $retval = join($related_str, $_links);
439         }
440
441         return $retval;
442 }
443
444 // User-defined rules (convert without replacing source)
445 function make_line_rules($str)
446 {
447         global $line_rules;
448         static $pattern, $replace;
449
450         if (! isset($pattern)) {
451                 $pattern = array_map(create_function('$a',
452                         'return \'/\' . $a . \'/\';'), array_keys($line_rules));
453                 $replace = array_values($line_rules);
454                 unset($line_rules);
455         }
456
457         return preg_replace($pattern, $replace, $str);
458 }
459
460 // Remove all HTML tags(or just anchor tags), and WikiName-speific decorations
461 function strip_htmltag($str, $all = TRUE)
462 {
463         global $_symbol_noexists;
464         static $noexists_pattern;
465
466         if (! isset($noexists_pattern))
467                 $noexists_pattern = '#<span class="noexists">([^<]*)<a[^>]+>' .
468                         preg_quote($_symbol_noexists, '#') . '</a></span>#';
469
470         // Strip Dagnling-Link decoration (Tags and "$_symbol_noexists")
471         $str = preg_replace($noexists_pattern, '$1', $str);
472
473         if ($all) {
474                 // All other HTML tags
475                 return preg_replace('#<[^>]+>#',        '', $str);
476         } else {
477                 // All other anchor-tags only
478                 return preg_replace('#<a[^>]+>|</a>#i', '', $str);
479         }
480 }
481
482 // Remove AutoLink marker with AutLink itself
483 function strip_autolink($str)
484 {
485         return preg_replace('#<!--autolink--><a [^>]+>|</a><!--/autolink-->#', '', $str);
486 }
487
488 // Make a backlink. searching-link of the page name, by the page name, for the page name
489 function make_search($page)
490 {
491         $s_page = htmlsc($page);
492         $r_page = rawurlencode($page);
493         return '<a href="' . get_base_uri() . '?plugin=related&amp;page=' . $r_page .
494                 '">' . $s_page . '</a> ';
495 }
496
497 // Make heading string (remove heading-related decorations from Wiki text)
498 function make_heading(& $str, $strip = TRUE)
499 {
500         global $NotePattern;
501
502         // Cut fixed-heading anchors
503         $id = '';
504         $matches = array();
505         if (preg_match('/^(\*{0,3})(.*?)\[#([A-Za-z][\w-]+)\](.*?)$/m', $str, $matches)) {
506                 $str = $matches[2] . $matches[4];
507                 $id  = & $matches[3];
508         } else {
509                 $str = preg_replace('/^\*{0,3}/', '', $str);
510         }
511
512         // Cut footnotes and tags
513         if ($strip === TRUE)
514                 $str = strip_htmltag(make_link(preg_replace($NotePattern, '', $str)));
515
516         return $id;
517 }
518
519 // Separate a page-name(or URL or null string) and an anchor
520 // (last one standing) without sharp
521 function anchor_explode($page, $strict_editable = FALSE)
522 {
523         $pos = strrpos($page, '#');
524         if ($pos === FALSE) return array($page, '', FALSE);
525
526         // Ignore the last sharp letter
527         if ($pos + 1 == strlen($page)) {
528                 $pos = strpos(substr($page, $pos + 1), '#');
529                 if ($pos === FALSE) return array($page, '', FALSE);
530         }
531
532         $s_page = substr($page, 0, $pos);
533         $anchor = substr($page, $pos + 1);
534
535         if($strict_editable === TRUE &&  preg_match('/^[a-z][a-f0-9]{7}$/', $anchor)) {
536                 return array ($s_page, $anchor, TRUE); // Seems fixed-anchor
537         } else {
538                 return array ($s_page, $anchor, FALSE);
539         }
540 }
541
542 // Check HTTP header()s were sent already, or
543 // there're blank lines or something out of php blocks
544 function pkwk_headers_sent()
545 {
546         if (PKWK_OPTIMISE) return;
547
548         $file = $line = '';
549         if (version_compare(PHP_VERSION, '4.3.0', '>=')) {
550                 if (headers_sent($file, $line))
551                     die('Headers already sent at ' .
552                         htmlsc($file) .
553                         ' line ' . $line . '.');
554         } else {
555                 if (headers_sent())
556                         die('Headers already sent.');
557         }
558 }
559
560 // Output common HTTP headers
561 function pkwk_common_headers()
562 {
563         if (! PKWK_OPTIMISE) pkwk_headers_sent();
564
565         if(defined('PKWK_ZLIB_LOADABLE_MODULE')) {
566                 $matches = array();
567                 if(ini_get('zlib.output_compression') &&
568                     preg_match('/\b(gzip|deflate)\b/i', $_SERVER['HTTP_ACCEPT_ENCODING'], $matches)) {
569                         // Bug #29350 output_compression compresses everything _without header_ as loadable module
570                         // http://bugs.php.net/bug.php?id=29350
571                         header('Content-Encoding: ' . $matches[1]);
572                         header('Vary: Accept-Encoding');
573                 }
574         }
575 }
576
577 // DTD definitions
578 define('PKWK_DTD_XHTML_1_1',              17); // Strict only
579 define('PKWK_DTD_XHTML_1_0',              16); // Strict
580 define('PKWK_DTD_XHTML_1_0_STRICT',       16);
581 define('PKWK_DTD_XHTML_1_0_TRANSITIONAL', 15);
582 define('PKWK_DTD_XHTML_1_0_FRAMESET',     14);
583 define('PKWK_DTD_HTML_4_01',               3); // Strict
584 define('PKWK_DTD_HTML_4_01_STRICT',        3);
585 define('PKWK_DTD_HTML_4_01_TRANSITIONAL',  2);
586 define('PKWK_DTD_HTML_4_01_FRAMESET',      1);
587
588 define('PKWK_DTD_TYPE_XHTML',  1);
589 define('PKWK_DTD_TYPE_HTML',   0);
590
591 // Output HTML DTD, <html> start tag. Return content-type.
592 function pkwk_output_dtd($pkwk_dtd = PKWK_DTD_XHTML_1_1, $charset = CONTENT_CHARSET)
593 {
594         static $called;
595         if (isset($called)) die('pkwk_output_dtd() already called. Why?');
596         $called = TRUE;
597
598         $type = PKWK_DTD_TYPE_XHTML;
599         $option = '';
600         switch($pkwk_dtd){
601         case PKWK_DTD_XHTML_1_1             :
602                 $version = '1.1' ;
603                 $dtd     = 'http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd';
604                 break;
605         case PKWK_DTD_XHTML_1_0_STRICT      :
606                 $version = '1.0' ;
607                 $option  = 'Strict';
608                 $dtd     = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd';
609                 break;
610         case PKWK_DTD_XHTML_1_0_TRANSITIONAL:
611                 $version = '1.0' ;
612                 $option  = 'Transitional';
613                 $dtd     = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd';
614                 break;
615
616         case PKWK_DTD_HTML_4_01_STRICT      :
617                 $type    = PKWK_DTD_TYPE_HTML;
618                 $version = '4.01';
619                 $dtd     = 'http://www.w3.org/TR/html4/strict.dtd';
620                 break;
621         case PKWK_DTD_HTML_4_01_TRANSITIONAL:
622                 $type    = PKWK_DTD_TYPE_HTML;
623                 $version = '4.01';
624                 $option  = 'Transitional';
625                 $dtd     = 'http://www.w3.org/TR/html4/loose.dtd';
626                 break;
627
628         default: die('DTD not specified or invalid DTD');
629                 break;
630         }
631
632         $charset = htmlsc($charset);
633
634         // Output XML or not
635         if ($type == PKWK_DTD_TYPE_XHTML) echo '<?xml version="1.0" encoding="' . $charset . '" ?>' . "\n";
636
637         // Output doctype
638         echo '<!DOCTYPE html PUBLIC "-//W3C//DTD ' .
639                 ($type == PKWK_DTD_TYPE_XHTML ? 'XHTML' : 'HTML') . ' ' .
640                 $version .
641                 ($option != '' ? ' ' . $option : '') .
642                 '//EN" "' .
643                 $dtd .
644                 '">' . "\n";
645
646         // Output <html> start tag
647         echo '<html';
648         if ($type == PKWK_DTD_TYPE_XHTML) {
649                 echo ' xmlns="http://www.w3.org/1999/xhtml"'; // dir="ltr" /* LeftToRight */
650                 echo ' xml:lang="' . LANG . '"';
651                 if ($version == '1.0') echo ' lang="' . LANG . '"'; // Only XHTML 1.0
652         } else {
653                 echo ' lang="' . LANG . '"'; // HTML
654         }
655         echo '>' . "\n"; // <html>
656
657         // Return content-type (with MIME type)
658         if ($type == PKWK_DTD_TYPE_XHTML) {
659                 // NOTE: XHTML 1.1 browser will ignore http-equiv
660                 return '<meta http-equiv="content-type" content="application/xhtml+xml; charset=' . $charset . '" />' . "\n";
661         } else {
662                 return '<meta http-equiv="content-type" content="text/html; charset=' . $charset . '" />' . "\n";
663         }
664 }
665
666 /**
667  * Get template of List (ul, ol, dl) attributes
668  */
669 function pkwk_list_attrs_template() {
670         return ' class="list%d list-indent%d"';
671 }