Как мне написать знак умножения в reStructuredText (reST)? - PullRequest
Новая
       15

Как мне написать знак умножения в reStructuredText (reST)?

2 голосов
/ 16 июня 2011

Я пишу документы reST, которые будут отображаться в HTML и PDF с использованием Sphinx. Мои исходные файлы имеют формат UTF-8 и ожидают, что мой HTML будет отображаться как UTF-8.

Как лучше всего писать знак умножения?

То есть: ×, а не х.

Я знаю, что могу вставить его как символ Юникода. Если бы я писал LaTeX, я бы использовал \times. В HTML есть ×. Собирается ли простой Unicode правильно пережить процесс конвертации, когда я рендерину все с помощью Sphinx? Даже если я отдам в более экзотические форматы?

Я просто хочу перепроверить, что это никуда не денется.

Ответы [ 4 ]

3 голосов
/ 16 июня 2011

Оказывается, в документации по Сфинксу есть ответ, я просто недостаточно читал:

Так как самый простой способ включить специальные символы, такие как их тире или авторские права в REST напрямую запишите их как символы Unicode, один должен указать кодировку. сфинкс предполагает, что исходные файлы должны быть закодированы в UTF-8 по умолчанию; Вы можете изменить это со значением конфигурации source_encoding.

http://sphinx.pocoo.org/rest.html#source-encoding

Edit: Просто для продолжения: хотя знак умножения работает просто отлично, многие другие, казалось бы, стандартные символы Юникода (меньше или равны и больше или равны) отсутствуют в шрифте по умолчанию, используемом при рендеринге LaTeX (и, следовательно, PDF).

2 голосов
/ 10 апреля 2015

Чтобы добавить к ответу @Paul McMillan, если вы пытаетесь опубликовать документацию по sphinx в виде латексного pdf, вы часто можете обойти пропущенные символы юникода, включив в преамбулу conf.py: 

_PREAMBLE = r"""
\usepackage[utf8]{inputenc}
\DeclareUnicodeCharacter{00D7}{\times}
"""

latex_elements = {
    'preamble': _PREAMBLE,
}

Где 00D7 - это кодировка Unicode, а \times - это то, что вы хотите заменить в латексе.

Вы можете найти кодировку Unicode для вашего символа в формате файла веб-сайт.

Дополнительная информация здесь и здесь .

2 голосов
/ 09 января 2013

Я бы использовал MathML в течение первого :math:`m \times p`

0 голосов
/ 05 октября 2017

Что не так с |times| после использования .. include:: <isonum.txt>?

С http://docutils.sourceforge.net/0.6/docutils/parsers/rst/include/isonum.txt: 

.. |sup2|   unicode:: U+000B2 .. SUPERSCRIPT TWO
.. |sup3|   unicode:: U+000B3 .. SUPERSCRIPT THREE
.. |times|  unicode:: U+000D7 .. MULTIPLICATION SIGN
.. |trade|  unicode:: U+02122 .. TRADE MARK SIGN
.. |uarr|   unicode:: U+02191 .. UPWARDS ARROW
...