README.md

Arcadia IDE

About

Arcadia is a light editor (IDE) for Ruby language
written in Ruby using the classic Tcl/Tk GUI toolkit.

Some of Arcadia ide project features include:

Editor with source browsing, syntax highlighting, code completion

Working on any platform where Ruby and Tcl-Tk work.

Debugging support

Highly estensibile architecture.

How to install

exec on command line "gem install arcadia"

NOTE: on some linux distributions like archlinux the default Tcl/Tk runtime at this time is on versions >= 8.6
on the other hand ruby-tk supports fully only versions <= 8.5.x.y so to make arcadia working a choice
can be install ActiveTcl 8.5 and use ruby via rvm.

introduced in file-history a new kind of view (list view) activable by button on toolbar

bugs fixed and optimizations

Dependencies

rubygems

ruby-tk

tcl/tk (ruby-tk supports fully Tcl/Tk runtime <= 8.5 )

tk-tile (if Tcl/Tk < 8.5)

ctags (Linux)

xterm (Linux, optional)

xdotool (Linux, optional)

ack (optional)

gem coderay (> 1.0)

gem debugger (ruby-debug on Ruby < 1.9)

gem win32-process (only on Windows)

gem ruby-wmi (only on Windows)

Short User guide

Application layout is splitted in vertical and horizontal resizable frames.
On vertical and horizontal splitter appear two button for left or right
one shot frame closing.
Every frame has a title, a button to expand or resizing it and a menu-button
for dynamic layout functions (like add row, add column, close or for move a frame).

Main Toolbar

The toolbar button are in order:

new, open, save, find
(relatively to edit/find operation)
after "new" there is a menubutton to choose a type of file

run current, run last
(for execute the raised file in the editor or the last runned file)
after "run current" there is a menubutton to choose a configurated runner to apply at current file

debug current, debug last, quit debug panel
(for debug need)

quit (to exit from arcadia)

Editor

Editor can use the notebook metaphor. Same command are on the popup menu
that is raised on "Button-3" click event fundamentally for closing the tab
under the mouse pointer.
These are same editor short-cut:

Project drawer

File history

The last used files are organizing in tree so you can reopen them or their
directory by clicking on the tree node.

Debug

Require debugger gem.
It is created when a debug session init.
The debug button are: Step Next, Step Into, Step Over, Resume and quit.
The debug frame show the local, instance and global variables for each
step.

NOTE: at this moment debugger doesn't seem to work with ruby >= 2.0

Configuration

Same Arcadia properties are locally configurabled by editing the file arcadia.conf
under ~/.arcadia directory. The format of property definition are:
PROPERTY_NAME=PROPERTY_VALUE

I have tested arcadia with ruby 1.8, 1.9, 2.x on

Archlinux

Ubuntu/Mint

Fedora

FreeBsd,

Vector linux,

Mac OS X

Windows 2000/XP/7,

Cygwin (note: same page fault error on dll under cygwin may be solved in this way: by ash.exe exec "/bin/rebaseall")