yard 0.7.3 无法在 Markdown 和 Textile 中构建我的自述文件

我决定将我的项目中的 README 文件转换为 Markdown，并一直使用yard 验证文档是否正确呈现。所以我安装了 rdiscount，将 README 更改为 README.md 并尝试：

yard doc README.md

这给了我一个警告：

[warn]: Syntax error in `readme.md`:(3,18): syntax error, unexpected tinteger, expecting $end

所以我尝试：

yard doc -m markdown -- README.md

同样的问题。跑步：

yard doc --backtrace -- README.md

提供了更多信息：

[warn]: Syntax error in `readme.md`:(3,18): syntax error, unexpected tinteger, expecting $end
[error]: ParserSyntaxError: syntax error in `README.md`:(3,18): syntax error, unexpected tINTEGER, expecting $end
[error]: Stack trace:
    /Users/wadewest/.rvm/gems/ruby-1.9.2-p290@peppercorn/gems/yard-0.7.3/lib/yard/parser/ruby/ruby_parser.rb:505:in `on_parse_error'
    /Users/wadewest/.rvm/gems/ruby-1.9.2-p290@peppercorn/gems/yard-0.7.3/lib/yard/parser/ruby/ruby_parser.rb:49:in `parse'
    /Users/wadewest/.rvm/gems/ruby-1.9.2-p290@peppercorn/gems/yard-0.7.3/lib/yard/parser/ruby/ruby_parser.rb:49:in `parse'
    /Users/wadewest/.rvm/gems/ruby-1.9.2-p290@peppercorn/gems/yard-0.7.3/lib/yard/parser/ruby/ruby_parser.rb:15:in `parse'
    /Users/wadewest/.rvm/gems/ruby-1.9.2-p290@peppercorn/gems/yard-0.7.3/lib/yard/parser/source_parser.rb:438:in `parse'
    /Users/wadewest/.rvm/gems/ruby-1.9.2-p290@peppercorn/gems/yard-0.7.3/lib/yard/parser/source_parser.rb:361:in `parse_in_order'

如果我尝试使用纺织品，也会发生同样的情况。如果有人想尝试重现该问题，该项目已启动github https://github.com/wadewest/peppercorn/tree/markdown。谢谢。

我想你只是对yard选项。帮助是这样说的：

$ yard --help doc
Usage: yard doc [options] [source_files [- extra_files]]
(if a list of source files is omitted, 
  {lib,app}/**/*.rb ext/**/*.c is used.)

Example: yardoc -o documentation/ - FAQ LICENSE
  The above example outputs documentation for files in
  lib/**/*.rb to documentation/ including the extra files
  FAQ and LICENSE.
...

所以当你这样说时：

$ yard doc -m markdown -- README.md

Yard将尝试解读README.md作为某种源文件。你的README.md将被解释为 Ruby 源文件（事实并非如此），这会导致Ruby像这样的错误：

unexpected tinteger, expecting $end

如果您编辑您的README.md稍微你会看到错误的位置移动，但如果你尝试阅读，错误就会有意义README.md作为 Ruby 源文件。

你不需要说什么README.md跑步时yard无论如何，yard会知道该怎么办README.md一切都靠它自己。