combres Wiki & Documentation Rss Feed

Updated Wiki: Documentation

buunguyen — Mon, 10 Dec 2012 19:00:53 GMT

Note: Combres is now hosted in Github

Updated Wiki: Documentation

buunguyen — Mon, 10 Dec 2012 19:00:30 GMT

Combres is now hosted in Github

Updated Wiki: Documentation

buunguyen — Mon, 10 Dec 2012 19:00:18 GMT

Combres is now hosted in Github

Read this first

5-Minute Quick Start

Combres in depth

Change Notes

Updated Wiki: Home

buunguyen — Mon, 10 Dec 2012 18:49:53 GMT

Note: Combres is now hosted in Github

New Comment on "5-Minute Quick Start"

darkking86 — Wed, 28 Nov 2012 06:41:03 GMT

This is what I really need and looking for many times. Good job ;)

Updated Wiki: Home

buunguyen — Tue, 04 Sep 2012 04:50:16 GMT

Note: since Combres 2.1, new releases are distributed only via NuGet (see instruction in 5-Minute Quick Start). If you don't want to use NuGet, you have to build from source.

Project Description

.NET library which enables minification, compression, combination, and caching of JavaScript and CSS resources for ASP.NET and ASP.NET MVC web applications. Simply put, it helps your applications rank better with YSlow and PageSpeed.

Many web developers are probably aware of various website optimization techniques described in this Yahoo Developer Network article and/or Steve Souders' book. Most of these techniques are very simple, yet bring about huge difference to the downloading time of most web pages. As simple as they are, applying some of these rules again and again in all .NET web applications can easily become a tedious task. Combres automates many steps that you would have to do yourself when applying many optimization techniques in your ASP.NET MVC and Web Form applications.

Using Combres

Want to get started immediately? Refer to 5-Minute Quick Start. For more information, refer to documentation.

Contact

Follow me on Twitter to receive updates about Combres.

New Comment on "5-Minute Quick Start"

delpak — Sat, 16 Jun 2012 14:49:41 GMT

All in One Solution! It s Great!

Updated Wiki: Home

buunguyen — Fri, 27 Apr 2012 01:31:58 GMT

Note: since Combres 2.1, new releases are distributed only via NuGet (see instruction in 5-Minute Quick Start). If you don't want to use NuGet, you have to build from source.

Project Description

Using Combres

Want to get started immediately? Refer to 5-Minute Quick Start. For more information, refer to documentation.

Updated Wiki: Home

buunguyen — Fri, 27 Apr 2012 01:31:42 GMT

Note: since Combres 2.1, new releases are distributed only via NuGet (see instruction in 5-Minute Quick Start). If you don't want to use NuGet, you have to build from source.

Project Description

Using Combres

Want to get started immediately? Refer to 5-Minute Quick Start. For more information, refer to documentation.

New Comment on "5-Minute Quick Start"

Yillb — Sat, 18 Feb 2012 02:04:03 GMT

