pinc v0.2.0
pinc
pinc (pretty include) は設定ファイル( pinc.yaml )にもとづいてファイルインクルードを実現するインクルードエンジンです。
インストール
npm install pinc(※ pinc コマンドを利用する為には npm install -g でインストールするか node_modules/.bin/ にPATHを通す必要があります)
用途
例えば、以下のディレクトリ構成の場合を考えます。
./
pinc.yaml
template/
default.html
partial/
header.html
footer.html
main.htmlそれぞれのファイル内容は以下のとおりです。
pinc.yaml:
P001:
url: index.html
template: default.html
partial:
header: header.html
footer: footer.html
main: main.htmltemplate/default.html:
<!doctype html>
<html lang="ja">
<head>
{{ header }}
</head>
<body>
<div clas="main">
{{ main }}
</div>
{{ footer }}
</body>
</html>template ファイルに 埋め込み指示コード {{ IDENTIFIER }} を記載します。
この時の IDENTIFIER は partial の属性名に対応します。
partial/header.html:
<meta charset="utf-8">partial/footer.html:
<div>
</div>partial/main.html:
hello world.この状態で pinc コマンドを実行すると、カレントディレクトリにある pinc.yaml に基づいてインクルードが実行されます。つまり、partial.headerであるheader.htmlの中身を {{ header }} に展開します。
$ pinc
P001 -> index.htmlインクルードされた結果は dest ディレクトリに出力されます。
その際のファイル名およびパスは url で指定したものになります。
./
pinc.yaml
dest/
index.html
template/
default.html
partial/
header.html
footer.html
main.html出力された dest/index.html の中身は以下のとおりです。
partialの各ファイルの内容が展開されています。
<!doctype html>
<html lang="ja">
<head>
<meta charset="utf-8">
</head>
<body>
<div clas="main">
hello world.
</div>
<div>
</div>
</body>
</html>pinc はこれを実現するためだけのアプリケーションです。
pinc.yamlについて
設定ファイル pinc.yaml には以下のような記述をします。
(id):
url: path
template: path
partial:
(key): path※ (id), (key) はそれぞれ任意の文字列
- yamlハッシュのキーとして数値のみを指定することは推奨しません。その場合、意図しない動作をする可能性があります。
- pinc.yaml に記載する id は処理には利用されませんが、yamlハッシュである性質上、ユニークでなければなりません。
- pinc.yaml には yamlに準拠したコメント(#)を含めることができます。
- template に指定した値 path が指すファイルが存在しない場合、エラー(Error)が発生し該当のファイルは作成されません。
- partial に指定した値 path が指すファイルが存在しない場合、警告(Warn)が発生し空ファイルとみなして処理します。
- partial に指定した値 path が@から始まる文字列の場合、それはファイルパスではなく文字列として扱われ、その文字列がそのままインクルード対象なります。(0.1.0 > )
- template および partial に指定するファイルパスにはディレクトリを含めることができます。
- url に指定するファイルパスにはディレクトリを含めることができます。生成時にそのディレクトリも自動的に作成します。
その他仕様
- template ファイルに記載する埋め込み指示コード
{{ IDENTIFIER }}は空白も含めて厳密でなければなりません。正規表現では{{ \w+ }}となります。 pincが動作する上で template ディレクトリ、 partial ディレクトリ、および pinc.yaml は必須です。
これらのディレクトリやファイルの名称を変更したい場合はpinc --helpを参照ください
$ pinc --help
Usage: pinc [options] [target_yaml_file]
--help, -h
Displays help information about this script
'pinc -h' or 'pinc --help'
--version
Displays version info
pinc --version
--dest, -d
destination directory
pinc -d dest
--template, -t
template directory
pinc -t template'
--partial, -p
partial directory
pinc -p partial