README

Pickles 2 是一个开源的HTML生成工具，能够高效地构建静态的大型网站。

• 使用CSV格式管理网站地图（页面列表），自动生成全局导航、当前处理、面包屑生成、标题和元标签的输出等。
• 将内容（页面特定的内容部分）和主题（头部、底部、导航等通用部分）分开编码。主题是从网站全体的通用代码中自动生成的。
• 无需数据库，可以轻松部署到PHP 5.4以上的Web服务器。
• 可以动态引入Markdown或SCSS等语法。
• 使用简单的命令即可输出静态HTML文件（发布）。
• 通过Composer的引入，可以轻松添加和扩展功能。

安装步骤 - 安装

使用composer命令设置Pickles 2项目。

$ cd {$yourProjectRoot}
$ composer create-project pickles2/preset-get-start-pickles2 ./
$ chmod -R 777 ./px-files/_sys
$ chmod -R 777 ./src_px2/common/px_resources

通过浏览器访问Web服务器，如果显示顶层页面或者通过以下命令显示设置信息，则表示成功。

$ php ./src_px2/.px_execute.php "/?PX=config"

发布步骤 - 发布

$ php ./src_px2/.px_execute.php "/?PX=publish.run"

dist/ 将输出为静态HTML。

清除缓存步骤

$ php ./src_px2/.px_execute.php "/?PX=clearcache"

系统需求 - 系统要求

• Linux服务器或Windows服务器
• Apache
  • mod_rewrite 可用
  • .htaccess 可用
• PHP 7.3以上
  • mbstring PHP扩展
  • ZipArchive PHP扩展
  • JSON PHP扩展
  • PDO PHP扩展
  • PDO SQLite (PDO_SQLITE) PHP扩展
  • XML解析器 PHP扩展
  • XMLWriter PHP扩展

推荐环境

• PHP 7.4以上
  • Ctype PHP扩展
  • DOM PHP扩展
  • Fileinfo PHP扩展
  • GD PHP扩展
  • iconv PHP扩展
  • libxml PHP扩展
  • SimpleXML PHP扩展
  • XMLReader PHP扩展
  • Zlib PHP扩展

根据插件和其他包的配置，可能需要满足一些额外要求。请确保检查依赖包的系统需求。

更新日志 - 变更日志

pickles2/preset-get-start-pickles2 v2.3.0 (2023年2月12日)

