2009-12-07 4 views
9

Я хочу использовать некоторые символы в реструктурированном тексте; как я могу это сделать? (Например, → в Markdown дает «→» символ, как это определено в list of standard HTML character entities - смотри также w3c reference)символы в реструктурированном тексте

Примечание: Я не хочу требовать математическую формулу поддержки, как зависимость.

ответ

9

У вас есть большое количество определенных символов через оператор «замещения».

Вы должны включить определения через .. include:: <isonum.txt> или что-то подобное.

Большинство из них имеют форму |larr| или |rarr|.

Они определены в каталоге установки docutils.parsers.rst.include. Существуют десятки файлов, которые определяют многочисленные символы Юникода.

+0

Хммм. Они выглядят действительно паршивыми по сравнению с символами Markdown. –

+1

"lousy"? Что это значит в этом контексте? Вы говорите, что '←' хуже, чем '| larr |' или вы говорите, что ваш шрифт браузера выглядит паршиво? –

+0

Я смотрю на этот '→' на этом сайте и сравнивая его с HTML-выходом Sphinx (используя RST) | rarr |. Оба являются HTML и используют один и тот же шрифт по умолчанию. Я не уверен, являются ли они одним и тем же символом юникода, у меня нет кодировщика символов. –

3

Это было мое впечатление, что первые поддерживали Unicode; можете ли вы просто ввести необработанный символ и позволить docutils обрабатывать кодировку HTML?

+0

Хм ... Думаю, я мог бы, но я предпочел бы придерживаться ASCII. –

1

Поскольку rST определенно поддерживает unicode (см. Редактор NoTex rST), вы можете просто ввести символ напрямую; в примере NoTex вы обнаружите что-то вроде этого:

|7Li+p → 2·4He| replace:: :sup:`7`\ Li + p → 2 :sup:`4`\ He 

Вы видите стрелку в правой на стороне замещения? Надеюсь, это ответит на ваш вопрос.

2

Я думаю, что вы искали это: http://docutils.sourceforge.net/docs/ref/rst/roles.html#raw

Вы можете определить следующую роль:

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

И тогда вы можете написать:

This way :raw-html:`&rarr;` 

, который делает так:

Этот способ →

+0

спасибо, но только работает с HTML; В реструктурированном тексте есть разные бэкэнды, кроме HTML. –

Смежные вопросы