メインコンテンツにスキップ
  • Middleman ホームページ
  • サポート
  • コミュニティ
  • ドキュメント

基礎

  • インストール
  • v4 へのアップグレード
  • 新しいサイトの作成
  • ディレクトリ構造
  • 開発サイクル
  • ビルド & デプロイ
  • Frontmatter
  • テンプレート言語
  • ヘルパーメソッド
  • レイアウト
  • パーシャル
  • リダイレクト
  • ブログ機能

高度な機能

  • 設定
  • プロジェクトテンプレート
  • 動的ページ
  • データファイル
  • 多言語化 (i18n)
  • アセットパイプライン
  • 外部パイプライン
  • Rack ミドルウェア
  • サイトマップ
  • きれいな URL (ディレクトリインデックス)
  • キャッシュ機能の改善
  • ファイルサイズ最適化
  • カスタム拡張
  • テンプレートエンジンオプション

プロジェクトテンプレート

新しいプロジェクトを始める場合, middleman init コマンドは デフォルトのプロジェクトテンプレート をフォルダに 展開します。以前のバージョンの middleman とは異なり, カスタムプロジェクトテンプレートは git リポジトリに単にファイルを置くか Thor コマンド用意するだけです。 デフォルトのプロジェクトテンプレートを使いたくない場合, -T オプションに git リポジトリのパスを指定する必要があります。

Github テンプレート



init コマンドに Github の username/repo-name を渡します。

middleman init MY_PROJECT_FOLDER -T username/repo-name

ローカルテンプレート

ローカルの Git リポジトリへのパスを file:// で渡します。 Note: 3本の スラッシュ /// が必要です。

 +middleman init MY_PROJECT_FOLDER -T file:///path/to/local/repo/

テンプレートディレクトリ

デフォルトのプロジェクトテンプレートに加え, Middleman コミュニティには たくさんのカスタムテンプレートがあります。コミュニティによって開発された プロジェクトテンプレートは ディレクトリ で確認できます。

ディレクトリにあなたが開発したテンプレートを追加したい場合は, Middleman ディレクトリ の説明を読んでください。プロジェクトを 追加すると init コマンド実行時に短い名前でテンプレートを指定できます。 たとえば, 公式の Middleman ブログ テンプレートは blog として 登録されているので, 次のようにプロジェクトの初期化を行うことができます:

middleman init MY_NEW_BLOG -T blog

Thor テンプレート

処理を必要とするテンプレートは Thor で実現することができます。 デフォルトテンプレート はこの方法で作られているので プロジェクト初期化時に質問をすることができます。

Thorfile はリポジトリの root に配置してください:

require 'thor/group'

module Middleman
  class Generator < ::Thor::Group
    include ::Thor::Actions

    source_root File.expand_path(File.dirname(__FILE__))

    def copy_default_files
      directory 'template', '.', exclude_pattern: /\.DS_Store$/
    end
  end
end

この Ruby クラスの中の public メソッドは順に実行されます。上記の簡単な例では フォルダをコピーしています。template ディレクトリにあなたが使用したい デフォルトテンプレートがある場合, 先述した Thor を使用しないテンプレートのように 動作します。

© 2011–2022 Thomas Reynolds

コントリビュータ の助けを借りて コアチーム によって メンテナンスされています。

  • Twitter
  • GitHub