• 将新的约定*.direct/*、*.direct.*和*.pass/*、*.pass.*添加到$conf->paths_proc_type。
• 引入了px2-serve。
• 引入了.env。
• 引入了px2style和Summernote字段，并刷新了模块集。
• 整理了主题集合。

pickles2/preset-get-start-pickles2 v2.2.0 (2022年6月5日)

• 将支持的PHP版本更改为PHP 7.3以上。
• 更新了模块包。

pickles2/preset-get-start-pickles2 v2.1.2 (2021年7月10日)

• 更新了模块包。

pickles2/preset-get-start-pickles2 v2.1.1 (2021年4月24日)

• 更新了库 - jQuery到v3.6.0。
• 在Broccoli的image字段中，设置自动随机命名图像文件名。
• 更新了模块包。

pickles2/preset-get-start-pickles2 v2.1.0 (2020年12月19日)

• 更改了目录结构。预览环境的文档根目录更改为src_px2/，发布目标目录更改为dist/。
• 更新了模块包。

pickles2/preset-get-start-pickles2 v2.0.26 (2020年12月10日)

• 更新了库 - jQuery到v3.5.1。
• 更新了模块包。

pickles2/preset-get-start-pickles2 v2.0.25 (2020年4月4日)

• 将模块包tomk79/broccoli-module-std-document更新到0.1.5。
• 将模块包tomk79/broccoli-module-interact更新到0.1.1。
• 将模块包 tomk79/broccoli-module-lp 更新到 0.1.4。
• 引入插件 tomk79/px2-scss。

pickles2/preset-get-start-pickles2 v2.0.24 (2020年3月14日)

• 将模块包 tomk79/broccoli-module-std-document 更新到 0.1.4。
• 为了解决在用户环境不兼容时安装失败的问题，已删除 composer.lock。 (但不要在 .gitignore 中记录。用户在环境中设置的 composer.lock 应该提交到项目中)

pickles2/preset-get-start-pickles2 v2.0.23 (2020年1月18日)

• 依赖包更新: pickles2/px-fw-2.x (2.0.43 => 2.0.44)
• 依赖包更新: twig/twig (v1.42.4 => v3.0.1)
• 依赖包更新: tomk79/langbank (0.0.3 => 0.0.4)
• 依赖包更新: broccoli-html-editor/broccoli-html-editor (0.3.11 => 0.3.13)
• 依赖包更新: pickles2/lib-px2-contents-editor (2.0.9 => 2.0.10)
• 依赖包更新: pickles2/lib-px2-module-editor (0.2.4 => 0.2.6)
• 依赖包更新: pickles2/px2-px2dthelper (2.0.13 => 2.0.14)
• 依赖包更新: pickles2/px2-publish-ex (2.0.4 => 2.0.5)

pickles2/preset-get-start-pickles2 v2.0.22 (2019年12月13日)

• 将 $conf->extra 规定为项目特定的设置项。
• 依赖包更新: michelf/php-markdown (1.8.0 => 1.9.0)
• 依赖包更新: pickles2/px-fw-2.x (2.0.42 => 2.0.43)
• 依赖包更新: tomk79/broccoli-module-std-document (0.1.1 => 0.1.3)
• 依赖包更新: tomk79/broccoli-module-lp (0.1.0 => 0.1.1)
• 依赖包更新: symfony/polyfill-ctype (v1.12.0 => v1.13.1)
• 依赖包更新: twig/twig (v1.42.3 => v1.42.4)
• 依赖包更新: broccoli-html-editor/broccoli-html-editor (0.3.10 => 0.3.11)
• 依赖包更新: pickles2/lib-px2-contents-editor (2.0.8 => 2.0.9)

pickles2/preset-get-start-pickles2 v2.0.21 (2019年9月10日)

• 依赖包更新: pickles2/px2-dec (2.0.1 => 2.0.2)
• 依赖包更新: pickles2/px2-remove-attr (2.0.2 => 2.0.3)

pickles2/preset-get-start-pickles2 v2.0.20 (2019年9月4日)

• 刷新初始导入的通用模块集。现在可以立即导入以制作更通用的网站。
• 依赖包更新: pickles2/px-fw-2.x (2.0.41 => 2.0.42)
• 依赖包更新: pickles2/px2-path-resolver (2.0.12 => 2.0.13)
• 依赖包更新: symfony/polyfill-ctype (v1.11.0 => v1.12.0)
• 依赖包更新: twig/twig (v1.42.2 => v1.42.3)
• 依赖包更新: broccoli-html-editor/broccoli-html-editor (0.3.8 => 0.3.10)
• 依赖包更新: pickles2/lib-px2-contents-editor (2.0.7 => 2.0.8)
• 依赖包更新: pickles2/lib-px2-module-editor (0.2.3 => 0.2.4)
• 依赖包更新: pickles2/px2-px2dthelper (2.0.12 => 2.0.13)
• 依赖包更新: pickles2/px2-publish-ex (2.0.3 => 2.0.4)
• 依赖包更新: tomk79/broccoli-module-std-document (0.1.0 => 0.1.1)

pickles2/preset-get-start-pickles2 v2.0.19 (2019年6月20日)

• 依赖包更新: twig/twig (v1.42.1 => v1.42.2)
• 依赖包更新: broccoli-html-editor/broccoli-html-editor (0.3.7 => 0.3.8)

pickles2/preset-get-start-pickles2 v2.0.18 (2019年6月15日)

• 依赖包更新: leafo/scssphp (v0.7.7 => v0.7.8)
• 依赖包更新: pickles2/px-fw-2.x (2.0.40 => 2.0.41)
• 依赖包更新: pickles2/px2-path-resolver (2.0.11 => 2.0.12)
• 依赖包更新: twig/twig (v1.39.1 => v1.42.1)
• 依赖包更新: broccoli-html-editor/broccoli-html-editor (0.3.6 => 0.3.7)
• 依赖包更新: pickles2/lib-px2-contents-editor (2.0.5 => 2.0.6)
• 依赖包更新: pickles2/lib-px2-module-editor (0.2.2 => 0.2.3)
• 依赖包更新: pickles2/px2-px2dthelper (2.0.11 => 2.0.12)
• 依赖包更新: pickles2/px2-sitemapexcel (2.0.10 => 2.0.11)
• 依赖包更新: pickles2/px2-publish-ex (2.0.2 => 2.0.3)

pickles2/preset-get-start-pickles2 v2.0.17 (2019年4月20日)

• 依赖包更新: pickles2/px-fw-2.x (2.0.39 => 2.0.40)
• 依赖包更新: pickles2/px2-path-resolver (2.0.10 => 2.0.11)
• 依赖包更新: phpoffice/phpexcel (1.8.1 => 1.8.2)
• 依赖包更新: pickles2/px2-sitemapexcel (2.0.9 => 2.0.10)
• 依赖包更新: pickles2/px2-publish-ex (2.0.1 => 2.0.2)
• 依赖包更新: symfony/polyfill-ctype (v1.10.0 => v1.11.0)
• 依赖包更新: twig/twig (v1.37.1 => v1.39.1)
• 依赖包更新: broccoli-html-editor/broccoli-html-editor (0.3.5 => 0.3.6)

pickles2/preset-get-start-pickles2 v2.0.16 (2019年4月19日)

• 将默认的 Broccoli 引擎更改为 broccoli-html-editor-php。
• 将字符集和换行符转换的插件 picklesFramework2\processors\encodingconverter\encodingconverter::exec 设置为一组，在 $conf->funcs->before_output 中进行。

pickles2/preset-get-start-pickles2 v2.0.15 (2019年2月22日)

• 添加 composer.lock。

pickles2/preset-get-start-pickles2 v2.0.14 (2019年1月11日)

• 修正了 composer 显示错误的问题。

pickles2/preset-get-start-pickles2 v2.0.13 (2018年8月30日)

• 作为发布插件，引入了功能扩展版 pickles2/px2-publish-ex。

pickles2/preset-get-start-pickles2 v2.0.12 (2018年5月16日)

• 将模块的设置从 $conf->paths_module_template 更改为 $conf->path_module_templates_dir。因此，现在可以用 DesktopTool 进行编辑。

pickles2/preset-get-start-pickles2 v2.0.11 (2018年4月24日)

• 新增支持GUI编辑模式的样本主题
• 添加px2-sitemapexcel的转换方向设置为仅xlsx -> csv
• 从项目中移除捆绑的Bootstrap、normalize.css
• 从主题中移除捆绑的Bootstrap

pickles2/preset-get-start-pickles2 v2.0.10 (2017年10月27日)

• 将使用旧方法名 $bowl->pull() 的地方更改为新的 $bowl->get_clean()

pickles2/preset-get-start-pickles2 v2.0.9 (2017年9月21日)

• 新增配置项 scheme
• 默认启用broccoli-receive-message脚本插入插件
• 解决主题与项目资源紧密依赖的问题

版权 - License

版权所有 (c)2001-2023 Tomoya Koyanagi, and Pickles Project
MIT许可证 https://open-source.org.cn/licenses/mit-license.php

作者 - Author

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