README

px2-path-resolver 为 Pickles 2 添加相对路径和绝对路径的写入选项。

安装方法 - 设置

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;
} );

更新日志 - 变更记录

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 文件过大导致解析失败的错误处理。

许可证 - 许可

MIT 许可证

作者 - 作者

• (C)Tomoya Koyanagi tomk79@gmail.com
• 网站: https://www.pxt.jp/
• 推特: @tomk79 https://twitter.com/tomk79/