genrst calls xsltproc to generate gui_flow.svg.

Unfortunately, Sphinx doesn't seem to recognize that gui_flow.xml will
turn into gui_flow.svg after graph.xsl's transformation (but perhaps
I'm just doing something wrong?).  We work around that by running the
transformation and linking hacking.txt to the generated svg file
instead of the source xml.  Of course, this adds an additional build
dependency (xsltproc), but xslt processors should be common enough
that that's not a big deal.

The change was made in the scons cache file doc/.sconsrc-sphinx.
I also added the generated file (doc/img/gui_flow/gui_flow.svg) to
.hgignore.

diff --git a/.hgignore b/.hgignore
index fa29da787481b7046542338eebdb72082f3d4cbf..fe04478c2836b99ef6b7d77597ca36beb2bec27b 100644 (file)
--- a/.hgignore
+++ b/.hgignore
@@ -7,4 +7,5 @@ build/
 
 .hooke.cfg
 doc/.sconsign.dblite
+doc/img/gui_flow/gui_flow.svg
 hooke/license.py

diff --git a/doc/.sconsrc-sphinx b/doc/.sconsrc-sphinx
index bb1926a9f909788fe33528007bfeff67805bc2e8..9086db55ae04a59201c770182b0195852f04090f 100644 (file)
--- a/doc/.sconsrc-sphinx
+++ b/doc/.sconsrc-sphinx
@@ -1 +1 @@
-genrst = 'python generate-hooke-txt.py'
+genrst = 'python generate-hooke-txt.py && xsltproc img/gui_flow/graph.xsl img/gui_flow/gui_flow.xml > img/gui_flow/gui_flow.svg'