From: Jérôme C. <cJ-...@zo...> - 2013-08-25 20:12:04
|
Hi, I noticed that docutils does not have anything to deal with include paths when looking for external files, whether it be includes or figures, images. A lot of my personal use cases deals with generating data to be included in rst files, and using build tools with a separate build folder which I'd like to add to a list of search directories for the includes processing. See example in:: https://code.google.com/p/waf/source/browse/playground/rst/?r=45a85542c5e6d9ce0e275086392898f4f384cd37 The waf build tool is detecting that test1.rst and test2.rst need stuff to be generated from test.svg, so it generates them, and wisely puts them in the build folder. Then, rst2pdf is run, but fails to find a picture. Actually this particular example might be a rst2pdf issue, but suppose that I instead build a .rst file to be included or a chunk of source code, it would be the same thing. Is the proposal of adding search paths for external files sane ? If so, I can propose a patch. As of now, a path resolver hook to be called in parsers/rst/directives/* everywhere we use io.FileInput or read images / urlopen would be my approach. But I'm very open to suggestions regarding where we'd put the search code. Best regards, -- Jérôme |
From: Jérôme C. <cJ-...@zo...> - 2013-08-25 21:11:00
Attachments:
docutils-include-path.patch
|
Hi, Actually, here's a preliminary patch that deals with include, image, csv-table, and raw :file:. Comments welcome (I did no particular effort for the command-line option name, just copy/pasted code). Just tested with the examples updated at: https://code.google.com/p/waf/source/browse/playground/rst/?name=waf-1.8 At least my problem is solved! Regards, -- Jérôme |
From: Jérôme C. <cJ-...@zo...> - 2013-08-25 22:12:26
Attachments:
docutils-0.11-search-path.patch
|
On Sun, 25 Aug 2013 17:10:52 -0400 Jérôme Carretero <cJ-...@zo...> wrote: > Actually, here's a preliminary patch And here's the same thing minus useless whitespace and that dangling debug print(). -- Jérôme |