我正在考虑将我的文档从Doxygen移到Sphinx,并为doxygenalias寻找一个替代方案。
table_row2{2}=<tr><td align= center>\1</td><td align= center>\2</td></tr>
或
limited_res{1}=The number of supported \1 depends on the specific platform. See the \ref appendixes section"
它可用于以下文档:
...
table_h2{ Resource Name, Value }
table_row2{ MAC Entries , 256}
table_row2{ Ingress Flow , \limited_res { Ingress Flow } }
...
我在Sphinx中发现的最接近的东西是替换,但是我很难让它工作,即使是对于下面这样的简单命令替换:
.. |H1| replace:: `*****************************************************`
My section
|H1|
H1要么不编译要么只打印“*…*”。
我不确定这是一个语法问题还是不能做到。我试图避免记住*/+/-/=中的哪个表示什么,并根据嵌套的级别来命名它。我这几天记性不太好:)
我可以考虑的另一个选择是编写如下扩展
this