生成sphinx文档时如何将两个单词保留在同一行?例如,我希望
2
中的 sec
和 2 sec
之间没有换行符。例如,我想避免以下布局:
some text some text some text some text some text some text some text and then done in 2
sec
并获取以下内容:
some text some text some text some text some text some text some text and then done in
2 sec
在 LaTex 中,在这种情况下,可以使用
~
来实现这一点:2~sec
。
我发现无论输出格式如何(?),最好的方法是使用替换和Unicode。
编辑你的conf.py以引入全局替换:
rst_epilog = """
.. |nbh| unicode:: U+2011
:trim:
.. |nbsp| unicode:: U+00A0
:trim:
"""
然后在 RST 中使用作为替换(注意我需要写
|nbsp|
并周围有空格,否则替换将不会被拾取。
为我工作了 HTML 和 PDF。
参考资料:
结语: https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-rst_epilog
替补: https://www.sphinx-doc.org/en/master/usage/restructedtext/basics.html#substitutions
Unicode指令: https://docutils.sourceforge.io/docs/ref/rst/directives.html#unicode-character-codes
Unicode 字符: 不间断连字符:https://www.compart.com/en/unicode/U+2011