Как сделать зачеркивание в файле reStructuredText, размещенном на GitHub?

Я конвертирую файл 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`

Но проблема в том, что я не могу контролировать файл CSS GitHub.


github strikethrough restructuredtext
person Santosh Kumar    schedule 13.04.2013    source источник

Ответы (3)


arrow_upward
13
arrow_downward

Вы также можете использовать замены, чтобы упростить многократное использование. Поместите эту разметку где-нибудь в свой файл:

.. |ss| raw:: html

   <strike>

.. |se| raw:: html

   </strike>

Затем просто заключите текст, который нужно вычеркнуть, с помощью |ss| и |se|:

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

будет отображаться как:

Раз, два, три страйка ты выбыл!

Просто убедитесь, что вокруг элементов подстановки есть место, чтобы они правильно анализировались. Здесь это выглядит немного неуклюже, но это надуманный пример.

person Hal W    schedule 30.08.2017

arrow_upward
4
arrow_downward

Не очень чистое решение, но работает для меня.

.. raw:: html

   <s>

This text is crossed out

.. raw:: html

   </s>
person Praveen Kumar    schedule 15.03.2015
comment
Используя статический блоггер Nikola, мне пришлось заменить <s> на <s>This text is crossed out.</s> и пропустить последнюю директиву .. raw:: html. Затем зачеркнутый текст был визуализирован в выходных данных Nikola. Спасибо за предложение! - person dmmfll; 12.06.2016

arrow_upward
2
arrow_downward

Сейчас это невозможно, так как эквивалент Markdown — это синтаксис GitHub Flavored Markdown верхнего уровня, тогда как в RST это стиль документа. При рендеринге репозитория GitHub в настоящее время не разрешены добавления CSS.

person Matthew McCullough    schedule 25.08.2013
comment
Как Правин Кумар рабочее решение, это осуществимо на самом деле... для определенного (хотя и распространенного) выходного формата HTML. Хотя стандарт reST не обеспечивает явной поддержки зачеркивания, он обеспечивает явную поддержку встраивания необработанных HTML-тегов, включая тег <s>...</s> зачеркивания. Естественно, это не работает для выходных данных, отличных от HTML (например, PDF). Когда жизнь преподносит вам лимоны, вы взламываете HTML. - person Cecil Curry; 03.01.2017