Actionscript 3 编写文档-在线显示文档的开源解决方案?

Actionscript 3 编写文档-在线显示文档的开源解决方案?,actionscript-3,frameworks,documentation,Actionscript 3,Frameworks,Documentation,我一直在研究AS3中的一个框架,我想发布它,但首先我显然需要准备一些文档 我注意到相当多的网站都有与AdobeLiveDocs完全相同的布局、功能等,这让我相信有一些开源的东西可以用来创建在线文档 以下是一些例子: 有没有人能为我指明正确的方向,让我可以使用这些工具来准备在线文档 理想情况下,该系统将特别适用于ActionScript 3中的文档。对于自动生成的文档,我也没有任何要求——如果有什么东西看起来/工作起来很好,我很乐意手动创建文档(前提是它附带了用于轻松添加类、参数等的工具)。

我一直在研究AS3中的一个框架,我想发布它,但首先我显然需要准备一些文档

我注意到相当多的网站都有与AdobeLiveDocs完全相同的布局、功能等,这让我相信有一些开源的东西可以用来创建在线文档

以下是一些例子:

  • 有没有人能为我指明正确的方向,让我可以使用这些工具来准备在线文档


    理想情况下,该系统将特别适用于ActionScript 3中的文档。对于自动生成的文档,我也没有任何要求——如果有什么东西看起来/工作起来很好,我很乐意手动创建文档(前提是它附带了用于轻松添加类、参数等的工具)。

    Adobe有一个名为的免费工具。它生成遵循官方Adobe模式的文档。坦白说,这不值得。ASDoc工具有缺陷且不可靠。如果很难找到导入,如果没有使用导入,注释格式不正确,或者源代码以任何意外的方式展开,那么它就会崩溃


    我的公司在试图绕过这些限制和我们的解决方案时损失了50多个开发小时(一些人试图让几个不同的项目工作,但失败了)?我们使用了(一个JavaDoc编译器)。它完美吗?否。它的输出是否与ASDoc相当?在某种程度上,它并没有那么整洁,如果它处理事情的方式有点不同,那就好了,但它可以显示文档。

    Adobe有一个名为的免费工具。它生成遵循官方Adobe模式的文档。坦白说,这不值得。ASDoc工具有缺陷且不可靠。如果很难找到导入,如果没有使用导入,注释格式不正确,或者源代码以任何意外的方式展开,那么它就会崩溃


    我的公司在试图绕过这些限制和我们的解决方案时损失了50多个开发小时(一些人试图让几个不同的项目工作,但失败了)?我们使用了(一个JavaDoc编译器)。它完美吗?否。它的输出是否与ASDoc相当?在某种程度上,它没有那么整洁,如果它处理事情的方式有点不同,那将是一件好事,但它可以显示文档。

    谢谢你,我将首先查看ASDoc(出于明显的原因),如果我有任何问题,我将查看NaturalDocs。我以我认为最受支持的方式评论了所有内容(例如FlashDevelop收集了我所有的@param等)。@Marty在很多情况下,它都工作得很好,但如果你有任何角落的案例,它会给你留下一两处战伤。这是命令行的耻辱。。这样的东西从来都不好用。你知道一个有实际GUI的类似工具吗?不知道,但是你可能会找到一个有GUI的JavaDoc工具——ASDoc几乎与JavaDoc兼容(这就是为什么NaturalDocs可以工作的原因)。如果你使用FlashDevelop,你可以去工具->Flash工具->文档生成器。谢谢你,我会先看看ASDoc(原因很明显)如果我有什么问题,我会去看看NaturalDocs。我以我认为最受支持的方式评论了所有内容(例如FlashDevelop收集了我所有的@param等)。@Marty在很多情况下,它都工作得很好,但如果你有任何角落的案例,它会给你留下一两处战伤。这是命令行的耻辱。。这样的东西从来都不好用。你知道一个有实际GUI的类似工具吗?不知道,但是你可能会找到一个有GUI的JavaDoc工具——ASDoc几乎与JavaDoc兼容(这就是为什么NaturalDocs可以工作的原因)。如果你使用FlashDevelop,你可以去工具->Flash工具->文档生成器。