将CSS类添加到reStructuredText内部引用

时间:2017-03-23 10:16:09

标签: css python-sphinx restructuredtext

我想在我的文档中使用CSS类格式化一个内部链接 - 用: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并将其渲染,但我不能链接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:

1 个答案:

答案 0 :(得分:4)

我不确定直接在链接中获取课程。但你应该能够通过以下方式获得它:

.. cssclass:: btn-primary

  :ref:`link`

然后调整css选择器使用:

.btn-primary a