John - For me, I just use an editor (vim); it's easy enough for contributions (the "cheatsheet" for all I use is only 2 pages, so that's good enough for me)
For writing the entire thing, I'm looking (once again) at Leo, an outlining editor which will generate the RST from it's outline structure (with RST headers, etc. per section), and you can build sphinx sources from that. Not much experience with that yet, as Leo in this direction is pretty new to Leo (also, I don't like that the sources created are named a quite goofy "xxx.html.txt") Yarko. On Sun, Jul 19, 2009 at 6:19 PM, JohnMc <[email protected]> wrote: > > Yarko, > > A directed question if I may. What tools do you use to create the rest > doc that goes into Sphinx. > > JohnMc > > On Jul 19, 4:55 pm, Yarko Tymciurak <[email protected]> wrote: > > John - > > > > Play along (you are not the only player, of course)... > > > > Collaboration would mean some sort of harmonization; > > > > Massimo "had trouble" w/ sphinx (not sure what he tried) - it's reST with > > extensions (and reST is a tad less "regular" than some other markups, so > > attempts at treating it the same way for wikis failed to hit the sweet > spot, > > but there are examples - in Pycon-tech, and moin-moin for example). > > > > The "only 2 people" Massimo pointed out isnt' - they are the only 2 he > saw > > give him stuff, and he made assumptions based on that. > > > > An open-source book, Python 3 Patterns and Idioms ( > http://www.mindviewinc.com/Books/Python3Patterns/Index.php) also uses > Sphinx > > (and also has been frustrated w/ lack of submissions, but this is I > believe > > more to do with the lack of an interactive, live version for sphinx than > > anything). > > > > "Anything goes" sounds good initially - but results are the proof; it > can > > generate relief (no one likes change, so learning something new, or > rather > > not needing to is generally received with "appreciation")... > > > > As Massimo will attest, as long as it's a one man show - one contributor, > > one decision, then "what I want" works pretty well. > > > > Massimo writes in LaTex - shall we write a latex source, and post a PDF? > > > > As long as opionions abound, there will be "I think I'll try".... time > and > > actual results are the only real measure. > > > > I'm in the Sphinx camp (with a little off on LaTex, and definitely a > Scribus > > fan, as I build and bug report on the release candidates ... but would > not > > necessarily use either of those for this; LaTex / beemer is what I'm > trying > > for the time being for presentations; Scribus for brochures and manuals). > > > > While everyone will find it easy to use what they are comfortable with, I > > still challenge people to ask "what are we trying to serve? How will we > > deliver? What will be best for this?" --- that discussion (along with > some > > Prototyping that goes far enough) is what I would like to encourage. > > > > The "whatever" approach is just.... easy. (Not much more than a "don't > rock > > anyone's boat" approach, and not necessarily very effective in the mid- > to > > long run). > > > > Regards, > > - Yarko > > > > On Sun, Jul 19, 2009 at 8:39 AM, JohnMc <[email protected]> > wrote: > > > > > Yarko, I'll play it by ear initially till we see what the volume will > > > be. If Sphinx markup can be manipulated in a reasonable fashion we > > > can explore that route. If the volume warrants some level of > > > automation I don't see why a article submission system could not be > > > developed with Web2Py. In the same vein an entire search, index and > > > publish system could be implemented for the reader that could > > > incorporate web, PDF, slides and videos. > > > > > JohnMc > > > > > On Jul 18, 9:54 pm, Yarko Tymciurak <[email protected]> wrote: > > > > On Sat, Jul 18, 2009 at 9:41 PM, gluegl <[email protected]> wrote: > > > > > > > I personally favor SlideShare, ScribD, DocStoc, Vimeo, Truveo/ > > > > > YouTube... > > > > > However every is encourage to contribute in whatever manner they > feel > > > > > they can do the best job at it. > > > > > At least something positive is being done, which a great step in > the > > > > > right direction. > > > > > > That's nice..... > > > > > > My sepcific question was about your choice of Scribus - and if you > chose > > > > "printed" document generation (Scribus's forte), and if you > considered > > > > Sphinx (which generates online, static, searchable document as an > > > option). > > > > > > -Y > > > > > > > -G > > > > > > > On Jul 18, 5:43 pm, Yarko Tymciurak <[email protected]> wrote: > > > > > > Scribus (starting w/ 1.3.5 I think) also has rendered frames, > e.g. > > > > > > LaTex.... > > > > > > > > Any reason you did not consider Sphinx? That gives indexs, > > > > > searchability, > > > > > > both web and pdf presentation.... > > > > > > > > On Sat, Jul 18, 2009 at 4:36 PM, JohnMc < > [email protected]> > > > > > wrote: > > > > > > > > > Yarko, > > > > > > > > > Well I have drafted my article using OOffice and am preparing > to > > > > > > > publish in Scribus. Text/graphics format. I can embed a link to > > > video. > > > > > > > I don't know if I can embed video in a Scribus document but I > will > > > > > > > find out. Being the 'test subject' I fully expect a bunch of > > > feedback. > > > > > > > > > If the format is acceptable I would be willing to act as > > > 'publisher' > > > > > > > so long as an agreed upon submission format can be adhered to. > I > > > would > > > > > > > want it make it as drop-in and publish as possible. > > > > > > > > > JohnMc > > > > > > > > > On Jul 18, 2:18 pm, Yarko Tymciurak <[email protected]> wrote: > > > > > > > > many questions I have before getting to "where"... > > > > > > > > > > What form? Tutorials of what sort? Videos? Text? Interactive > w/ > > > > > > > excercises? > > > > > > > > > > On Sat, Jul 18, 2009 at 2:12 PM, gluegl <[email protected] > > > > > wrote: > > > > > > > > > > > Will follow Massimo and the members of this group advice... > > > > > > > > > Where do you suggest? > > > > > > > > > -G > > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "web2py-users" 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 -~----------~----~----~----~------~----~------~--~---
