从精通到晕头转向：基于Listpages与CSS计数器的进阶数据处理

字数：16280

各位下午好，这里是Sharia Vanilla，欢迎回到我们的Listpages进阶教程——在上一期的入门讲座中，我们介绍了通过Listpages抓取单页数据并对其进行简单处理与展示的小技巧，以及共计(n-1)位中分成员都非常喜欢的Listpages迭代。然而，对抓取到的多个页面进行整体上的数据统计似乎一直以来都是个麻烦事。在大多数人的理解中，如果仅凭借基础的Listpages统计功能，我们只能对抓取到的页面做一些类似于最大值、最小值以及总数之类的常规统计。但是，如果我们在这里面混入一点点小技巧，我们就能得到一些可能会有更多人感兴趣的数据：例如，总分数、总投票数或总作者数。

这期的相关文档包括CSS计数器的使用以及Listpages的官方文档。那么话不多说，让我们开始吧。

1.回顾/预备知识

1.1. Listpages生成结构

这一章节中的部分内容在上一期教程中已经有过讲解，此处仅作简单说明。

在不添加任何参数的情况下，Listpages的生成结构如下：

[[div class="list-pages-box"]]
  [[div class="list-pages-item"]]
    内容1
  [[/div]]
  [[div class="list-pages-item"]]
    内容2
  [[/div]]
  ......
[[/div]]

调用Listpages模块时，wrapper=与separate=这两个参数分别被用于控制上述结构的外部div和内部div。它们的缺省值是"yes"。当wrapper="no"时，将不会在编译时添加list-pages-box这一div块，当separate="no"时，则不会添加list-pages-item这一div块。

为了避免模块额外添加的分割块影响CSS调整，本文中的Listpages模块将默认使用wrapper="no" separate="no"。同时，为了尽可能避免分页模块的影响，建议额外添加perPage="250"以最大化可用列举范围。

1.2. 在Listpages模块中插入CSS修改

这一技术同样在入门篇中做过简单介绍。你可以通过使用

[[%%content{0}%%module css]]
你需要的css代码
[[%%content{0}%%/module]]

在Listpages模块中插入CSS修改。其原理是任何页面的%%content{0}%%均会被Listpages模块解析为空字符串。

1.3. CSS计数器

CSS计数器是CSS提供的一个功能。它由三个属性counter-reset、counter-set与counter-increment，以及两个函数counter()与counters()组成。它们的格式与用法简单列举如下：

div.reset {
  counter-reset: counter1; /* 创建计数器counter1，并将counter1的值设为0。 */
  counter-reset: counter1 2 counter2 4; 
  /* 可以为计数器提供初始值，也可以一次初始化多个计数器。 */
}
div.set {
  counter-set: counter1 8; /* 将计数器的值直接设置为指定值。此处同样可以一次设置多个计数器。 */
}
div.increment {
  counter-increment: counter1; /* 缺省参数时，将计数器的值增加1。 */
  counter-increment: counter1 -1 counter2 0; /* 参数可以填写0或负数。 */
}
div.print::before {
  content: counter(counter1); /* counter函数只能被用在伪元素的content上，是一个字符串变量。 */ 
  content: "(" counter(counter1, lower-roman) ")."; 
  /* 可以为counter的第二个参数填写计数器样式，或将函数通过空格与其它字符串连接。
      例如，当counter1的值为7时，此处展示为(vii). */
}

以001提案中心页为例，其CSS/FTML结构简化后如下所示。此处CSS计数器“series”在进入div.content-panel时被创建并初始化为0，并在每次经过div.divider时自增1。如此即可实现自动的系列编号标注。

[[module css]]
.content-panel {
  counter-reset: series;
}
.content-panel .divider {
  font-size: 0;
  counter-increment: series;
}
.content-panel .divider::after {
  font-size: .675rem;
  content: counter(series, upper-roman);
}
[[/module]] 
 
[[div class="content-panel standalone series"]]
  [[div class="divider"]]
     此处Series=1。本段文字内容不会展示，仅用于确保所属div不会被隐藏，下同。
  [[/div]]
  [[div class="divider"]]
     此处Series=2。
  [[/div]]
  [[div class="divider"]]
     此处Series=3。
  [[/div]]
  [[div class="divider"]]
     此处Series=4，实际展示内容为"IV"。
  [[/div]]
