Hopiu/jquery-mobile
1
0
Fork 0
mirror of https://github.com/Hopiu/jquery-mobile.git synced 2026-03-16 22:10:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

updated the readme with more helpful information

Browse source
This commit is contained in:
scottjehl 2011-01-31 22:11:28 -05:00
parent d509404b72
commit a51adb98c4
1 changed files with 36 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

53
README.md
View file

@ -1,27 +1,17 @@
Early stage development for the jQuery Mobile UI Framework.
Code is subject to change dramatically!
Usage
jQuery Mobile Framework
=====
http://jquerymobile.com
Early documentation: https://github.com/jquery/jquery-mobile/wiki/_pages
For now, I've set things up with a little combinator script to concat all the css and js files into one request and gzip. (js/ and themes/default)
You'll need to point your local apache & php webserver at this root directory in order to preview things.
Demos and documentation
===================================
http://jquerymobile.com/test/
If you don't currently have a webserver running locally, a quick way to get up and running is to download and install Mamp for Mac OSX. Once installed, just open Mamp, click preferences, go to the Apache tab, and select your local jQuery Mobile folder as the root. Then you can open a browser to http://localhost:8888 to preview the code.
An alternative is XAMPP, which is also available for Windows, though you need to actually modify Apache's httpd.conf to point to your checkout: http://www.apachefriends.org/en/xampp.html
You need the Rewrite (mod_rewrite.so), Expire (mod_expires.so) and Header (mod_headers.so) modules loaded.
Whenever this configuration becomes inconvenient, we can remove it, obviously it's not meant to stay!
- when adding a js or css file, add it to the manifest in its directory and it'll be included in the request
- As far as JS files go, jQuery.mobile.core.js is the starting point.
How to build your own jQuery Mobile
How to build your own jQuery Mobile CSS and JS files
===================================
Clone this repo and build the js and css files:
Clone this repo and build the js and css files (you'll need Git and Make installed):
git clone git://github.com/jquery/jquery-mobile.git
cd jquery-mobile
@ -29,3 +19,32 @@ Clone this repo and build the js and css files:
Two complete versions, one minified, one not, of jQuery Mobile js and css files will be created.
Submitting bugs
===================================
If you think you've found a bug, please visit the Issue tracker (https://github.com/jquery/jquery-mobile/issues) and create an issue explaining the problem and expected result. Be sure to include any relevant information for reproducing the issue, such as the browser/device (with version #), and the version of the jQuery Mobile code you're running. It also helps a lot to make sure that the bug still exists on jquerymobile.com/test/, as it's possible we may have fixed it already!
Submitting patches
===================================
To contribute code and bug fixes to jQuery Mobile: fork this project on Github, make changes to the code in your fork, and then send a
"pull request" to notify the team of updates that are ready to be reviewed for inclusion.
Running the jQuery Mobile demos & docs locally
===================================
To preview locally, you'll need to clone a local copy of this repository and point your Apache & PHP webserver at its root directory (a webserver is required, as PHP and .htaccess are used for combining development files).
If you don't currently have a webserver running locally, there are a few options. If you're on a Mac, you can try dropping jQuery Mobile into your sites folder and turning on Web Sharing via System Prefs. From there, you'll find a URL where you can browse folders in your sites directory from a browser.
Another quick way to get up and running is to download and install MAMP for Mac OSX. Once installed, just open MAMP, click preferences, go to the Apache tab, and select your local jQuery Mobile folder as the root. Then you can open a browser to http://localhost:8888 to preview the code.
Another alternative is XAMPP, which is also available for Windows, though you need to actually modify Apache's httpd.conf to point to your checkout: http://www.apachefriends.org/en/xampp.html
You need the Rewrite (mod_rewrite.so), Expire (mod_expires.so) and Header (mod_headers.so) modules loaded.