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

Mariano Martinez Peck marianopeck at gmail.com
Sat May 7 09:31:31 EDT 2011


On Fri, May 6, 2011 at 6:51 PM, laurent laffont
<laurent.laffont at gmail.com>wrote:

>
> 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 :)
>
>
Take into account that you have the CSS of the pbe website:
http://pharobyexample.org/
Ok, it is not that much heheheh but something is better than nothing ;)


> 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
>> > >
>> > >
>> > >
>> >
>> >
>> >
>>
>>
>>
>


-- 
Mariano
http://marianopeck.wordpress.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pharo.org/pipermail/pharo-dev_lists.pharo.org/attachments/20110507/734e2144/attachment.html>


More information about the Pharo-dev mailing list