.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.ad l
.
.TH "POLYMER" "1" "February 2011" "POLYMER 1.0.0.BETA.7" "Polymer Manual"
.
.SH "NAME"
\fBpolymer\fR \- Image spriting for web applications
.
.SH "SYNOPSIS"
\fBpolymer\fR [\-\-no\-colour] COMMAND [ARGUMENTS]
.
.SH "DESCRIPTION"
\fBPolymer\fR is a tool for creating sprite images which combine many smaller sources into a single larger image\. Spriting allows you to reduce the number of HTTP requests required to load a web page, and as such can result in reduced load times\.
.
.P
Polymer also creates the necessary CSS to position the sprite within an HTML element so that only the desired source appears\. Those writing their website or application in Ruby can make use of Polymer\'s Sass builder which creates a Sass mixin, further simplifying the use of your sprites\.
.
.P
In order to reduce the amount of data transferred to clients loading your pages, Polymer optimises the sprites it generates using PNGOUT, OptiPNG, and PNGCrush\.
.
.SH "OPTIONS"
.
.TP
\fB\-\-no\-colour\fR
Disables the use of colour in output\. This option is also available as \fB\-\-no\-color\fR\.
.
.SH "COMMANDS"
.
.TP
polymer init(1) \fIpolymer\-init\.1\.html\fR
Creates a new Polymer project in the current directory\.
.
.TP
polymer bond(1) \fIpolymer\-bond\.1\.html\fR
Creates the sprites specified by your \fB\.polymer\fR or \fBpolymer\.rb\fR file, optimises the images, and creates any requested CSS or Sass files\.
.
.TP
polymer optimise(1) \fIpolymer\-optimise\.1\.html\fR
Given paths to PNG files as arguments, optimises them to reduce the filesize as much as possible without compromising quality\. Also available as \fBpolymer optimize\fR\.
.
.TP
polymer position(1) \fIpolymer\-position\.1\.html\fR
Shows the position of a source within a sprite, and provides CSS which you can use in your own stylesheets\.
.
.P
Detailed documentation for each of Polymer\'s commands can be viewed with the \fBpolymer help\fR command\. For example, to view the documentation for the \fBbond\fR command, run \fBpolymer help bond\fR\.
.
.SH "SEE ALSO"
polymer(5) (\fBpolymer help \.polymer\fR) provides a description of the \fB\.polymer\fR configuration file format\.