如何使用重构文本编写标注？

Question

Asciidoc支持callouts。如何使用reStructuredText编写类似的标注？

Answer 1

似乎有不被内置相当，但很容易使一些看起来类似于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. 

你应该有很多，这些标注的，那么我建议让他们自定义的指令。