On Fri, May 6, 2011 at 11:56 AM, Stéphane Ducasse <[email protected] > wrote:
> Ok if some good souls want to give a try to generate html. > > On OSX with MacTex-2010 installed, I've tried git clone --depth 1 https://github.com/SquareBracketAssociates/PharoByExample-english.git cd PharoByExample-english/ htlatex PBE1.tex "html,2" Then open PBE1.html , one page per chapter. See http://www.tug.org/applications/tex4ht/mn-commands.html Laurent. > Stef > > > > > Probably we should find a way to generate HTML from PDF or Latex. > > Any ideas? > > > > I've used latex2html several years ago. > > > > +1 for html > > > > Laurent. > > > > > > > > >>>> Now for the documentation when did you send an help documentation > for any part of the system? > > >>>> Or a bug fix? > > >>>> I find quite funny that people always talk but few are doing. We > welcome comments/examples help. > > >>> No need to get into a cat-fight here :) > > >> > > >> No this is not my point. But what do people really do to help? > > >> > > >>> I do agree with Stefan, as well as with you that we could help; but > I'm unaware of a good documentation effort outside of the image to start > with. Camillo's website project might be the best effort I've seen until > now; but then I didn't really look either. Maybe I missed some great > website? > > >> > > >> If this is just to spit out class comment on html I do not call that a > documentation. > > >> Now we can take the book contents and generate html > > >> We have 350 pages in the first book and the same in the second one. > > >> People are free to join and write one or two chapters. > > > > > > Stéphane, > > > > > > Of course you are right: wining/complaining doesn't help, only action > does. We need more people like Laurent focusing on documentation. > > > > > > I for one think that the well written, high quality books that exist > (PBE, Seaside Book) are *very valuable*, much better than confusing wiki > site (although these have their place as well). > > > > > > But the other point is: in most other popular languages, what current, > young developers do, when they get an error that they don't understand is > copy/paste the literal text in Google and in a surprisingly large number of > cases you find some real answers in the first page. > > > > > > This is also related to popularity of course. > > > > > > Sven > > > > > > > > >
