mirror of
https://github.com/mrclay/minify.git
synced 2025-09-02 18:32:58 +02:00
Improves README and add install doc page
Shows how to install as a composer dependency
This commit is contained in:
56
README.md
56
README.md
@@ -1,5 +1,4 @@
|
||||
Welcome to Minify!
|
||||
==================
|
||||
# Welcome to Minify!
|
||||
|
||||
Minify is an HTTP server for JS and CSS assets. It compresses and combines files
|
||||
and serves it with appropriate headers, allowing conditional GET or long-Expires.
|
||||
@@ -12,8 +11,11 @@ The stats above are from a [brief walkthrough](http://mrclay.org/index.php/2008/
|
||||
|
||||
Relative URLs in CSS files are rewritten to compensate for being served from a different directory.
|
||||
|
||||
Wordpress User?
|
||||
---------------
|
||||
## Support
|
||||
|
||||
Post to the [Google Group](http://groups.google.com/group/minify).
|
||||
|
||||
### Wordpress User?
|
||||
|
||||
Consider instead using a dedicated WordPress plugin for more deep integration and simpler installation. E.g.:
|
||||
- [BWP Minify](http://wordpress.org/extend/plugins/bwp-minify/)
|
||||
@@ -21,37 +23,13 @@ Consider instead using a dedicated WordPress plugin for more deep integration an
|
||||
|
||||
Unfortunately we can't support the WordPress plugins here.
|
||||
|
||||
Installation
|
||||
------------
|
||||
## Installation
|
||||
|
||||
Installation requires PHP 5.3+, SSH access, and access to tools like `git` and `composer` or the privileges to install them.
|
||||
See the [install guide](https://github.com/mrclay/minify/blob/master/docs/Install.wiki.md).
|
||||
|
||||
```bash
|
||||
cd /path/to/public_html
|
||||
git clone https://github.com/mrclay/minify.git min
|
||||
cd min
|
||||
composer install --no-dev
|
||||
```
|
||||
## Configuration & Usage
|
||||
|
||||
What this does:
|
||||
|
||||
1. Inside your DOCUMENT_ROOT directory, we clone this repo. Otherwise you may [download](https://github.com/mrclay/minify/archive/master.zip) and extract the zip file.
|
||||
1. We rename this directory `min`. E.g. You will have something like: `/home/example/public_html/min`
|
||||
1. We `cd` into it and run `composer install` to install the dependencies.
|
||||
|
||||
You can verify that it is working by visiting these two URLs:
|
||||
|
||||
* http://example.org/min/?f=min/quick-test.js
|
||||
* http://example.org/min/?f=min/quick-test.css
|
||||
|
||||
If your server supports mod_rewrite, this URL should also work:
|
||||
|
||||
* http://example.org/min/f=min/quick-test.js
|
||||
|
||||
Configuration & Usage
|
||||
---------------------
|
||||
|
||||
See the [user guide](https://github.com/mrclay/minify/blob/master/docs/UserGuide.wiki.md)!
|
||||
See the [user guide](https://github.com/mrclay/minify/blob/master/docs/UserGuide.wiki.md).
|
||||
|
||||
Minify also comes with a [URI Builder application](https://github.com/mrclay/minify/blob/master/docs/BuilderApp.wiki.md) that can help you write URLs
|
||||
for use with Minify or configure groups of files.
|
||||
@@ -60,26 +38,18 @@ See the [cookbook](https://github.com/mrclay/minify/blob/master/docs/CookBook.wi
|
||||
|
||||
More [docs are available](https://github.com/mrclay/minify/tree/master/docs).
|
||||
|
||||
Support
|
||||
-------
|
||||
|
||||
[Google Group](http://groups.google.com/group/minify)
|
||||
|
||||
Unit Testing
|
||||
------------
|
||||
## Unit Testing
|
||||
|
||||
1. Install dev deps via Composer: `composer install`
|
||||
1. `composer test` or `phpunit`
|
||||
|
||||
Warnings
|
||||
--------
|
||||
## Warnings
|
||||
|
||||
* Minify is designed for efficiency, but, for very high traffic sites, it will probably serve files slower than your HTTPd due to the CGI overhead of PHP. See the [FAQ](https://github.com/mrclay/minify/blob/master/docs/FAQ.wiki.md#how-fast-is-it) and [CookBook](https://github.com/mrclay/minify/blob/master/docs/CookBook.wiki.md) for more info.
|
||||
* If you combine a lot of CSS, watch out for [IE's 4096 selectors-per-file limit](http://stackoverflow.com/a/9906889/3779), affects IE 6 through 9.
|
||||
* Minify *should* work fine with files encoded in UTF-8 or other 8-bit encodings like ISO 8859/Windows-1252. By default Minify appends ";charset=utf-8" to the Content-Type headers it sends.
|
||||
|
||||
Acknowledgments
|
||||
---------------
|
||||
## Acknowledgments
|
||||
|
||||
Minify was inspired by [jscsscomp](http://code.google.com/p/jscsscomp/) by Maxim Martynyuk and by the article [Supercharged JavaScript](http://www.hunlock.com/blogs/Supercharged_Javascript) by Patrick Hunlock.
|
||||
|
||||
|
Reference in New Issue
Block a user