Re: [Pharo-project] PBE in HTML [was: Popularity of Smalltalk in Software Industry]
On Fri, May 6, 2011 at 11:56 AM, Stéphane Ducasse <stephane.ducasse@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
I installed pdf to html but I could not make it run :( 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@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
On Fri, May 6, 2011 at 5:30 PM, Stéphane Ducasse <stephane.ducasse@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@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
this would be gorgeous. I like your doing spirit laurent! Stef On May 6, 2011, at 6:51 PM, laurent laffont wrote:
On Fri, May 6, 2011 at 5:30 PM, Stéphane Ducasse <stephane.ducasse@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@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
On Sat, May 7, 2011 at 9:23 AM, Stéphane Ducasse <stephane.ducasse@inria.fr>wrote:
this would be gorgeous. I like your doing spirit laurent!
oh, it's the first thing I've learned in Pharo. Right-click, do it :) Laurent
Stef
On May 6, 2011, at 6:51 PM, laurent laffont wrote:
On Fri, May 6, 2011 at 5:30 PM, Stéphane Ducasse <
stephane.ducasse@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@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
On Fri, May 6, 2011 at 6:51 PM, laurent laffont <laurent.laffont@gmail.com>wrote:
On Fri, May 6, 2011 at 5:30 PM, Stéphane Ducasse < stephane.ducasse@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@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
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@inria.fr <mailto:stephane.ducasse@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@inria.fr <mailto:stephane.ducasse@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
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@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
Here's a first shot of PBE1 in html http://lolgzs.free.fr/pharo/PBE1_html.zip. Extract and open PBE1.html. 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 :) Laurent Laffont - @lolgzs <http://twitter.com/#!/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@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@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
Thanks a lot for your effort. It looks good to me. May be we could put it on the gforge. Stef
Here's a first shot of PBE1 in html http://lolgzs.free.fr/pharo/PBE1_html.zip.
Extract and open PBE1.html.
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 :)
Laurent Laffont - @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@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@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
On Sat, May 14, 2011 at 3:38 PM, laurent laffont <laurent.laffont@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 :) 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. Who should be contact to do 1) and 2) ? 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@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@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
On Sat, May 14, 2011 at 3:56 PM, Mariano Martinez Peck < marianopeck@gmail.com> wrote:
On Sat, May 14, 2011 at 3:38 PM, laurent laffont < laurent.laffont@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@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@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
I hosted it on the gforge. Now we can also put it in github. I would prefer to not maintain several versions. Laurent how many links did you have to fix? Stef
On Sat, May 14, 2011 at 9:39 PM, Stéphane Ducasse <stephane.ducasse@inria.fr
wrote:
I hosted it on the gforge. Now we can also put it in github. I would prefer to not maintain several versions. Laurent how many links did you have to fix?
- htlatex output dir doesn't work, so I had to move manually *html and *png to a build dir (indeed, I wrote a bash script for that). - I've resized the pharo.png icon and create the creative commons one from the .pdf - PBE1.html: there was some mess at the end of the table of content, I've removed it - add a max-width for figures in the css - next link was missing in almost all chapters, previous link wrong in 4 or 5 chapters. Ideally we should have a script which do all this stuff so we can always generate from the last version. This is possible, I may look at it for PBE2 :) Laurent.
Stef
On May 14, 2011, at 9:58 PM, laurent laffont wrote:
On Sat, May 14, 2011 at 9:39 PM, Stéphane Ducasse <stephane.ducasse@inria.fr> wrote: I hosted it on the gforge. Now we can also put it in github. I would prefer to not maintain several versions. Laurent how many links did you have to fix?
- htlatex output dir doesn't work, so I had to move manually *html and *png to a build dir (indeed, I wrote a bash script for that). - I've resized the pharo.png icon and create the creative commons one from the .pdf - PBE1.html: there was some mess at the end of the table of content, I've removed it - add a max-width for figures in the css - next link was missing in almost all chapters, previous link wrong in 4 or 5 chapters.
argh!
Ideally we should have a script which do all this stuff so we can always generate from the last version. This is possible, I may look at it for PBE2 :)
Thanks!
Laurent.
Stef
On Sat, May 14, 2011 at 10:33 PM, Stéphane Ducasse < stephane.ducasse@inria.fr> wrote:
On May 14, 2011, at 9:58 PM, laurent laffont wrote:
On Sat, May 14, 2011 at 9:39 PM, Stéphane Ducasse < stephane.ducasse@inria.fr> wrote: I hosted it on the gforge. Now we can also put it in github. I would prefer to not maintain several versions. Laurent how many links did you have to fix?
- htlatex output dir doesn't work, so I had to move manually *html and *png to a build dir (indeed, I wrote a bash script for that). - I've resized the pharo.png icon and create the creative commons one from the .pdf - PBE1.html: there was some mess at the end of the table of content, I've removed it - add a max-width for figures in the css - next link was missing in almost all chapters, previous link wrong in 4 or 5 chapters.
argh!
Ideally we should have a script which do all this stuff so we can always
generate from the last version. This is possible, I may look at it for PBE2 :)
Thanks!
I was just thinking that it may be a good use case for Coral .... who knows it well ? Laurent.
Laurent.
Stef
I thought about the same stef On May 15, 2011, at 8:05 AM, laurent laffont wrote:
On Sat, May 14, 2011 at 10:33 PM, Stéphane Ducasse <stephane.ducasse@inria.fr> wrote:
On May 14, 2011, at 9:58 PM, laurent laffont wrote:
On Sat, May 14, 2011 at 9:39 PM, Stéphane Ducasse <stephane.ducasse@inria.fr> wrote: I hosted it on the gforge. Now we can also put it in github. I would prefer to not maintain several versions. Laurent how many links did you have to fix?
- htlatex output dir doesn't work, so I had to move manually *html and *png to a build dir (indeed, I wrote a bash script for that). - I've resized the pharo.png icon and create the creative commons one from the .pdf - PBE1.html: there was some mess at the end of the table of content, I've removed it - add a max-width for figures in the css - next link was missing in almost all chapters, previous link wrong in 4 or 5 chapters.
argh!
Ideally we should have a script which do all this stuff so we can always generate from the last version. This is possible, I may look at it for PBE2 :)
Thanks!
I was just thinking that it may be a good use case for Coral .... who knows it well ?
Laurent.
Laurent.
Stef
now available online at: http://pharo.gforge.inria.fr/PBE1/PBE1.html Stef
participants (5)
-
Hilaire Fernandes -
laurent laffont -
Mariano Martinez Peck -
Stéphane Ducasse -
Sven Van Caekenberghe