zukucode
主にWEB関連の情報を技術メモとして発信しています。

gulp front-matterの内容をdataとして使用する

ブログの記事を作成するにあたって、title descriptionのメタ情報などファイルごとに管理する情報はfront-matterの形式で管理すると便利です。

front-matterとは

front-matterを使うと、ファイルの先頭の---で囲まれた部分を簡単にデータとして扱うことができるようになります。

---
title: タイトル
arr: ['配列', 'も', '設定', 'できます']
obj: {'object': 123, 'も': 'test', '設定可能': 456}
---
記事の内容

gulpでfront-matterを使う

最初にfront-matterのパッケージをインストールします。

gulp-front-matterというgulp専用のパッケージも用意されていますが、細かな制御も実装したいため、普通のfront-matterを使用します。

$ npm install --save-dev front-matter

また、タスク処理でfront-matterのデータを、扱うためにgulp-dataもインストールします。

$ npm install --save-dev gulp-data

gulp-〜を自動読み込み

gulp-dataなどgulp-〜のパッケージを自動で読み込むためにgulp-load-pluginsをインストールします。

$ npm install --save-dev gulp-load-plugins

gulpをES2015で実装するで紹介したように、gulpfileES2015の記法で実装しています。

gulpfile.babel.js
import gulp from 'gulp';
import gulpLoadPlugins from 'gulp-load-plugins';

const $ = gulpLoadPlugins();

// $.data でgulp-dataのパッケージが使用可能になります。

タスク処理の流れの中で以下のように実装します。

gulpfile.babel.js
import gulp from 'gulp';
import gulpLoadPlugins from 'gulp-load-plugins';
import fm from 'front-matter';

const $ = gulpLoadPlugins();

// task処理一部抜粋
.pipe($.data((file) => {
  const content = fm(String(file.contents));
  // ファイルの内容を設定します(front-matterの記載部分を取り除く)
  file.contents = new Buffer(content.body);
  // front-matterの情報をデータとして返します
  return content.attributes;
}))

続きを表示

関連記事

  • gulpをES2015で実装する

    gulpをES2015で実装するための手順です。babelを使うと、ES2015 (ES6)などで書かれたソースコードを一般的なブラウザがサポートしているECMAScript5の形式に変換できます。


  • gulp lessをcssにコンパイルする

    lessファイルをgulpを使ってcssにコンパイルします。gulp-lessとgulp-autoprefixerをインストールします。gulp-autoprefixerはなくても構いませんが、古いブ...


  • gulp markdownを変換してnunjucksで扱う

    実際に公開するhtmlファイルの中身はmarkdownから変換したhtmlの内容だけではなく、titleやdescriptionなどのmetaタグやヘッダ、フッタなどの情報が必要です。そのため、mar...


  • gulp markdownの内容をhtmlに変換する

    gulpでmarkdownの形式で記載したデータをhtmlに変換します。本ブログのように技術ブログの場合はコードをシンタックスハイライト(色付け)して表示したいので、highlight.jsもインスト...


  • gulp nunjucksをコンパイルしてhtmlに変換する

    nunjucksで記載されたテンプレートエンジンをhtmlに変換します。今回はnunjucksのコンパイルにgulp-nunjucks-renderを使用します。特に設定をしなくても正しく動作するので...


  • nunjucks includeで絶対パスを指定する

    nunjucksの便利な機能の1つにincludeがあります。ファイルパスはデフォルトでは相対パスで設定されます。なのでメインとなるnjkファイルのパスによって以下のようになってしまいます。これではフ...


  • 静的サイトジェネレーターを自作してブログ作成システムを作成

    JekyllやHugoなど、魅力的なものはあったのですが、この際勉強を兼ねて静的サイトジェネレーターを自作してみようと思いました。以下、gulpで静的サイトジェネレーターを自作したときの作業メモです。


  • gulp 引数を受け取って開発時とリリース時で処理を分岐する

    コマンドラインでタスクを実行する際に、以下のようにパラメータを指定して、タスク処理では指定されたパラメータを受け取って処理を分岐するようにします。minimistを使えば上記の形式で指定したパラメータ...