Hi, just wanted to add this since it was driving me crazy today. Using the Nuget package for a webforms site kept resulting in combres.axd being 404. Tried a MVC site and that worked. Kept trying different webforms sites and nothing. Try adding WebFormRouteHandler.cs (http://combres.codeplex.com/SourceControl/changeset/view/fecb3ce12157#Samples%2fWebFormSample%2fWebFormRouteHandler.cs) found in the webforms sample to your site. I added that and no more 404. Hope it helps anyone else.

Updated Wiki: Home

buunguyen — Mon, 08 Aug 2011 08:26:08 GMT

Project Description

Using Combres

Want to get started immediately? Refer to 5-Minute Quick Start. For more information, refer to documentation.

Note: since Combres 2.1, new releases are distributed only via NuGet (see instruction in 5-Minute Quick Start). If you don't want to use NuGet, you have to build from source.

Updated Wiki: 5-Minute Quick Start

buunguyen — Thu, 27 Jan 2011 05:36:01 GMT

Install from NuGet

Download & install NuGet Package Manager extension for VS.NET 2010
Open your project in VS.NET 2010
Open the Package Manager Console (Tools > Library Package Manager > Package Manager Console)
In the command window:
- If you work with ASP.NET MVC: enter Install-Package Combres.Mvc
- If you work with ASP.NET WebForm: enter Install-Package Combres

Register Route
This step is only necessary for ASP.NET 3.5 users. ASP.NET 4.0 users can skip to the next step. This step is necessary because there's currently no way to generate/transform/reference different code/config/assemblies for different .NET runtimes with NuGet.

Delete the generated file AppStart_Combres.cs
Remove the reference to the assembly WebActivator
Open global.asax code-behind file
- Import Combres namespace, i.e. using Combres;
- Add this to the first line of either RegisterRoutes() or Application_Start(): RouteTable.Routes.AddCombresRoute("Combres");

Modify Combres.xml

Open App_Data/Combres.xml (this should be auto-created when you install the Combres NuGet package)
Add/remove resource sets, resources etc. as per your need. See this article for more information.

Reference to Combres' resource sets in view

Open any view page (e.g. master page) which need to reference JS/CSS resource sets defined in Combres.xml
Add the followings:

<%= WebExtensions.CombresLink("siteCss") %>  
<%= WebExtensions.CombresLink("siteJs") %>

Notes:

Change the values of the arguments to match the names you use in Combres.xml
If you use ASP.NET MVC, you can replace WebExtensions with Html or Url (you need to import Combres.Mvc namespace instead of Combres namespace)
If you use Razor view engine, you need to add @using Combres or @using Combres.Mvc explicitly (if you want to configure in web.config, read this post)

Updated Wiki: 5-Minute Quick Start

buunguyen — Thu, 27 Jan 2011 04:49:11 GMT

Install from NuGet

Download & install NuGet Package Manager extension for VS.NET 2010
Open your project in VS.NET 2010
Open the Package Manager Console (Tools > Library Package Manager > Package Manager Console)
In the command window:
- If you work with ASP.NET MVC: enter Install-Package Combres.Mvc
- If you work with ASP.NET WebForm: enter Install-Package Combres

Modify Combres.xml

Open App_Data/Combres.xml (this should be auto-created when you install the Combres NuGet package)
Add/remove resource sets, resources etc. as per your need. See this article for more information.

Reference to Combres' resource sets in view

Open any view page (e.g. master page) which need to reference JS/CSS resource sets defined in Combres.xml
Add the followings:

<%= WebExtensions.CombresLink("siteCss") %>  
<%= WebExtensions.CombresLink("siteJs") %>

Notes:

Change the values of the arguments to match the names you use in Combres.xml
If you use ASP.NET MVC, you can replace WebExtensions with Html or Url (you need to import Combres.Mvc namespace instead of Combres namespace)
If you use Razor view engine, you need to add @using Combres or @using Combres.Mvc explicitly (if you want to configure in web.config, read this post)

Updated Wiki: 5-Minute Quick Start for the Impatient

buunguyen — Thu, 27 Jan 2011 03:00:53 GMT

This page has been moved here 5-Minute Quick Start (sorry, can't auto redirect).

Updated Wiki: 5-Minute Quick Start for the Impatient

buunguyen — Thu, 27 Jan 2011 03:00:39 GMT

This page has been moved here 5-Minute Quick Start (sorry, can't auto redirect).

Updated Wiki: 5-Minute Quick Start

buunguyen — Thu, 27 Jan 2011 02:58:49 GMT

Install from NuGet

Download & install NuGet Package Manager extension for VS.NET 2010
Open your project in VS.NET 2010
Open the Package Manager Console (Tools > Library Package Manager > Package Manager Console)
In the command window:
- If you work with ASP.NET MVC: enter Install-Package Combres.Mvc
- If you work with ASP.NET WebForm: enter Install-Package Combres

Configure Combres route

Open global.asax's code-behind file
Import Combres namespace:

using Combres;

Add this to the first line of {Application_Start() or RegisterRoutes():

RouteTable.Routes.AddCombresRoute("Combres");

Modify Combres.xml

Open App_Data/Combres.xml (this should be auto-created when you install the Combres NuGet package)
Add/remove resource sets, resources etc. as per your need. See this article for more information.

Reference to Combres' resource sets in view

Open any view page (e.g. master page) which need to reference JS/CSS resource sets defined in Combres.xml
Add the followings:

<%@ Import Namespace="Combres" %>
<%= WebExtensions.CombresLink("siteCss") %>  
<%= WebExtensions.CombresLink("siteJs") %>

Notes:

Change the values of the arguments to match the names you use in Combres.xml
If you use ASP.NET MVC, you can replace WebExtensions with Html or Url (you need to import Combres.Mvc namespace instead of Combres namespace)

Optional: Using Local-Closure minifier
Combres goes with several excellent minifiers like YUI and MS Ajax, so people probably don't have much reason to use the local-closure minifier, which usually has poorer performance because Combres needs to invoke it out of process. That said, if you want to use local-closure minifier, simply download compiler.jar and copy it to the bin folder of your application

Optional: Working with MVC 3.0
Combres.Mvc.dll is built against MVC 2.0 because it doesn't need any feature of MVC 3.0. If you're building MVC 3.0 app and your development/production machines have both MVC 2.0 and MVC 3.0, then you don't have to do anything for Combres.Mvc to work. However, if the machines only have MVC 3.0 installed, you need to add the following to web.config to tell Combres to accept MVC 3.0 assembly instead:

<configuration>
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <dependentAssembly xmlns="">
                <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
                <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="3.0.0.0" />
            </dependentAssembly>
        </assemblyBinding>
    </runtime>
</configuration>

That should be it. Start your browser and view source to observe Combres in action.

Updated Wiki: 5-Minute Quick Start

buunguyen — Thu, 27 Jan 2011 02:55:26 GMT

Install from NuGet

Download & install NuGet Package Manager extension for VS.NET 2010
Open your project in VS.NET 2010
Open the Package Manager Console (Tools > Library Package Manager > Package Manager Console)
In the command window:
- If you work with ASP.NET MVC: enter Install-Package Combres.Mvc
- If you work with ASP.NET WebForm: enter Install-Package Combres

Configure Combres route

Open global.asax's code-behind file
Import Combres namespace:

using Combres;

Add this to the first line of {Application_Start() or RegisterRoutes():

RouteTable.Routes.AddCombresRoute("Combres");

Modify Combres.xml

Open App_Data/Combres.xml (this should be auto-created when you install the Combres NuGet package)
Add/remove resource sets, resources etc. as per your need. See this article for more information.

Reference to Combres' resource sets in view

Open any view page (e.g. master page) which need to reference JS/CSS resource sets defined in Combres.xml
Add the followings:

<%@ Import Namespace="Combres" %>
<%= WebExtensions.CombresLink("siteCss") %>  
<%= WebExtensions.CombresLink("siteJs") %>

Notes:

Change the values of the arguments to match the names you use in Combres.xml
If you use ASP.NET MVC, you can replace WebExtensions with Html or Url (you need to import Combres.Mvc namespace instead of Combres namespace)

Optional: follow this step only if you use the Local-Closure minifier

Download compiler.jar and copy it to the bin folder of your application

Optional: Working with MVC 3.0
Combres.Mvc.dll is built against MVC 2.0 because it doesn't need any feature of MVC 3.0. If you're building MVC 3.0 app and your development/production machines have both MVC 2.0 and MVC 3.0, then you don't have to do anything for Combres.Mvc to work. However, if the machines only have MVC 3.0 installed, you need to add the following to web.config to tell Combres to accept MVC 3.0 assembly instead:

<configuration>
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <dependentAssembly xmlns="">
                <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
                <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="3.0.0.0" />
            </dependentAssembly>
        </assemblyBinding>
    </runtime>
</configuration>

That should be it. Start your browser and view source to observe Combres in action.

Updated Wiki: 5-Minute Quick Start

buunguyen — Thu, 27 Jan 2011 02:54:25 GMT

Install from NuGet

Download & install NuGet Package Manager extension for VS.NET 2010
Open your project in VS.NET 2010
Open the Package Manager Console (Tools > Library Package Manager > Package Manager Console)
In the command window:
- If you work with ASP.NET MVC: enter Install-Package Combres.Mvc
- If you work with ASP.NET WebForm: enter Install-Package Combres

Configure Combres route

Open global.asax's code-behind file
Import Combres namespace:

using Combres;

Add this to the first line of {Application_Start() or RegisterRoutes():

RouteTable.Routes.AddCombresRoute("Combres");

Modify Combres.xml

Open App_Data/Combres.xml (this should be auto-created when you install the Combres NuGet package)
Add/remove resource sets, resources etc. as per your need. See this article for more information.

Reference to Combres' resource sets in view

Open any view page (e.g. master page) which need to reference JS/CSS resource sets defined in Combres.xml
Add the followings:

<%@ Import Namespace="Combres" %>
<%= WebExtensions.CombresLink("siteCss") %>  
<%= WebExtensions.CombresLink("siteJs") %>

Notes:

Change the values of the arguments to match the names you use in Combres.xml
If you use ASP.NET MVC, you can replace WebExtensions with Html or Url (you need to import Combres.Mvc namespace instead of Combres namespace)

Optional: follow this step only if you use the Local-Closure minifier

Download compiler.jar and copy it to the bin folder of your application

Optional: Combres.Mvc is built against MVC 2.0 because it doesn't need any feature of MVC 3.0. If you're building MVC 3.0 app, and your development/production machines have both MVC 2.0 and MVC 3.0, then it should just work. But if the machines only have MVC 3.0 installed, you need to add the following to web.config to tell Combres to accept MVC 3.0 assembly instead:

<configuration>
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <dependentAssembly xmlns="">
                <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
                <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="3.0.0.0" />
            </dependentAssembly>
        </assemblyBinding>
    </runtime>
</configuration>

That should be it. Start your browser and view source to observe Combres in action.

Updated Wiki: 5-Minute Quick Start

buunguyen — Tue, 25 Jan 2011 07:24:30 GMT

Install from NuGet

Download & install NuGet Package Manager extension for VS.NET 2010
Open your project in VS.NET 2010
Open the Package Manager Console (Tools > Library Package Manager > Package Manager Console)
In the command window:
- If you work with ASP.NET MVC: enter Install-Package Combres.Mvc
- If you work with ASP.NET WebForm: enter Install-Package Combres

Configure Combres route

Open global.asax's code-behind file
Import Combres namespace:

using Combres;

Add this to the first line of {Application_Start() or RegisterRoutes():

RouteTable.Routes.AddCombresRoute("Combres");

Modify Combres.xml

Open App_Data/Combres.xml (this should be auto-created when you install the Combres NuGet package)
Add/remove resource sets, resources etc. as per your need. See this article for more information.

Reference to Combres' resource sets in view

Open any view page (e.g. master page) which need to reference JS/CSS resource sets defined in Combres.xml
Add the followings:

<%@ Import Namespace="Combres" %>
<%= WebExtensions.CombresLink("siteCss") %>  
<%= WebExtensions.CombresLink("siteJs") %>

Notes:

Change the values of the arguments to match the names you use in Combres.xml
If you use ASP.NET MVC, you can replace WebExtensions with Html or Url (you need to import Combres.Mvc namespace instead of Combres namespace)

Optional: follow this step only if you use the Local-Closure minifier

Download compiler.jar and copy it to the bin folder of your application

That should be it. Start your browser and view source to observe Combres in action.

Updated Wiki: Documentation

buunguyen — Tue, 25 Jan 2011 06:52:17 GMT

Read this first

5-Minute Quick Start

Combres in depth

Change Notes