扩展:动态Pabelist3

来自MyaWiki.Org
跳转到导航 跳到搜索
MeimaWiKi扩展手册
OOJS用户界面图标
动态Pabelist3
发布状态: 稳定的
实施 标签 解析器函数
描述 创建列表其他文章的基础上类别、命名空间、标题、引用模板使用包括内容或者将这些文章模板调用到页面中的参数。
作者(S) 亚历克西亚史密斯算法组合丹维尔伊利亚海金森泰阿泰德篇恩德里希
最新版本 3.3.3-(2019-04-03)
维基百科 1.27 +
PHP 5.6 +
许可证 GNU通用公共许可证2或以后
下载
例子 DPL:手动- GAMPEPDA帮助维基
翻译动态Pabelist3扩展如果在TurtLeWik.NET中可用
检查使用和版本矩阵。
这是一个延续和岔口。动态页面(第三方). 它是一个完全重新设计的面向对象的代码库、重要的代码和数据库速度的改进,并且完全与以前的版本兼容。

这个动态Pabelist3扩展是MeaWiKi的报告工具,列出类别成员和交叉口,具有各种格式和细节。有关完整文档,请参见手动.

当调用一组基本的选择参数时,DPL显示一个或多个类别中的页面列表。选择也可以基于诸如作者、命名空间、日期、名称模式、模板的使用或其他文章的引用等因素。输出有多种形式,其中一些结合了选定文章的元素。

