@ -4,20 +4,20 @@ Build mobile apps with simple HTML, CSS, and JS components.
## Table of contents
## Table of contents
- [Getting started](#getting-started)
* [Getting started](#getting-started)
- [Documentation](#documentation)
* [Documentation](#documentation)
- [Support](#support)
* [Support](#support)
- [Contributing](#contributing)
* [Contributing](#contributing)
- [Troubleshooting](#troubleshooting)
* [Troubleshooting](#troubleshooting)
- [Versioning](#versioning)
* [Versioning](#versioning)
- [Maintainers](#maintainers)
* [Maintainers](#maintainers)
- [License](#license)
* [License](#license)
## Getting started
## Getting started
- Clone the repo with `git clone https://github.com/twbs/ratchet.git` or just [download](http://github.com/twbs/ratchet/archive/v2.0.2.zip) the bundled CSS and JS
* Clone the repo with `git clone https://github.com/twbs/ratchet.git` or just [download](http://github.com/twbs/ratchet/archive/v2.0.2.zip) the bundled CSS and JS
- [Read the docs](http://goratchet.com) to learn about the components and how to get a prototype on your phone
* [Read the docs](http://goratchet.com) to learn about the components and how to get a prototype on your phone
- [Check out examples](http://goratchet.com/examples/)
* [Check out examples](http://goratchet.com/examples/)
Take note that our master branch is our active, unstable development branch and that if you're looking to download a stable copy of the repo, check the [tagged downloads](https://github.com/twbs/ratchet/tags).
Take note that our master branch is our active, unstable development branch and that if you're looking to download a stable copy of the repo, check the [tagged downloads](https://github.com/twbs/ratchet/tags).
@ -53,7 +53,7 @@ Ratchet's documentation is built with [Jekyll](http://jekyllrb.com) and publicly
### Running documentation locally
### Running documentation locally
1. If necessary, [install Jekyll](http://jekyllrb.com/docs/installation) (requires v2.5.x).
1. If necessary, [install Jekyll](http://jekyllrb.com/docs/installation) (requires v2.5.x).
- **Windows users:** Read [this unofficial guide](http://jekyll-windows.juthilo.com/) to get Jekyll up and running without problems.
* **Windows users:** Read [this unofficial guide](http://jekyll-windows.juthilo.com/) to get Jekyll up and running without problems.
2. Install the Ruby-based syntax highlighter, [Rouge](https://github.com/jneen/rouge), with `gem install rouge`.
2. Install the Ruby-based syntax highlighter, [Rouge](https://github.com/jneen/rouge), with `gem install rouge`.
3. From the root `/ratchet` directory, run `jekyll serve` in the command line.
3. From the root `/ratchet` directory, run `jekyll serve` in the command line.
4. Open <http://localhost:4000> in your browser, and boom!
4. Open <http://localhost:4000> in your browser, and boom!
@ -78,12 +78,12 @@ Please file a GitHub issue to [report a bug](https://github.com/twbs/ratchet/iss
A small list of "gotchas" is provided below for designers and developers starting to work with Ratchet.
A small list of "gotchas" is provided below for designers and developers starting to work with Ratchet.
- Ratchet is designed to respond to touch events from a mobile device. In order to use mouse click events (for desktop browsing and testing), you have a few options:
* Ratchet is designed to respond to touch events from a mobile device. In order to use mouse click events (for desktop browsing and testing), you have a few options:
- Enable touch event emulation in Chrome (found in the overrides tab in the web inspector preferences)
* Enable touch event emulation in Chrome (found in the overrides tab in the web inspector preferences)
- Use a JavaScript library like fingerblast.js to emulate touch events (ideally only loaded from desktop devices)
* Use a JavaScript library like fingerblast.js to emulate touch events (ideally only loaded from desktop devices)
- Script tags containing JavaScript will not be executed on pages that are loaded with push.js. If you would like to attach event handlers to elements on other pages, document-level event delegation is a common solution.
* Script tags containing JavaScript will not be executed on pages that are loaded with push.js. If you would like to attach event handlers to elements on other pages, document-level event delegation is a common solution.
- Ratchet uses XHR requests to fetch additional pages inside the application. Due to security concerns, modern browsers prevent XHR requests when opening files locally (aka using the file:// protocol); consequently, Ratchet does not work when opened directly as a file.
* Ratchet uses XHR requests to fetch additional pages inside the application. Due to security concerns, modern browsers prevent XHR requests when opening files locally (aka using the `file://` protocol); consequently, Ratchet does not work when opened directly as a file.
- A common solution to this is to simply serve the files from a local server. One convenient way to achieve this is to run `python -m SimpleHTTPServer <port>` to serve up the files in the current directory to `http://localhost:<port>`
* A common solution to this is to simply serve the files from a local server. One convenient way to achieve this is to run `python -m SimpleHTTPServer <port>` to serve up the files in the current directory to `http://localhost:<port>`
## Versioning
## Versioning
@ -95,9 +95,9 @@ Releases will be numbered with the following format:
And constructed with the following guidelines:
And constructed with the following guidelines:
- Breaking backward compatibility **bumps the major** while resetting minor and patch
* Breaking backward compatibility **bumps the major** while resetting minor and patch
- New additions without breaking backward compatibility **bumps the minor** while resetting the patch
* New additions without breaking backward compatibility **bumps the minor** while resetting the patch
- Bug fixes and misc changes **bumps only the patch**
* Bug fixes and misc changes **bumps only the patch**
For more information on SemVer, please visit <http://semver.org/>.
For more information on SemVer, please visit <http://semver.org/>.
@ -105,14 +105,8 @@ For more information on SemVer, please visit <http://semver.org/>.
Connor Sears
Connor Sears
- <https://twitter.com/connors>
* <https://twitter.com/connors>
- <https://github.com/connors>
* <https://github.com/connors>
Connor Montgomery
- <https://twitter.com/connor>
- <https://github.com/connor>
Created by Connor Sears, Dave Gamache, and Jacob Thornton.
Created by Connor Sears, Dave Gamache, and Jacob Thornton.