File Source for new

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<?php
/**
* Advanced Web Interface to phpDocumentor
* @see phpdoc.php
* @package phpDocumentor
* @deprecated in favor of docbuilder (see {@link docbuilder/config.php})
* @filesource
*/
//
//
// An HTML interface for Joshua Eichorn's phpDocumentor
// Author: Juan Pablo Morales <[email protected]>
// Joshua Eichorn <[email protected]>
// Gregory Beaver <[email protected]>
//
// phpDocumentor, a program for creating javadoc style documentation from php code
// Copyright (C) 2000-2002 Joshua Eichorn
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
//
// This program 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 General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
//
// Copyleft 2001 Juan Pablo Morales
if (!function_exists('version_compare'))
{
print "phpDocumentor requires PHP version 4.1.0 or greater to function";
exit;
}
// set up include path so we can find all files, no matter what
$GLOBALS['_phpDocumentor_install_dir'] = dirname(realpath(__FILE__));
// add my directory to the include path, and make it first, should fix any errors
if (substr(PHP_OS, 0, 3) == 'WIN')
ini_set('include_path',$GLOBALS['_phpDocumentor_install_dir'].';'.ini_get('include_path'));
else
ini_set('include_path',$GLOBALS['_phpDocumentor_install_dir'].':'.ini_get('include_path'));
/**
* common file information
*/
include_once("phpDocumentor/common.inc.php");
// find the .ini directory by parsing phpDocumentor.ini and extracting _phpDocumentor_options[userdir]
$ini = phpDocumentor_parse_ini_file($_phpDocumentor_install_dir . PATH_DELIMITER . 'phpDocumentor.ini', true);
if (isset($ini['_phpDocumentor_options']['userdir']))
$configdir = $ini['_phpDocumentor_options']['userdir'];
else
$configdir = $_phpDocumentor_install_dir . '/user';
// allow the user to change this at runtime
if (!empty($_REQUEST['altuserdir'])) $configdir = $_REQUEST['altuserdir'];
?>
<html>
<head>
<title>
Form to submit to phpDocumentor v<?php print PHPDOCUMENTOR_VER; ?>
</title>
<?php
if(!isset($_GET['submit']) || !empty($_REQUEST['altuserdir'])) {
?>
<script src="HTML_TreeMenu-1.1.2/TreeMenu.js" language="JavaScript" type="text/javascript"></script>
<?php
include_once('HTML_TreeMenu-1.1.2/TreeMenu.php');
set_time_limit(0); // six minute timeout
ini_set("memory_limit","256M");
/**
* Directory Node
* @package HTML_TreeMenu
*/
class DirNode extends HTML_TreeNode
{
/**
* full path to this node
* @var string
*/
var $path;
function DirNode($text = false, $link = false, $icon = false, $path, $events = array())
{
$this->path = $path;
$options = array();
if ($text) $options['text'] = $text;
if ($link) $options['link'] = $link;
if ($icon) $options['icon'] = $icon;
HTML_TreeNode::HTML_TreeNode($options,$events);
}
}
function getDir($path,&$node)
{
global $pd;
if (!$dir = opendir($path)) return;
$node = new HTML_TreeNode(array('text' => basename(realpath($path)), 'link' => "", 'icon' => 'folder.gif'));
while (($file = readdir($dir)) !== false)
{
if ($file != '.' && $file != '..')
{
if (is_dir("$path$pd$file") && !is_link("$path$pd$file"))
{
$entry[] = "$path$pd$file";
}
}
}
closedir($dir);
for($i = 0; $i < count($entry); $i++)
{
$node->addItem(new HTML_TreeNode(array('text'=>basename(realpath($entry[$i])), 'link' => "javascript:setHelp('".addslashes(realpath($entry[$i]))."');", 'icon' => 'folder.gif')));
}
}
function recurseDir($path, &$node) {
global $pd;
if (!$dir = opendir($path)) {
return false;
}
$anode = new HTML_TreeNode(array('text' => basename($path), 'link' => "javascript:setHelpVal('".$path."');", 'icon' => 'folder.gif'));
$result = addslashes(realpath(stripslashes($path).$pd.".."));
if (!$node) $anode->addItem(new DirNode('..',"javascript:setHelp('".$result."');",'folder.gif'),'..');
while (($file = readdir($dir)) !== false) {
if ($file != '.' && $file != '..') {
if (is_dir("$path$pd$file")) {
recurseDir("$path$pd$file",$anode);
}
}
}
rewinddir($dir);//
while (false){//($file = readdir($dir)) !== false) {
if ($file != '.' && $file != '..') {
if (is_file("$path$pd$file")) {
$anode->addItem(new DirNode($file,"javascript:setHelpVal('$path$pd$file');",'branchtop.gif',"$path$pd$file"));
}
}
}
if (!$node) $node = $anode;
else
$node->addItem($anode);
closedir($dir);
}
function switchDirTree($path, &$node)
{
global $pd;
// initialize recursion simulation values
// array format: path => &parent in $node itemlist
$parent = array();
$parent_indexes = array();
$parenti = 1;
$node = new DirNode(basename($path),"javascript:setHelpVal('".$path."');",'folder.gif',$path);
$result = addslashes(realpath($path.$pd.".."));
$node->addItem(new DirNode('..',"javascript:setHelp('".$result."');",'folder.gif','..'));
$rnode = &$node;
$parent[realpath($path)] = false;
$recur = 0;
do
{
if ($recur++ > 120) return;
if (!$dir = @opendir($path)) {
// no child files or directories
// echo "$path no child files or directories return to ";
$rnode = &$parent[realpath($path)];
$path = $rnode->path;
if (isset($parent_indexes[realpath($path)])) $parenti = $parent_indexes[realpath($path)];
// echo "$path parenti $parenti<br>";
}
// fancy_debug($path,$parent_indexes);
// vdump_par($parent);
if (!isset($parent_indexes[realpath($path)]))
{
$file = readdir($dir);
while ($file !== false) {
if ($file != '.' && $file != '..') {
if (@is_dir(realpath("$path$pd$file"))) {
if (!isset($parent_indexes[realpath($path)])) $parent_indexes[realpath($path)] = true;
$parent[realpath("$path$pd$file")] = &$rnode;
// echo "<br>adding new ".addslashes(realpath($path.$pd.$file))." to $path<br>";
$rnode->addItem(new DirNode(addslashes(realpath("$path$pd$file")),"javascript:setHelpVal('".addslashes(realpath($path.$pd.$file))."');",'folder.gif',addslashes(realpath($path.$pd.$file))));
}
}
$file = readdir($dir);
}
}
// go down the tree if possible
if (isset($parent_indexes[realpath($path)]))
{
if ($parenti + 1 > (count($rnode->items)))
{
// no more children, go back up to parent
// echo "$path no more children, go back up to parent ";
$rnode = &$parent[realpath($path)];
$path = $rnode->path;
if (isset($parent_indexes[realpath($path)])) $parenti = $parent_indexes[realpath($path)];
// echo $path." parenti $parenti<br>";
} else
{
// go to next child
// echo "$path go to next child ";
$parent_indexes[realpath($path)] = $parenti+1;
// debug("set parent ".$rnode->items[$parenti]->path." = ".$rnode->path.'<br>');
$parent[realpath($rnode->items[$parenti]->path)] = &$rnode;
$rnode = &$rnode->items[$parenti];
$path = $rnode->path;
// echo "$path<br>";
$parenti = 0;
}
} else
{
// no children, go back up the tree to the next child
// echo "$path no children, go back up to parent ";
$rnode = &$parent[realpath($path)];
$path = $rnode->path;
if (isset($parent_indexes[realpath($path)])) $parenti = $parent_indexes[realpath($path)];
// echo "$path parenti $parenti<br>";
}
@closedir($dir);
} while ($path && (($parenti < (count($rnode->items))) || ($parent[realpath($path)] !== false)));
}
function vdump_par($tree)
{
foreach($tree as $key => $val)
{
if ($val === false)
debug($key.' -> false<br>');
else
debug($key.' -> ' .$val->path.'<br>');
}
debug('<br>');
}
$menu = new HTML_TreeMenu();
$filename = '';
if (isset($_GET) && isset($_GET['fileName'])) $filename = $_GET['fileName'];
$filename = realpath($filename);
$pd = (substr(PHP_OS, 0, 3) == 'WIN') ? '\\' : '/';
$test = ($pd == '/') ? '/' : 'C:\\';
if (empty($filename) || ($filename == $test))
{
$filename = ($pd == '/') ? '/' : 'C:\\';
$node = false;
getDir($filename,$node);
} else
{
flush();
// if ($pd != '/') $pd = $pd.$pd;
$anode = false;
switchDirTree($filename,$anode);
// recurseDir($filename,$anode);
$node = new HTML_TreeNode(array('text' => "Click to view $filename",'link' => "",'icon' => 'branchtop.gif'));
$node->addItem($anode);
};
$menu->addItem($node);
$DHTMLmenu = &new HTML_TreeMenu_DHTML($menu, array('images' => 'HTML_TreeMenu-1.1.2/images'));
?>
<script type="text/javascript" language="Javascript">
/**
Creates some global variables
*/
function initializate() {
//
//The "platform independent" newLine
//
//Taken from http://developer.netscape.com/docs/manuals/communicator/jsref/brow1.htm#1010426
if (navigator.appVersion.lastIndexOf('Win') != -1)
{
$pathdelim="\\";
$newLine="\r\n";
} else
{
$newLine="\n";
$pathdelim="/";
}
/* for($a=0;$a<document.dataForm.elements.length;$a++) {
alert("The name is '"+document.dataForm.elements[$a].name+"' "+$a);
}
*/
}
/** Sets the contents of the help box, and submits the form
*/
function setHelp($str)
{
document.helpForm.fileName.value = $str;
document.helpForm.helpdata.click();
}
/** Sets the contents of the help box only
*/
function setHelpVal($str)
{
document.helpForm.fileName.value = $str;
}
/**Adds the contents of the help box as a directory
*/
function addDirectory($object) {
$a = document.helpForm.fileName.value;
$a = myReplace($a,'\\\\','\\');
if ($a[$a.length - 1] == $pathdelim) $a = $a.substring(0, $a.length - 1);
if ($a.lastIndexOf('.') > 0)
{
$a = $a.substring(0,$a.lastIndexOf($pathdelim));
}
$object.value = prepareString($object.value)+$a;
}
/**Adds the contents of the converter box to the converters list
*/
function addConverter($object) {
$object.value = prepareString($object.value)+document.dataForm.ConverterSetting.value;
}
/**Replaces the converters list with the contents of the converter box
*/
function replaceConverter($object) {
$object.value = document.dataForm.ConverterSetting.value;
}
/**Adds the contents of the help box as a file to the given control
*/
function addFile($object) {
$a = document.helpForm.fileName.value;
$a = myReplace($a,'\\\\','\\');
$object.value = prepareString($object.value)+$a;
}
/**Takes a given string and leaves it ready to add a new string
That is, puts the comma and the new line if needed
*/
function prepareString($myString) {
//First verify that a comma is not at the end
if($myString.lastIndexOf(",") >= $myString.length-2) {
//We have a comma at the end
return $myString;
}
if($myString.length > 0) {
$myString+=","+$newLine;
}
return $myString;
}
/**Do the validation needed before sending the from and return a truth value indicating if the form can be sent
*/
function validate() {
//Take out all newLines and change them by nothing
//This could be done by using javascript function's replacebut that was implemented only until Navigator 4.0 and so it is better to use more backward compatible functions like substr
document.dataForm.elements[0].value= stripNewLines(document.dataForm.elements[0].value);
document.dataForm.elements[1].value= stripNewLines(document.dataForm.elements[1].value);
document.dataForm.elements[2].value= stripNewLines(document.dataForm.elements[2].value);
document.dataForm.elements[3].value= stripNewLines(document.dataForm.elements[3].value);
document.dataForm.elements[4].value= stripNewLines(document.dataForm.elements[4].value);
document.dataForm.elements[5].value= stripNewLines(document.dataForm.elements[5].value);
document.dataForm.elements[6].value= stripNewLines(document.dataForm.elements[6].value);
document.dataForm.elements[7].value= stripNewLines(document.dataForm.elements[7].value);
//By returning true we are allowing the form to be submitted
return true;
}
/**Takes a string and removes all the ocurrences of new lines
Could have been implemented a lot easier with replace but it's not very backwards compatible
*/
function stripNewLines($myString) {
return myReplace($myString,$newLine,'');
}
function myReplace($string,$text,$by) {
// Replaces text with by in string
var $strLength = $string.length, $txtLength = $text.length;
if (($strLength == 0) || ($txtLength == 0)) return $string;
var $i = $string.indexOf($text);
if ((!$i) && ($text != $string.substring(0,$txtLength))) return $string;
if ($i == -1) return $string;
var $newstr = $string.substring(0,$i) + $by;
if ($i+$txtLength < $strLength)
$newstr += myReplace($string.substring($i+$txtLength,$strLength),$text,$by);
return $newstr;
}
</script><?php } ?>
</head>
<?php
//Find out if we are submitting and if we are, send it
// This code originally by Joshua Eichorn on phpdoc.php
//
if(isset($_GET['submit']) && empty($_REQUEST['altuserdir'])) {
echo "<body bgcolor=\"#ffffff\">";
echo "<h1>Parsing Files ...</h1>";
flush();
echo "<pre>\n";
/** phpdoc.inc */
include("phpDocumentor/phpdoc.inc");
echo "</pre>\n";
echo "<h1>Operation Completed!!</h1>";
} else
{
?>
<body bgcolor="#ffffff" onload="javascript:initializate()">
<h1>
phpDocumentor v<?php print PHPDOCUMENTOR_VER; ?> Web Interface
</h1>
phpDocumentor written by Joshua Eichorn<br>
Web Interface written by Juan Pablo Morales and enhanced by Greg Beaver<br>
<img src="poweredbyphpdoc.gif" alt="" width="88" height="31" border="0">
<table cellpadding="1" cellspacing="1" border="0" width="60%" bgcolor=
"#000000">
<tr>
<td bgcolor="#ffff66">
<b>Help</b>
</td>
<td bgcolor="#ffff99">
use this to find directories and files which can be used below
<form name="helpForm" action="<?php print $_SERVER['PHP_SELF']; ?>" method="get"
enctype="multipart/form-data">
<input size="80" type="text" name="fileName" value="<?php print $filename;?>">
<input type="submit" name="helpdata" value="browse tree">
</form>
<div id='menuLayer'></div>
<?php
$DHTMLmenu->printMenu();
?>
</td>
</tr>
</table>
<form name="dataForm" action="<?php print $_SERVER['PHP_SELF']; ?>" method="GET" onsubmit=
"return validate()">
<table cellpadding="3" cellspacing="3" border="0" width="80%"
bgcolor="#000000">
<tr>
<td bgcolor="#3399ff">
<b>Use a pre-created config file for form values.</b>
</td>
<td bgcolor="#CCCCCC">
Normally, phpDocumentor uses the form values from this form to set up parsing. In version 1.2,
phpDocumentor allows you to "save" form values in configuration files so that you can replicate
common complicated documentation tasks with only one time. Just choose a config file below or create a
new one and refresh this page to choose it.<hr /><b>change config directory:</b><input size="20" type="text" name="altuserdir" value=""><?php if (!empty($_REQUEST['altuserdir'])) print '<br><i>changed to <b>"'.$_REQUEST['altuserdir'].'"</b></i>'; ?>
<b>Choose a config:</b> <select name="setting[useconfig]">
<option value="" <?php if (empty($_REQUEST['altuserdir'])) print 'selected'; ?>>don't use config file</option>
<?php
$dirs = array();
$dirs = phpDocumentor_ConfigFileList($configdir);
$path = '';
$sel = ' selected';
if (!empty($_REQUEST['altuserdir'])) $path = $configdir . PATH_DELIMITER;
else $sel = '';
foreach($dirs as $configfile)
{
print '<option value="'.$path.$configfile.'"'.$sel.'>'.$configfile.".ini</option>\n";
$sel = '';
}
?>
</select><input type="SUBMIT" value=
"Go" name="submitButton"><br>
</td>
</tr>
</tr>
<td bgcolor="#66cc66">
<b>Target</b>
</td>
<td bgcolor="#eeeeee">
Target is the directory where
the output produced by phpDocumentor will reside<br>
<input type="TEXT" name="setting[target]" size=
"80"><br>
<a href=
"javascript:addDirectory(document.dataForm.elements[3])">
Add the directory in the help box</a>
</td>
</tr>
<tr>
<td bgcolor="#3399ff">
<b>Files to parse</b>
</td>
<td bgcolor="#CCCCCC">
This is a group of comma-separated names of php files
or tutorials that will be processed by phpDocumentor.<br>
<textarea rows="6" cols="80" name=
"setting[filename]"></textarea> <br>
<a href=
"javascript:addFile(document.dataForm.elements[4])">
Add the file in the help box</a>
</td>
</tr>
<tr>
<td bgcolor="#66cc66">
<b>Directory to parse</b>
</td>
<td bgcolor="#eeeeee">
This is a group of comma-separated directories where php files
or tutorials are found that will be processed by phpDocumentor.
phpDocumentor automatically parses subdirectories<br>
<textarea rows="6" cols="80" name="setting[directory]"></textarea> <br>
<a href=
"javascript:addDirectory(document.dataForm.elements[5])">
Add the directory in the help box</a>
</td>
</tr>
<tr>
<td bgcolor="#66cc66">
<b>Files to ignore</b>
</td>
<td bgcolor="#eeeeee">
A list of files (full path or filename), and patterns
to ignore. Patterns may use wildcards * and ?. To
ignore all subdirectories named "test" for example,
using "test/" To ignore all files and directories
with test in their name use "*test*"
<textarea rows="6" cols="80" name="setting[ignore]"></textarea> <br>
<a href=
"javascript:addDirectory(document.dataForm.elements[6])">
Add the directory in the help box</a>
</td>
</tr>
<tr>
<td bgcolor="#66cc66">
<b>Generated Documentation Title</b>
</td>
<td bgcolor="#eeeeee">
Choose a title for the generated documentation<br>
<input type="TEXT" name="setting[title]" size=
"80" value="Generated Documentation"><br>
</td>
</tr>
<tr>
<td bgcolor="#3399ff">
<b>Default Package Name</b>
</td>
<td bgcolor="#cccccc">
Choose a name for the default package<br>
<input type="TEXT" name="setting[defaultpackagename]" size=
"80" value="default"><br>
</td>
<tr>
<tr>
<td bgcolor="#3399ff">
<b>Custom Tags</b>
</td>
<td bgcolor="#CCCCCC">
Custom Tags is a comma-separated list of tags
you want phpDocumentor to include as valid tags
in this parse. An example would be "value, size"
to allow @value and @size tags.
<input type="TEXT" name="setting[customtags]" size=
"80"><br>
</td>
</tr>
<tr>
<td bgcolor="#66cc66">
<b>Packages to parse</b>
</td>
<td bgcolor="#eeeeee">
The parameter packages is a group of comma
separated names of abstract packages that will
be processed by phpDocumentor. All package names must be
separated by commas.<br>
<textarea rows="3" cols="80" name=
"setting[packageoutput]"></textarea> <br>
</td>
</tr>
<tr>
<td bgcolor="#3399ff">
<b>Output Information</b>
</td>
<td bgcolor="#CCCCCC">
<br>
Outputformat
may be HTML, XML, PDF, or CHM (case-sensitive) in version 1.2. There is only one Converter
for both CHM and PDF, <b>default</b>. There are 2 HTML Converters,
<b>frames</b> and <b>Smarty</b>. <b>frames templates</b> may be any of:<br><br>
<b>default, l0l33t, phpdoc.de, phphtmllib, phpedit, DOM/default, DOM/l0l33t, or DOM/phpdoc.de</b>.
<b>Smarty templates</b> may be any of:<br><br>
<b>default or PHP</b>.<br>
<br>
There is only 1 template for all other Converters, <b>default</b>
<br>Output type:Converter name:template name <input type=
"TEXT" name="setting[output]" value=
"HTML:Smarty:default" size="80"><br>
<select name="ConverterSetting">
<option value="HTML:frames:default">HTML:frames:default</option>
<option value="HTML:frames:l0l33t">HTML:frames:l0l33t</option>
<option value="HTML:frames:phpdoc.de">HTML:frames:phpdoc.de</option>
<option value="HTML:frames:phphtmllib">HTML:frames:phphtmllib</option>
<option value="HTML:frames:phpedit">HTML:frames:phpedit</option>
<option value="HTML:frames:DOM/default">HTML:frames:DOM/default</option>
<option value="HTML:frames:DOM/l0l33t">HTML:frames:DOM/l0l33t</option>
<option value="HTML:frames:DOM/phpdoc.de">HTML:frames:DOM/phpdoc.de</option>
<option value="HTML:Smarty:default" SELECTED>HTML:Smarty:default</option>
<option value="PDF:default:default">PDF:default:default</option>
<option value="CHM:default:default">CHM:default:default</option>
<option value="XML:DocBook/peardoc2:default">XML:DocBook/peardoc2:default</option>
</select><br>
<a href=
"javascript:addConverter(document.dataForm.elements[11])">
Add the converter in the help box</a> <br>
<a href=
"javascript:replaceConverter(document.dataForm.elements[11])">
Use ONLY the converter in the help box</a>
</td>
</tr>
<tr>
<td bgcolor="#3399ff">
<b>Parse @access private</b>
</td>
<td bgcolor="#CCCCCC">
The parameter Parse @access private tells phpDocumentor
whether to parse elements with an "@access private" tag in their docblock<br>
<input type="checkbox" name="setting[parseprivate]" value="on">Parse private <br>
</td>
</tr>
<tr>
<td bgcolor="#66cc66">
<b>JavaDoc-compliant Description parsing.</b>
</td>
<td bgcolor="#eeeeee">
Normally, phpDocumentor uses several rules to determine the short description. This switch
asks phpDocumentor to simply search for the first period (.) and use it to delineate the short
description. In addition, the short description will not be separated from the long description<br>
<input type="checkbox" name="setting[javadocdesc]" value="on">JavaDoc-compliant Description <br>
</td>
</tr>
</table>
<input type="HIDDEN" name="interface" value="web"> <input type=
"HIDDEN" name="submit" value="true"> <input type="SUBMIT" value=
"Create Documentation" name="submitButton">
</form>
<br>
<br>
<br>
<p>
Joshua Eichorn <a href="mailto:[email protected]">[email protected]</a><br>
Juan Pablo Morales <a href=
"mailto:[email protected]">[email protected]</a><br>
Gregory Beaver <a href=
"mailto:[email protected]">[email protected]</a>
</p>
<p>
If you have any problems with phpDocumentor, please visit the website: <a
href='http://phpdocu.sourceforge.net'>phpdocu.sourceforge.net</a> and
submit a bug
</p>
<pre>
Last modified: $Date: 2005/10/17 18:15:16 $
Revision: $Revision: 1.1 $
</pre>
<?php } //End the else that prints all code
?>
</body>
</html>

	HTML_TreeMenu

[ class tree: HTML_TreeMenu ] [ index: HTML_TreeMenu ] [ all elements ]

Source for file new_phpdoc.php