README

	Linux	Windows
master
develop

px2-path-resolver は、Pickles 2 に、相対パス・絶対パスでの書き出しオプションを追加します。

導入方法 - Setup

1. Pickles 2 をセットアップ

2. composer.json に、パッケージ情報を追加

{
    "require": {
        "pickles2/px2-path-resolver": "^2.0"
    }
}

3. composer update

更新したパッケージ情報を反映します。

$ composer update

4. config.php を更新

$conf->funcs->before_output に、プラグイン設定を追加します。

<?php
return call_user_func( function(){

  /* (中略) */

  // processor
  $conf->funcs->processor->html = [
    // px2-path-resolver - 共通コンテンツのリンクやリソースのパスを解決する
    //   このAPIは、サイトマップCSV上で path と content が異なるパスを参照している場合に、
    //   相対的に記述されたリンクやリソースのパスがあわなくなる問題を解決します。
    'tomk79\pickles2\pathResolver\main::resolve_common_contents()' ,

    // テーマ
    // 'theme'=>'pickles2\themes\pickles\theme::exec' ,
    'theme'=>'(API name of theme package)' ,

  ];

  /* (中略) */

  // funcs: Before output
  $conf->funcs->before_output = [
    // px2-path-resolver - 相対パス・絶対パスを変換して出力する
    //   options
    //     string 'to':
    //       - relate: 相対パスへ変換
    //       - absolute: 絶対パスへ変換
    //       - pass: 変換を行わない(default)
    //     bool 'supply_index_filename':
    //       - true: 省略されたindexファイル名を補う
    //       - false: 省略できるindexファイル名を削除
    //       - null: そのまま (default)
    'tomk79\pickles2\pathResolver\main::exec('.json_encode(array(
      'to' => 'relate',
      'supply_index_filename' => true
    )).')' ,

  ];

  /* (中略) */

  return $conf;
} );

更新履歴 - Change log

pickles2/px2-path-resolver v2.1.1 (2023年2月11日)

• 内部コードの細かい修正。

pickles2/px2-path-resolver v2.1.0 (2022年1月8日)

• サポートするPHPのバージョンを >=7.3.0 に変更。
• PHP 8.1 に対応した。

pickles2/px2-path-resolver v2.0.15 (2021年5月25日)

• 内部コードの修正。

pickles2/px2-path-resolver v2.0.14 (2020年10月17日)

• サイズの大きなコンテンツを処理できない問題を修正。 600MBまで扱えるようになった。

pickles2/px2-path-resolver v2.0.13 (2019年9月4日)

• PHP 7.3 系で発生する不具合を修正。

pickles2/px2-path-resolver v2.0.12 (2019年6月8日)

• CSSが参照するファイル名に ) 記号を含められない不具合を修正。

pickles2/px2-path-resolver v2.0.11 (2019年4月19日)

• パス変換時に、もとの文字セットが無視されて UTF-8 に変換されてしまう不具合を修正。

pickles2/px2-path-resolver v2.0.10 (2019年1月25日)

• GETパラメータ部分やアンカー部分に未解決のパスが含まれているときに、これを変換しないようにした。

pickles2/px2-path-resolver v2.0.9 (2018年8月30日)

• 細かい不具合の修正。

pickles2/px2-path-resolver v2.0.8 (2018年1月24日)

• resolve_common_contents() が、 path または content が未定義のページでエラーを起こす不具合を修正。

pickles2/px2-path-resolver v2.0.7 (2016年7月27日)

• tomk79\pickles2\pathResolver\main::resolve_common_contents() で、 content が 0バイト のファイルの場合に異常終了する不具合を修正。

pickles2/px2-path-resolver v2.0.6 (2016年5月25日)

• HTML 1枚 のファイルサイズが大きくてパースに失敗する場合のエラー処理を追加。

ライセンス - License

MIT License

作者 - Author

• (C)Tomoya Koyanagi tomk79@gmail.com
• website: https://www.pxt.jp/
• Twitter: @tomk79 https://twitter.com/tomk79/