Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
a tiny graphical app kit for ruby
C Ruby Objective-C Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
platform
samples
shoes
static
COPYING
INSTALL
Makefile
README
Rakefile
use-deps

README

                      
    ((( |||_| ///\ [[[_ (((
     ))) || |  \\/  [[_  )))
    a cross-platform applikit

//////////////////////////////////////////////////////////////////////////

    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.

//////////////////////////////////////////////////////////////////////////

    BUILDING AND INSTALLING SHOES

    Since this project is in its infancy, be sure to get instructions from
    the wiki at http://code.whytheluckystiff.net/shoes/.  Things are changing
    quickly and this README will be updated when the first release is made.

//////////////////////////////////////////////////////////////////////////

    LICENSE

    Copyright (c) 2007 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.
Something went wrong with that request. Please try again.