YUICompressor Wiki & Documentation Rss Feed

Updated Wiki: Home

purekrome — Sat, 30 Mar 2013 02:03:16 GMT

Project Description
This is a .NET port of the Yahoo! UI Library's YUI Compressor Java project. The objective of this project is to compress any Javascript and Cascading Style Sheets to an efficient level that works exactly as the original source, before it was minified.

Available via NuGet

Main Features

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

Referenced Version
Based on YUI Compressor version: 2.4.4 (last checked at 2011-01-17).

How close to the Java Port?
Pretty damn close, now :) Same unit tests (which pass).
The only thing I haven't been able to do is get the exact same obfuscation because the java code is using a hashtable instead of a sorted hashtable/dictionary. It's identical besides that (and works the same). Just visually look different but is exactly the same file size, etc.

Video Tutorials

Using YUI Compressor .NET (Core)

Using YUI Compressor .NET (MSBuild)

Using YUI Compressor .NET (Web Optimization)

(Older video) Using YUI Compressor .NET 1.7 with MSBuild

Sample MsBuild output

Who's utilising this code/library?
If you use this code in some project, please drop us a message so we can include it in this list :)

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner
HippoValidator

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Tue, 04 Dec 2012 13:07:45 GMT

Main Features

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

Using YUI Compressor .NET (Web Optimization)

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Tue, 04 Dec 2012 12:21:40 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

Using YUI Compressor .NET (Web Optimization)

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Mon, 26 Nov 2012 22:34:36 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Mon, 26 Nov 2012 22:33:36 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Mon, 26 Nov 2012 22:33:03 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Mon, 26 Nov 2012 22:24:58 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Thank You's!
We couldn't have made this project without the support of the following software:

Can’t code withoutThe best C# refactoring plugin for Visual Studio

Please support them buy trying their software. If you like it (like we do!) then purchase it. Thank you :)

Updated Wiki: Home

purekrome — Tue, 20 Nov 2012 11:56:26 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Updated Wiki: Home

purekrome — Tue, 20 Nov 2012 11:52:42 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Updated Wiki: Home

purekrome — Thu, 01 Nov 2012 12:53:35 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Updated Wiki: Home

purekrome — Thu, 01 Nov 2012 12:10:48 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Updated Wiki: Home

purekrome — Thu, 01 Nov 2012 12:09:40 GMT

Compress and/or Bundle Javascript and/or Cascading StyleSheets.
1 source file -> 1 destination file (that's just compression)
Multiple source files -> 1 destination file (compression and bundling)
Multiple source files -> multiple destination files (so you're pro at this now?!)
Optional MSBuild Tasks, NAnt Tasks and MVC4 BundleTransform.

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Updated Wiki: Home

purekrome — Wed, 17 Oct 2012 00:29:21 GMT

Stock YUI Css compression.
Stock YUI JavaScript compression.
Visual Studio post-build event intergration! :) (with detailed instructions here and the download section has a sample solution showing this)
MsBuild task which can be used in a Web Deployment Project build. (The download section has a sample solution showing this)
The MsBuild task also compiles all compressed files into a single destination file (aka. file combining).
Can now handle Encoding Types (eg. Unicode) from v1.2.2.0 onwards and ThreadCulture from v1.3.0.0 onwards.
Can handle wildcards (eg. *.js), because it uses MSBuild as the core engine :)

Referenced Version
Based on YUI Compressor version: 2.4.4 (last checked at 2011-01-17).

How close to the Java Port?
Pretty damn close, now :) Same unit tests (which pass).
The only thing I haven't been able to do is get the exact same obfuscation because the java code is using a hashtable instead of a sorted hashtable/dictionary. It's identical besides that (and works the same). Just visually look different but is exactly the same file size, etc.

Who's utilising this code/library?
If you use this code in some project, please drop us a message so we can include it in this list :)