这个扩展是用解析器函数调用的。{{ dpl:…}或分析器标签< DPL >. 维基媒体可以调用某些特性的兼容实现。<动态页面>.

复杂的查找可能导致计算昂贵的数据库查询。但是,默认情况下,所有输出缓存一个小时的时间,以减少每个页面加载重新运行查询的需要。这个DPL:参数:其他参数手册页包含有关可用于禁用缓存并允许即时更新的参数的信息。

手册和完整的文件
GAMPEDA帮助Wiki文档
源代码
GITLAB的源代码
错误和特征请求
GITLAB问题
许可证贸易
动态Paulelist3发布GNU通用公共许可证,第2版.

安装[编辑]

  • 下载,摘录并将文件放置在一个名为动态页面员在你扩展文件夹

配置[编辑]

这些是DPL的配置设置以及它们的默认值。要更改它们,请确保它们在包含wiki上的扩展之前定义。

笔记在版本3.0.4中,配置变量名从$DPLSET$WGDPLSET. 这是为了兼容MealWiki 1.25的扩展注册更改。

设置 默认 描述
$WGDPLSt[ [允许名称空间] ] 无效的 默认情况下,当DPL初始化时使用所有现有的命名空间。使用命名空间常量数组自定义此设置,以限制DPL仅在那些命名空间中工作。
$WGDPLSt[ [允许限制的分类] ] 将此设置为true,忽略“MaxCythyCyt”,并允许无限制的类别。请注意,查询中的大量类别可以减慢或崩溃服务器。
$WGDPLSt[ [允许不限制结果] ] 将此设置为true以忽略“Max ReultCurt”,并允许无限制的结果。请注意,大的结果集可能会导致页面加载缓慢或失败。
$WGDPLSt[ [行为相似交集] ] 设置DPL总是表现得像扩展:交集。
$WGDPLSt[ [分类-TyLelelistCut关闭] ] 在被切断之前类别列表中的最大项目数。
$WGDPLSt[固定的分类] 空数组 这有助于防止DPL“看”这些类别。
$WGDPLSt[ [功能丰富] ] 3, 0如果$dPLAcExtTestTestTo设置为true 设置最终用户可用的参数级别。
$WGDPLSt[ [最大分类计数] ] 在查询中允许的最大类别数。
$WGDPLSt[ [分钟分类] 允许查询的最小类别数。
$WGDPLSt[ [最大结果计数] ] 五百 从查询返回的最大结果数。
$WGDPLSt[ [ RealsivEtAgPARSE ] ] 对DPL>解析器标签进行递归标签解析,转换标签和函数,如{{PaGeNAM}}}之类的魔术词。这类似于{{0dp}}解析器函数调用,但在所有情况下可能不完全相同。
$WGDPLSt[ [从ReloDebug页面仅] 将此设置为true,以允许DPL仅从受保护的页运行。如果Wiki管理员遇到恶意用户创建计算密集型查询的问题,这是值得推荐的。
$WGDPLSt[ [手抄标签] ] 将此设置为true以在DPL解析器标签外部具有DPL句柄<节>标签。

全局变量$WGNN包含AbEnLeNAMESPACE被DPL自动尊重。它将防止列表命名空间的内容出现在DPL的输出中。

笔记$WGDPLSt[ [最大结果计数] ]是一个极限SQL查询本身. 一些DPL查询参数包括附录应用之后然而,SQL查询在这里的结果可能容易误导。

功能丰富度[编辑]

动态Pabeliston有许多基于最大功能丰富度级别的解锁特征。有些可能会导致高CPU或数据库负载,应谨慎使用。

  • $WGDPLSt[ [功能丰富] ]=0相当于维基媒体维基媒体
  • $WGDPLSt[ [功能丰富] ]=1添加附加格式化参数
  • $WGDPLSt[ [功能丰富] ]=2添加模板和页面的性能等效特性
  • $WGDPLSt[ [功能丰富] ]=3允许更昂贵的页面包含特性和正则表达式查询。
  • $WGDPLSt[ [功能丰富] ]=4允许异域和潜在危险的批量更新和删除操作;不推荐用于公共网站。包括调试和开发的调试参数。

用法[编辑]

扩展DPL功能[编辑]

通过使用解析器函数调用扩展的DPL{{ dpl:…}或解析器扩展标记<dpL>…</dpL>.

见:手动通用用法和调用语法DPL:参数:Page Selection准则

向后兼容性[编辑]

与Wikimdia的DPL扩展兼容的功能可以被调用<动态页面编辑器>…<动态页面>. 进一步的信息可以在兼容性手册页.

使用哲学与概览[编辑]

假设有些文章是关于国家这些文章通常有三个共同点:

  • 它们属于共同的范畴。
  • 它们将有相似的章节结构,即它们将包含“宗教”或“历史”的段落。
  • 他们将使用一个模板,用来以一种好的方式呈现高度结构化的短数据项(‘资本’,‘居民’,……)(例如WikEnable)。

基于报表生成报表国家[编辑]

如果需要汇编一个国家实行某种宗教的报告,这很容易做到。多类别林克斯托参数。

{ { dpL:*类别=国家〉

DPL可以:

  • 生成所有这些文章的列表(或随机样本)
  • 显示文章的元数据(流行度,最后更新日期,…)
  • 显示文章的一个或多个章节(“阻止内容”)
  • 显示传递给公共模板的参数值
  • 适当订购物品
  • 将结果呈现在可排序表中(例如)
  • 生成多栏输出

哪些步骤是必要的?[编辑]

找到你想列出的文章:

  • 由类别的逻辑组合(或,或,或不是)选择
  • 指定物品必须被分配到的类别数量的范围
  • 通过命名空间的逻辑组合(或,或,不是)来选择
  • 定义一个必须与文章名称匹配的模式
  • 命名该文章必须或不能链接的页面
  • 命名一个模板,该模板必须或不能使用
  • 命名必须在页面外部链接中发生的文本模式
  • 排除或包含重定向
  • 将搜索限制为稳定页面或质量页面(“标记修订版”)
  • 使用其他选择标准,如作者、上次更改日期等。
  • 定义正则表达式以匹配要包含的页的内容

按顺序排列文章的结果列表

  • 文章名称
  • 文章大小
  • 上次更改日期
  • 最后一个用户进行编辑

定义你想看到的属性

  • 文章名称
  • 条目名字空间
  • 文章大小
  • 上次更改日期
  • 最后访问日期
  • 最后一个用户进行编辑

定义要显示的内容

  • 整篇文章
  • 某些部分的内容(由标题标识)
  • 文本部分(由文章中的特殊标记标记定义)
  • 模板调用的值
  • 使用自定义模板显示输出

定义输出格式

  • 为默认输出指定页眉和页脚
  • 使用有序列表,无序列表
  • 使用表
  • 通过将模板应用到它们的内容来单独地格式化表字段
  • 使用类别样式列表
  • 将标题或内容截断到某个最大长度
  • 向文章或其一个或多个部分添加链接

考虑事项[编辑]

性能[编辑]

对于典型的类别和文章查找,DPL的代码执行和数据库访问通常很快。然而,使用松散类和ReGeXP匹配参数和/或请求大数据集可以导致长的数据库访问时间。还应考虑解析器时间。例如,将图像结果的查询放入显示它们的模板中,将导致对每一个的解析器媒体转换。这可以很快吃掉2MB的RAM每媒体转换。

也见[编辑]

进一步阅读[编辑]

DPL可以做的比我们在这里能解释的多。完整的手动可以提供完整的参数文档。