Clojure的狮身人面像域
|
我曾经使用Sphinx进行C ++和Python项目。我刚刚在Clojure中启动了一个项目,我想重用我的Sphinx / reStructuredText技能来记录我的Clojure代码。由于Clojure没有内置域,因此我开始编写一个域。
具有讽刺意味的是,Sphinx的文档对于编写扩展完全没有帮助。因此,从Python和Javascript的内置模式开始,我有了一些基本的要素。我可以使用以下指令编写函数文档:
.. clj:ns:: clojure.core
.. clj:fn:: (filter f coll)
:param f: predicate
:param coll: collection
Built-in!
但是,HTML输出会生成C / Python样式的签名。前面的示例生成如下内容:
filter(f, coll)
Parameters: * f - predicate
* coll - collection
Built-in!
我宁愿以轻快的形式获得签名,如下所示:
(filter f coll)
Parameters: * f - predicate
* coll - collection
Built-in!
生成签名的代码似乎一直到“ 3”模块。如何使Sphinx使用Sphinx语法生成HTML?可以使用模板完成此操作,还是需要遍历整个构建器系统才能做到这一点?
没有找到相关结果
已邀请:
1 个回复
琶竞捆栓
)中扩展
类。但是,此级别没有特定于域的处理,Clojure签名的更改也会影响其他域上的签名。