SquishIt by Justin Etheredge
.Less (dot-less) by Christopher Owen, Erik van Brakel, Daniel Hoelbling and James Foster
Shinkansen: compress, crunch, combine, and cache JavaScript and CSS by Milan Negovan
gStyleManager
Phil Haack and his T4CSS : A T4 Template for .Less CSS With Compression
Karl Seguin (from CodeBetter fame)
StreetAdvisor.com
FUser.com
Include-Combiner

Sample Code : Css Compression

using Yahoo.Yui.Compressor;

...

string compressedCss;

// Note: string css == some cascading style sheet data loaded from some file, etc.
compressedCss = CssCompressor.Compress(css);  // No column width's specified.
compressedCss = CssCompressor.Compress(css, 73); // Column width of 73 specified,for nice reading 
                                                 //     if that's what you want.

Sample Code : JavaScript Compression

using Yahoo.Yui.Compressor;

...

string compressedJavaScript;

// Note: string javaScript == some javascript data loaded from some file, etc.
compressedJavaScript= JavaScriptCompressor.Compress(javaScript);

Sample MsBuild output

Sample MSBuild.xml file, which Visual Studio Post-build Events or Web Deployment Projects use
Read all about it here.

YouTube Video Tutorials

References
YUI Compressor home page: http://developer.yahoo.com/yui/compressor/

Updated Wiki: Documentation

freeranger — Sun, 30 Sep 2012 12:08:26 GMT

Sample MSBuild.xml File

This is an example MSBuild.xml file, which contains all the settings (both required and optional) to use msbuild.exe to compress and/or minify any casscading style sheets and/or javascript.

IMPORTANT NOTE: Please take careful note of the path locations for the following :-

