Hi, > - Because of my experience w/ Python3Patterns book, Can you please tell me more here? What implications does the book give?
> - To find what docstring needs work, look at the docs for things like: > System Message: ERROR/3 (web2py-sphinx/gluon/sql.py:docstring of gluon.sql, > line 6) > Unexpected indentation. I know. These are also saved in the sphinx log file in the doc directory. > Running the sphinx build from the MAIN makefile - then all directories are > as needed - seem to work. I'll go through the rest of the makefile - but > basically, the make command for htmldocs (which can go in the main Makefile) > will look somthing like: Yesterday, I run in the same problem, I guess. Therefore I wrote in docs?contrib.rst: #. built with custom make files for web2py => **Note: we could create a cross-platform python script for this!** #. unix-like: ``sh doc/make-doc_html.sh`` #. windows: ``doc\make-doc_html.bat`` Due to the special manner of the *web2py* import mechanism it requires that the doc is built from the *web2py* root directory. > also probably want the html output do be more directly under docs... but > these are details... No, I defined a output path specified by Massimo. He probably wants to put these in the same folder as the epydoc in the examples app. > I seem to get the warnings like you get from the wiki, so we must be in > sync at this point (though I wonder if the generated html is the same); We could check whether this is systematic and edit the files by a script. > I have not yet tried generating pdf version - but it would also be nice to > create a link to download the pdf (for web hosting). I did it once for another project. Wasn't too difficult. I give it lower priority. > Thanks for all your significant efforts. This is a great start! Welcome. I am happy to bring in my experience this Sphinx. Regards, Timmie --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py Web Framework" group. To post to this group, send email to web2py@googlegroups.com To unsubscribe from this group, send email to web2py+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/web2py?hl=en -~----------~----~----~----~------~----~------~--~---