github - 如何在 GitHub 上托管的 reStructuredText 文件中添加删除线？

Question

我正在将README.md文件转换为README.rst。原因是，我要为 PyPi 提供一个包。我被迫使用.rst。

我的转换几乎完成了，但我的降价文件中有一条删除线，例如：

~~This text is crossed out~~

它在 GitHub 上呈现为划掉。但我无法在 reStructuredText 中做到这一点。StackOverflow 上的一篇类似文章建议定义这样的罢工：

.. role:: strike
    :class: strike

并在 CSS 文件中使用类似的东西：

.strike {
  text-decoration: line-through;
}

并像这样做删除线：

:strike:`This text is crossed out`

但问题是我无法控制 GitHub 的 CSS 文件。

score 13 · Accepted Answer

您还可以使用替换来简化多次使用。将此标记放在文件中的某个位置：

.. |ss| raw:: html

   <strike>

.. |se| raw:: html

   </strike>

然后只需将要删除的文本括起来|ss|& |se|：

One, |ss| two |se|, three |ss| strikes |se| you're out!

将呈现为：

一，二，三击，你出局了！

只需确保在替换元素周围留有空间，以便正确解析它们。这里看起来有点尴尬，但这是一个人为的例子。

score 4 · Accepted Answer

不是那么干净的解决方案，但对我有用。

.. raw:: html

   <s>

This text is crossed out

.. raw:: html

   </s>

score 2 · Accepted Answer

现在这是不可能的，因为 Markdown 等价物是顶级GitHub Flavored Markdown 语法，而 RST 是文档特定的样式。在 GitHub 的存储库渲染中，目前不允许添加 CSS。

3 回答 3