AssemblyFile
SourceFiles
OutputFile (this can be defined in the xml file OR via the msbuild command line argument)

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/MsBuild/2003">
  
    <UsingTask TaskName="CssCompressorTask" AssemblyFile="..\..\MainAssemblies\Yahoo.Yui.Compressor.Build.MsBuild.dll" />
    <UsingTask TaskName="JavaScriptCompressorTask" AssemblyFile="..\..\MainAssemblies\Yahoo.Yui.Compressor.Build.MsBuild.dll" />

    <!-- Define the output locations. These can be set via the msbuild command line using
         /p:OutputFile=$(TargetDir)../whatever...
         If they are not supplied or are empty, then we the value whatever is supplied, below.
    -->

    <Target Name="Minify">
        <!--           
            For both tasks, all Properties except SourceFiles and OutputFile are optional
        
            CssCompressorTask:
                SourceFiles: An ITaskItem[] list of files to compress.
                             Add <CompressionType> meta data to individual items to override the default compression type set for the task
                DeleteSourceFiles: True | False (default).  Set True if you want to delete the source files after compressing
                CompressionType: Standard (default) | None.  None => Concatenate files only.
                EncodingType: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default (default).
                LineBreakPosition: The position where a line feed is appened when the next semicolon is reached. 
                                   Default is -1 (never add a line break).
                                   0 (zero) means add a line break after every semicolon. (This might help with debugging troublesome files).          
                LoggingType: Info (default) | Debug | None.
                PreserveComments: True | False (default).  Set True if you wish to preserve css comments.  False will remove them except ones marked with "!" 

            JavaScriptCompressorTask:
                SourceFiles: An ITaskItem[] list of files to compress.
                             Add <CompressionType> meta data to individual items to override the default compression type set for the task
                DeleteSourceFiles: True | False (default).  Set True if you want to delete the source files after compressing
                CompressionType: Standard (default) | None.  None => Concatenate files only.
                EncodingType: ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default (default).
                LineBreakPosition: The position where a line feed is appened when the next semicolon is reached. 
                                   Default is -1 (never add a line break).
                                   0 (zero) means add a line break after every semicolon. (This might help with debugging troublesome files).          
                LoggingType: Info (default) | Debug | None.  Debug also lists javascript verbose warnings, if there are any (and there usually is :P ).
                ObfuscateJavaScript: True (default) | False.  True => Obfuscate function and variable names
                PreserveAllSemicolons: True | False (default).  True => preserve redundant semicolons (e.g. after a '}'
                DisableOptimizations: True | False (default).
                ThreadCulture: The culture you want the thread to run under. This affects the treatment of numbers etc - e.g. 9.00 could be output as 9,00.
                               Default value is the Invariant Culture
                IsEvalIgnored: True | False (default).  True => compress any functions that contain 'eval'. Default is False, which means a function that contains
                               'eval' will NOT be compressed. It's deemed risky to compress a function containing 'eval'. That said,
                               if the usages are deemed safe this check can be disabled by setting this value to True.
        -->
        <ItemGroup>
            <!-- Single files, listed in order of dependency -->
            <CssFiles Include="StylesheetSample1.css"/>
            <CssFiles Include="StylesheetSample2.css"/>
            <CssFiles Include="StylesheetSample3.css">
                <CompressionType>None</CompressionType> <!-- This one will not be compressed -->
            </CssFiles>            
            <CssFiles Include="StylesheetSample4.css"/>
            
            <JavaScriptFiles Include="jquery-1.3.2.js"/>
        </ItemGroup>
 
      <CssCompressorTask
            SourceFiles="@(CssFiles)"
            DeleteSourceFiles="false"
            OutputFile="Minified.css"
            CompressionType="Standard"
            LoggingType="Info"
            PreserveComments="false"
            LineBreakPosition="-1"
       />

      <!-- The version below produces the exact same results -->
      <!--
      <CssCompressorTask
            SourceFiles="@(CssFiles)"
            OutputFile="Minified.css"
       />
       -->

      <!-- The version below will output one minified file per input css file - ie
           StylesheetSample1.css.min StylesheetSample2.css.min, and StylesheetSample3.css.min-->
      <!--
      <CssCompressorTask
            SourceFiles="@(CssFiles)"
            DeleteSourceFiles="false"
            OutputFile="%(CssFiles.Identity).min"
            CompressionType="Standard"
            LoggingType="Info"
            PreserveComments="false"
            LineBreakPosition="-1"
      />
      -->
      
      <JavaScriptCompressorTask
          SourceFiles="@(JavaScriptFiles)"
          DeleteSourceFiles="false"
          OutputFile="Minified.js"
          CompressionType="Standard"
          ObfuscateJavaScript="True"
          PreserveAllSemicolons="False"
          DisableOptimizations="No"
          EncodingType="Default"
          LineBreakPosition="-1"
          LoggingType="Info"
          ThreadCulture="en-au"
          IsEvalIgnored="false"
            />

      <!-- The version below produces the exact same results -->
      <!--
      <JavaScriptCompressorTask
          SourceFiles="@(JavaScriptFiles)"
          DeleteSourceFiles="false"
          OutputFile="Minified.js"
       />
       -->
    </Target>
</Project>

Updated Wiki: Sample MSBuild.xml File

freeranger — Fri, 21 Sep 2012 06:58:57 GMT

Sample MSBuild.xml File

** This documentation is out of date and being updated - please download the latest source code and look at the Example web project there **

This is an example MSBuild.xml file, which contains all the settings (both required and optional) to use msbuild.exe to compress and/or minify any casscading style sheets and/or javascript.

IMPORTANT NOTE: Please take careful note of the path locations for the following :-

AssemblyFile
JavaScriptFiles
JavaScriptOutputFile (this can be defined in the xml file OR via the msbuild command line argument)
CssFiles
CssOutputFile (this can be defined in the xml file OR via the msbuild command line argument)

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/MsBuild/2003">
    <UsingTask
        TaskName="CompressorTask"
        AssemblyFile="<the path to the dll...>\Yahoo.Yui.Compressor.Build.MsBuild.dlll" />

    <!-- Define the output locations. These can be set via the msbuild command line using
         /p:SourceLocation="$(ProjectDir)"
         /p:CssOutputFile=$(ProjectDir)../whatever...
         /p:JavaScriptOutputFile=$(ProjectDir)../whatever...
         
         If they are not supplied or are empty, then we the value whatever is supplied, below.
    -->
    <PropertyGroup>
        <CssOutputFile Condition=" '$(CssOutputFile)'=='' ">SylesSheetFinal.css</CssOutputFile>
        <JavaScriptOutputFile Condition=" '$(JavaScriptOutputFile)'=='' ">JavaScriptFinal.js</JavaScriptOutputFile>
    </PropertyGroup>
    
    
    <Target Name="MyTaskTarget">
        <!--
            ItemGroup\CssFiles or ItemGroup\JavaScriptFiles: add zero to many files you wish to include in this compression task.
                                                             Don't forget, you can use the wildcard (eg. *.css, *.js) if you feel up to it.
                                                             Finally, at least one item is required - either a css file or a js file.
                                                             
            CssFiles/JavaScriptFiles data format: Please do not touch this.
            DeleteCssFiles: [Optional] True | Yes | Yeah | Yep | True | FoSho | Fo Sho. Default is False. Anything else is False. (eg. blah = false, xxxx111 = false, etc)
            CssCompressionType: YuiStockCompression | MichaelAshsRegexEnhancements | HaveMyCakeAndEatIt or BestOfBothWorlds or Hybrid; Default is YuiStockCompression.
            ObfuscateJavaScript: [Optional] refer to DeleteCssFiles, above.
            PreserveAllSemicolons: [Optional] refer to DeleteCssFiles, above.
            DisableOptimizations: [Optional] refer to DeleteCssFiles, above.
            EncodingType: [Optional] ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default. Default is 'Default'.
            DeleteJavaScriptFiles: [Optional] refer to DeleteCssFiles, above.
            LineBreakPosition: [Optional] the position where a line feed is appened when the next semicolon is reached. Default is -1 (never add a line break).
                               0 (zero) means add a line break after every semicolon. (This might help with debugging troublesome files).          
            LoggingType: None | ALittleBit | HardcoreBringItOn;  Hardcore also lists javascript verbose warnings, if there are any (and there usually is :P ).
            ThreadCulture: [Optional] the culture you want the thread to run under. Default is 'en-gb'.
            IsEvalIgnored: [Optional] compress any functions that contain 'eval'. Default is False, which means a function that contains
                           'eval' will NOT be compressed. It's deemed risky to compress a function containing 'eval'. That said,
                           if the usages are deemed safe this check can be disabled by setting this value to True.
            PreserveCssComments: [Optional] refer to DeleteCssFiles, above.
        -->
        <ItemGroup>
            <!-- Single files, listed in order of dependency -->
            <CssFiles Include="$(SourceLocation)StylesheetSample1.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample2.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample3.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample4.css"/>
            
            <JavaScriptFiles Include=$(SourceLocation)"jquery-1.3.2.js"/>
            
            <!-- All the files. They will be handled (I assume) in alphabetically. -->
            <!-- <CssFiles Include="$(SourceLocation)*.css" />
            <JavaScriptFiles Include="$(SourceLocation)*.js" />
            -->
            
        </ItemGroup>
        <CompressorTask
            CssFiles="@(CssFiles)"
            DeleteCssFiles="false"
            CssOutputFile="$(CssOutputFile)"
            CssCompressionType="YuiStockCompression"
            JavaScriptFiles="@(JavaScriptFiles)"
            ObfuscateJavaScript="True"
            PreserveAllSemicolons="False"
            DisableOptimizations="Nope"
            EncodingType="Default"
            DeleteJavaScriptFiles="false"
            LineBreakPosition="-1"
            JavaScriptOutputFile="$(JavaScriptOutputFile)"
            LoggingType="ALittleBit"
            ThreadCulture="en-au"
            IsEvalIgnored="false"
            />
    </Target>
</Project>

Updated Wiki: Visual Studio Post-build Event example

freeranger — Fri, 21 Sep 2012 06:58:22 GMT

How to use Visual Studio's Post-build Event with YUI Compressor for .NET

** This documentation is out of date and being updated - please download the latest source code and look at the Example web project there **

It's possible to take advantage of Visual Studio's Post-build events to compress and/or minify any casscading style sheets and/or javascript after a successful build.

Personally, I would recommend this for RELEASE configurations but you can do this under any configuration type (eg. DEBUG, RELEASE and custom types).

Note: You can modify the steps below to add other custom actions, like removing the msbuild folder after build, etc. This is not explained in this wiki page ... and is left for you to research :P

Step 1 - Create an MSBuild xml file which creates all the settings. Here is an example xml file with sample settings.

Step 2 - Make a folder where we will place all the MSBuild stuff. Place the xml file and the 2 dependant dll's in the same folder.

Step 3 - Modify the web project Build settings. Please take note of

/p:CssOutputFile
/p:JavaScriptOutputFile
$(TargetDir) <-- you might wish to change this if you have another destination directory.

Step 4 - Build away :)

New Comment on "Visual Studio Post-build Event example"

manitra — Mon, 02 Jul 2012 12:46:40 GMT

Ok, This documentation is totally outdated. Absolutely nothing here is working since the version 2.0 : - CompressorTask is now Abstract so you cannot invoke it directly (btw: thanks to msbuild to NOT mention that and stick with a stupid message like "Cannot load task") - There are 2 separate task 'JavaScriptCompressorTask' and 'CssCompressorTask' - The parameters have changed (@JavaScriptFiles is not supported anymore) Please, guys update this page, I've just spent 2 full hours trying to make this to work.

Updated Wiki: Documentation

purekrome — Thu, 28 Jun 2012 05:24:25 GMT

Note: This documentation relates to the 1.X version. Documentation for 2.X, still a work in progress, can be found in the example projects that form part of the current source tree. !

This page will be updated with 2.X documentation once that is released. !

AssemblyFile
JavaScriptFiles
JavaScriptOutputFile (this can be defined in the xml file OR via the msbuild command line argument)
CssFiles
CssOutputFile (this can be defined in the xml file OR via the msbuild command line argument)

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/MsBuild/2003">
    <UsingTask
        TaskName="CompressorTask"
        AssemblyFile="<the path to the YUIC.Net MSBuild dll>/Yahoo.Yui.Compressor.Build.MsBuild.dll" />

    <!-- Define the output locations. These can be set via the msbuild command line using
         /p:SourceLocation="$(ProjectDir)"
         /p:CssOutputFile=$(ProjectDir)../whatever...
         /p:JavaScriptOutputFile=$(ProjectDir)../whatever...
         
         If they are not supplied or are empty, then we the value whatever is supplied, below.
    -->
    <PropertyGroup>
        <CssOutputFile Condition=" '$(CssOutputFile)'=='' ">SylesSheetFinal.css</CssOutputFile>
        <JavaScriptOutputFile Condition=" '$(JavaScriptOutputFile)'=='' ">JavaScriptFinal.js</JavaScriptOutputFile>
    </PropertyGroup>
    
    
    <Target Name="MyTaskTarget">
        <!--
            ItemGroup\CssFiles or ItemGroup\JavaScriptFiles: add zero to many files you wish to include in this compression task.
                                                             Don't forget, you can use the wildcard (eg. *.css, *.js) if you feel up to it.
                                                             Finally, at least one item is required - either a css file or a js file.
                                                             
            CssFiles/JavaScriptFiles data format: Please do not touch this.
            DeleteCssFiles: [Optional] True | Yes | Yeah | Yep | True | FoSho | Fo Sho. Default is False. Anything else is False. (eg. blah = false, xxxx111 = false, etc)
            CssCompressionType: YuiStockCompression | MichaelAshsRegexEnhancements | HaveMyCakeAndEatIt or BestOfBothWorlds or Hybrid | None;  Default is YuiStockCompression.  None => Concatenate files only
            JavaScriptCompressionType: YuiStockCompression | None;  Default is YuiStockCompression.  None => Concatenate files only
            ObfuscateJavaScript: [Optional] refer to DeleteCssFiles, above.
            PreserveAllSemicolons: [Optional] refer to DeleteCssFiles, above.
            DisableOptimizations: [Optional] refer to DeleteCssFiles, above.
            EncodingType: [Optional] ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default. Default is 'Default'.
            DeleteJavaScriptFiles: [Optional] refer to DeleteCssFiles, above.
            LineBreakPosition: [Optional] the position where a line feed is appened when the next semicolon is reached. Default is -1 (never add a line break).
                               0 (zero) means add a line break after every semicolon. (This might help with debugging troublesome files).          
            LoggingType: None | ALittleBit | HardcoreBringItOn;  Hardcore also lists javascript verbose warnings, if there are any (and there usually is :P ).
            ThreadCulture: [Optional] the culture you want the thread to run under. Default is 'en-gb'.
            IsEvalIgnored: [Optional] compress any functions that contain 'eval'. Default is False, which means a function that contains
                           'eval' will NOT be compressed. It's deemed risky to compress a function containing 'eval'. That said,
                           if the usages are deemed safe this check can be disabled by setting this value to True.
            PreserveCssComments: [Optional] refer to DeleteCssFiles, above.
        -->
        <ItemGroup>
            <!-- Single files, listed in order of dependency -->
            <CssFiles Include="$(SourceLocation)StylesheetSample1.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample2.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample3.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample4.css"/>
            
            <JavaScriptFiles Include=$(SourceLocation)"jquery-1.3.2.js"/>
            
            <!-- All the files. They will be handled (I assume) in alphabetically. -->
            <!-- <CssFiles Include="$(SourceLocation)*.css" />
            <JavaScriptFiles Include="$(SourceLocation)*.js" />
            -->
            
        </ItemGroup>
        <CompressorTask
            CssFiles="@(CssFiles)"
            DeleteCssFiles="false"
            CssOutputFile="$(CssOutputFile)"
            CssCompressionType="YuiStockCompression"
            JavaScriptCompressionType="YuiStockCompression"
            JavaScriptFiles="@(JavaScriptFiles)"
            ObfuscateJavaScript="True"
            PreserveAllSemicolons="False"
            DisableOptimizations="Nope"
            EncodingType="Default"
            DeleteJavaScriptFiles="false"
            LineBreakPosition="-1"
            JavaScriptOutputFile="$(JavaScriptOutputFile)"
            LoggingType="ALittleBit"
            ThreadCulture="en-au"
            IsEvalIgnored="false"
            />
    </Target>
</Project>

Updated Wiki: Sample MSBuild.xml File

purekrome — Thu, 28 Jun 2012 05:22:48 GMT

AssemblyFile
JavaScriptFiles
JavaScriptOutputFile (this can be defined in the xml file OR via the msbuild command line argument)
CssFiles
CssOutputFile (this can be defined in the xml file OR via the msbuild command line argument)

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/MsBuild/2003">
    <UsingTask
        TaskName="CompressorTask"
        AssemblyFile="<the path to the dll...>\Yahoo.Yui.Compressor.Build.MsBuild.dlll" />

    <!-- Define the output locations. These can be set via the msbuild command line using
         /p:SourceLocation="$(ProjectDir)"
         /p:CssOutputFile=$(ProjectDir)../whatever...
         /p:JavaScriptOutputFile=$(ProjectDir)../whatever...
         
         If they are not supplied or are empty, then we the value whatever is supplied, below.
    -->
    <PropertyGroup>
        <CssOutputFile Condition=" '$(CssOutputFile)'=='' ">SylesSheetFinal.css</CssOutputFile>
        <JavaScriptOutputFile Condition=" '$(JavaScriptOutputFile)'=='' ">JavaScriptFinal.js</JavaScriptOutputFile>
    </PropertyGroup>
    
    
    <Target Name="MyTaskTarget">
        <!--
            ItemGroup\CssFiles or ItemGroup\JavaScriptFiles: add zero to many files you wish to include in this compression task.
                                                             Don't forget, you can use the wildcard (eg. *.css, *.js) if you feel up to it.
                                                             Finally, at least one item is required - either a css file or a js file.
                                                             
            CssFiles/JavaScriptFiles data format: Please do not touch this.
            DeleteCssFiles: [Optional] True | Yes | Yeah | Yep | True | FoSho | Fo Sho. Default is False. Anything else is False. (eg. blah = false, xxxx111 = false, etc)
            CssCompressionType: YuiStockCompression | MichaelAshsRegexEnhancements | HaveMyCakeAndEatIt or BestOfBothWorlds or Hybrid; Default is YuiStockCompression.
            ObfuscateJavaScript: [Optional] refer to DeleteCssFiles, above.
            PreserveAllSemicolons: [Optional] refer to DeleteCssFiles, above.
            DisableOptimizations: [Optional] refer to DeleteCssFiles, above.
            EncodingType: [Optional] ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default. Default is 'Default'.
            DeleteJavaScriptFiles: [Optional] refer to DeleteCssFiles, above.
            LineBreakPosition: [Optional] the position where a line feed is appened when the next semicolon is reached. Default is -1 (never add a line break).
                               0 (zero) means add a line break after every semicolon. (This might help with debugging troublesome files).          
            LoggingType: None | ALittleBit | HardcoreBringItOn;  Hardcore also lists javascript verbose warnings, if there are any (and there usually is :P ).
            ThreadCulture: [Optional] the culture you want the thread to run under. Default is 'en-gb'.
            IsEvalIgnored: [Optional] compress any functions that contain 'eval'. Default is False, which means a function that contains
                           'eval' will NOT be compressed. It's deemed risky to compress a function containing 'eval'. That said,
                           if the usages are deemed safe this check can be disabled by setting this value to True.
            PreserveCssComments: [Optional] refer to DeleteCssFiles, above.
        -->
        <ItemGroup>
            <!-- Single files, listed in order of dependency -->
            <CssFiles Include="$(SourceLocation)StylesheetSample1.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample2.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample3.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample4.css"/>
            
            <JavaScriptFiles Include=$(SourceLocation)"jquery-1.3.2.js"/>
            
            <!-- All the files. They will be handled (I assume) in alphabetically. -->
            <!-- <CssFiles Include="$(SourceLocation)*.css" />
            <JavaScriptFiles Include="$(SourceLocation)*.js" />
            -->
            
        </ItemGroup>
        <CompressorTask
            CssFiles="@(CssFiles)"
            DeleteCssFiles="false"
            CssOutputFile="$(CssOutputFile)"
            CssCompressionType="YuiStockCompression"
            JavaScriptFiles="@(JavaScriptFiles)"
            ObfuscateJavaScript="True"
            PreserveAllSemicolons="False"
            DisableOptimizations="Nope"
            EncodingType="Default"
            DeleteJavaScriptFiles="false"
            LineBreakPosition="-1"
            JavaScriptOutputFile="$(JavaScriptOutputFile)"
            LoggingType="ALittleBit"
            ThreadCulture="en-au"
            IsEvalIgnored="false"
            />
    </Target>
</Project>

Updated Wiki: Sample MSBuild.xml File

purekrome — Thu, 28 Jun 2012 05:15:54 GMT

AssemblyFile
JavaScriptFiles
JavaScriptOutputFile (this can be defined in the xml file OR via the msbuild command line argument)
CssFiles
CssOutputFile (this can be defined in the xml file OR via the msbuild command line argument)

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/MsBuild/2003">
    <UsingTask
        TaskName="CompressorTask"
        AssemblyFile="<the path to the dll...>\Yahoo.YUI.Compressor.MsBuildTask.dll" />

    <!-- Define the output locations. These can be set via the msbuild command line using
         /p:SourceLocation="$(ProjectDir)"
         /p:CssOutputFile=$(ProjectDir)../whatever...
         /p:JavaScriptOutputFile=$(ProjectDir)../whatever...
         
         If they are not supplied or are empty, then we the value whatever is supplied, below.
    -->
    <PropertyGroup>
        <CssOutputFile Condition=" '$(CssOutputFile)'=='' ">SylesSheetFinal.css</CssOutputFile>
        <JavaScriptOutputFile Condition=" '$(JavaScriptOutputFile)'=='' ">JavaScriptFinal.js</JavaScriptOutputFile>
    </PropertyGroup>
    
    
    <Target Name="MyTaskTarget">
        <!--
            ItemGroup\CssFiles or ItemGroup\JavaScriptFiles: add zero to many files you wish to include in this compression task.
                                                             Don't forget, you can use the wildcard (eg. *.css, *.js) if you feel up to it.
                                                             Finally, at least one item is required - either a css file or a js file.
                                                             
            CssFiles/JavaScriptFiles data format: Please do not touch this.
            DeleteCssFiles: [Optional] True | Yes | Yeah | Yep | True | FoSho | Fo Sho. Default is False. Anything else is False. (eg. blah = false, xxxx111 = false, etc)
            CssCompressionType: YuiStockCompression | MichaelAshsRegexEnhancements | HaveMyCakeAndEatIt or BestOfBothWorlds or Hybrid; Default is YuiStockCompression.
            ObfuscateJavaScript: [Optional] refer to DeleteCssFiles, above.
            PreserveAllSemicolons: [Optional] refer to DeleteCssFiles, above.
            DisableOptimizations: [Optional] refer to DeleteCssFiles, above.
            EncodingType: [Optional] ASCII, BigEndianUnicode, Unicode, UTF32, UTF7, UTF8, Default. Default is 'Default'.
            DeleteJavaScriptFiles: [Optional] refer to DeleteCssFiles, above.
            LineBreakPosition: [Optional] the position where a line feed is appened when the next semicolon is reached. Default is -1 (never add a line break).
                               0 (zero) means add a line break after every semicolon. (This might help with debugging troublesome files).          
            LoggingType: None | ALittleBit | HardcoreBringItOn;  Hardcore also lists javascript verbose warnings, if there are any (and there usually is :P ).
            ThreadCulture: [Optional] the culture you want the thread to run under. Default is 'en-gb'.
            IsEvalIgnored: [Optional] compress any functions that contain 'eval'. Default is False, which means a function that contains
                           'eval' will NOT be compressed. It's deemed risky to compress a function containing 'eval'. That said,
                           if the usages are deemed safe this check can be disabled by setting this value to True.
            PreserveCssComments: [Optional] refer to DeleteCssFiles, above.
        -->
        <ItemGroup>
            <!-- Single files, listed in order of dependency -->
            <CssFiles Include="$(SourceLocation)StylesheetSample1.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample2.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample3.css"/>
            <CssFiles Include="$(SourceLocation)StylesheetSample4.css"/>
            
            <JavaScriptFiles Include=$(SourceLocation)"jquery-1.3.2.js"/>
            
            <!-- All the files. They will be handled (I assume) in alphabetically. -->
            <!-- <CssFiles Include="$(SourceLocation)*.css" />
            <JavaScriptFiles Include="$(SourceLocation)*.js" />
            -->
            
        </ItemGroup>
        <CompressorTask
            CssFiles="@(CssFiles)"
            DeleteCssFiles="false"
            CssOutputFile="$(CssOutputFile)"
            CssCompressionType="YuiStockCompression"
            JavaScriptFiles="@(JavaScriptFiles)"
            ObfuscateJavaScript="True"
            PreserveAllSemicolons="False"
            DisableOptimizations="Nope"
            EncodingType="Default"
            DeleteJavaScriptFiles="false"
            LineBreakPosition="-1"
            JavaScriptOutputFile="$(JavaScriptOutputFile)"
            LoggingType="ALittleBit"
            ThreadCulture="en-au"
            IsEvalIgnored="false"
            />
    </Target>
</Project>