README

pickles2/px2-blog-kit 为 Pickles 2 添加博客管理功能。

导入说明 - 设置

1. 在 composer.json 中添加 pickles2/px2-blog-kit

$ composer require pickles2/px2-blog-kit;

2. 在 config.php 中设置插件

编辑配置文件 config.php (通常是 ./px-files/config.php)。在 before_content 的开头添加设置。

<?php

/* 中略 */

/**
 * funcs: Before content
 */
$conf->funcs->before_content = array(

    // BlogKit
    \pickles2\px2BlogKit\register::blog( array(
        "blogs" => array(
            "articles" => array( // ブログID
                "orderby" => "update_date", // 並べ替えに使用するカラム名
                "scending" => "desc", // 並び順 (昇順 asc or 降順 desc)
                "logical_path" => "/articles/{*}", // パンくず (サイトマップCSV上での記法と同じ)
            ),
        ),
    ) ),

);

3. 创建博客列表

在 ./px-files/blogs/ 目录下创建博客文章列表。

博客文章列表以 ${博客ID}.csv 的名称创建。例如，如果博客ID是 articles，则文件名是 articles.csv。

CSV的语法与网站地图CSV相同，但请勿包含 id 列和 logical_path 列。

下面是一个博客CSV的示例。

"* title","* path","* release_date","* update_date","* article_summary","* article_keywords"
"サンプルブログページ3のタイトル","/articles/2023/03/18/samplepage_3/","2023-03-18","2023-03-18",,
"サンプルブログページ2のタイトル","/articles/2023/03/17/samplepage_2/","2023-03-17","2023-03-17",,
"サンプルブログページ1のタイトル","/articles/2023/03/16/samplepage_1/index.html","2023-03-16","2023-03-16",,

导入最新的 px2-sitemapexcel 插件后，可以使用 Excel 格式进行编辑，这非常方便。

4. 创建内容

与在网站地图中记录的常规内容相同，请将内容文件放置在设置的 path 中。

使用 Blog Kit 模块创建文章列表页面

Broccoli 模块 Blog Kit 包含创建列表页面的模块。使用此模块创建列表页面。

5-1. 在网站地图CSV中添加列表页面

理想的列表页面应该是插件选项中指定的父页面的 logical_path。

例如，将 path 设置为 /articles/{*}。末尾的 {*} 对于处理列表页面的分页是必需的。

5-2. 在列表页面的内容中添加文章列表模块

配置的模块中，设置博客ID、每页的文章数、分页大小、排序键、升序/降序和列表页面ID。

此处指定的博客ID是博客CSV文件名中不含扩展名的部分（例如：articles）。

6. 设置RSS输出

编辑配置文件 config.php (通常是 ./px-files/config.php)。在 before_output 的任何位置添加设置。

<?php

/* 中略 */

/**
 * funcs: Before output
 */
$conf->funcs->before_output = array(

    // BlogKit: RSS出力
    \pickles2\px2BlogKit\register::feeds( array(
        "path_trigger" => "/",
        "blog_id" => "articles",
        "orderby" => "update_date",
        "scending" => "desc",
        'dpp' => 10,
        'lang' => 'ja',
        'scheme' => 'https',
        'domain' => 'yourdomain.com',
        'title' => 'test list 1',
        'description' => 'TEST LIST',
        'url_home' => 'https://yourdomain.com/',
        'url_index' => 'https://yourdomain.com/listsample/',
        'author' => 'Tomoya Koyanagi',
        'dist' => array(
            'atom-1.0' => '/rss/atom0100.xml',
            'rss-1.0' => '/rss/rss0100.rdf',
            'rss-2.0' => '/rss/rss0200.xml',
        ),
    ) ),

);

更新日志 - 变更日志

pickles2/px2-blog-kit v0.1.3 (2024年2月18日)

• 修正了从Markdown文章中正确提取缩略图的不当之处。
• 修正了文章摘要的转义处理不当的问题。

pickles2/px2-blog-kit v0.1.2 (2023年8月29日)

• 改进了编辑文章信息时的验证功能。

pickles2/px2-blog-kit v0.1.1 (2023年5月1日)

• 向Broccoli模块中添加README。
• 添加插件 \pickles2\px2BlogKit\register::feeds。

pickles2/px2-blog-kit v0.1.0 (2023年4月22日)

• 首次发布

许可证 - 许可

MIT 许可证 https://open-source.org.cn/licenses/mit-license.php

作者 - 作者

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