【问题标题】:Solving error messages given by PHPdoc解决 PHPdoc 给出的错误信息
【发布时间】:2009-08-30 12:15:55
【问题描述】:

如何解决PHPdoc给出的以下错误信息?

我通过以下命令运行madedoc.sh

命令

sudo ./makedoc.sh

我明白了

错误消息

PHP Version 5.2.6-3ubuntu4.2
phpDocumentor version 1.4.2

Parsing configuration file phpDocumentor.ini...
   (found in /usr/share/php/data/PhpDocumentor/)...

done
Maximum memory usage set at 256M after considering php.ini...
using tokenizer Parser

        ERROR: Converter PDFSmartyConverter specified by --output command-line option is not a class

        ERROR: No Converters have been specified by --output command-line option

        ERROR: No Converters have been specified by --output command-line option

我要生成的 cmets 示例

/** Create HTML for tags
 * @param string @tags
 */
function create_tags_at_question ( $tags ) {
    echo ("<label for='tags'>Tags</label>"
        . "<input name='question[tags]' type='text' cols='92' class='tags' id='required'"
        . " value='" . $tags . "' />"
    );
}

我的 PHPdoc 的 makedoc.sh

#!/bin/bash
#/**
#  * title of generated documentation, default is 'Generated Documentation'
#  *
#  * @var               string TITLE
#  */
TITLE="komponentit"

#/**
#  * name to use for the default package. If not specified, uses 'default'
#  *
#  * @var               string PACKAGES
#  */
PACKAGES="default"

#/**
#  * name of a directory(s) to parse directory1,directory2
#  * $PWD is the directory where makedoc.sh
#  *
#  * @var               string PATH_PROJECT
#  */
PATH_PROJECT=$PWD:$PWD/handlers/:$PWD/handlers/searches/

#/**
#  * path of PHPDoc executable
#  *
#  * @var               string PATH_PHPDOC
#  */
PATH_PHPDOC=/usr/bin/phpdoc

#/**
#  * where documentation will be put
#  *
#  * @var               string PATH_DOCS
#  */
PATH_DOCS=$PWD/docs/

#/**
#  * what outputformat to use (html/pdf)
#  *
#  * @var               string OUTPUTFORMAT
#  */
OUTPUTFORMAT=pdf

#/**
#  * converter to be used
#  *
#  * @var               string CONVERTER
#  */
CONVERTER=Smarty

#/**
#  * template to use
#  *
#  * @var               string TEMPLATE
#  */
TEMPLATE=default

#/**
#  * parse elements marked as private
#  *
#  * @var               bool (on/off)           PRIVATE
#  */
PRIVATE=off

# make documentation
"$PATH_PHPDOC" -d "$PATH_PROJECT" -t "$PATH_DOCS" -ti "$TITLE" -dn $PACKAGES \
-o $OUTPUTFORMAT:$CONVERTER:$TEMPLATE -pp $PRIVATE

【问题讨论】:

  • 我用 Doxygen 替换了 PHPdoc,所以问题至少在短期内解决了。

标签: php phpdoc documentation


【解决方案1】:

请耐心等待......我不知道 PHPdoc,所以我在这里猜测一下,直到骑兵到达。

关于

"$PATH_PHPDOC" -d "$PATH_PROJECT" -t "$PATH_DOCS" -ti "$TITLE" -dn $PACKAGES \ -o $OUTPUTFORMAT:$CONVERTER:$TEMPLATE -pp $PRIVATE

使标记器解析器不高兴。语法有问题。

所有三个错误都与 makedoc.sh 的这一行有关

  • --output 可能是您在 makedoc.sh 中使用的 -o 的长格式
  • PdfSmartConverter中的第一个错误似乎是makedoc.sh中的几个变量一起运行造成的。您需要空格或其他分隔符吗?
  • 你需要更多“”
  • 'pdf' 足够输出格式说明符

正如我所说,我只是猜测 - 但也许它会给你一些想法。

现在……那个骑兵在哪里?

【讨论】:

  • 该文件基于PHPdoc安装程序中的官方模板文件。您的代码在安装程序中完全相同。我没有改变它。 - 在这种情况下,分隔符是什么意思? - 我显然不需要更多字符“。 - 根据文件,允许 PDF 为输出格式。
  • 我在想 $OUTPUTFORMAT 和 $CONVERTER 和 $TEMPLATE 之间的 :。哦,好吧,正如我所说,我只是在猜测,我希望我的回答中的某些内容会让你说“啊哈!”但是你比我更了解 PHPdoc。我希望有人能尽快给出正确的答案。
猜你喜欢
  • 1970-01-01
  • 2017-09-12
  • 2016-08-23
  • 2015-06-22
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2012-11-11
相关资源
最近更新 更多