Como chamadas escrever usando reestruturado texto?

StackOverflow https://stackoverflow.com/questions/997428

  •  13-09-2019
  •  | 
  •  

Pergunta

AsciiDoc suportes chamadas . Como se pode escrever textos explicativos semelhantes usando reStructuredText ?

Foi útil?

Solução

Não parece ser um built-in equivalente, mas é fácil de fazer algo que se parece com o exemplo dado na documentação 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.

A única coisa que esta falta é os destaques sobre os marcadores. Se esses são muito importantes para você, você pode usar um bloco 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.

Se você tiver muito muitos desses textos explicativos, então eu sugiro fazer uma directiva personalizado para eles.

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top