代码之家  ›  专栏  ›  技术社区  ›  Nando Vieira

RDOC XML生成

  •  0
  • Nando Vieira  · 技术社区  · 15 年前

    我正在尝试使用XML格式生成RDOC。下面是我使用的命令:

    $ rdoc --fmt=xml --opname=api.xml
    

    文件已创建,但未生成方法列表。我在用 rdoc (2.4.3) . XML的RDOC模板包含用于方法显示的标记。

    有可能吗?

    1 回复  |  直到 15 年前
        1
  •  1
  •   ire_and_curses    15 年前

    自2.4以来,不支持XML输出。参见 this blog 由其中一名维护人员:

    将HTML和XML生成器移动到未维护的

    • 不会提供宝石,因为宝石太难使其发挥作用。
    • 删除了选项“一个文件,一个样式=,一个内嵌源,一个混杂,一个名称”

    我认为您不能运行2.4.3——您在示例中指定的选项不适用于此版本。我刚下载了最新的gem并确认了这一点:

    $ rdoc --format=xml --opname=api.xml 
    invalid argument: --format=xml
    

    也许你有一个旧版本的 rdoc 已安装,在您的 $PATH ?

    我试过 rdoc 1.0.1 得到了您描述的行为(XML输出,没有方法)。所以看起来你的问题的答案是“不,这是不可能的(以前是小车,现在不支持)”。

    你可以试着把这个作为 feature request 尽管这听起来有一段时间不会发生,如果有的话。