【未解决】docbook中给callout的co重新编号

【问题】

docbook中，已经实现了callout的co，可以放在chapter的任意位置，然后可以在别处通过coref去引用，生成的pdf和html中，对应的callout的bug图标，也都可以正常显示了。但是目前由于所涉及条目较多，会超过20（甚至30），而由于目前callout 的编号所对应图片（svg和png），最大只有30，所以，此处希望对于callout超过20，就让其重新编号，使得后续的callout可以继续从1继续编号到20，这样就可以正常显示了。

当前的docbook源码为：

对应的html和pdf中生成的效果为：

希望第二个orderedlist中的co可以重新编号，从1开始，而不是从21开始。

【解决过程】

1.后来在

Part 2. FO Parameter Reference

和

Part 1. HTML Parameter Reference

中找到关于callout方面的参数：

callout.graphics.number.limit，但却发现，其知只能指定最大编号的限制，超过了编号，没法重新编号，只是会用文字版代替图片（plain text instead of a graphic）。

2.搜了半天，网上也找不到任何有关callout重新编号方面的内容。

看来只能自己试着看看能否通过修改xsl配置去实现了。

3.先是去看了fo中的代码，然后把对应的编号21改为1，变成：

然后生成的pdf的效果为：

就是我所想要的了，即编号可以从1开始，但是其中的图标，都还是可以点击的，可以调转到对应的位置的。

不过对于如何去修改xsl配置以实现此目的，则还是暂时没有搞定。

3.目前所能想到的办法是，在想要重新编号的co中，添加对应的配置参数，比如

role="reindex"，然后再去xsl中处理此处的co编号，让其从此处开始往后重新编号。

所以，把代码改为：

然后去找到对应callout所在xsl：

docbook-xsl-ns-1.77.0\fo\callout.xsl

然后找到了对应的处理callout的位置，是：

<xsl:template name="callout-bug">

其中对于发现callout是image的话，就去显示对应的callout的图片：

对应的$filename是上面定义出来的：

而此处的图片的索引，即为$conum，其是此模板的参数：

且学习了XSLT <xsl:param> 元素后，得知此处通过select去设置了默认值为1。

而此处编号已经变为了21,了，所以传递进来的图片地址是xxx\21.svg。

因此，此时还是要想办法，如果让此处的传入进来的值是1，而不是21.

4.然后就找到了，是在同一文件中：

去调用callout-bug的，其中传递的参数是conum。

然后又去学习XSLT <xsl:number> 元素，得知就是此处去计算co的值的。

从1开始，一点点往下面增加，直到此处的21.

所以，此处就是要去判断，如果有role="reindex"的话，就重新设置conum为1.

5.经过一番折腾，通过如下代码：

可以实现和上述手动把21改为1的同样的效果，也是可以自动生成1.svg了。

但是问题是，后续的编号还是从22开始的，而不是所期望的从2开始的。

6.目前所能想到的逻辑是，对于callout的index计数来说，

要设计一个lastCoPos为（programlisting或全文的）最开始，然后接下来的每个callout的计数都是根据lastCoPos来确定的，每次加1，这样就可以实现在role="reindex"后自动重新编号了。

但是经过一番折腾，由于对于xsl的语法不是足够清楚，所以还是失败了，没能搞定。

7.目前暂时的结果是：

参考Using position to count nodes – sometimes enumeration starts at 0 instead of 1和

 Position of parent，写成的如下代码：

所得到的结果，只是全部都是2，reindex后的，全部都是1.

等待以后更加熟悉了xsl后，或许可以写出对应的配置，实现callout重新编号的功能。

另外，对于xsl:number的计数方面可供参考的资料，找到了一些：

Numbering

Position

转载请注明：在路上 » 【未解决】docbook中给callout的co重新编号