保留Sphinx Makefile代码块中的选项卡

问题描述 投票:1回答:1

我将Sphinx与reStructuredText输入和HTML输出配合使用,以记录基础结构的不同部分。这个想法是,阅读文档的用户可以复制示例并将其粘贴到她的文件中。 Makefile示例如何完成? Makefile在某些位置需要使用制表符,但Sphinx会将制表符转换为空格。

示例:command行必须以最终HTML中的标签开头。这里用缩进和制表符的三个空格编写:

.. code-block:: Makefile

   target: dependency
    command -i $< -o $@

[code-block没有控制选项卡扩展的选项。

使用sphinx代码块makefile选项卡进行网络搜索,可以在包含的代码中扩展选项卡(我更喜欢将其内联)或如何编辑Sphinx Makefile,但是没有什么可以解决我的问题的答案。

我将Sphinx与reStructuredText输入和HTML输出配合使用,以记录基础结构的不同部分。这个想法是,阅读文档的用户可以复制示例并将其粘贴到...

python-sphinx restructuredtext
1个回答
0
投票

Tab扩展发生在解析RST的早期,因此您必须自定义解析器本身才能将其禁用。我希望这能奏效。

© www.soinside.com 2019 - 2024. All rights reserved.