Metadata-Version: 1.1
Name: unicode-slugify-latin
Version: 0.2
Summary: A slug generator that turns strings into unicode slugs, and enables replacement for common latin letters into ascii representations.
Home-page: http://github.com/eminbugrasaral/unicode-slugify-latin
Author: Emin Bugra Saral
Author-email: eminbugrasaral@me.com
License: BSD
Description: [![Build Status](https://travis-ci.org/eminbugrasaral/unicode-slugify-latin.svg?branch=master)](https://travis-ci.org/eminbugrasaral/unicode-slugify-latin)
        
        # Unicode Slugify (with Latin Hack)
        
        Unicode Slugify is a slugifier that generates unicode slugs.  It was originally
        used in the Firefox Add-ons web site to generate slugs for add-ons and add-on
        collections.  Many of these add-ons and collections had unicode characters and
        required more than simple transliteration.
        
        ## Install
        
            pip install unicode-slugify-latin
        
        ## Usage
        
            >>> import slugify
        
            >>> slugify.slugify(u'Bän...g (bang)')
            u'bäng-bang'
        
        ## Latin Hack
        
        - Replaces special Latin chars with similar ascii representations.
        - Problem: I want users who speak Latin languages with English keyboards to be able to search through my Latin strings.
        - Solution: Slugify that Latin string by enabling Latin replacement, and match this string with the slugified search word.
        - Example: Strore "Sabancı Üniversitesi" as "sabanci-universitesi" and then users will be able to search with any combination like "Sabanci", "Sabancı" and "SABANCI".
        - Note: Do not forget to slugify both strings with replace_latin=True
        
        ## Example
        
            >>> from slugify import slugify
        
            >>> string_without_latin_letters = slugify(u'ıspanaklı boğaz turşusu', replace_latin=True)
            u'ispanakli-bogaz-tursusu'
        
            >>> slugify(u'Ispanakli Bogaz Tursusu') == string_without_latin_letters
            True
        
            >>> u'Bogazici'.lower() in slugify(u'boğaziçi', replace_latin=True)
            True
            
            >>> slugify(u'çiçek', replace_turkish=True) in slugify(u'ÇİÇEK', replace_latin=True)
            True
            
            >>> u'cicek' in slugify(u'ÇİÇEK', replace_latin=True)
            True
        
        ## List of common latin letters to be replaced
        
        - ı, ì, í, î, ï -> i
        - İ, Ì, Í, Î, Ï -> I
        - ö, ó, ò, ô, õ, ø -> o
        - Ö, Ò, Ó, Ô, Õ, Ø -> O
        - ü, ù, ú, û -> u
        - Ü, Ù, Ú, Û -> U
        - à, á, â, ã, ä, å -> a
        - À, Á, Â, Ã, Ä, Å -> A
        - æ -> ae
        - Æ -> AE
        - è, é, ê, ë -> e
        - È, É, Ê, Ë -> E
        - ñ -> n
        - Ñ -> N
        - ý, ÿ -> y
        - Ý, Ÿ -> Y
        - ş -> s
        - Ş -> S
        - ç -> c
        - Ç -> C
        - ğ -> g
        - Ğ -> G
        
        ## New parameters after this fork
        
        - replace_latin: Replace common Latin letters to be replaced with similar ascii representation.
        - unicode_pairs: You can give a dictionary of unicode characters with their replacement values. Like: {u'\xe9', 'e'} - é will be replaced with e
        
        ## Sponsors
        
        - This library is being used in The Volt Ride Sharing App (http://thevoltapp.com)
        - Hippo Foundry (http://hipolabs.com)
        
        ## Contact
        
        - Website: http://www.eminbugrasaral.com
        
Keywords: turkish,latin,unicode,slugify,letter,char,replace,replacement,ascii,django
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Environment :: Web Environment :: Mozilla
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Django
