如何创建phpdoc教程/扩展页面以补充注释的代码
内容导读
互联网集市收集整理的这篇技术教程文章主要介绍了如何创建phpdoc教程/扩展页面以补充注释的代码,小编现在分享给大家,供广大互联网技能从业者学习和参考。文章包含1299字,纯文字阅读大概需要2分钟。
内容图文
我正在尽一切努力获取phpdocumentor,以允许我使用DocBook教程格式来补充它创建的文档:
>我正在使用Eclipse
>我已经在OSX机器上通过PEAR安装了phpDocumentor
>我可以从我的php类运行并自动生成代码
>它不会格式化教程-我找不到解决方案
我尝试将.pkg示例文件移动到整个文件结构中,并在子文件夹中使用与代码中引用的包相似的名称..我真的很茫然-如果有人可以解释在哪里放置它们, .pkg和其他DocBook文件,它们与它们正在记录的代码有关,以及它们如何触发phpdoc对其进行格式设置,对此我将不胜感激,此刻我正在使用它:
phpdoc -o HTML:Smarty:HandS
-d "/path/to/code/classes/", "/path/to/code/docs/tutorials/"
-t /path/to/output
解决方法:
我没想到会回答我自己的问题,但是经过两天的痛苦折腾和一个周末的实验后,看来这是问题所在:
本教程和我的示例都可以使用,但是phpdoc解释开关值的方式似乎有一个小缺陷.这是我一直在使用的:
phpdoc -o HTML:Smarty:HandS
-d "/path/to/code/classes/", "/path/to/code/docs/tutorials/"
-t /path/to/output
但是,如果使用以下命令:
phpdoc -o HTML:Smarty:HandS
-d /path/to/code/classes/, /path/to/code/docs/tutorials/
-t /path/to/output
它将正确格式化您的教程和扩展文档,我所做的就是删除目录路径周围的双引号.单引号根本不起作用-因为phpdoc本身在没有空格的情况下用双引号将目录包装起来……这似乎是phpdoc的错误,并且基于Web的界面也发生了相同的行为,因此它是内部的问题.我最初的尝试应该可以奏效,但我不会与开发人员联系并引起他们的注意.
问题解决了.
内容总结
以上是互联网集市为您收集整理的如何创建phpdoc教程/扩展页面以补充注释的代码全部内容,希望文章能够帮你解决如何创建phpdoc教程/扩展页面以补充注释的代码所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错,欢迎将互联网集市网站推荐给程序员好友。
内容备注
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 gblab@vip.qq.com 举报,一经查实,本站将立刻删除。
内容手机端
扫描二维码推送至手机访问。