<br><br><div class="gmail_quote">On Sat, May 14, 2011 at 3:38 PM, laurent laffont <span dir="ltr">&lt;<a href="mailto:laurent.laffont@gmail.com">laurent.laffont@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Here&#39;s a first shot of PBE1 in html <a href="http://lolgzs.free.fr/pharo/PBE1_html.zip" target="_blank">http://lolgzs.free.fr/pharo/PBE1_html.zip</a>.<div><br></div><div>Extract and open PBE1.html.<br><div><br></div></div>
</blockquote><div><br>Cool. Thanks!<br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div><div></div><div>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 :)</div>


<div><br></div></div></blockquote><div><br>Like every good programmer :)<br><br>I think this is cool Laurent. Even if the design is a little ugly, I think we can make it available:<br><br>1) Host it in <a href="http://pharobyexample.org/">http://pharobyexample.org/</a>  and put a link to it<br>
2) Put a link to it from pharo website.<br><br>Then, we can improve it. And updating it will just be a matter of unzipping a new zip.<br><br>Who should be contact to do 1) and 2) ?<br><br>thanks<br><br><br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div><div></div><div>Laurent Laffont - <a href="http://twitter.com/#%21/lolgzs" target="_blank">@lolgzs</a></div><div><br>Pharo Smalltalk Screencasts: <a href="http://www.pharocasts.com/" target="_blank">http://www.pharocasts.com/</a><br>


Blog: <a href="http://magaloma.blogspot.com/" target="_blank">http://magaloma.blogspot.com/</a><div>Developer group: <a href="http://cara74.seasidehosting.st" target="_blank">http://cara74.seasidehosting.st</a></div><div>
<div></div><div class="h5"><br>

<br><br><div class="gmail_quote">On Sun, May 8, 2011 at 2:18 PM, Stéphane Ducasse <span dir="ltr">&lt;<a href="mailto:stephane.ducasse@inria.fr" target="_blank">stephane.ducasse@inria.fr</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


I could not generate all the html because apparently there is a problem.<br>
The table of contents was broken.<br>
<br>
Stef<br>
<div>On May 6, 2011, at 2:05 PM, laurent laffont wrote:<br>
<br>
</div><div><div></div><div>&gt; On Fri, May 6, 2011 at 11:56 AM, Stéphane Ducasse &lt;<a href="mailto:stephane.ducasse@inria.fr" target="_blank">stephane.ducasse@inria.fr</a>&gt; wrote:<br>
&gt; Ok if some good souls want to give a try to generate html.<br>
&gt;<br>
&gt;<br>
&gt; On OSX with MacTex-2010 installed, I&#39;ve tried<br>
&gt;<br>
&gt; git clone --depth 1 <a href="https://github.com/SquareBracketAssociates/PharoByExample-english.git" target="_blank">https://github.com/SquareBracketAssociates/PharoByExample-english.git</a><br>
&gt; cd PharoByExample-english/<br>
&gt; htlatex PBE1.tex &quot;html,2&quot;<br>
&gt;<br>
&gt; Then open PBE1.html , one page per chapter.<br>
&gt;<br>
&gt; See <a href="http://www.tug.org/applications/tex4ht/mn-commands.html" target="_blank">http://www.tug.org/applications/tex4ht/mn-commands.html</a><br>
&gt;<br>
&gt; Laurent.<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; Stef<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; &gt; Probably we should find a way to generate HTML from PDF or Latex.<br>
&gt; &gt; Any ideas?<br>
&gt; &gt;<br>
&gt; &gt; I&#39;ve used latex2html several years ago.<br>
&gt; &gt;<br>
&gt; &gt; +1 for html<br>
&gt; &gt;<br>
&gt; &gt; Laurent.<br>
&gt; &gt;<br>
&gt; &gt;<br>
&gt; &gt;<br>
&gt; &gt; &gt;&gt;&gt;&gt; Now for the documentation when did you send an help documentation for any part of the system?<br>
&gt; &gt; &gt;&gt;&gt;&gt; Or a bug fix?<br>
&gt; &gt; &gt;&gt;&gt;&gt; I find quite funny that people always talk but few are doing. We welcome comments/examples help.<br>
&gt; &gt; &gt;&gt;&gt; No need to get into a cat-fight here :)<br>
&gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt;&gt; No this is not my point. But what do people really do to help?<br>
&gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt;&gt;&gt; I do agree with Stefan, as well as with you that we could help; but I&#39;m unaware of a good documentation effort outside of the image to start with. Camillo&#39;s website project might be the best effort I&#39;ve seen until now; but then I didn&#39;t really look either. Maybe I missed some great website?<br>



&gt; &gt; &gt;&gt;<br>
&gt; &gt; &gt;&gt; If this is just to spit out class comment on html I do not call that a documentation.<br>
&gt; &gt; &gt;&gt; Now we can take the book contents and generate html<br>
&gt; &gt; &gt;&gt; We have 350 pages in the first book and the same in the second one.<br>
&gt; &gt; &gt;&gt; People are free to join and write one or two chapters.<br>
&gt; &gt; &gt;<br>
&gt; &gt; &gt; Stéphane,<br>
&gt; &gt; &gt;<br>
&gt; &gt; &gt; Of course you are right: wining/complaining doesn&#39;t help, only action does. We need more people like Laurent focusing on documentation.<br>
&gt; &gt; &gt;<br>
&gt; &gt; &gt; 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).<br>
&gt; &gt; &gt;<br>
&gt; &gt; &gt; But the other point is: in most other popular languages, what current, young developers do, when they get an error that they don&#39;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.<br>



&gt; &gt; &gt;<br>
&gt; &gt; &gt; This is also related to popularity of course.<br>
&gt; &gt; &gt;<br>
&gt; &gt; &gt; Sven<br>
&gt; &gt;<br>
&gt; &gt;<br>
&gt; &gt;<br>
&gt;<br>
&gt;<br>
&gt;<br>
<br>
<br>
</div></div></blockquote></div><br></div></div></div></div>
</blockquote></div><br><br clear="all"><br>-- <br>Mariano<br><a href="http://marianopeck.wordpress.com" target="_blank">http://marianopeck.wordpress.com</a><br><br>