= RwdEliza program for RwdTinker using RubyWebDialogs

RwdEliza is a AI application to simulate dialogs between humans and people

== Usage


The GUI interface used is RubyWebDialogs 


Start the program by typing 
ruby init.rb

Then point your web browser to:
http://localhost:7705/

  RwdEliza is a toy program
  to test sentence production by computer
      
  This program is just starting to be developed

  at this version '0.01' it is just responding randomly
  
  The plan is to parse input sentences and general
  responses that are learned over time
 
   The 'Sentence' tab can do simple parsing of simple sentences

== Installing Applets

   click on the "Selection Panel"
   click on Rwdtinker Back Window

      You can download an applet created by someone else
      put the file in the zips directory
      
      click on the "list zips" tab
      click on "list applets available for installing"
      
      chose the applet you want
      click on "install applet"
      If all goes well the applet should be installed.
      You will need to restart rwdtinker to see the new screens
      
      
== Changing configuration file

 click on "Edit Configuration"
 You can view the configuration file
 
  You can edit the configuration
  
  Remember to reload the configuration variables if you want your
  changes used.




      
== Documents
  
  
  when you click on a document name, the document should pop up in a 
  browser window, or in another browser tab.

To exit, press the x inside the browser window.

== To add context sensitive help

 You need to add a hash file that just needs to contain
 Helptext.update( :myapplet_generalhelp => "    This is the general help 
      You can add help text hear")
      
      And you need to add a help run script that will call runhelpwindow
      This should have a method that includes:
       setting $help_topic, and adds to $helptopicsarray, saves the calling window and calls runhelpwindow which will render the help message.
  
  if @rwd_tab == "gemservescan"
      $help_topic = "gemdocs_help"
    end
   $helptopicsarray =  $helptopicsarray | ["rubyslippers_generalhelp", "Install_Gem","GemCommands_help", "gemfilesinstalled","gemdocs_help"]
 if @rwd_window != "rwdtinkerhelpwindow"
       $previouswindow = @rwd_window
      $previoustab = @rwd_tab
  end
  runhelpwindow
 end

== Languages


 You can add tranlations in the lang subdirectory
 You change the $lang constant in Tinker config file in the configuration directory
 You can see one translation on the install applet tab, after you have installed and applet
 
== Using over a Network
  
To serve the application over your local LAN,change the last line in the
init.rb file to something like:
RwdTinker.file(RWDFile).serve(8080, "-r" ? ".rwduids" : nil)
Then you should be able to login at: http://yourhostname:8080

You have to authorize yourself. The .rwuids example is a string with
the name of the authorization file, relative to the home directory
of the user that started the service. This file has to be in the form of:

user1 = password
user2 = pass phrase

Thus the file .rwduids might contain:

erik = secret
 
== Requirements:
RubyWebDialogs - I am using 0.1.2 
 This package you downloaded should have a runtime version of 
 the needed rubywebdialog files

Ruby I am using version 1.8.2

I have tested this under Linux-Debian kernel 2.6.9

= Operation:
The code files reside in the code directory and are combined before 
the main Class is loaded

The rwd files in gui are combined before the gui is activated

Translated text reside in the lang directory

== Installing:

untar the file
tar zxvf rwdtinker-x.y.tar.gz
then cd to the directory
cd rwdshell-x.y
then start the init.rb program file
ruby init.rb
Then point your browser at http://localhost:7705
or where it tells you.
Trouble shooting:

If the program is not working, try looking at the ev subdirectory. That is where
the runtime of rubywebdialogs are.

for long term installation, I would suggest putting most files in a lib directory
like /usr/lib/rwdshell
then make a writable directory the local directory for command files to be written
like ~/rwdshell


Closing the browser doesn't terminate the application. You have to use the application's close-button  And terminating the application doesn't terminate the application when running in network mode. You just log out.

Don't use the back-button of the browser! Strange and unpredictable things may and will happen!

RubyWebDialogs is a platform independent graphical user interface for Ruby applications. It generates HTML and serves it with an internal HTTP server, so you can use your favorite web browser as the front end for your Ruby application. All this means, that it can be used on almost every platform, like Ruby itself. http://www.erikveen.dds.nl/rubywebdialogs/

== Credits

Thanks go to:

* Matz, for creating Ruby in the first place.
* Erik, for creating RubyWebDialogs.
* Charlotte, my wife for coming up for the name Tinker.

== License

rwdtinker is copyright (c) 2004 Steven Gibson.  It is free software, and may be redistributed
under the terms of the GPL licence: 

== Contact
  For more information see:
http://rwdapplications.rubyforge.org/wiki/wiki.pl


For more information about RubyWebDialogs see:
http://www.erikveen.dds.nl/rubywebdialogs/index.html

Thanks, Steven Gibson

== Changelog
Version 0.03
  upgraded to work with rwdtinker 1.75
  still not functional
  includes sentance structure tab
  added word lookup
  added Druida quote reader - like Unix fortunes
 
version 0.02
 upgraded to work with rwdtinker 1.69
 just beginning, not useful
 
Version 0.01
 first public version released
 designed for rwdtinker version 1.66