将 CSS Class 添加到 reStructuredText 内部引用

Question

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

我的问题是我无法转换: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 并按原样呈现它，但我无法链接 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

我不确定直接在链接中获取课程。但是您应该能够通过以下方式在父级中获取它：

.. cssclass:: btn-primary

  :ref:`link`

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

.btn-primary a