コマンドリファレンス
mtb Pro を入れると、mtb に23のコマンドが追加されます。どれも mtb のほかのコマンドと同じ構造なので、 --set --fields --extract --dry-run が使えます。ファイルを送るコマンドには --dir(ディレクトリを階層ごと送る)もあります。
一覧は mtb extensions show mtb-pro、パラメータは各コマンドの --help で確かめられます。
作成者
| コマンド | すること |
|---|---|
mtb sites entries author update <site-id> <entry-id> | 記事の作成者を変える |
mtb sites pages author update <site-id> <page-id> | ウェブページの作成者を変える |
Data API で作った記事の作成者は、サインインしている利用者になり、あとから変えられません(うまくいかないとき)。 記事を原稿の書き手の名前で登録したいときに使います。
テーマ
| コマンド | すること |
|---|---|
mtb themes files upload <theme-id> | テーマのディレクトリにファイルを置く(--dir でディレクトリごと) |
mtb sites theme-export-settings get <site-id> | テーマ書き出しの設定(静的ファイルのフォルダ)を見る |
mtb sites theme-export-settings update <site-id> | 同じ設定を変える |
テーマを置いたら、mtb 本体の mtb sites themes apply で適用します(テーマからサイトを起こす)。 themes files upload には MtbProAllowFileUpload 1 が要ります(インストール)。
カスタムブロック(ブロックエディタ)
| コマンド | すること |
|---|---|
mtb sites block-editor blocks list <site-id> | サイトのカスタムブロックの一覧 |
mtb sites block-editor blocks get <site-id> <block-id> | 1つの内容を見る |
mtb sites block-editor blocks create <site-id> | 作成する |
mtb sites block-editor blocks update <site-id> <block-id> | 更新する |
mtb sites block-editor blocks delete <site-id> <block-id> | 削除する |
利用者とサイトの Data API
| コマンド | すること |
|---|---|
mtb users api-password issue <user-id> | Webサービスパスワードを発行する(応答に一度だけ出る) |
mtb sites data-api get <site-id> | サイトで Data API が許可されているかを見る |
mtb sites data-api update <site-id> | 許可する・しない(--enabled true) |
自分のパスワードを発行し直すと、現在のプロファイルに保存したパスワードは使えなくなります(次にサインインし直すときに認証に失敗します)。このコマンドはほかの利用者のパスワードの発行に使います。
アセットとサイトのファイル
| コマンド | すること |
|---|---|
mtb sites assets replace <site-id> <asset-id> | アセットのファイルを差し替える(ID と URL はそのまま) |
mtb sites files upload <site-id> | アセットにせずにサイトの公開パスへファイルを置く(.js・.html も) |
mtb sites files delete <site-id> | サイトの公開パスのファイルを消す |
files upload / delete には MtbProAllowFileUpload 1 が要ります。
監査ログとエンドポイントの制限
| コマンド | すること |
|---|---|
mtb audit-logs list | Data API の監査ログ(だれが・いつ・何を・何の作業として) |
mtb audit-logs get <audit-log-id> | 1件の詳細を見る |
mtb endpoint-policy get | MtbPro のどのエンドポイントが開いているか |
使い方は運用。
Movable Type Advanced だけで使えるもの
| コマンド | すること |
|---|---|
mtb users bulk export | 利用者を、一括の取り込みに使える行として書き出す(UTF-8) |
mtb users bulk import | 利用者の登録・更新・削除を一括で(行ごとに結果が返る) |
mtb directory get | 利用者のディレクトリ(LDAP)の設定を診断する |
mtb directory synchronize | LDAP と同期し、変わったものを返す |
説明が英語で出ます
mtb Pro のコマンドの --help の1行目の説明は、いまは英語だけです(mtb 本体の説明は日本語でも出ます)。