I'm totally happy with this great extension. I highly encourage you to
publish it on the list. The module could need a little bit adaption to be
even more user-friendly. But now that I know how it works, I would say it's
rather easy to use.
A hint about something that I needed to figure out again, but you also
mentioned it: I needed to make sure that I'm in the directory where I store
the make file when I execute sphinx-build from the linux shell with the
extension. That is not the case when I execute Sphinx normally - I edited
the autoextract.py so that it throws a reminder for me:
...
source_paths = self.env.app.config['autoextract_source_paths']
if not os.path.exists(source_paths[0]):
raise self.error("The first given source path does not exist.
Are you sure that you are in the directory where you usually call make?")
...
Well, this is my first trip to python in fact, so it's not great
programming. Don't know about a proper way to adress this problem.
Anyway:
Love it. It works like a charm for me now.
Hvala puno.
2011/5/2 Juraj Ivančić <juraj.ivan...@gmail.com>
> On 2.5.2011 14:55, Enyavar Nathis wrote:
>
>>
>> Can you send me your autoextract module, or upload it to the sphinx-group,
>> preferably with some description how to use it? Im not a pro in C or Python
>> myself.
>>
>
> I will upload it as soon as I can. Meanwhile here is my current version.
> The usage is basically as described
> in my post.
>
> You need to put the autoextract.py module where it can be found by Sphinx.
> You can either put it
> in sphinx/ext or preferably in a separate directory which is added on
> sphinx search path in conf.py.
>
> You should then define source paths for the autoextract module. Add a new
> configuration option called
> autoextract_source_paths to the conf.py:
>
> autoextract_source_paths = [ 'Sources1', 'Sources2', 'Sources3' ]
>
> Where Sources1, Sources2, Source3 are directories which contain sources.
> They can be absolute or relative
> to the documentation directory (from where you usually call make).
>
> That should be it - now you can add
>
> .. autoextract:: fileName.txt tag
>
> and autoextract will search for Sources1/fileName.txt
> Sources2/fileName.txt, Sources3/fileName.txt and try
> to locate a autoextract::begin/end block named 'tag'.
>
> If you run into any problems please let me know.
>
> Best regards,
> Juraj Ivančić
>
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en.
