jQuery JavaScript Library

Find a file

John Resig d1f3dc9a04 Make sure that empty height/width values are still set.		2010-09-17 13:51:12 -04:00
build	Increase max number of JSLint errors. This is necessary because we have several error messages that we choose to ignore.	2010-09-01 10:48:19 -05:00
speed	Expose jQuery.uuid (use with caution) and make sure the expando property is used in the events module.	2010-06-19 22:29:48 -07:00
src	Make sure that empty height/width values are still set.	2010-09-17 13:51:12 -04:00
test	Fixed some sloppy checks in the effects test suite, makes it more apparent where issues are happening.	2010-09-17 13:38:13 -04: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	Fixed ant build to be more consistent with Makefile. Now has all same targets (see README.md) and	2010-07-21 22:47:13 +08:00
GPL-LICENSE.txt	Updated the licensing information.	2006-08-21 19:36:44 +00:00
Makefile	Trim out the module wrappers during the build process. Follow-up to #7011 .	2010-09-09 10:34:21 -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	Slight optmization on the Rakefile	2010-06-19 22:29:49 -07:00
README.md	Edits to README after Karl's review	2010-06-19 22:29:49 -07:00
version.txt	Updating the source version to 1.4.3pre.	2010-02-13 22:33:57 -05: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 jQuery mailing list, which can be found here:
http://docs.jquery.com/Discussion