This package provides a library and a protocol to create slugs for given strings.
By default, a slug will be containing only chars A-Za-z0-9
and the default seperator -
.
Using the library is straightforward, check out a few examples:
iex(1)> Slugger.slugify " A b C "
"A-b-C"
iex(2)> Slugger.slugify_downcase " A b C "
"a-b-c"
iex(3)> Slugger.slugify "A cool title of a blog post"
"A-cool-title-of-a-blog-post"
iex(4)> Slugger.slugify "Wikipedia Style", ?_
"Wikipedia_Style"
Next to the library, a protocol is provided to ease creating slugs for own data structures.
By default, the protocol will try to run Slugger.slugify(Kernel.to_string(your_data))
, so if your_data
implements String.Chars
, the returned string will be slugified.
If you want to provide a own way to create a slug, check out the following example:
iex(10)> defmodule User do
...(10)> defstruct name: "Julius Beckmann"
...(10)> end
iex(11)> defimpl Slugify, for: User do
...(11)> def slugify(user), do: Slugger.slugify(user.name)
...(11)> end
iex(12)> Slugify.slugify %User{}
"Julius-Beckmann"
Special chars like äöüéáÁÉ
will be replaced by rules given in the file lib/replacements.exs.
Modify that file if you need have own replacement rules and recompile.