[ANNOUNCE] Aejaks 0.7 release
Tom Poindexter
http://aejaks.sf.net.
Summary of changes for this release:
Additional container widgets now provide absolute positioning of child widgets.
Table widget now allows custom cell and header renderers.
Window setFocusedComponent method allows focus to be set on a widget.
BrowserCommand setwaitms method sets interval for browser "Please wait" message.
-------------------------------------------------------------------------------
Detailed CHANGES for this release:
0.7 2008-02-22
* Widgets from EchopointNG
ContainerEx (allows absolute positioning)
ContentPaneEx ( " " " )
Strut (simple spacer component)
DisplayLayoutData (positioning info)
ScrollableDisplayLayoutData ( " " )
* Table header and cell renderers, allow custom widgets
to be defined for headers and cells. Tables now
expand gracefully with null data when -rows or -columns
are increased.
* Strip leading "::" from widget names during Pack.
Pack updated for new container widgets and layout data.
* SplitPaneLayoutData -overflow option now takes a symbolic
name instead of integer (POTENTIAL INCOMPATIBILITY)
* Added ". setFocusedComponent $wid" to Window object, allows
focus to be set on a widget.
* Added "BrowserCommand setwaitms $ms" to set the interval before
displaying the "Please wait" message box.
* New widget_tour.tcl demos for Table renderers, absolute
positioning for new containers.
Check out the "analog clock" in the 'ContainersEx' demo!!
* Updated docs.
* Updated Echo2, Extras, EchopointNG libraries to latest versions.
-------------------------------------------------------------------------------
README
AEJAKS: http://aejaks.sf.net
ABOUT:
Aejaks combines the server-side Ajax windowing system Echo2 with the powerful
simplicity of the Tcl langauge. The result is a rich development environment
in which to develop Ajax-based web applications, often with much less code to
write.
Building a Rich Internet Application (RIA) usually means having to write
your application in a variety of languages and markup: HTML, CSS, and
Javascript for the browser, plus some backend language (PHP, Java, Tcl, etc.)
With Aejaks, you only need a single language: Tcl. Aejaks applications
resemble desktop Tcl/Tk applications. Aejaks uses a Tk-inspired object
interface to create and interact with widgets.
Classic "Hello world" in Aejaks:
Button .hello -text "Hello world" -command {. exitApp /index.html}
Pack .hello
The first line creates a Button widget named '.hello' and defines a command
to be run when the button is pressed (exit the application and tell the
browser to load the index.html page.) The second line makes the Button widget
visible in the browser window. That's all you need!
AUTHOR:
Aejaks was conceived and written by Tom Poindexter. Please subscribe and use
the mailing list for Aejaks related discussion. Subscription information at:
http://lists.sourceforge.net/lists/listinfo/aejaks-general
If you really, absolutely need to get in touch with me privately, email:
tpoi...@nyx.net
ACKNOWLEDGEMENTS:
Aejaks stands on the shoulders of giants, and would not be possible
without the contributions of a host of very talented programmers and
artists:
Echo2: Tod Liebeck, NextApp
Tcl/Jacl John Ousterhout, Ioi Lam, Brian Smith, Mo DeJong
IncrTcl: Michael J. McLennan, Mo DeJong
Jetty: Greg Wilkins, Mort Bay Consulting
Clcms: Jelte Jansen
EchopointNG: Brad Bakerman
Nuvola icons: David Vignoni
DOWNLOAD:
http://sourceforge.net/project/showfiles.php?group_id=184611
or http://sourceforge.net/projects/aejaks
Three downloads are available (where 'x.y' is the current version):
aejaks-x.y-exe.tar.gz
aejaks-x.y-exe.zip
This package contains everything required to run, develop and deploy
Aejaks applications. Included are the aejaks.war file, Jetty web server,
sample scripts, and documentation.
Java 1.4 or higher is required to run the Aejaks and the Jetty web server.
http://java.sun.com
aejaks-x.y-src.tar.gz
aejaks-x.y-src.zip
Developers who wish to contribute to Aejaks development should download
this file and the above '-exe' file, and unpack both into the same
directory. This package contains source for Java and Tcl files,
documentation source, build scripts, library files, icon and image
source, Eclipse project and classpath files.
Java JDK 1.4 or higher is required to develop Aejaks.
http://java.sun.com
Ant or Eclipse is require to run the Java source build.xml file.
Ant and Eclipse can be downloaded from
http://ant.apache.org
http://eclipse.org
Clcms and Python are required to regenerate the local website &
documentation. Clcms and Python can be downloaded from:
http://www.jelte.nlnetlabs.nl/Projects/clcms/index.html
http://python.org
AejaksDemo.war
This war is the webserver deployment file containing the Aejaks
runtime and all required libraries, along with the 'widget_tour'
demo script. Simply deploy this file into your existing Java Servlet
engine (e.g., Jetty, Tomcat, Resin, Websphere, Weblogic, Winstone, etc.
Java 1.4 or higher is also requried.)
Once deployed (and depending on your servlet engine), you should be
able to invoke the Aejaks 'widget_tour' demo by opening a browser to
http://your-web-server-host/AejaksDemo
AejaksDemo.war is a full run-time environment for Aejaks. Update the
internal WEB-INF/web.xml file or provide the runtime parameters as
outlined in the documentation:
http://aejaks.sourceforge.net/Documentation/Running/index.html
http://aejaks.sourceforge.net/Documentation/Configuration/index.html
REQUIREMENTS:
Aejaks requires a Java JRE 1.4 or higher installation. No other
external software is required, Aejaks is ready to run. Aejaks includes
the Jetty webserver, configured to start on port 8080.
DOCUMENTATION:
See: ./website/out/index.html
This is a local copy of the website, including all documentation to related
software.
All documentation is also available at: http://aejaks.sf.net
QUICK START:
You will need Java JDK or JRE 1.4 or higher installed. un-tar or un-zip
the '-exe' distribution file:
tar zxf aejaks-x.y-exe.tar.gz
unzip aejaks-x.y-exe.zip
winzip ...etc...
Start the Jetty webserver:
unix/linux:
sh run.sh
windows, execute in a Command Prompt window:
run.bat
Start your web browser and load the index.html page:
unix/linux:
firefox http://localhost:8080
windows:
start http://localhost:8080
Now start exploring the demos!
To stop the web server:
unix/linux:
sh stop.sh
windows:
^C (in the Command Prompt window where you started jetty)
COPYRIGHT & LICENSE:
Aejaks (a.k.a. "Æjaks") Copyright 2006-2008, Tom Poindexter
Aejaks is licensed under the Mozilla Public License 1.1, or the GNU LGPL 2.1.
Aejaks includes the following software, please refer to the copyright
and license statements for each package in the ./licenses/ directory:
Echo2
EchopointNG
Jacl, IncrTcl, TJC
Jetty
JFreeChart
Nuvola icons
--
Tom Poindexter
tpoi...@nyx.net