Hi Robert,
There is an initial sphinx-based documentation at [1]. It seems like the html pages are being served, but the js/css is not working? Do you see that as well? It's strange because it works locally on my machine. So I need to figure out what's going on there. Does anyone know what the problem could be?
Also, you can pull the source from my github repository at [2]. Basically, I just added a few files in the doc directory using "sphinx-quickstart" and then hand-edited them as needed. Then, with sphinx installed, I can just run "make html" in the doc directory to build the documentation in doc/_build/html, which I copied into the gh-pages branch of the repository (following the instructions on github). So that part is quite simple. :)
So far, I've just added one class to the documentation as an example. The documentation process is (at least from what I read on the sphinx docs) semi-automatic in that the docstrings get pulled in after writing an rst file telling sphinx which docstrings to pulll. But I think that's better since it gives more control. I can try generating the documentation for the rest of the code as an exercise in familiarizing myself with the code base. But I have an exam on Thursday, so I probably can't get to it until after then. :)
On Tue, Oct 13, 2009 at 5:18 AM, Robert Cimrman <cimr...@ntc.zcu.cz> wrote:
Great! This would really help a lot, thank you.
cheers, r.
PS: This time-lagged discussion is rather slow, I have to get up early one day, or stay till night at work :)
Glad to help out where I can! Hope to catch you online sometime, but don't adjust your schedule on my account :)
Best, Logan
[1] http://logansorenson.github.com/sfepy_doc2/ [2] git://github.com/logansorenson/sfepy_doc2.git