PMCORE-3992
This commit is contained in:
Paula Quispe
242
thirdparty/wizard/org/active-link/doc/DocHTML.php
vendored
Normal file
242
thirdparty/wizard/org/active-link/doc/DocHTML.php
vendored
Normal file
@@ -0,0 +1,242 @@
|
||||
<?php
|
||||
|
||||
/*
|
||||
This file is part of ActiveLink PHP DOC Package (www.active-link.com).
|
||||
Copyright (c) 2002-2004 by Zurab Davitiani
|
||||
|
||||
You can contact the author of this software via E-mail at
|
||||
hattrick@mailcan.com
|
||||
|
||||
ActiveLink PHP DOC Package is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU Lesser General Public License as published by
|
||||
the Free Software Foundation; either version 2.1 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
ActiveLink PHP DOC Package is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU Lesser General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU Lesser General Public License
|
||||
along with ActiveLink PHP DOC Package; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
*/
|
||||
|
||||
import("org.active-link.xml.XML");
|
||||
import("org.active-link.doc.PHPClass");
|
||||
import("org.active-link.doc.Method");
|
||||
|
||||
/**
|
||||
* DocHTML parses PHP class file comments and generates documentation
|
||||
* @class DocHTML
|
||||
* @package org.active-link.doc
|
||||
* @author Zurab Davitiani
|
||||
* @version 0.3.4
|
||||
* @requires XML, PHPClass, Method
|
||||
* @see PHPClass
|
||||
*/
|
||||
|
||||
class DocHTML {
|
||||
|
||||
var $CSSFile;
|
||||
var $CSSFileTag;
|
||||
var $CSSString;
|
||||
var $CSSStringTag;
|
||||
var $CSSStringDefault;
|
||||
|
||||
/**
|
||||
* Constructor, runs when new object instance is created, sets default values
|
||||
* @method DocHTML
|
||||
*/
|
||||
function DocHTML() {
|
||||
$this->CSSStringDefault = "
|
||||
body {background-color: white;}
|
||||
a {font-family: monospace;}
|
||||
ul {list-style-type: none;}
|
||||
.classTitle {color: blue;}
|
||||
.name {color: black;}
|
||||
.version {color: black;}
|
||||
.requires {color: red;}
|
||||
.extends {color: black;}
|
||||
.description {color: black;font-family: sans-serif;}
|
||||
.author {color: blue;}
|
||||
.methodsTitle {color: blue;}
|
||||
.methodList {color: blue;}
|
||||
.methodName {color: blue;font-weight: bold;}
|
||||
.returns {color: black;}
|
||||
.param {color: black;font-weight: bold;font-family: monospace;}
|
||||
";
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns class documentation as a string, formatted in HTML
|
||||
* If argument is a filename, it parses the file for comments and generates documentation
|
||||
* If argument is an object of type PHPClass, then documentation is generated from it
|
||||
* @method getClassDoc
|
||||
* @param mixed argument
|
||||
* @returns string HTML-formatted documentation if successful, false otherwise
|
||||
*/
|
||||
function getClassDoc($argument) {
|
||||
if(is_object($argument) && get_class($argument) == "phpclass")
|
||||
return $this->getClassDocFromClass($argument);
|
||||
elseif(is_string($argument))
|
||||
return $this->getClassDocFromFile($argument);
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns class documentation as a string, formatted in HTML
|
||||
* @method getClassDocFromClass
|
||||
* @param object objClass
|
||||
* @returns string HTML-formatted documentation if successful, false otherwise
|
||||
*/
|
||||
function getClassDocFromClass($objClass) {
|
||||
if(is_object($objClass) && get_class($objClass) == "phpclass") {
|
||||
$classDocXML = new XML_("html");
|
||||
// ---------------------- HEAD ---------------------- //
|
||||
$headXML = new XMLBranch("head");
|
||||
$headXML->setTagContent($objClass->getInfo("name"), "head/title");
|
||||
$headXML->setTagContent("", "head/meta");
|
||||
$headXML->setTagAttribute("http-equiv", "content-type", "head/meta");
|
||||
$headXML->setTagAttribute("content", "text/html; charset=ISO-8859-1", "head/meta");
|
||||
$headXML->setTagContent($this->CSSStringDefault, "head/style");
|
||||
$headXML->setTagAttribute("type", "text/css", "head/style");
|
||||
// ---------------------- BODY ---------------------- //
|
||||
$bodyXML = new XMLBranch("body");
|
||||
$classTitleXML = new XMLBranch("h1");
|
||||
$classTitleXML->setTagAttribute("class", "classTitle");
|
||||
$classTitleXML->setTagContent($objClass->getInfo("name") . " Class");
|
||||
$bodyXML->addXMLBranch($classTitleXML);
|
||||
foreach($objClass->info as $infoKey => $infoValue) {
|
||||
$brXML = new XMLBranch("br");
|
||||
$bodyXML->addXMLBranch($brXML);
|
||||
if(is_array($infoValue)) {
|
||||
$spanXML = new XMLBranch("span");
|
||||
$spanXML->setTagAttribute("class", $infoKey);
|
||||
$spanXML->setTagContent(ucfirst($infoKey) . ":");
|
||||
$ulXML = new XMLBranch("ul");
|
||||
$ulXML->setTagAttribute("class", $infoKey);
|
||||
foreach($infoValue as $value) {
|
||||
$liXML = new XMLBranch("li");
|
||||
$liXML->setTagContent($value);
|
||||
$ulXML->addXMLBranch($liXML);
|
||||
}
|
||||
$bodyXML->addXMLBranch($spanXML);
|
||||
$bodyXML->addXMLBranch($ulXML);
|
||||
}
|
||||
else {
|
||||
$spanXML = new XMLBranch("span");
|
||||
$spanXML->setTagAttribute("class", $infoKey);
|
||||
$spanXML->setTagContent(ucfirst($infoKey) . ": " . $infoValue);
|
||||
$bodyXML->addXMLBranch($spanXML);
|
||||
}
|
||||
}
|
||||
$hrXML = new XMLBranch("hr");
|
||||
$bodyXML->addXMLBranch($hrXML);
|
||||
$h2XML = new XMLBranch("h2");
|
||||
$h2XML->setTagAttribute("class", "methodsTitle");
|
||||
$h2XML->setTagContent("All Methods");
|
||||
$bodyXML->addXMLBranch($h2XML);
|
||||
$spanXML = new XMLBranch("span");
|
||||
$spanXML->setTagAttribute("class", "methodList");
|
||||
foreach($objClass->methods as $methodName => $method) {
|
||||
$aMethodXML = new XMLBranch("a");
|
||||
$aMethodXML->setTagAttribute("href", "#" . $methodName);
|
||||
$aMethodXML->setTagContent($methodName);
|
||||
$brXML = new XMLBranch("br");
|
||||
$spanXML->addXMLBranch($aMethodXML);
|
||||
$spanXML->addXMLBranch($brXML);
|
||||
}
|
||||
$bodyXML->addXMLBranch($spanXML);
|
||||
foreach($objClass->methods as $methodName => $method) {
|
||||
$hrXML = new XMLBranch("hr");
|
||||
$bodyXML->addXMLBranch($hrXML);
|
||||
$pMethodXML = new XMLBranch("p");
|
||||
$aMethodXML = new XMLBranch("a");
|
||||
$aMethodXML->setTagAttribute("name", $methodName);
|
||||
$spanXMLName = new XMLBranch("span");
|
||||
$spanXMLName->setTagAttribute("class", "methodName");
|
||||
$spanXMLName->setTagContent($methodName);
|
||||
$spanXMLArgs = new XMLBranch("span");
|
||||
$tagContentArgs = " ( ";
|
||||
if(is_array($method->params) && count($method->params) > 0) {
|
||||
$paramCount = 0;
|
||||
foreach($method->params as $key => $value) {
|
||||
if($paramCount > 0)
|
||||
$tagContentArgs .= ", ";
|
||||
$tagContentArgs .= $key;
|
||||
$paramCount ++;
|
||||
}
|
||||
}
|
||||
$tagContentArgs .= " )";
|
||||
$spanXMLArgs->setTagContent($tagContentArgs);
|
||||
$aMethodXML->addXMLBranch($spanXMLName);
|
||||
$aMethodXML->addXMLBranch($spanXMLArgs);
|
||||
$pMethodXML->addXMLBranch($aMethodXML);
|
||||
$bodyXML->addXMLBranch($pMethodXML);
|
||||
unset($method->info["name"]);
|
||||
foreach($method->info as $infoKey => $infoValue) {
|
||||
if(is_array($infoValue)) {
|
||||
$pXML = new XMLBranch("p");
|
||||
$pXML->setTagAttribute("class", $infoKey);
|
||||
$pXML->setTagContent(ucfirst($infoKey) . ":");
|
||||
$ulXML = new XMLBranch("ul");
|
||||
$ulXML->setTagAttribute("class", $infoKey);
|
||||
foreach($infoValue as $value) {
|
||||
$liXML = new XMLBranch("li");
|
||||
$liXML->setTagContent($value);
|
||||
$ulXML->addXMLBranch($liXML);
|
||||
}
|
||||
$bodyXML->addXMLBranch($pXML);
|
||||
$bodyXML->addXMLBranch($ulXML);
|
||||
}
|
||||
else {
|
||||
$pXML = new XMLBranch("p");
|
||||
$pXML->setTagAttribute("class", $infoKey);
|
||||
$pXML->setTagContent(ucfirst($infoKey) . ": " . $infoValue);
|
||||
$bodyXML->addXMLBranch($pXML);
|
||||
}
|
||||
}
|
||||
if(is_array($method->params) && count($method->params) > 0) {
|
||||
$pParamXML = new XMLBranch("p");
|
||||
//$pParamXML->setTagAttribute("class", "param");
|
||||
$paramTitleXML = new XMLBranch("span");
|
||||
$paramTitleXML->setTagContent("Arguments:");
|
||||
$pParamXML->addXMLBranch($paramTitleXML);
|
||||
$paramListXML = new XMLBranch("ul");
|
||||
foreach($method->params as $key => $value) {
|
||||
$paramItemXML = new XMLBranch("li");
|
||||
$paramItemXML->setTagAttribute("class", "param");
|
||||
$paramItemXML->setTagContent($key);
|
||||
$paramListXML->addXMLBranch($paramItemXML);
|
||||
}
|
||||
$pParamXML->addXMLBranch($paramListXML);
|
||||
$bodyXML->addXMLBranch($pParamXML);
|
||||
}
|
||||
}
|
||||
// ---------------------- END ---------------------- //
|
||||
$classDocXML->addXMLBranch($headXML);
|
||||
$classDocXML->addXMLBranch($bodyXML);
|
||||
return $classDocXML->getXMLString(0);
|
||||
}
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns class documentation as a string, formatted in HTML
|
||||
* @method getClassDocFromFile
|
||||
* @param string filename
|
||||
* @returns string HTML-formatted documentation if successful, false otherwise
|
||||
*/
|
||||
function getClassDocFromFile($filename) {
|
||||
if(is_string($filename) && file_exists($filename) && is_readable($filename)) {
|
||||
$objClass = new PHPClass($filename);
|
||||
return $this->getClassDocFromClass($objClass);
|
||||
}
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
}
|
||||
Reference in New Issue
Block a user