代码之家  ›  专栏  ›  技术社区  ›  Kinglish

如何制作apidoc。需要json参数?

  •  0
  • Kinglish  · 技术社区  · 8 年前

    非常简单,但我找不到关于如何将参数标记为的文档 必修的 当我标记文档以生成api文档时(使用包@: http://apidocjs.com )

    // My APIDOC markup in my PHP doc
    
     * @apiParam {String} [type] comma delimited list of any or all of: contests, deals, coupons
    

    ... 生成以下html:

    enter image description here

    我想要 optional 如图所示成为 required . 它的标记是什么?

    1 回复  |  直到 8 年前
        1
  •  1
  •   Kinglish    8 年前

    找到了。事实证明,您只需删除变量周围的[]括号

     * @apiParam {String} required_variable comma delimited list of any or all of: contests, deals, coupons