12

是否有类似 javadoc 或 rdoc 用于记录 YAML 文件,以便我们可以将其提取到 HTML 文档中?理想情况下使用降价语法。

4

1 回答 1

7

概述

正如对问题的评论中所显示的那样,一般来说,记录 YAML 所需要做的就是创建专门用于文档或元数据的 YAML 内容部分。

唯一值得注意的挑战是确定您是否希望您的文档部分符合用于文档代码的各种语法样式的约定(例如,Doxygen、NaturalDocs 等)。

这个问题域有多种方法。此答案的“另请参阅”部分指出了替代方法。

例子

在 YAML 中创建元数据部分非常简单,您只需创建一个内联字符串即可将所有文档转储为单个块。

  ## comments
  ## NOTE: YAML generally throws your comments away, so they are not very useful
  ## for round-trip metadata

  meta: | 
     Here is all my documentation and metadata
     blah blah blah.

  data: 
     branch_one: 
        - caption: blah blah
          date: blah blah
          details: blah blah

        - caption: blah two
          date: blah blah
          details: blah blah

     branch_two: 

  [..]

也可以看看

于 2011-12-19T17:45:57.880 回答