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

laurent laffont laurent.laffont at gmail.com
Sat May 14 11:51:55 EDT 2011


On Sat, May 14, 2011 at 3:56 PM, Mariano Martinez Peck <
marianopeck at gmail.com> wrote:

>
>
> On Sat, May 14, 2011 at 3:38 PM, laurent laffont <
> laurent.laffont at gmail.com> wrote:
>
>> Here's a first shot of PBE1 in html
>> http://lolgzs.free.fr/pharo/PBE1_html.zip.
>>
>> Extract and open PBE1.html.
>>
>>
> Cool. Thanks!
>
>
>> I had to fix manually several links and pictures. At least navigation
>> works even if not nice. CSS needs improvement but I suck at design / visual
>> :)
>>
>>
> Like every good programmer :)
>

Some good programmers are also good at graphics - indeed, I know some ;)



>
> I think this is cool Laurent. Even if the design is a little ugly, I think
> we can make it available:
>
> 1) Host it in http://pharobyexample.org/  and put a link to it
> 2) Put a link to it from pharo website.
>
> Then, we can improve it. And updating it will just be a matter of unzipping
> a new zip.
>


May be I should put it on github.


Who should be contact to do 1) and 2) ?
>
>

I can do 2)


Laurent



> thanks
>
>
>
>
>> Laurent Laffont - @lolgzs <http://twitter.com/#%21/lolgzs>
>>
>> Pharo Smalltalk Screencasts: http://www.pharocasts.com/
>> Blog: http://magaloma.blogspot.com/
>> Developer group: http://cara74.seasidehosting.st
>>
>>
>>
>> On Sun, May 8, 2011 at 2:18 PM, Stéphane Ducasse <
>> stephane.ducasse at inria.fr> wrote:
>>
>>> I could not generate all the html because apparently there is a problem.
>>> The table of contents was broken.
>>>
>>> Stef
>>> 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
>>> > >
>>> > >
>>> > >
>>> >
>>> >
>>> >
>>>
>>>
>>>
>>
>
>
> --
> Mariano
> http://marianopeck.wordpress.com
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pharo.org/pipermail/pharo-dev_lists.pharo.org/attachments/20110514/0f4e7f2f/attachment.html>


More information about the Pharo-dev mailing list