summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorThomas Park <thomas@thomaspark.me>2012-12-06 09:18:07 -0500
committerThomas Park <thomas@thomaspark.me>2012-12-06 09:18:07 -0500
commitf5951f3a55f14d7e5e1dd9acf3039c13e8c65c56 (patch)
tree0fbff4a3d75d9cc3296857dd9b3aa7e563a10af4 /README.md
parentacb7ffef748c46ae7beef8f836c731868a11fe45 (diff)
moved readme and swatchmaker to gh-pages branch
Diffstat (limited to 'README.md')
-rw-r--r--README.md63
1 files changed, 63 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..9f7c11fd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+Bootswatch
+==========
+
+Bootswatch is a collection of free themes for [Twitter Bootstrap](http://twitter.github.com/bootstrap/). Check it out at [bootswatch.com](http://bootswatch.com).
+
+On GitHub, the source is located in the [gh-pages branch](https://github.com/thomaspark/bootswatch/tree/gh-pages).
+
+Usage
+-----
+Head over to [Bootswatch](http://bootswatch.com) and download the `bootstrap.min.css` file associated with a theme.
+
+In Bootstrap’s CSS directory, you’ll find a stylesheet in full (`bootstrap.css`) and minified (`bootstrap.min.css`) forms. Rename them or move them to a safe place, and replace with the downloaded file. If you ever change your mind, simply drop in another theme or switch back to the original.
+
+For use with Rails, check out [bootswatch-rails](https://github.com/maxim/bootswatch-rails) (Sass) and [twitter-bootswatch-rails](https://github.com/scottvrosenthal/twitter-bootswatch-rails) (LESS).
+
+
+Customization
+------
+Bootswatch is an open source project, and you’re welcome to modify the themes further. If you’re interested, fork or follow the GitHub repository. The files of interest are in the `gh-pages` branch.
+
+Each raw theme consists of two LESS files. One is `variables.less`, which is included by default in Bootstrap and allows you to customize [these settings](http://twitter.github.com/bootstrap/less.html#variables). The other is called `bootswatch.less` and introduces more extensive structural changes.
+
+Check out the README in the [swatchmaker directory](https://github.com/thomaspark/bootswatch/tree/master/swatchmaker) for step-by-step instructions on building your own swatch.
+
+API
+-----
+
+A simple API is available for integrating your platform with Bootswatch.
+
+The swatch objects are housed in an array called `themes`, and each swatch has the following properties: `name`, `description`, `preview`, `thumbnail`, `css`, `css-min`, `less`, and `less-variables`.
+
+CORS and JSONP are supported. Send your request to `http://api.bootswatch.com`.
+
+A simple demo, using mustache.js for templating: http://jsbin.com/asowud/1/edit
+
+Feedback
+------
+Please send feedback to thomas@thomaspark.me. For more information, visit http://thomaspark.me/2012/02/introducing-bootswatch/.
+
+Author
+------
+[Thomas Park](http://github.com/thomaspark)
+
++ http://thomaspark.me
+
+Thanks
+------
+[Mark Otto](http://github.com/markdotto) and [Jacob Thornton](http://github.com/fat) for [Bootstrap](https://github.com/twitter/bootstrap).
+
+[James Taylor](http://github.com/jostylr) for [cors-lite](https://github.com/jostylr/cors-lite).
+
+[Zack Maril](http://github.com/zmaril) for [bootswatch/swatchmaker/watcher.rb](https://github.com/thomaspark/bootswatch/blob/master/swatchmaker/watcher.rb).
+
+
+Copyright and License
+----
+Copyright 2012 Thomas Park
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. \ No newline at end of file