代码之家 › 专栏 › 技术社区 › bhadra

如何使用重组文本编写标注?

asciidoc restructuredtext

bhadra · 技术社区 · 16 年前

Asciidoc 支架 callouts .如何使用 reStructuredText ?

1 回复 | 直到 16 年前

Martin Geisler 16 年前

似乎没有内置的等价物,但很容易制作出类似于asciidoc文档中给出的示例的东西:

.. topic:: MS-DOS directory listing

   ::

     10/17/97   9:04         <DIR>    bin
     10/16/97  14:11         <DIR>    DOS            <1>
     10/16/97  14:40         <DIR>    Program Files
     10/16/97  14:46         <DIR>    TEMP
     10/17/97   9:04         <DIR>    tmp
     10/16/97  14:37         <DIR>    WINNT
     10/16/97  14:25             119  AUTOEXEC.BAT   <2>
      2/13/94   6:21          54,619  COMMAND.COM    <2>
     10/16/97  14:25             115  CONFIG.SYS     <2>
     11/16/97  17:17      61,865,984  pagefile.sys
     2/13/94   6:21           9,349  WINA20.386      <3>

   1. This directory holds MS-DOS.
   2. System startup code for DOS.
   3. Some sort of Windows 3.1 hack.

唯一缺少的是标记上的突出显示。如果这些对您非常重要,您可以使用 parsed-literal 阻止:

.. topic:: MS-DOS directory listing

   .. parsed-literal::

      10/17/97   9:04         <DIR>    bin
      10/16/97  14:11         <DIR>    DOS            **<1>**
      10/16/97  14:40         <DIR>    Program Files
      10/16/97  14:46         <DIR>    TEMP
      10/17/97   9:04         <DIR>    tmp
      10/16/97  14:37         <DIR>    WINNT
      10/16/97  14:25             119  AUTOEXEC.BAT   **<2>**
       2/13/94   6:21          54,619  COMMAND.COM    **<2>**
      10/16/97  14:25             115  CONFIG.SYS     **<2>**
      11/16/97  17:17      61,865,984  pagefile.sys
      2/13/94   6:21           9,349  WINA20.386      **<3>**

   1. This directory holds MS-DOS.
   2. System startup code for DOS.
   3. Some sort of Windows 3.1 hack.

如果你有很多这样的冷酷无情,那么我建议你为他们制定一个自定义指令。

推荐文章

AZhao · 放入图像的语法。rst公司

7 年前

bluprince13 · 如何使用重组文本嵌入完整PDF?

7 年前

guettli · 如何确保自述。rst有效吗?

7 年前

Jared Wilber · 渲染内部标记文件的输出。rst文件

7 年前

Mad Physicist · 如何通过sphinx链接到Python 3文档中的typecontextmanager标签

7 年前

Ray Brian Agnew · Python ReST文档字符串中是否有类似C#'s“see cref”的内容?

8 年前

paugier · Math Latex宏用于在reStructuredText和Sphinx中进行替换

10 年前

mgilson · ..重新构造文本中的绘图指令

12 年前