在reStructuredText中分配自定义ID

如何解决在reStructuredText中分配自定义ID

我想为reStructuredText中的自动生成的div分配一个自定义ID。

因此，给出了以下reStructuredText代码段：

The mobile application
----------------------

HTML结果如下：

<div class="section" id="the-mobile-application">
    <h1 class="title">The mobile application</h1>
</div>

但是我想指定另一个这样的自定义ID：

<div class="section" id="my-custom-id">
    <h1 class="title">The mobile application</h1>
</div>

我该怎么做？

---

编辑：

Steve Piercy建议该页面可以回答我的问题：Adding a cross-reference to a subheading or anchor in another page。

不幸的是事实并非如此。本页提及此处记录的参考方法：Cross-referencing arbitrary locations。

建议的解决方案如下：

.. _my-custom-id:

The mobile application
----------------------

此解决方案生成具有所需ID的空<span>元素。

<div class="section" id="the-mobile-application">
    <span id="my-custom-id"></span>
    <h1>The mobile application</h1>
</div>

这似乎可以完成工作，但实际上只完成了我需要的一半。它可用于HTML，但不适用于PDF。 浏览器在单击带有href="#id="the-mobile-application"的链接时可以找到此ID，但是不幸的是，PDF阅读器并不总是能够做到这一点。我也不明白为什么它在PDF中会间歇性地工作。

有关信息，我的工作流程如下：

• rst→html（带有docutils）
• html→pdf（带有Weaysprint或PrinceXML）