用sphinx記錄XML

我有一個python項目，我正在記錄與獅身人面像。該項目讀入一個XML配置文件。記錄此配置文件的最佳方式是什麼？我能否以某種方式包含xml模式？或者有一個很好的級聯例子？我知道我可以直接輸入，但有沒有更好的方法讓它看起來非常漂亮，易於編寫/維護？用sphinx記錄XML

所有我所發現的是方式，包括在獅身人面像XML改變結構等

我正在尋找一種方式是高度集成和易於使用。

感謝：d

答案this question建議使用獅身人面像的literalinclude指令。

這將允許您使用標準XML註釋字符串包含XML文件的文字內容。該指令允許您指定可能影響最終呈現的內容的語言。

2014-01-24 01:52:15

是的，我看到了。這只是文本方法。我想象一個很好的可擴展的XML標籤......但我一直在尋找，我找不到其他東西：/但謝謝：D –

我認爲替代方案將是爲獅身人面像寫一個新的域名（http：// sphinx-doc.org/domains.html），它允許它以更原始的方式解析XML。 –

或者說，定義模式的DTD的域。 –

回答