添加 CSS Class 到 reStructuredText 内部参考

Question

我想在我的文档中使用 CSS 类格式化内部 link - 用 :ref: 定义。

我的问题是我无法将 :ref:`Link <internal_link> 转换为 HTML <a href="internal_link" class="btn btn-primary btn-sm">Link</a>

的以下位

我试过定义一个新的 role 但也没有成功。

.. role:: ref
   :class: btn btn-sm btn-primary

:ref:`Link <internal_link>`

我目前的解决方案是使用原始 html 并按原样渲染它，但我不能 link RST 文件，而是必须指向 HTML 文件（这不'不适用于 PDF 输出）。

.. role:: raw-html(raw)
   :format: html

:raw-html:`<a href="internal_link.html" class="btn btn-primary btn-sm">Link</a>`

有谁知道如何将自定义 CSS 类添加到 :ref:？

Answer 1

我不确定是否可以直接在 link 中获取 class。但是您应该可以通过以下方式在父级中获取它：

.. cssclass:: btn-primary

  :ref:`link`

然后调整 css 选择器以使用：

.btn-primary a

Add CSS Class to reStructuredText internal reference