インクルード

インクルードを使用すると、1つのパグファイルの内容を別のファイルに挿入できます。

パスが絶対パス(例: include /root.pug)の場合、options.basedirが先頭に付加されて解決されます。それ以外の場合は、コンパイルされる現在のファイルに対する相対パスを解決します。

ファイル拡張子が指定されていない場合は、ファイル名に自動的に.pugが付加されます。

プレーンテキストのインクルード

パグ以外のファイルをインクルードするのは、単にその生のテキストを含めるだけです。

フィルタされたテキストのインクルード

フィルターとインクルードを組み合わせると、インクルードするときにフィルター処理できます。

//- index.pug
doctype html
html
  head
    title An Article
  body
    include:markdown-it article.md
# article.md

This is an article written in markdown.
<!DOCTYPE html>
<html>
  <head>
    <title>An Article</title>
  </head>
  <body>
    <h1>article.md</h1>
    <p>This is an article written in markdown.</p>
  </body>
</html>