node-parameterize
=================
This repository adds node.js and npm support for [parameterize](http://apidock.com/rails/String/parameterize) which is originally used in Ruby on Rails. It replaces special characters in a string so that it may be used as part of a 'pretty' URL.

parameterize.js is a port of django admin [urlify.js](https://github.com/django/django/blob/master/django/contrib/admin/static/admin/js/urlify.js)

Installing
--------------------------------
npm install parameterize

 
Supports
--------------------------------
Turkish
Azerbaijani
Serbian
Greek
Georgian
Russian
Ukranian
Czech
Polish
Romanian
Latvanian
Lithuanian 
Arabic
Latin special chars


Require
--------------------------------
```javascript
var parameterize = require('parameterize');
```


Using
--------------------------------
```javascript
parameterize('parameterized url with special characters, öçıŞÇ');
// outputs
// parameterized-url-with-special-characters-ocisc
```

```javascript
// using optional length limit
parameterize('this is a long text', 10);
// outputs
// this-is-a-l
```

```javascript
// you can change delimiter character
parameterize('this is a long text', 10, '_');
// outputs
// this_is_a_l
```

Using in express.js 3 view files as view helper
--------------------------------

You can implement it as in the example just below in your app.js file so that you can use it in all views. Note that it should be before the line 'app.use(app.router)'.

app.configure
--------------------------------

```javascript
  app.use(function(req, res, next) {
    res.locals.parameterize = parameterize
    next();
  });
  
  app.use(app.router);
```


using with jade template engine
----
index.jade

```html
#{parameterize('parameterized url with special characters, öçıŞÇ')}
// output:
// parameterized-url-with-special-characters-ocisc
```


using with ejs template engine
---
index.ejs

```ejs
<% parameterize('parameterized url with special characters, öçıŞÇ') %>
// parameterized-url-with-special-characters-ocisc
```