HTTPS clone URL
Subversion checkout URL
a tiny graphical app kit for ruby
Fetching latest commit...
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
((( |||_| ///\ [[[_ ((( ))) || | \\/ [[_ ))) an artsy any-platform app kit <http://github.com/shoes/shoes> ////////////////////////////////////////////////////////////////////////// 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/shoes/shoes Or, if you have git installed, you can clone the repo like so: git clone git://github.com/shoes/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://wiki.github.com/shoes/shoes/BuildingShoes> ////////////////////////////////////////////////////////////////////////// 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.