((( |||_| ///\ [[[_ (((
))) || | \\/ [[_ )))
an artsy any-platform app kit <http://shoooes.net/>
//////////////////////////////////////////////////////////////////////////
Hi, guys, thankyou for taking Shoes.
Shoes is for writing plain old windowing software. But it borrows a
few things I like from the web:
* Hyperlinks and URLs within Shoes and to the web.
* Simple text layout -- though Shoes eschews floats.
* Images and colors in the layout and in the background.
* Margin and padding.
* Resizable layouts.
However, layouts can be tough on the web. Like a two-column layout.
So rather than using floating divs, Shoes uses two layout types:
stacks and flows. More on that later.
Shoes does keep a few things from traditional windowing toolkits:
* Buttons.
* Text edit (single-line and multi-line).
* Progress bars.
* Scroll bars.
* Dialogs.
And, last of all, Shoes gets some inspiration from NodeBox and
Processing:
* The whole window is a canvas.
* Shapes, paths, curves and transformations.
* Animation.
* Easy event-handling for mouse and keyboard.
Lastly, Shoes uses Ruby as its interface language.
That's really about all that's in Shoes. It's supposed to be light.
Not much code and not too much ambition.
//////////////////////////////////////////////////////////////////////////
WHY NOT WXWINDOWS? WHY NOT THE FOX TOOLKIT? OR QT??
Shoes is strictly inspired by stuff like REBOL/View, HyperCard,
the web itself and, of course, Processing and NodeBox.
I don't like the bulkiness and the layers and layers of wxWindows,
FOX, QT, GNOME. They are big, big libraries and all the apps look
identical, devoid of spirit.
The unique thing about the web is that it gives you very few
controls, but people are able to build wildly different pages
with it that are still immediately accessible to people.
//////////////////////////////////////////////////////////////////////////
THE INSIDE OF SHOES
So, to save a bit of work, Shoes relies on a few libraries:
* Cairo, for drawing. (http://cairographics.org)
* Pango, for text.
* Ruby, for programming.
All native widgets use the OS APIs directly. Half of Shoes is platform
specific code. The targets are: OSX, Windows and GTK.
//////////////////////////////////////////////////////////////////////////
STAYING CURRENT WITH SHOES
Shoes development happens at Github. You can download a current
tarball of the very latest Shoes from here:
http://github.com/why/shoes
Or, if you have git installed, you can clone the repo like so:
git clone git://github.com/why/shoes.git
Once you have your compiler and dependencies set up, building Shoes
is as simple as:
rake
Your Shoes build will then appear in the `dist` directory.
For instructions on how to set up your compiler and acquire deps for
Windows, OS X, and Linux, see the Shoes wiki:
<http://github.com/why/shoes/wikis> Look for a "Building Shoes"
link on the front page.
//////////////////////////////////////////////////////////////////////////
LICENSE
Copyright (c) 2008 why the lucky stiff
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.