注释 Comment ~~ Comments

带输出的注释和 JavaScript 的单行注释类似,它们像标签,能生成 HTML 注释,而且必须独立一行。

  1. // 一些内容
  2. p foo
  3. p bar

Pug 也同样提供了不输出的注释,只需要加上一个横杠。这些内容仅仅会出现在 Pug 模板之中,不会出现在渲染后的 HTML 中。

  1. //- 这行不会出现在结果里
  2. p foo
  3. p bar

块注释 ~~ Block Comments

一个格式正确的块注释应该像这样:

  1. body
  2. //-
  3. 给模板写的注释
  4. 随便写多少字
  5. 都没关系。
  6. //
  7. 给生成的 HTML 写的注释
  8. 随便写多少字
  9. 都没关系。

条件注释 ~~ Conditional Comments

Pug 没有特殊的语法来表示条件注释(conditional comments)。条件注释是一种用于分辨 Internet Explorer 新老版本的特殊标记。不过因为所有以 < 开头的行都会被当作纯文本,因此直接写一个 HTML 风格的条件注释也是没问题的。

  1. doctype html
  2. <!--[if IE 8]>
  3. <html lang="en" class="lt-ie9">
  4. <![endif]-->
  5. <!--[if gt IE 8]><!-->
  6. <html lang="en">
  7. <!--<![endif]-->
  8. body
  9. p Supporting old web browsers is a pain.
  10. </html>