wiselinks-artirix 1.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d5d1c19dda93dd6246e051028014a9b2d332150d
+  data.tar.gz: 4925057deeea5b143c1603845d6bb4c182d55a07
+SHA512:
+  metadata.gz: 8bce94811c1e2467724656dd4d29bb3165a05ae9ab32945b1515e215d4bfafb36ab804b2791404de6cd8d5d2dfe84c8ea94537150e3d8147ebf59f679d61f13c
+  data.tar.gz: 1064045c52ca69342348acfc7641fec2cb64a0aaaae9e696ec16b3b88f38c955fe9fe5f27c2947703772014637a4c05ac6c0e4f38f96a2465092a992625ad327

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,51 @@
+# rcov generated
+coverage
+coverage.data
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+spec/dummy/log/test.log
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+#*.swp
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc

data/.rspec

@@ -0,0 +1,2 @@
+--format nested
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,7 @@
+if system('ping -c1 gemcache.ldn.uk.office.artirix.com >/dev/null 2>&1')
+  source 'http://gemcache.ldn.uk.office.artirix.com'
+else
+  source 'https://rubygems.org'
+end
+
+gemspec name: 'wiselinks-artirix'

data/Gemfile.lock

@@ -0,0 +1,184 @@
+PATH
+  remote: .
+  specs:
+    wiselinks-artirix (1.3.0)
+
+GEM
+  remote: http://gemcache.ldn.uk.office.artirix.com/
+  specs:
+    actionmailer (3.2.16)
+      actionpack (= 3.2.16)
+      mail (~> 2.5.4)
+    actionpack (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.5)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.16)
+      activesupport (= 3.2.16)
+      builder (~> 3.0.0)
+    activerecord (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
+    activesupport (3.2.16)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
+    addressable (2.3.5)
+    arel (3.0.3)
+    builder (3.0.4)
+    capybara (2.2.1)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    closure-compiler (1.1.10)
+    coffee-rails (3.2.2)
+      coffee-script (>= 2.2.0)
+      railties (~> 3.2.0)
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.6.3)
+    coffeelint (0.1.3)
+      coffee-script
+      json
+    coveralls (0.7.0)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
+    crack (0.4.1)
+      safe_yaml (~> 0.9.0)
+    diff-lcs (1.2.5)
+    docile (1.1.2)
+    erubis (2.7.0)
+    execjs (2.0.2)
+    factory_girl (4.3.0)
+      activesupport (>= 3.0.0)
+    faker (1.2.0)
+      i18n (~> 0.5)
+    hike (1.2.3)
+    i18n (0.6.9)
+    journey (1.0.4)
+    json (1.8.1)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.25.1)
+    mini_portile (0.5.2)
+    multi_json (1.8.4)
+    nokogiri (1.6.1)
+      mini_portile (~> 0.5.0)
+    polyglot (0.3.3)
+    rack (1.4.5)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.3)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (3.2.16)
+      actionmailer (= 3.2.16)
+      actionpack (= 3.2.16)
+      activerecord (= 3.2.16)
+      activeresource (= 3.2.16)
+      activesupport (= 3.2.16)
+      bundler (~> 1.0)
+      railties (= 3.2.16)
+    railties (3.2.16)
+      actionpack (= 3.2.16)
+      activesupport (= 3.2.16)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.1.1)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    rspec-rails (2.14.1)
+      actionpack (>= 3.0)
+      activemodel (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    safe_yaml (0.9.7)
+    shoulda (3.5.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (>= 1.4.1, < 3.0)
+    shoulda-context (1.1.6)
+    shoulda-matchers (2.5.0)
+      activesupport (>= 3.0.0)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sqlite3 (1.3.8)
+    term-ansicolor (1.2.2)
+      tins (~> 0.8)
+    thor (0.18.1)
+    tilt (1.4.1)
+    tins (0.13.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.38)
+    webmock (1.9.3)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  capybara
+  closure-compiler
+  coffee-rails
+  coffeelint
+  coveralls
+  factory_girl
+  faker
+  rails (~> 3.2.13)
+  rake
+  rspec
+  rspec-rails
+  shoulda
+  simplecov
+  sqlite3
+  webmock (~> 1.9.0)
+  wiselinks-artirix!
+
+BUNDLED WITH
+   1.10.6

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Igor Alexandrov, Alexey Solilin and Julia Egorova
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,479 @@
+[![Build Status](https://travis-ci.org/igor-alexandrov/wiselinks.png)](https://travis-ci.org/igor-alexandrov/wiselinks)
+[![Code Climate](https://codeclimate.com/github/igor-alexandrov/wiselinks.png)](https://codeclimate.com/github/igor-alexandrov/wiselinks)
+[![Coverage Status](https://coveralls.io/repos/igor-alexandrov/wiselinks/badge.png)](https://coveralls.io/r/igor-alexandrov/wiselinks)
+[![Dependency Status](https://gemnasium.com/igor-alexandrov/wiselinks.png)](https://gemnasium.com/igor-alexandrov/wiselinks)
+[![Gem Version](https://badge.fury.io/rb/wiselinks.png)](http://badge.fury.io/rb/wiselinks)
+
+
+#Wiselinks
+
+Wiselinks makes following links and submitting forms in your web application faster.
+
+You may find Wiselinks similar to [Turbolinks](https://github.com/rails/turbolinks) or [Pjax](https://github.com/defunkt/jquery-pjax), but Wiselinks works as a whitelist rather than blacklist. We tried to make Wiselinks as easy to use as Turbolinks are but also as configurable as Pjax.
+
+Try Wiselinks online in our **demo application**:
+
+ * [http://wiselinks.herokuapp.com/](http://wiselinks.herokuapp.com/)
+
+## Compatibility
+
+**Please be advised that Javascript events in wiselinks-0.5.0 are not backward compatible.**
+
+Wiselinks uses [History.js](https://github.com/balupton/History.js/) library to perform requests.
+
+Wiselinks works in all major browsers including browsers that do not support HTML History API out of the box.
+
+## In Comparison to Turbolinks and PJAX
+
+<table>
+	<thead>
+		<tr>
+			<th></th>
+			<th>Wiselinks</th>
+			<th>Turbolinks</th>
+			<th>PJAX</th>
+		</tr>
+	</thead>
+	<tbody>
+		<tr>
+			<td>Work in HTML5 browsers</td>
+			<td><strong>Yes</strong></td>
+			<td>Yes</td>
+			<td>Yes</td>
+		</tr>
+		<tr>
+			<td>Work in browsers without History API</td>
+			<td><strong>Yes</strong>, with hashbang (can be switched off)</td>
+			<td>No, degrades to normal request processing</td>
+			<td>No, degrades to normal request processing</td>
+		</tr>
+		<tr>
+			<td>Work without JavaScript</td>
+			<td>No, degrades to normal request processing</td>
+			<td>No, degrades to normal request processing</td>
+			<td>No, degrades to normal request processing</td>
+		</tr>
+		<tr>
+			<td>Form processing</td>
+			<td><strong>Yes</strong></td>
+			<td>No</td>
+			<td>Yes (experimental feature)</td>
+		</tr>
+		<tr>
+			<td>Form blank values exclusion</td>
+			<td><strong>Yes</strong> (optional)</td>
+			<td>No</td>
+			<td>No</td>
+		</tr>
+		<tr>
+			<td>Form values optimization</td>
+			<td><strong>Yes</strong></td>
+			<td>No</td>
+			<td>No</td>
+		</tr>
+		<tr>
+			<td>Assets change detection</td>
+			<td><strong>Yes</strong>, by calculating assets MD5 hash on boot</td>
+			<td>Yes, by parsing document head on every request</td>
+			<td>Yes, manually</td>
+		</tr>
+		<tr>
+			<td>30x HTTP redirects processing</td>
+			<td><strong>Yes</strong></td>
+			<td>No</td>
+			<td>Yes</td>
+		</tr>
+	</tbody>
+</table>
+
+##Installation
+
+### Rails
+
+Add this to your Gemfile:
+
+```ruby
+gem 'wiselinks'
+```
+
+Then do:
+
+	bundle install
+
+Restart your server and you're now using wiselinks!
+
+### All others
+
+Copy `wiselinks-x.y.z.js` or `wiselinks-x.y.z.min.js` from `build` folder in this project to your project.
+
+## How does it work?
+
+### CoffeeScript
+
+Create Wiselinks object in your `application.js.coffee`:
+
+```coffeescript
+#= require jquery
+#= require wiselinks
+
+$(document).ready ->
+    window.wiselinks = new Wiselinks()
+```
+
+You can disable HTML4 browsers support easily:
+
+```coffeescript
+#= require jquery
+#= require wiselinks
+
+$(document).ready ->
+    window.wiselinks = new Wiselinks($('body'), html4: false )
+```
+
+
+Or you can add some more options, if you want:
+
+```coffeescript
+#= require jquery
+#= require jquery.role
+#= require wiselinks
+
+$(document).ready ->
+    # DOM element with id = "content" will be replaced after data load.
+    window.wiselinks = new Wiselinks($('#content'))
+
+	$(document).off('page:loading').on(
+        'page:loading'
+        (event, $target, render, url) ->
+            console.log("Loading: #{url} to #{$target.selector} within '#{render}'")
+            # code to start loading animation
+    )
+
+	$(document).off('page:redirected').on(
+        'page:redirected'
+        (event, $target, render, url) ->
+            console.log("Redirected to: #{url}")
+            # code to start loading animation
+    )
+
+	$(document).off('page:always').on(
+        'page:always'
+        (event, xhr, settings) ->
+            console.log("Wiselinks page loading completed")
+            # code to stop loading animation
+    )
+
+    $(document).off('page:done').on(
+        'page:done'
+        (event, $target, status, url, data) ->
+            console.log("Wiselinks status: '#{status}'")
+    )
+
+    $(document).off('page:fail').on(
+        'page:fail'
+        (event, $target, status, url, error, code) ->
+            console.log("Wiselinks status: '#{status}'")
+            # code to show error message
+    )
+```
+
+### HTML
+
+Click on links with `data-push` attribute will fire History.pushState() event.
+Data from the request will replace content of the container that was passed to Wiselinks (default is `$('body')`)
+
+
+```html
+<ul class="menu">
+    <li>
+	    <a href="/" data-push="true">Home</a>
+    </li>
+    <li>
+   		<a href="/contacts" data-push="true">Contacts</a>
+    </li>
+</ul>
+```
+
+Click on links with `data-replace` will fire History.replaceState() event.
+Data from the request will replace content of the container that was passed to Wiselinks (default is "body")
+
+```html
+<div class="dialog">
+	<a href="/step2" data-replace="true">Proceed to the next step</a>
+</div>
+```
+
+Click on following links will fire History.pushState() event.
+Data from the request will be pasted into `<div id="catalog">`. This configuration is widely when you have list of items that are paginated, sorted or maybe grouped by some attributes and you want to update only these items and nothing more on page.
+
+```html
+<ul class="pagination">
+    <li>
+	    <span>1</span>
+    </li>
+    <li>
+   		<a href="/?page=2" data-push="true" data-target="#catalog">2</a>
+    </li>
+    <li>
+   		<a href="/?page=3" data-push="true" data-target="#catalog">3</a>
+    </li>
+    <li>
+   		<a href="/?page=4" data-push="true" data-target="#catalog">4</a>
+    </li>
+</ul>
+
+<ul class="sort">
+	<li>
+	    <a href="/?sort=title" data-push="true" data-target="#catalog">Sort by Title</a>
+    </li>
+    <li>
+   		<a href="/?sort=price" data-push="true" data-target="#catalog">Sort by Price</a>
+    </li>
+</ul>
+
+<div id="catalog">
+	<!-- the list of your items -->
+	...
+</div>
+```
+
+**Form processing**
+
+Wiselinks can process forms. After submit button is clicked, Wiselinks will perform a request to form url with form attributes serialized to a string. Wiselinks always performs a HTTP GET request.
+
+```html
+<div class="filter">
+    <form action="/" method="get" data-push="true" data-target="@catalog">
+		<input type="text" size="30" name="title" id="title">
+
+		<select name="scope" id="scope">
+			<option value="">All Tax Liens</option>
+			<option value="accruing">Accruing Interest</option>
+          	<option value="awaiting_payment">Awaiting Payment</option>
+          	<option value="closed">Closed</option>
+          	<option value="trashed">Trash</option>
+    	</select>
+
+		<input type="submit" value="Find" name="commit">
+    </form>
+</div>
+
+<div role="catalog">
+	<!-- the list of your items -->
+	...
+</div>
+```
+**data-include-blank-url-params**
+
+During form submit Wiselinks excludes blank parameters to make your URLs cleaner. You can disable this behaviour with ```data-include-blank-url-params``` attribute.
+
+```html
+<div class="filter">
+    <form action="/" method="get" data-push="true" data-target="@catalog" data-include-blank-url-params="true">
+		<input type="text" size="30" name="title" id="title">
+		<input type="submit" value="Find" name="commit">
+    </form>
+</div>
+```
+
+**data-optimize-url-params**
+
+Array parameters ```category_ids[]=1&category_ids[]=2&category_ids[]=3``` are optimized to more human readable ```category_ids=1,2,3```. To changed this behaviour use ```data-optimize-url-params``` attribute.
+
+```html
+<div class="filter">
+    <form action="/" method="get" data-push="true" data-target="@catalog" data-optimize-url-params="false">
+		<input type="text" size="30" name="title" id="title">
+		<input type="submit" value="Find" name="commit">
+    </form>
+</div>
+```
+
+
+### Server processing
+
+The idea of Wiselinks is that you should render only content that you need in current request. Usually you don't need to reload your stylesheets and javascripts on every request.
+
+`X-Wiselinks` header is passed with every Wiselinks request. Server should respond with content that should be inserted into `$target`.
+
+In Rails after installing Wiselinks gem, all requests that have `X-Wiselinks` header will be automatically processed within 'app/views/layouts/wiselinks' layout, that basically has only `yield` operator. Of course you can override layout name by redefining `wiselinks_layout` method in your controller.
+
+### Javascript Events
+
+While using Wiselinks you **can rely** on `DOMContentLoaded` or `jQuery.ready()` to trigger your JavaScript code, but Wiselinks gives you some additional useful event to deal with the lifecycle of the page:
+
+**page:loading ($target, render, url)**
+
+Event is triggered before the `XMLHttpRequest` is initialised and performed.
+* *$target* – JQuery object in which result of the request will be inserted;
+
+* *url* - URL of the request that will be performed;
+
+* *render* – what should be rendered; can be 'template' or 'partial';
+
+**page:redirected ($target, render, url)**
+
+Event is triggered when you were redirected during `XMLHttpRequest` (with HTTP 30x status).
+* *$target* – jQuery object in which result of the request will be inserted;
+
+* *url* - URL where you have been redirected to;
+
+* *render* – what should be rendered; can be 'template' or 'partial';
+
+**page:done ($target, status, url, data)**
+
+Event is triggered if the request succeeds.
+* *$target* – jQuery object that was updated with the request;
+
+* *status* – a string describing the status;
+
+* *url* – url of the request;
+
+* *data* – content of the request;
+
+**page:fail ($target, status, url, error, code)**
+
+Event is triggered if the request fails.
+
+* *$target* – jQuery object that had to be updated with the request;
+
+* *status* – a string describing the status;
+
+* *url* – url of the request;
+
+* *error* – a string describing the type of error that occurred;
+
+* *code* – HTTP response status code
+
+**page:always ($target, status, url)**
+
+Event is triggered after each request.
+
+* *$target* – jQuery object that had to be updated with the request;
+
+* *status* – a string describing the status;
+
+* *url* – url of the request;
+
+So if you want to show a client-side loading spinner, you could listen for `page:loading` to start it and `page:always` to stop it.
+
+### ActionDispatch::Request extensions
+
+Wiselinks adds a couple of methods to `ActionDispatch::Request`. These methods are mostly syntax sugar and don't have any complex logic, so you can use them or not.
+
+#### #wiselinks? ###
+Method returns `true` if current request is initiated by Wiselinks (has `X-Wiselinks` header), `false` otherwise.
+
+#### #wiselinks_template? ###
+Method returns `true` if current request is initiated by Wiselinks and client want to render template (`X-Wiselinks != 'partial'`), `false` otherwise.
+
+#### #wiselinks_partial? ###
+Method returns `true` if current request is initiated by Wiselinks and client want to render partial (`X-Wiselinks == 'partial'`), `false` otherwise.
+
+### Assets change detection
+
+You can enable assets change detection with Wiselinks. To do this you have to enable assets digests by adding this to you environment file:
+
+```ruby
+config.assets.digest = true
+```
+
+Then you should append your layout by adding this to head section:
+
+```erb
+<%= wiselinks_meta_tag %>
+```
+
+Now Wiselinks will track changes of your assets and if anything will change, your page will be reloaded completely.
+
+### Title handling
+
+Wiselinks handles page titles by passing `X-Wiselinks-Title` header with response. To set this header you can use `wiselinks_title` helper (in Rails).
+
+```html
+<% wiselinks_title("Wiselinks is awesome") %>
+
+<div>
+	<!-- your content -->
+	...
+</div>
+```
+
+Of course you can use `wiselinks_title` helper in your own helpers too.
+
+### Redirect handling
+
+Wiselinks follows 30x HTTP redirects. Location is updated in browser with `X-Wiselinks-Url` header that is setting up automatically (in Rails) on every wiselinks request.
+
+### Target missing handling
+
+By default, if Wiselinks cannot find target that you specified during initialization, it will fail silently. But you can override this behaviour:
+
+```coffeescript
+#= require jquery
+#= require wiselinks
+
+$(document).ready ->
+    window.wiselinks = new Wiselinks(
+      $('something that does not exist'),
+      target_missing: 'exception'
+    )
+```
+
+`[Wiselinks] Target missing` exception will be thrown. This also works for `data-target` attributes.
+
+
+### Google Analytics and Yandex Metrika
+
+If you want to handle these analytics tools, then you should add handler to `page:done` event.
+
+Let's say, that you have two objects, first is `_gaq` – instance of Google Analytics, second is `_metrika` – instance of Yandex Metrika. Then you have to add the following code somewhere in your `application.js.coffee`.
+
+```coffeescript
+$(document).off('page:done').on(
+  'page:done'
+  (event, $target, status, url, data) ->
+    _gaq.push(['_trackPageview', url])
+    _metrika.hit(url)
+)
+```
+
+After this, you will have correct page view statistics in your analytics tools.
+
+
+## Example
+
+We crafted example application that uses nearly all features of Wiselinks so you can see it in action.
+
+* GitHub Repository: [https://github.com/igor-alexandrov/wiselinks_example](https://github.com/igor-alexandrov/wiselinks_example)
+
+* Live Example: [http://wiselinks.herokuapp.com/](http://wiselinks.herokuapp.com/)
+
+## Note on Patches / Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Credits
+
+![JetRockets](http://www.jetrockets.ru/jetrockets.png)
+
+Wiselinks is maintained by [JetRockets](http://www.jetrockets.ru).
+
+Contributors:
+
+* [Igor Alexandrov](http://igor-alexandrov.github.com/)
+* [Alexey Solilin](https://github.com/solilin)
+* [Julia Egorova](https://github.com/vankiru)
+* [Alexandr Borisov](https://github.com/aishek)
+
+## License
+
+It is free software, and may be redistributed under the terms specified in the LICENSE file.
+