parameterize

node-parameterize
=================
This repository adds node.js and npm support for 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

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
``