blog.taaas.jp

これは何か？

MTでテーマを同期するためのツールチェーンの一部で、デスクトップ上のファイルをMTにアップロードするためのアプリケーションです。(全体についてはこちら)

できること

• デスクトップ上のテーマのファイルをMTに同期することができます
• デスクトップ上に保存したテーマから直接プレビューを生成できます
  • 複数のファイルにまたがる変更の場合にも、全ての変更を反映した状態でプレビューを生成できます
• デスクトップ上に保存したテーマから、MTにテンプレートを一括で反映することができます
• 同じテーマのブログをまとめて再構築することができます

デモ

(全体の説明でのデモと同じものです)

動作環境

• OS X 10.9 以降
  • OS X Mavericks
  • OS X Yosemite
  • それ以降

インストール

1. GitHubからdmgファイルをダウンロードしてください。リリース一覧
2. ダウンロードしたファイルを開いて、MTSyncTheme.app をアプリケーションフォルダへインストールしてください。

(これ以降の説明はコマンドライン版の mt-sync-theme とほぼ同じ内容です)

実行前の設定

最小限の設定

1. MTにSyncedThemeをインストールしてください
2. 書きだしたテーマをデスクトップに保存してください
3. MTSyncTheme.appを実行する準備が整いました

詳細設定

1. MTにSyncedThemeをインストールしてください
2. (オプション) SyncedTheme を使ってテンプレートをテーマファイルにリンクしておくと便利です
3. (オプション) ブログからテーマを書き出してください
4. 書きだしたテーマをデスクトップに保存してください
5. (オプション) テーマのディレクトリにmt-sync-theme.yamlという名前で設定ファイルを置いてください。
   • 設定例
     • Mac
     • Windows
   • 設定値はコマンドラインオプションとして指定することもできます
6. MTSyncTheme.appを実行する準備が整いました

使いかた

概要

利用可能なコマンド

• Preview
  • ファイルの更新を監視して、ファイルが更新されるとプレビューページを生成し、指定されたハンドラでページを開きます。
  • このサブコマンドではmt-sync-themeは本番環境には影響を与えません。
• On the fly
  • ファイルの更新を監視して、ファイルが更新されると対応している公開ページを更新し、指定されたハンドラでページを開きます。
  • このサブコマンドではmt-sync-theme本番環境に影響を与えます。公開前の構築時に利用されることを想定しています。
• Sync
  • デスクトップ上のファイルをMTにアップロードします。
• Apply
  • 関連付けられている全てのブログで、テーマを再適用します。
• Rebuild
  • 関連付けられている全てのブログを再構築します。

Preview

• ファイルの更新を監視して、ファイルが更新されるとプレビューページを生成します。
  
  • このコマンドはファイルを監視するループになります。Ctrl+C で終了します。
• 更新されたファイルがインデックステンプレートかアーカイブテンプレートであった場合、url_handler として指定されたコマンドで URL を開きます。
  • モジュールテンプレートの場合には、theme.yaml で "preview_via" を指定することで、任意のテンプレートでプレビューを生成することができます。

On the fly

• ファイルの更新を監視して、ファイルが更新されると対応するページを生成します。
  
  • このコマンドはファイルを監視するループになります。Ctrl+C で終了します。
• このコマンドを実行する前には、ブログを1度再構築しておく必要があります。
• 更新されたファイルがインデックステンプレートかアーカイブテンプレートであった場合、url_handler として指定されたコマンドで URL を開きます。
  • モジュールテンプレートの場合には、theme.yaml で "preview_via" を指定することで、任意のテンプレートでプレビューを生成することができます。

Sync

• デスクトップ上のファイルをMTにアップロードします

Apply

• 関連付けられている全てのブログで、テーマを再適用します
• 以下の importer のみが実行されます。
  • template_set
  • static_files
  • custom_fields
    • テーマからカスタムフィールドを適用すると失敗するケースが多いですが、これはMT側の仕様です

Rebuild

• 関連付けられている全てのブログを再構築します。

詳細設定

preview_via

preview_via を使って、プレビューに利用するテンプレートを明示的に指定することができます。

--- 
elements: 
  template_set: 
    data: 
      templates: 
        module: 
          entry_summary: 
            label: Entry Summary
            preview_via: main_index

関連するツールのリンク

• ツール全体について
• SyncedTheme
  • MT側でこのツールを利用可能にするためのプラグイン
• mt-sync-theme
  • デスクトップ上のファイルをMTにアップロードするためのコマンドラインツール
• MTSyncTheme.app (このページです)
  • デスクトップ上のファイルをMTにアップロードするためのアプリケーション