23得票5回答
JSDoc - 如何记录原型方法

我一直在尝试使用JSDoc记录以下代码:/** * @module person */ /** * A human being. * @class * @param {string} name */ function Person(name){ this.nam...

92得票5回答
如何使用Pydoc创建文档?

我正在尝试从我的模块创建一个文档。我在Windows 7上使用Python 3.2.3中的命令行使用pydoc:python "<path_to_pydoc_>\pydoc.py" -w myModule 这导致我的shell中填充了文本,每个文件在模块中占用一行,内容为:no P...

16得票1回答
Sphinx-apidoc在构建Django HTML时出现`django.core.exceptions.AppRegistryNotReady`错误

问题背景: 我想在我的Django项目中使用Sphinx编写文档,并利用我的Django代码注释自动创建文档。 现在我有一个Django(1.9)项目,文件结构如下: myproject/ myproject/ __init__.py settings.py ...

7得票2回答
如何在Xcode中创建实例变量和方法的文档?

我希望能够在我创建的程序中,通过Alt-Click来查看实例变量(或方法)的用途。尽管Xcode告诉我类变量是在哪里声明的很好,但这还不够。在这种情况下,我想看到我自己输入的自定义文本来描述一个asset的真实含义。此外,知道ivar的类型也很有用。 怎么做呢?在这种情况下,我想知道我所说的...

12得票2回答
使用Swagger编写CXF REST API文档

根据Swagger的教程,似乎swagger仅支持Jersey框架(请参见https://github.com/wordnik/swagger-core/wiki/java-jax-rs)。 有没有人在使用CXF JAX-RS实现时使用Swagger的经验?你能在这里分享你的建议吗?

8得票3回答
使用Appledocs生成文档

非常抱歉我的问题很简单,但我正在尝试使用Appledocs(https://github.com/tomaz/appledoc#quick-install)生成文档。 我不确定如何准确地设置它。我是这样做的: 我克隆了GitHub存储库,然后使用终端中的安装脚本安装appledocs (...

25得票1回答
使用Sphinx-apidoc从C++代码生成文档

以前有一些帖子谈论过这个话题,声称Sphinx根本不支持这个。我有些怀疑,但它可能已经更新了,或者文档被很好地隐藏起来了,因为这里有一个链接表明了相反的情况: http://www.sphinx-doc.org/en/master/usage/restructuredtext/domains....

14得票2回答
为JSF 2组合组件生成文档

我希望生成一个自定义JSF 2组合组件库的文档。这些组合组件没有在任何faces-config.xml文件中被引用,而是将组合组件的.xhtml文件存储在META-INF/resources中,并使用新的composite:interface标签来定义接口。 对于JSP标签库,可以使用htt...

8得票2回答
Sphinx文档和自动文档跳过成员

我正在按照以下方式为我的Django项目构建Sphinx文档: sphinx-apidoc app -o docs/source/app --force 现在我的文档里包含了所有南迁移的内容,而我并不想要它们。我尝试使用以下方式将它们排除: conf.py: def skip_...

7得票2回答
XML可以使用Doxygen、Sandcastle或其他文档生成器进行文档化吗?

我目前使用Sandcastle、Doxygen和JavaDoc来生成我编写的代码文档。是否可以使用这些工具包来记录XML模式?如果不行,是否有任何(最好是免费的!)工具可以做到这一点?我可以在Doxygen或Sandcastle中作为额外的概念主题自己编写文档,但我更希望有一个工具可以替代我完...