Sphinxを使用してHTMLおよびPDFにレンダリングされるreSTドキュメントを作成しています。私のソースファイルはUTF-8であり、HTMLがUTF-8として表示されることを期待しています。
乗算記号を書くためのベストプラクティスは何ですか？
つまり、xではなく×です。
Unicode文字として挿入できることはわかっています。LaTeXを書いている場合は、を使用します\times。HTMLには。があり×ます。Sphinxですべてをレンダリングすると、単純なUnicodeは変換プロセスを適切に乗り切ることができますか？他のよりエキゾチックなフォーマットにレンダリングしても？
これがどこかで物事をつまずかせないことを再確認したいだけです。
Sphinxのドキュメントに答えが含まれていることがわかりました。私は十分に読んでいませんでした:
全角ダッシュや著作権記号などの特殊文字を reST に含める最も簡単な方法は、それらを Unicode 文字として直接記述することであるため、エンコーディングを指定する必要があります。Sphinx は、ソース ファイルがデフォルトで UTF-8 でエンコードされていることを前提としています。これは source_encoding 設定値で変更できます。
https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#source-encoding
編集: ここでフォローアップ:乗算記号は正常に機能しますが、他の多くの一見標準的な Unicode 記号 (以下、および以上) は、LaTeX (したがって PDF) で使用されるデフォルトのフォントから欠落しています。レンダリング。
@Paul McMillan の回答に追加するには、スフィンクスのドキュメントをラテックス pdf として公開しようとしている場合、conf.pyプリアンブルに含めることで不足している Unicode シンボルを回避できることがよくあります。
_PREAMBLE = r"""
\usepackage[utf8]{inputenc}
\DeclareUnicodeCharacter{00D7}{\times}
"""
latex_elements = {
'preamble': _PREAMBLE,
}
00D7Unicodeエンコーディングはどこにあり\times、ラテックスで置き換えたいものです。
キャラクターの Unicode エンコーディングは、fileformatのWeb サイトで確認できます。
最初にMathMLを使用します:math:`m \times p`