Revision [14199]

This is an old revision of HTMLHandler made by BrianKoontz on 2006-05-10 09:16:22.

 

HTML Handler


See also:
Documentation: HTMLHandlerInfo.
This is the development page for the HTML handler.
 


This handler generates "standalone" HTML, without the header/footer/menu items.

Dependency

None.

The code

Copy css/wikka.css to css/html.css, then add the following line to the top of html.css:

.header, .footer, .commentsheader, .copyright, .smallprint { display:none; }


Create handlers/page/html.php:

<?php
if ($this->HasAccess("read") && $this->page) {
    // display page
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
    <title><?php echo $this->PageTitle(); ?></title>
    <base href="" />
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
    <style type="text/css">
    <?php include("css/html.css") ?>  
    </style>
</head>
<body>
<?php
    print($this->Format($this->page["body"], "html"));
}
?>


Add the following after about line 1109 in wikka.php (just before the final else statement):

        elseif ($this->method == "html")
        {
            print($this->Method($this->method));
        }


The Wikka parsing engine doesn't differentiate between relative URIs and absolute URIs (the default is to prepend any "unidentified" URIs with http:). To enable relative URIs, copy formatters/wakka.php to formatters/html.php, then make the following changes starting at around line 240:

        // forced links
        // \S : any character that is not a whitespace character
        // \s : any whitespace character
--->change start<---
        // Hack to pick up leading . and / characters in URI
        else if (preg_match("/^\[\[([\S|\.|\/]*)(\s+(.+))?\]\]$/s", $thing, $matches))      # recognize forced links across lines
        {
--->change end<---
            list (, $url, , $text) = $matches;
            if ($url)
            {
                //if ($url!=($url=(preg_replace("/@@|&pound;&pound;||\[\[/","",$url))))$result="</span>";
                if (!$text) $text = $url;
                //$text=preg_replace("/@@|&pound;&pound;|\[\[/","",$text);
--->change start<---
                $link = $wakka->Link($url, "", $text);
                // Hack to handle relative URIs (i.e., links to files
                // in the same directory)
                if(strstr($link, "http://.") || strstr($link, "http:///"))
                    $link = preg_replace("/^(.*)http:\/\/(.*)$/",
                                         "\${1}\${2}",
                                         $link);
                return $result.$link;
--->change end<---
            }


To disable the display of CamelWords and InterWiki as clickable links, also delete the following lines from formatters/html.php:

    "\b[A-Z???][A-Za-z???????]+[:](?![=_])\S*\b|".                                          
              # InterWiki link
    "\b([A-Z???]+[a-z????]+[A-Z0-9???][A-Za-z0-9???????]*)\b|".                            
              # CamelWords




To Do

  • Provide option to exclude inline CSS (with option to display listing of CSS to save in separate file)
  • Provide "raw" html (no html, head, body tags)
  • Clean up kludge in wikka.php (there should be no need to modify this file to accomodate a new handler type)
  • Convince DarTar to include this formatter in the next release so we can show Exports HTML == yes in the ""WikkaWiki" entry on WikiMatrix!



Categories
CategoryDevelopmentHandlers
CategoryUserContributions
There are 4 comments on this page. [Show comments]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki