Htmlcompressor provides tools to minify html code. It includes
- HtmlCompressor::Compressor class which is a raw port of google's htmlcompressor
- HtmlCompressor::Rack a rack middleware to compress html pages on the fly
Please note that Htmlcompressor is still in alpha version and need some additional love.
Using the compressor class is straightforward:
compressor = HtmlCompressor::Compressor.new
compressor.compress('<html><body><div id="compress_me"></div></body></html>')The compressor ships with basic and safe default options that may be overwritten passing the options hash to the constructor:
options = {
:enabled => true,
:remove_multi_spaces => true,
:remove_comments => true,
:remove_intertag_spaces => false,
:remove_quotes => false,
:compress_css => false,
:compress_javascript => false,
:simple_doctype => false,
:remove_script_attributes => false,
:remove_style_attributes => false,
:remove_link_attributes => false,
:remove_form_attributes => false,
:remove_input_attributes => false,
:remove_javascript_protocol => false,
:remove_http_protocol => false,
:remove_https_protocol => false,
:preserve_line_breaks => false,
:simple_boolean_attributes => false
}Using rack middleware is as easy as:
config.middleware.use HtmlCompressor::Rack, optionsThe middleware uses a little more aggressive options by default:
options = {
:enabled => true,
:remove_multi_spaces => true,
:remove_comments => true,
:remove_intertag_spaces => false,
:remove_quotes => true,
:compress_css => false,
:compress_javascript => false,
:simple_doctype => false,
:remove_script_attributes => true,
:remove_style_attributes => true,
:remove_link_attributes => true,
:remove_form_attributes => false,
:remove_input_attributes => true,
:remove_javascript_protocol => true,
:remove_http_protocol => true,
:remove_https_protocol => false,
:preserve_line_breaks => false,
:simple_boolean_attributes => true
}Rails 2.3 users may need to add
require 'htmlcompressor'By default CSS/JS compression is disabled.
In order to minify in page javascript and css, you need to supply a compressor in the options hash.
A compressor can be :yui or :closure or any object that responds to :compress. E.g.: compressed = compressor.compress(source)
class MyCompressor
def compress(source)
return 'minified'
end
end
options = {
:compress_css => true,
:css_compressor => MyCompressor.new,
:compress_javascript => true,
:javascript_compressor => MyCompressor.new
}Please note that in order to use yui or closure compilers you need to manually add them to the Gemfile
gem 'yui-compressor'
...
options = {
:compress_javascript => true,
:javascript_compressor => :yui,
:compress_css => true
:css_compressor => :yui
} gem 'closure-compiler'
...
options = {
:compress_javascript => true,
:javascript_compressor => :closure
}As of now the statistic framework hasn't been ported. Refer to original htmlcompressor documentation for statistics on minified pages.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request