Jonathan - RE: Sphinx: Not much to read up on (unless you have free time ;-).
Get the latest snapshot, get jinja2 - and be off and running (make a test document, make sure it works). http://bitbucket.org/birkenfeld/sphinx/overview/ (clone or download a zip) If you get that far, then go get Bruce Eckel's "Python 3 Patterns & Idioms" book project (in Sphinx) from bitbucket - http://bitbucket.org/BruceEckel/python-3-patterns-idioms/ It has pre-built html and pdf - with instructions on how to setup to contribute to that book.... That can be a starting point. I have the FAQ from massimo; we can start a Sphinx-book repository also. All that is needed then is to host that. Suggest you use makefile approach. Regards, Yarko On Sun, Mar 8, 2009 at 5:45 AM, Jonathan B <[email protected]> wrote: > > Hi Yarko and all, > > > Thanks for the feedback. > > If you agree, I think that we can get started now. The wiki located at > https://mdp.cti.depaul.edu/wiki is good enough as a starting point for > documenting web2py. We can get going on creating and publishing a > source code repository for the community manual. I'm going to start > reading up on Sphinx. > > Hopefully over the next few months we can get the Wiki transferred to > a more suitable location, preferably one either without HTTPS or with > a valid certificate. > > > On Mar 8, 12:03 pm, Yarko Tymciurak <[email protected]> wrote: > > > - we don't have Reddish (!) --- you (apparently) can't get your app > > source back from appspot, and Massimo did not put this under revision > > repository anywhere. When his disk drive died, the current Reddish > died > > with it. The beginnings of it are all that's on the appliances link; > > Wow, that really sucks. Unfortunately, it's true that on Google App > Engine you can't recover your source directly. And it doesn't look > like Google is planning on fixing this issue any time soon, either. On > the bright side, old versions are retained on GAE, so you should be > able to safely replace Reddish with other code (although make sure to > change the version number when you upload!!!!). Then if Google *does* > fix this issue in the future you can still (in theory) recover the > Reddish source. > > > > - which leads to the second problem: the appliances are not dated, > not > > versioned, many of them (?) archaic, e.g. not able to run under > current > > versions. > > I fully agree with you. And all of the appliances should be fully > documented as well. > > > > - This same problem is now w/ the wiki - that is, it's not archived in > a > > versioning system anywhere... if it's going to be used, it should be > visible > > / accessible. (I suspect there might be some class project / > assignment > > type of issues at play here...) > > Yes, I was hoping we could get the source code for the Wiki. > > > > This is up to Massimo & DePaul. We can host elsewhere too. > > I think Massimo has his hands full, and would probably be happier to see > us > > offload this... > > I would love to help with this, but I can't do anything "official" > since I don't have the keys to anything web2py. I don't have the Wiki > source code, and I can't affect what's on web2py.appspot.com or on > web2py.com. So right now my hands are tied. > > > > 8 years is a long time; but Ok - then forget moin-moin for the moment... > > I took another look at MoinMoin today, and the UI seems greatly > improved. However, most of the community seems to have its heart set > on a web2py-based Wiki... The current version of the Wiki doesn't > have a lot of features, but it seems to have enough for us all to get > started. > > > > Well - designing redditt is not the same as cloning it. For wiki's, we > > (in a major worldwide corp) use a commercial wiki (languishes) and an > open > > source one (really gets a lot of traction). Let's clone Twiki (from > design > > structure), and make the rendering reST (or optionally markdown). > > I agree that Twiki is an awesome example to emulate. We used TWiki > internally where I used to work. > > > --Jonathan > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py Web Framework" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/web2py?hl=en -~----------~----~----~----~------~----~------~--~---
