3

reStructuredTextはオプションリストをうまくサポートしています。たとえば、rst2html.pyこのRSTマークアップを変換します

Options:
    --foo                 does a foo
    -b, --bar ABAR        bar something

次の適切にフォーマットされたHTMLテーブルに：

<dt>Options:</dt>
<dd><table class="first last docutils option-list" frame="void" rules="none">
<col class="option" />
<col class="description" />
<tbody valign="top">
<tr><td class="option-group">
<kbd><span class="option">--foo</span></kbd></td>
<td>does a foo</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-b</span>, <span class="option">--bar <var>ABAR</var></span></kbd></td>
<td>bar something</td></tr>
</tbody>
</table>
</dd>

ただし、これは位置的な議論に自然に拡張されるようには見えません。例えば

Arguments:
    foo                   does a foo
    bar ABAR              bar something

テーブル構造を完全に欠いているHTMLとしてレンダリングします。

<dt>Arguments:</dt>
<dd>foo                   does a foo
bar ABAR              bar something</dd>

ダッシュやスラッシュが前に付いていないコマンドライン引数のオプションリストテーブルを作成する方法はありますか？

4

1 に答える 1

3

うん。オプションリストのかなり限定された構文は、ここではあまり文書化されていません：http: //docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#option-lists

これが本当に苛立たしいことです。一連のオプションを作成していて、それらのいくつかは前のリンクの「オプション」の構文に適合しているが、適合していないものもあるとします。たとえば、--opt==keywordそうです（そして、「キーワード」は必要かどうかに関係なくイタリック体になります）が、そうで--pot=BLACK|KETTLEはありません。Docutilsは、構文に適合するすべてのものを優れたオプションリスト<table>テンプレートに配置しますが、そうでない場合は、テーブル形式から外れ、標準の<dl>としてコーディングします。したがって、オプションのスタックの真ん中には、他のオプションとは異なるカップルがあります。

于 2013-02-28T03:05:33.947 に答える