https://github.com/pickles2/px2-publish-ex
機能拡張された Pickles 2 のパブリッシュプラグイン。
https://github.com/pickles2/px2-publish-ex
Last synced: 5 months ago
JSON representation
機能拡張された Pickles 2 のパブリッシュプラグイン。
- Host: GitHub
- URL: https://github.com/pickles2/px2-publish-ex
- Owner: pickles2
- License: mit
- Created: 2018-03-18T10:55:17.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2025-07-12T08:10:19.000Z (11 months ago)
- Last Synced: 2025-10-15T05:00:54.114Z (8 months ago)
- Language: PHP
- Size: 1.44 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pickles2/px2-publish-ex
機能拡張された Pickles 2 のパブリッシュプラグインです。
## 導入手順 - Setup
### 1. composer.json に pickles2/px2-publish-ex を追加
```bash
$ composer require pickles2/px2-publish-ex;
```
### 2. config.php に、プラグインを設定
設定ファイル `config.php` (通常は `./px-files/config.php`) を編集します。
`before_content` にある、`PX=publish` の設定を、次の例を参考に書き換えます。
```php
funcs->before_content = array(
// PX=publish (px2-publish-ex)
'tomk79\pickles2\publishEx\publish::register()' , // オプションについては後述
);
```
※ Pickles 2 の設定をJSON形式で編集している方は、`config.json` の該当箇所に追加してください。
### 3. パブリッシュを実行
標準的な Pickles 2 のパブリッシュと同じ手順で、パブリッシュコマンドを実行します。
```
$ php .px_execute.php /?PX=publish.run
```
## オプション - Options
### コマンドラインオプション - CLI Options
次のコマンドラインオプションが、 `PX=publish.run` と合わせて使用できます。
#### `path_region`
対象範囲とするディレクトリパスを1つ指定します。省略時はカレントディレクトリが対象になります。
`/?PX=publish.run&path_region=/a/b/` と `/a/b/?PX=publish.run` は同じ意味です。
#### `paths_region`
対象範囲を追加指定します。配列で複数指定可能です。
#### `paths_ignore`
`path_region` で指定した対象範囲のうち、パブリッシュを除外するパスを指定します。複数指定可能です。
#### `keep_cache`
1を指定し、パブリッシュ処理の初期化時に、キャッシュの削除および再生成をスキップします。
#### 実行例
オプションを設定した実行例を示します。
```
$ php .px_execute.php "/?PX=publish.run&path_region=/a/b/&paths_region[]=/a/c/&paths_region[]=/a/d/&paths_ignore[]=/a/b/ignore1/&paths_ignore[]=/a/b/ignore2/&keep_cache=1"
```
この例では、対象範囲を `/a/b/` に絞った上で、 `/a/b/ignore1/` と `/a/b/ignore2/` を対象外に指定しています。
### プラグインオプション - Plugin Options
```php
funcs->before_content = array(
// PX=publish (px2-publish-ex)
'tomk79\pickles2\publishEx\publish::register('.json_encode(array(
// パブリッシュ対象から常に除外するパスを設定する。
// (ここに設定されたパスは、動的なプレビューは可能)
// ※この設定は、 `pickles2/px-fw-2.x` に付属するオリジナルのパブリッシュ機能と互換します。
'paths_ignore'=> array(
'/sample_pages/no_publish/*'
),
// パブリッシュするデバイスの情報を設定する。
// 複数のデバイス情報を配列で指定します。
// ここには、追加で処理したいデバイスの設定だけを記述します。
// 本来のパブリッシュで処理される標準的なデバイスは、暗黙的に処理されます。
// つまり、このオプションが空白でも、 1つの標準的なデバイスとしてパブリッシュされます。
// (この挙動を変更したい場合は、次の `skip_default_device` に true を設定します)
'devices'=>array(
array(
// USER_AGENT 文字列
'user_agent'=>'iPhone',
// このデバイスが常に付加するパラメータ
'params' => array(
'LANG' => 'ja',
),
// このデバイス向けのパブリッシュ先ディレクトリ
'path_publish_dir'=>'./px-files/dist_smt/',
// パスの書き換えロジック
// 次の部品を組み合わせて、書き換え後のパスの構成規則を指定します。
// - `{$dirname}` = 変換前のパスの、ディレクトリ部分
// - `{$filename}` = 変換前のパスの、拡張子を除いたファイル名部分
// - `{$ext}` = 変換前のパスの、拡張子部分
//
// または次のように、コールバックメソッド名を指定します。
// > 'path_rewrite_rule'=>'functionNameOf::rewrite_smt',
// コールバックメソッドには、 引数 `$path` が渡されます。
// これを加工して、書き換え後のパスを返してください。
'path_rewrite_rule' => '{$dirname}/{$filename}.smt.{$ext}',
// このデバイス向けに出力するファイルのパス
'paths_target' => array(
'*.html',
),
// このデバイス向けには出力しないファイルのパス
'paths_ignore'=>array(
'/default_only/*',
),
// リンクの書き換え方向
// `origin2origin`、`origin2rewrited`、`rewrited2origin`、`rewrited2rewrited` のいずれかで指定します。
// `origin` は変換前のパス、 `rewrited` は変換後のパスを意味します。
// 変換前のパスから変換後のパスへのリンクとして書き換える場合は `origin2rewrited` のように指定します。
'rewrite_direction'=>'rewrited2rewrited',
),
array(
'user_agent'=>'iPad',
'path_publish_dir'=>'./px-files/dist_tab/',
'path_rewrite_rule'=>'functionNameOf::rewriter_tab',
),
/* ...以下同様... */
),
// キャッシュバスターを有効にするか？ (default to `false`)
'enable_cache_buster' => false,
// 標準デバイスを出力しない (default to `false`)
// `true` を設定すると、標準デバイスでのパブリッシュはされなくなります。
'skip_default_device' => false,
// vendor ディレクトリをパブリッシュする (default to `false`)
'publish_vendor_dir' => false,
)).')' ,
);
```
## PX Commands
次の PX Command が登録されます。
- `PX=publish` : パブリッシュのホーム画面を表示します。
- `PX=publish.run` : パブリッシュを実行します。
- `PX=publish.version` : パブリッシュプラグインのバージョン番号を返します。
## 更新履歴 - Change log
### pickles2/px2-publish-ex v2.1.5 (2025年7月12日)
- ヘッダー情報の送信に関する改善。
### pickles2/px2-publish-ex v2.1.4 (2024年4月30日)
- `enable_cache_buster` オプションを追加。
- `X-PXFW-RELATEDLINK` によって追加された新しいパスが、キュー配列の先頭に追加されるようになった。
- その他の細かい修正。
### pickles2/px2-publish-ex v2.1.3 (2023年9月24日)
- 内部で扱う時刻情報を ISO 8601 形式 に変更した。
### pickles2/px2-publish-ex v2.1.2 (2023年4月22日)
- `PX=publish.run` で、`path_region` を省略しても、 `paths_region` だけで対象範囲を絞れるようになった。
### pickles2/px2-publish-ex v2.1.1 (2023年2月11日)
- 内部コードの修正など。
### pickles2/px2-publish-ex v2.1.0 (2022年1月8日)
- サポートするPHPのバージョンを `>=7.3.0` に変更。
- PHP 8.1 に対応した。
### pickles2/px2-publish-ex v2.0.8 (2021年8月21日)
- 同梱のプラグインが、より直接的な表現で設定できるようになった。
### pickles2/px2-publish-ex v2.0.7 (2021年7月10日)
- デバイス設定に `params` を追加。
- その他の細かい修正。
### pickles2/px2-publish-ex v2.0.6 (2020年4月4日)
- パブリッシュ時に、開始時刻と終了時刻を `timelog.txt` に記録するようになった。
### pickles2/px2-publish-ex v2.0.5 (2020年1月2日)
- 新しいオプション `publish_vendor_dir` を追加。
### pickles2/px2-publish-ex v2.0.4 (2019年9月4日)
- パブリッシュが2重に起動することがある問題を修正。
- PHP 7.3 系で発生する不具合を修正。
### pickles2/px2-publish-ex v2.0.3 (2019年6月8日)
- `path_region`、`paths_region`、`paths_ignore` で、各行の先頭にスラッシュを補完するようになった。
- CSSが参照するファイル名に `)` 記号を含められない不具合を修正。
### pickles2/px2-publish-ex v2.0.2 (2019年4月19日)
- パス変換時に、もとの文字セットが無視されて UTF-8 に変換されてしまう不具合を修正。
### pickles2/px2-publish-ex v2.0.1 (2019年2月4日)
- Windowsで、パス変換時に相対パスの階層がズレることがある不具合を修正。
### pickles2/px2-publish-ex v2.0.0 (2018年8月18日)
- Initial release.
## ライセンス - License
MIT License
## 作者 - Author
- Tomoya Koyanagi
- website:
- Twitter: @tomk79