merged with ckald

Author: imsamurai

README.md

@@ -1,4 +1,5 @@
-## pushState + ajax / hash navigation + ajax / hash navigation + ajax + form ajax + get forms parameters in address = pjax with normal fallback!
+# pjax with normal fallback!
+## pushState, hash-navigation, ajax forms, interchangeable url formats and other remarkable features
 
             .--.
            /    \
@@ -27,7 +28,7 @@ I hope, you'll enjoy mix of pushState and regular #!/hash navigation.
 
 Some features and changes:
 
-*    IE 7,8 support (maybe some others)
+*    IE7+, FF4+ and all modern browsers (if it works on some not mentioned ancient browser – please let me know `[email protected]`)
 *    mix of html5-like navigation and old-school #!/hashes
 *    i added most of ';' in lines of code for you :]. for some reason, defunkt didn't use them, but it was strange for me
 *    links from both kinds of browsers are interchangable
@@ -37,10 +38,27 @@ Some bad news:
 *    you HAVE to put some settings before using: 
 
 ```js
-$.siteurl = 'http://yousite.com';
+$.hash = '#!/';
+$.siteurl = 'http://yoursite.com';
 $.container = '#pjaxcontainer';
 ```
 
+`$.hash` is a string, which appeares is url, when browser doesn't support pushState. So, by default, url of page changes from http://yoursite.com/this/is/awesome/article to http://yoursite.com/#!/this/is/awesome/article and pjax sends request to server with first url. 
+
+Links are interchangable – so if someone with modern browser gets old-style link http://yoursite.com/#!/page – he would be redirected to http://yoursite.com/page and vice versa.
+
+## And what about SEO?
+
+All we know, most part of AJAX-enabled sites have issues with search engine crawlers – their links are basically not parsable because of `#`. But we can handle it at least with Google!
+
+Default `$.hash` value is meaningful and hopely would be parsed in future by all major search engine crawlers. All you need – set up some custom routing on your server: if crawler meets link like http://yoursite.com/#!/some/path/on/site, he sends request to http://yoursite.com/?_escaped_fragment_=/some/path/on/site and parses it.
+
+For more information: 
+
+*   http://googlewebmastercentral.blogspot.com/2009/10/proposal-for-making-ajax-crawlable.html
+*   http://code.google.com/intl/ru-RU/web/ajaxcrawling/docs/specification.html
+
+
 ## What was it?
 
 Pjax loads HTML from your server into the current page
@@ -190,6 +208,14 @@ def my_page
 end
 ```
 
+One more Rails example by slayerhabr (http://slayerhabr.habrahabr.ru/)
+
+```ruby
+class ApplicationController < ActionController::Base
+   layout Proc.new { |controller| request.headers['X-PJAX'] ? false : 'application' }
+end
+```
+
 Django: <https://github.com/jacobian/django-pjax>
 
 Asp.Net MVC3: <http://biasecurities.com/blog/2011/using-pjax-with-asp-net-mvc3/>
@@ -252,4 +278,4 @@ Then, in your HTML:
 ```
 
 Replace `path/to/js` with the path to your JavaScript directory,
-e.g. `public/javascripts`.
+e.g. `public/javascripts`.