Docco忽略评论块

Question

我使用docco作为创建coffeescript文档的工具。

默认情况下，我在coffeescript源中发表的每条评论都被视为文档，并移至左侧（解释性）列。 问题是，在我的源代码中有一些代码行被注释掉，留作备用选项，我希望保留在正确的（代码）列中。

有没有办法告诉docco-“不要触摸它，留下这就像它是正常的代码”？ “＃！”或者“#ignore”可能吗？ 提前谢谢。

Answer 1

你试过吗？它将忽略#! hashbang行。

  

忽略hashbangs和插值......

        l.commentFilter = /(^#![/]|^\s*#\{)/
      languages
    languages = buildMatchers languages

从源头，第277行https://github.com/jashkenas/docco/blob/master/docco.litcoffee

如果不出意外，您应该能够编辑源代码以添加您想要的任何选项。