[Pharo-project] PBE in HTML [was: Popularity of Smalltalk in Software Industry]

laurent laffont laurent.laffont at gmail.com
Fri May 6 12:51:08 EDT 2011


On Fri, May 6, 2011 at 5:30 PM, Stéphane Ducasse
<stephane.ducasse at inria.fr>wrote:

> I installed pdf to html but I could not make it run :(


htlatex seems OK, we can start with this. Need to supply a nice CSS though.
I will try to find some time to play with (help always welcome :)

Laurent.



> On May 6, 2011, at 2:05 PM, laurent laffont wrote:
>
> > On Fri, May 6, 2011 at 11:56 AM, Stéphane Ducasse <
> stephane.ducasse at inria.fr> 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
> > >
> > >
> > >
> >
> >
> >
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pharo.org/pipermail/pharo-dev_lists.pharo.org/attachments/20110506/23e509ee/attachment.html>


More information about the Pharo-dev mailing list