Как написать выноски, используя реструктурированный текст? - PullRequest
Новая
       8

Как написать выноски, используя реструктурированный текст?

1 голос
/ 15 июня 2009

Asciidoc поддерживает выноски . Как можно написать похожие выноски, используя reStructuredText ?

1 Ответ

4 голосов
/ 28 июня 2009

Кажется, нет встроенного эквивалента, но легко сделать что-то похожее на пример, приведенный в документации 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.

Если у вас очень много таких выносок, тогда я предлагаю сделать для них специальную директиву.

...