Introduction

This package provides modules for transliteration of names from Greek and Latin writing systems into our modern Roman writing system following conventions of the Classical Atlas Project.

Examples:

>>> from pleiades.transliteration import transliterate_name

Roma in Latin

>>> transliterate_name('la', 'Roma')
'Roma'

Choma in Greek with Latin transliteration (pretend it's ancient!)

>>> transliterate_name('grc-latn', 'Choma')
'Choma'

Aphrodisias in Greek

>>> name = u'\u1f08\u03c6\u03c1\u03bf\u03b4\u03b5\u03b9\u03c3\u03b9\u03b5\u03cd\u03c2'
>>> transliterate_name('grc', name)
'Aphrodeisieus'

Aphrodisiensis in Greek characters (no accents)

>>> name = u'\u1f08\u03c6\u03c1\u03bf\u03b4\u03b9\u03c3\u03b9\u03b5\u03bd\u03c3\u03b9\u03c2'
>>> transliterate_name('la-grek', name)
'Aphrodisiensis'

Invalid script

>>> transliterate_name('en', 'Ryland') # doctest: +ELLIPSIS
Traceback (most recent call last):
...
ValueError: Unsupported writing system (en)

Editorial characters that should be permitted

>>> transliterate_name('la', '(...)sinsensium')
'(...)sinsensium'

Out-of-range characters that shouldn't be there if the validator was used first. Aphrodisias in Greek but mis-languaged as latin

>>> name = u'\u1f08\u03c6\u03c1\u03bf\u03b4\u03b9\u03c3\u03b9\u1f71\u03c2'
>>> transliterate_name('la', name.encode('utf-8'))
'??????????'