2014-06-11 81 views

回答

0

我已經結束了graphviz。爲了保持它的簡單(沒有sphinx),我創建了一個編譯點到SVG一個Makefile:

figures/main_components.dot 
main.rst 
Makefile 

的Makefile:

generate_figures: 
    for f in $$(find . -iname *.dot); do \ 
     f_dir=$$(dirname $$f); \ 
     f_name=$$(basename $$f); \ 
     f_name="$${f_name%.*}";\ 
     dot -Tsvg $$f -o $$f_dir/$$f_name.svg; \ 
    done; 

在main.rst,我使用SVG-S。

.. figure:: figures/main_components.svg 
    :scale: 50% 
2

沒有什麼內置reStructuredText可以實現這一點。就個人而言,我只是將你需要的圖像作爲圖像加入。 ReStructuredText被設計爲人類可讀的,並且在reStructuredText文檔中包含一些額外的特定於圖形的標記語言(在我看來)有些不利於此。我將保留將圖形繪製在與reStructuredText文件相同的目錄中的單獨文件中所需的標記,並讓腳本自動生成圖像,然後將其包含在文檔中。

但是,reStructuredText當然是可擴展的,因此您可以編寫自己的繪製圖表自定義指令,類似於siafoo.net。請注意,我從來沒有使用過它,它看起來像是一個開始的好地方。