<!DOCTYPE html>
<html>
<head>
<title>Jtalk Smalltalk - documentation</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="author" content="Nicolas Petton" />
<link rel="stylesheet" type="text/css" href='css/style.css' />
<link rel="stylesheet" type="text/css" href='css/syntax.css' />
<script type='text/javascript' src='js/jquery-1.4.4.min.js'></script>
<script type='text/javascript' src='js/jquery-ui-1.8.9.custom.min.js'></script>
<script type='text/javascript' src='js/jquery.textarea.js'></script>
<script type='text/javascript' src='js/jtalk.js'></script>
<link rel="stylesheet" type="text/css" href="css/jtalk.css"/>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-2246313-6']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<script type="text/javascript">
jQuery(window).scroll(function() {
if(jQuery(window).scrollTop() > 210) {
jQuery('#menu')
.css('position', 'fixed')
.css('top', '0px')
} else {
jQuery('#menu')
.css('position', 'absolute')
.css('top', '210px')
}
});
</script>
<a href="http://github.com/NicolasPetton/jtalk"><img style="position: absolute; top: 0; lef
t: 0; border: 0;" src="https://assets.github.com/img/bec6c51521dcc8148146135149fe06a9cc737577?repo=&url=http%3A%2F%2Fs3.amazonaws.com%2Fgithub%2Fribbons%2Fforkme_left_darkblue_121621.png&path=" alt="Fork me on GitHub"></a>
<div id="wrapper">
<div id="header">
<div class="main">
<img alt="Jtalk, the Smalltalk for web developers" src="images/text_header.png"/>
</div>
</div>
<div id="menu">
<ul>
<li><a href="index.html">Overview</a></li> ·
<li><a href="index.html#download">Download</a></li> ·
<li><a href="documentation.html">Documentation</a></li> ·
<li><a target="_blank" href="https://github.com/NicolasPetton/jtalk">Source</a></li>
</ul>
</div>
<div id="content">
<div class="main">
<div class="box last doc" id="documentation">
<h2>Documentation</h2>
<div class="content">
<h3 id="intro">1. Introduction <a href="#intro">¶</a></h3>
<p class="warning">This documentation is a work in progress.</p>
<p class="information">Jtalk is a young piece of code and evolves quickly. Some features are still incomplete and you may very well encounter bugs, in which case you can <a href="https://github.com/NicolasPetton/jtalk/issues">file an issue</a> or a pull request on the <a href="https://github.com/NicolasPetton/jtalk">repository</a>.</p>
<p>Jtalk is an implementation of the Smalltalk-80 language. It allows developers to write client-side heavy web applications in Smalltalk. Jtalk includes an integrated development environment with a class browser, workspace and transcript.</p>
<p>Jtalk includes the following features:</p>
<ol>
<li>It is semantically and syntaxically equivalent to <a href="http://www.pharo-project.org">Pharo Smalltalk</a> (the implementation considered as the reference)</li>
<li>It is written in itself and compiles into efficient JavaScript</li>
<li>A canvas API similar to <a href="http://www.seaside.st">Seaside</a> to generate HTML</li>
<li>A <a href="http://www.jquery.com">jQuery</a> binding</li>
</ol>
<h3 id="differences-other-smalltalks">2. Differences with other Smalltalk implementations <a href="#differences-other-smalltalks">¶</a></h3>
<h3 id="committing">3. Committing changes to disk with the web-based IDE <a href="#committing">¶</a></h3>
<p>The class browser is able to commit changes to disk. The <code>commit category</code> button will send a PUT request with the compiled JavaScript code of all classes in the selected class category in a file named <code>js/CATEGORY.js</code>.</p>
<p>The easiest way to enable committing is probably to setup a webdav with Apache.</p>
<p class="information">The following steps explain how to setup a webdav for Jtalk with Debian, but the setup on OSX and other Linux distros should be similar.</p>
<h4>Installing Apache and enabling the dav module</h4>
<p>Evaluate the following as root:</p>
<pre>~# apt-get install apache2
~# a2enmod dav
~# a2enmod dav_fs</pre>
<h4>Creating a password for the webdav</h4>
<pre>htpasswd -c /etc/apache2/htpasswd-webdav USERNAME</pre>
<h4>Setting up the webdav directory</h4>
<p>Add the following lines to the default vhost (in /etc/apache2/sites-available/default):</p>
<pre>Alias /jtalk/ "/path/to/jtalk/"
<Directory "/path/to/jtalk/">
Options Indexes MultiViews FollowSymLinks
DirectoryIndex index.html
AllowOverride None
Order allow,deny
allow from all
Dav on
AuthType Basic
AuthName "jtalk"
AuthUserFile /etc/apache2/htpasswd-webdav
<LimitExcept GET OPTIONS>
Require valid-user
</LimitExcept>
</Directory></pre>
<p>Make sure the group <code>www-data</code> has required rights to make changes to files in the webdav directory.</p>
<h4>Restarting Apache</h4>
<p>To restart Apache, evaluate the following: <pre>~# /etc/init.d/apache2 restart</pre> and go to <code>http://localhost/jtalk/</code>.</p>
<p>The class browser should now be able to commit changes to disk.</p>
<h3 id="counter-example">4. The counter example <a href="#counter-example">¶</a></h3>
<p>The following example is the traditional Seaside-like multi-counter application. The buttons at the bottom of each counter increase or decrease the counter.</p>
<div id="counters"></div>
<script type="text/javascript">
jQuery(document).ready(function() {'#counters'._asJQuery()._append_(smalltalk.Counter._new())._append_(smalltalk.Counter._new())});
</script>
<p>Open a <button onclick="smalltalk.Browser._openOn_(smalltalk.Counter);">browser</button> on the <code>Counter</code> class in the <code>Canvas</code> class category.
<p>Each Jtalk widget is a subclass of <code>Widget</code>. A widget is a graphical component. The <code>#renderOn:</code> method is used to generate HTML using the HTML canvas.</p>
<h3 id="html-canvas">5. The HTML canvas <a href="#html-canvas">¶</a></h3>
<h3 id="widgets">6. Widgets <a href="#widgets">¶</a></h3>
<h3 id="jquery">7. jQuery <a href="#jquery">¶</a></h3>
</div>
</div>
</div>
</div>
<div id="footer">
<div class="main">
<p>Copyright © 2011 <a href="https://github.com/NicolasPetton">Nicolas Petton</a>.</p>
<p>Jtalk is an opensource project sponsored by <a href="http://www.objectfusion.fr">objectfusion</a>.</p>
<p>The design of this website was kindly provided by <a href="mailto:neomie.thirion@gmail.com">Noémie Thirion</a>.</p>
</div>
</div>
</body>
</html>