jQuery JavaScript Library

Find a file

John Resig d1a88b2e58 Merge branch 'fixAdjacentTests' of https://github.com/jitter/jquery into jitter-fixAdjacentTests		2010-11-09 15:49:07 -05:00
build	Handle the case where JSLint complains about arguments in try/catch already being defined (we use the name 'e' consistently for catch(e) - will work to standardize on that now).	2010-10-17 10:50:17 -04:00
speed	Adding some rooted-find perf tests.	2010-10-10 16:06:33 -04:00
src	Make sure that if an additional load event is triggered (such as an iframe being dynamically injected in DOM ready) the ready event isn't triggered twice. Fixes #7352 .	2010-11-09 13:44:06 -05:00
test	Merge branch 'fixAdjacentTests' of https://github.com/jitter/jquery into jitter-fixAdjacentTests	2010-11-09 15:49:07 -05:00
.gitattributes	Force endlines to be just LF (any CRLF is auto-converted to LF by Git).	2009-11-27 11:23:19 -05:00
.gitignore	Adding .DS_Store to Git ignore.	2009-12-09 23:49:13 -08:00
build.xml	Forgot to update the Rakefile and build.xml files from the previous commit. Thanks to @jitter for the catch.	2010-10-14 16:57:12 -04:00
GPL-LICENSE.txt	Updated the licensing information.	2006-08-21 19:36:44 +00:00
Makefile	Allow for versions with spaces in them, in the Makefile.	2010-10-23 00:35:09 -04:00
MIT-LICENSE.txt	Updating the date in MIT-LICENSE.txt. Thanks @mathias for the heads-up.	2010-01-21 09:07:19 -05:00
Rakefile	Forgot to update the Rakefile and build.xml files from the previous commit. Thanks to @jitter for the catch.	2010-10-14 16:57:12 -04:00
README.md	Updated the Questions? section with the forum information.	2010-09-17 12:40:04 -07:00
version.txt	Updating the source version to 1.4.4pre.	2010-11-03 15:46:40 -04:00

README.md

jQuery - New Wave Javascript

What you need to build your own jQuery

Make sure that you have Java installed (if you want to build a minified version of jQuery).
If not, go to this page and download "Java Runtime Environment (JRE) 5.0"

Build Options

You now have three options for building jQuery:

make: If you have access to common UNIX commands (like make, mkdir, rm, cat, and echo) then simply type make to build all the components.
rake: If you have Ruby Rake installed (on either Windows or UNIX/Linux), you can simply type rake to build all the components.
ant: If you have Ant installed (or are on Windows and don't have access to make). You can download Ant from here: [http://ant.apache.org/bindownload.cgi].

How to build your own jQuery

Note: If you are using either rake or ant, substitute your chosen method in place of make in the examples below. They work identically for all intents and purposes. Quick reference is also available for rake by typing rake -T in the jquery directory.

In the main directory of the distribution (the one that this file is in), type the following to make all versions of jQuery:

make

Here are the individual items that are buildable from the Makefile:

make init

Pull in all the external dependencies (QUnit, Sizzle) for the project.

make jquery

The standard, uncompressed, jQuery code.
Makes: ./dist/jquery.js

make min

A compressed version of jQuery (made the Closure Compiler).
Makes: ./dist/jquery.min.js

make lint

Tests a build of jQuery against JSLint, looking for potential errors or bits of confusing code.

make selector

Builds the selector library for jQuery from Sizzle.
Makes: ./src/selector.js

Finally, you can remove all the built files using the command:

make clean

Building to a different directory

If you want to build jQuery to a directory that is different from the default location, you can...

Make only: Specify the PREFIX directory, for example:

make PREFIX=/home/john/test/ [command]

With this example, the output files would be contained in /home/john/test/dist/

Rake only: Define the DIST_DIR directory, for example:

rake DIST_DIR=/home/john/test/ [command]

With this example, the output files would be contained in /home/john/test/

In both examples, [command] is optional.

Ant only: You cannot currently build to another directory when using Ant.

Questions?

If you have any questions, please feel free to ask them on the Developing jQuery Core forum, which can be found here:
http://forum.jquery.com/developing-jquery-core