post for recap

Author: shiftbot

_layouts/layout.html

@@ -11,6 +11,7 @@
 		<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
 		<title>{% if page.title != "code52" %}{{ page.title }} - code52{% else %}{{ page.title }}{% endif %}</title>
 		<link rel="stylesheet" type="text/css" href="/css/style20120128.css" />
+		<link rel="stylesheet" type="text/css" href="/css/nuget-button.min.css" />
 		<link rel="shortcut icon" href="/img/favicon.ico" />
 		<script id="contributorTemplate" type="text/x-jQuery-tmpl">
 		{% literal %}

_posts/2012-02-27-i18n-recap.md

@@ -0,0 +1,103 @@
+--- 
+layout: post
+permalink: /internationalization-recap.html
+date: 2012-03-05 22:00
+title: "Recap: i18n Packages for MVC4"
+author: "@aeoth, @shiftkey and @tobin"
+comments: true
+---
+
+Rather than boring you with the details of how this week went - it was quiet, then chaotic towards the end - I thought I'd run you through the packages you can install today and see the hard work done.
+
+These packages are split up so that users can pull in the features that they want in their applications, but if you want to start with a new application you can get started quickly.
+
+<div style="width: 700px">
+<div class="nuget-button-commandWrapper">
+	<div class="nuget-button-commandPrompt">
+		<p class="nuget-button-command">PM&gt; Install-Package <a href="http://nuget.org/List/Packages/Code52.i18n">Code52.i18n</a></p></div></div>
+</div>
+
+The core package contains a helper class for mapping a locale code to a CultureInfo object, with additional helper methods to identify culture-related information.
+
+This also includes a config transform to enable globalization on your website.
+
+<div style="width: 700px">
+<div class="nuget-button-commandWrapper">
+	<div class="nuget-button-commandPrompt">
+		<p class="nuget-button-command">PM&gt; Install-Package <a href="http://nuget.org/List/Packages/Code52.i18n.MVC4">Code52.i18n.MVC4</a></p></div></div>
+</div>
+
+<div style="width: 700px">
+<div class="nuget-button-commandWrapper">
+	<div class="nuget-button-commandPrompt">
+		<p class="nuget-button-command">PM&gt; Install-Package <a href="http://nuget.org/List/Packages/Code52.i18n.MVC3">Code52.i18n.MVC3</a></p></div></div>
+</div>
+
+These packages extend the core and allow a user to override their current region inside your application. There are two pieces to this:
+
+ * A ```LanguageController``` to handle requests from the browser and set a cookie value.
+ * A ```LanguageFilterAttribute``` set globally to detect the cookie and set the culture for the current user to a different value.
+
+<div style="width: 700px">
+<div class="nuget-button-commandWrapper">
+	<div class="nuget-button-commandPrompt">
+		<p class="nuget-button-command">PM&gt; Install-Package <a href="http://nuget.org/List/Packages/Code52.i18n.MVC4.Example.Razor">Code52.i18n.MVC4.Example.Razor</a></p></div></div>
+</div>
+
+<div style="width: 700px">
+<div class="nuget-button-commandWrapper">
+	<div class="nuget-button-commandPrompt">
+		<p class="nuget-button-command">PM&gt; Install-Package <a href="http://nuget.org/List/Packages/Code52.i18n.MVC3.Example.Razor">Code52.i18n.MVC3.Example.Razor</a></p></div></div>
+</div>
+
+These are the sample sites which have controllers, views and resources all ready to go. It is recommended that you install these into a **Blank** MVC Project as that's the scenarios we've been testing currently.
+
+Cool features:
+
+ * jQuery.globalize support
+ * ModelMetadataProvider using [Phil Haack's)[http://haacked.com] [ConventionalModelMetadataProvider](http://haacked.com/archive/2011/07/14/model-metadata-and-validation-localization-using-conventions.aspx) POC.
+
+## 10 Second Introduction
+
+A very quick walkthrough after installing the example site package. You should see a page resembling this:
+
+ ![](/img/i18n-1.png)
+
+*Start the application and you'll see the label in the top-left with your current language.*
+
+ ![](/img/i18n-2.png)
+
+ *Click on it to slide down a selector with the available languages.*
+
+ ![](/img/i18n-3.png)
+
+ *Pick one and the cookie gets set, reloads the page, and displays the new language.*
+
+A special shout-out to [David Christiansen](http://twitter.com/dchristiansen) who has been a great help this week with his tips and tricks like the above.
+
+## Want to try it out? There be dragons.
+
+Warning: this may drown puppies and kick kittens. Please log any and all feedback you have on the [GitHub site](https://github.com/Code52/internationalization-mvc4/issues) - this is still under active development.
+
+Add this feed to your NuGet Package Source settings: http://www.myget.org/F/Code52 - this contains the latest builds from tonight's integration work.
+
+We'll let you know (by pushing the packages to NuGet officially and tweeting) when its stabilised and ready for general use.
+
+**Note:** Please read the App_Readme before diving straight in - you need to change the _ViewStart.cshtml file to point at the different template:
+
+    @{
+        Layout = "~/Views/Shared/_Layout.Code52.cshtml";
+    }
+
+
+## But wait, there's more?
+
+There's a lot more to this story - we timed it when we thought we'd get a lot of interest (sadly that didn't eventuate), and I know there are people keen to get involved.
+
+ * Pseudoizer - the build has the ability to generate test resources so you can verify the localization of a site, but we haven't got this integrated into a project.
+ * DateTimeOffsetModelBinder - this has been started in [a fork](https://github.com/shiftkey/internationalization-mvc4/tree/ModelBinder-DateTimeOffset), but requires some polishing before we can merge it in to master.
+ * NuGet - the packages are generated from a build script, and there's some things we'd like to do that require some more Powershell skills and understanding the hooks available in ```install.ps1```. For example, pointing _ViewStart.cshtml to use a custom layout page rather than the default.
+ * Support for other versions/view engines/languages.
+ * Improved styles for the project templates - unfortunately the blank project templates are a bit plain...
+
+As we had a lot of interest in this idea, and the number of features still available to implmenet, I hope this is just the beginning.