[[/div]]

2.基于CSS/Listpages的总分计算

计算一系列文章的总分几乎可以说是Listpages不自带的所有功能中需求量最大的一个。你或许愿意在你的作者页中加上一个这玩意来展示你的累累战果，也可能需要在某些团队竞赛进行的时候为每个队伍在你的作者页中导演一场分数的皇城PK。一段简单的总分计算代码如下所示：

[[module css]]
span.hidden {
  display: none;
}
div.sumVotes {
  counter-reset: sumVotes;
}
div.sumVotes > div:last-of-type::before {
  content: "标签包含'猫科'的原创作品总分为" counter(sumVotes) "。";
}
[[/module]]
 
[[div class="sumVotes"]]
[[module Listpages tags="+原创 +猫科" category="-deleted" wrapper="no" separate="no" perPage="250"]]
[[div style="counter-increment: sumVotes %%rating%%;"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
[[/module]]
[[/div]]

这段代码能够实现总分计算的具体原理在于：

在div.sumVotes中，我们创建了一个名为sumVotes的CSS计数器。这一计数器被用于统计待抓取篇目的总分。
在通过Listpages创建的，每一篇文章各自对应的独立内容部分，我们通过内联样式counter-increment: sumVotes %%rating%%将计数器sumVotes的值增加%%rating%%，后者是Listpages提供的，获取文章当前分数的参数。
在div.sumVotes下的最后一个子div中，我们通过伪元素展示最终的统计结果。

这里的%%rating%%可以被替换为%%rating_votes%%/%%comments%%以统计总投票数/总评论数，也可以使用表达式结构（[[#expr ]]等）对数据进行一定的预处理。

如果需要统计的文章篇目过多（超过250篇），或是有某些不满足筛选条件但仍需统计的例外篇目，可以直接通过串联Listpages的方式扩展上述代码。例如，统计全站原创goi格式总分的代码如下所示：

[[module css]]
span.hidden {
  display: none;
}
div.sumVotes { /* 如果你希望在一个页面中添加多个展示文本不同的计分器，请修改每一处父div的class名。 */
  counter-reset: sumVotes; /* 计数器名称无需修改。 */
}
div.sumVotes > div:last-of-type::before {
  content: "原创GoI格式总分为" counter(sumVotes) "。";
}
[[/module]]
 
[[div class="sumVotes"]]
[[module Listpages tags="+原创 +goi格式" category="-deleted" wrapper="no" separate="no" limit="250" perPage="250"]]
[[div style="counter-increment: sumVotes %%rating%%;"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
[[/module]]
[[module Listpages tags="+原创 +goi格式" category="-deleted" wrapper="no" separate="no" offset="250" limit="250" perPage="250"]]
[[div style="counter-increment: sumVotes %%rating%%;"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
[[/module]]
[[/div]]

此外，你还可以用类似的技巧对实现多组Listpages参数的可视化。例如，下面的这段代码在实现统计朝颜文学报、旅行者之书以及妖精们三个标签的总分的同时，在一定程度上按照总分分配了对应进度条的占比：

[[module css]]
span.hidden {
  display: none;
}
.display-area {
  display: grid;
  grid-template-columns: 1fr 2fr 1fr;
}
.flex-line {
  grid-area: 1 / 1 / span 1 / span 3;
  display: flex;
  flex-wrap: wrap;
  counter-set: counter1 0 counter2 0 counter3 0;
}
.display-area p {
  margin: 0;
  color: transparent;
  user-select: none;
}
 
.item.c1 {background-color: #ff8889;}
.item.c2 {background-color: #5fc572;}
.item.c3 {background-color: #00c1ff;}
 
.counter-displayer {
  text-align: center;
  color: black;
}
 
.counter-displayer.c1 {grid-area: 1 / 1 / span 1 / span 1;}
.counter-displayer.c2 {grid-area: 1 / 2 / span 1 / span 1;}
.counter-displayer.c3 {grid-area: 1 / 3 / span 1 / span 1;}
 
.counter-displayer.c1::before {content: counter(counter1);}
.counter-displayer.c2::before {content: counter(counter2);}
.counter-displayer.c3::before {content: counter(counter3);}
 
[[/module]]
 
[[div class="display-area"]]
 
[[div class="flex-line"]]
 
[[module Listpages tags="+原创 +朝颜文学报" category="-deleted" separate="no" wrapper="no" perPage="250"]]
[[div class="item c1" style="flex: %%rating%%; counter-increment: counter1 %%rating%%;"]]
.
[[/div]]
[[/module]]
 
[[module Listpages tags="+原创 +旅行者之书" category="-deleted" separate="no" wrapper="no" perPage="250"]]
[[div class="item c2" style="flex: %%rating%%; counter-increment: counter2 %%rating%%;"]]
.
[[/div]]
[[/module]]
 
[[module Listpages tags="+原创 +妖精们" category="-deleted" separate="no" wrapper="no" perPage="250"]]
[[div class="item c3" style="flex: %%rating%%; counter-increment: counter3 %%rating%%;"]]
.
[[/div]]
[[/module]]
 
[[/div]]
 
[[div class="counter-displayer c1"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
 
[[div class="counter-displayer c2"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
 
[[div class="counter-displayer c3"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
 
[[/div]]

这一组件通过为一个flex布局下的子div调整其flex属性以动态调整宽度。需注意当抓取到的篇目总数过多时，组件可能强制换行从而影响展示效果。

3.基于CSS/Listpages的作者数统计

为某个标签统计其（发布页面的）不同贡献者总数对于希望构建中心页的用户来说可能有重要意义。其效果可以参考中央厨房中心。这一功能的一种实现方式如下：

[[module css]]
span.hidden {
  display: none;
}
div.count-author {
  counter-reset: listAuthor;
}
div.count-author > div.listAuthor {
  counter-increment: listAuthor;
}
div.count-author > div:last-of-type::before {
  content: "共有" counter(listAuthor) "名作者参与短竞。";
}
[[/module]]
 
[[div class="count-author"]]
[[module listpages tags="+2024噤声短文竞赛" category="-deleted" wrapper="no" separate="no" order="created_by" perPage="250"]]
[[div class="listAuthor n%%created_by_id%%"]]
[[span class="hidden"]]@@ @@[[/span]]
[[/div]]
[[%%content{0}%%module css]]
div.n%%created_by_id%% + div.n%%created_by_id%% {
  counter-increment: none;
}
[[%%content{0}%%/module]]
[[/module]]
[[/div]]

在前置的固定CSS代码部分，我们创建了一个名为listAuthor的CSS计数器，每当遇见一次div.listAuthor，这个计数器就会增加1。而在Listpages内部的div块默认带有listAuthor类，这也就代表着在没有其他修改的情况下，每统计到一篇文章就会将listAuthor这一计数器增加一次。

本段代码中出现的Listpages模块有一个与前述分数统计不同的地方：它拥有order="created_by"这一参数，这意味着所有被捕捉到的文章在这个模块中将按照页面创建者的名称顺序排列，也即每一位用户创建的所有页面将会彼此相邻。同时，n%%created_by_id%%被用来作为div块的另一个类：此处的%%created_by_id%%是页面创建者的数字ID，可以避免用户名中特殊符号（如空格）对代码的影响，这同样可以被%%created_by_unix%%（用户内部名）等效替换。

[[%%content{0}%%module css]]
div.n%%created_by_id%% + div.n%%created_by_id%% {
  counter-increment: none;
}
[[%%content{0}%%/module]]

在这段代码中，我们用到了在入门篇中提到过的，在Listpages模块中插入CSS修改的小技巧。这段CSS代码的作用是，如果前后相继的两个div块所属的文章由同一位用户创建，也即拥有同一个n%%created_by_id%%类名，那么靠后的那个div块将不会使计数器增加，下面的引用框中展示了这一算法的简单工作原理：

未添加CSS修改
user-A - listAuthor = 1
user-A - listAuthor = 2
user-B - listAuthor = 3
user-C - listAuthor = 4
user-C - listAuthor = 5
user-C - listAuthor = 6

添加CSS修改
user-A - listAuthor = 1
user-A - listAuthor = 1
user-B - listAuthor = 2
user-C - listAuthor = 3
user-C - listAuthor = 3
user-C - listAuthor = 3