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

Hilaire Fernandes hilaire.fernandes at gmail.com
Sun May 8 12:27:50 CEST 2011


Ah right, htlatex seems to be doing just fine. Lot of warning but it get
through the all file.

Hilaire

Le 06/05/2011 18:51, laurent laffont a écrit :
> 
> On Fri, May 6, 2011 at 5:30 PM, Stéphane Ducasse
> <stephane.ducasse at inria.fr
> <mailto: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
>     <mailto: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
>     > >
>     > >
>     > >
>     >
>     >
>     >
> 
> 
> 


-- 
Education 0.2 -- http://blog.ofset.org/hilaire




More information about the Pharo-project mailing list