Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для URL, имени файла, имени объекта в каком-то софте и тд. Требования совместимости простые: в тексте должны быть только допустимые символы. Обычно это a-z, 0-9 и "_" или "-". То есть, только прописные буквы латинского алфавита и цифры (как пример).
Допустим, нам нужно название статьи в блоге преобразовать в slug для добавления его в URL этой статьи. Как это лучше всего сделать?
В Django по умолчанию есть готовая функция slugify для таких случаев.
Но я её никогда не использую. Почему? Потому что её недостаточно!
Приведём пример
>>> from django.utils.text import slugify
>>> slugify('This is a Title')
'this-is-a-title'
Пока всё отлично
>>> slugify('This is a "Title!"')
'this-is-a-title'
Спец символы удалились, всё хорошо.
>>> slugify('Это заголовок статьи')
''
Вот и приехали 😢. Если текст не английский то буквы просто игнорируются. Можно это поправить
>>> slugify('Это заголовок статьи', allow_unicode=True)
'это-заголовок-статьи'
Но тогда мы не вписываемся в условие. У нас появилась кириллица в тексте.
Так как я часто пишу сайты для русскоязычных пользователей эта проблема весьма актуальна. Я не использую стандартную функцию и всегда пишу свою.
Оригинал я не беру в расчёт и пишу полностью свою функцию. И так, по порядку:
🔸1. Исходный текст:
>>> text = 'Мой заголовок №10 😁!'
Взял специально посложней со специальными символами.
🔸2. Транслит
Необходимо сделать транслит всех символов в латиницу. Здесь очень выручает библиотека unidecode. Помимо простого транслита кириллицы в латиницу она умеет преобразовывать спец символы и иероглифы в текстовые аналоги.
from unidecode import unidecode
>>> unidecode("Ñ Σ ® µ ¶ ¼ 月 山")
'N S (r) u P 1/4 Yue Shan'
Очень крутая библиотека, советую👍
В нашем случае получаем такое преобразование:
>>> text = unidecode(text)
>>> print(text)
'Moi zagolovok No. 10 !'
Отличный транслит. Смайл просто удалился, хотя я ждал что-то вроде :). Ну и ладно, всë равно невалидные символы.
А еще наш код уже поддерживает любой язык, будь то хинди или корейский.
🔸4. Фильтр символов
Unidecode не занимается фильтрацией по недопустимым символам. Это мы делаем в следующем шаге через regex. Просто заменим все символы на "_" если они вне указанного диапазона.
>>> text = re.sub(r'[^a-zA-Z0-9]+', '_', text)
>>> print(text)
'Moi_zagolovok_No_10_'
Символ "+" в паттерне выручает когда несколько недопустимых символов идут рядом. Все они заменяются на один символ "_".
🔸5. Slugify
Осталось удалить лишние символы по краям и сделать нижний регистр
>>> text = text.strip('_').lower()
>>> print(text)
'moi_zagolovok_no_10'
Получаем отличный slug! 😎
🌎 Полный код в виде функции.
______________
PS. Проверку что в строке остался хоть один допустимый символ я бы вынес в отдельную функцию.
#libs#tricks#django
《薄伽梵金刚持实证传承:Aogula坛城与一切续部集密法藏之震动密钥》
༄༅། །བཅོམ་ལྡན་འདས་རྡོ་རྗེ་འཆང་དངོས་གྲུབ་བརྒྱུད་པ། ། ཨོ་འགུ་ལ་དཀྱིལ་འཁོར་གསང་འདུས་ཆོས་མཛོད་ཀྱི་གཡོ་འགུལ་ལྡེ་མིག་ཅེས་བྱ་བ་བཞུགས་སོ། །
《薄伽梵金刚持实证传承:Aogula坛城与一切续部集密法藏之震动密钥》
The Direct Experience Lineage of Bhagavan Vajradhara: The Vibrational Key to the Aogula Mandala and the Guhyasamaja Treasury of All Tantras.
༄༅།། ན་མོ་གུ་རུ་བཛྲ་དྷཱ་རཱ་ཡ། ། 顶礼上师金刚持!
Namo Guru Vajradharaya. 纳摩 咕如 哇嘉RA 达RA呀!
རྡོ་རྗེ་འཆང་གི་དངོས་གྲུབ་ལམ། ། དཀྱིལ་འཁོར་བྱེ་བ་མཆོག་གི་ཆོས། །
金刚持佛实证道,亿万坛城最胜法;
The Path of Direct Experience of Buddha Vajradhara,The Supreme Dharma of Billions of Mandalas.
།གཡོ་འགུལ་བཟླས་པས་དཀྱིལ་འཁོར་ཞུགས་པར་བྱ། ། རྒྱུད་སྡེ་ཀུན་གྱི་གསང་འདུས་ཆོས་མཛོད་གསང་བའི་ལྡེ་མིག །
震动持诵入法坛,集密法藏之密钥。
Vibrate and Chant to enter the Dharma Mandala,The Secret Key to the Guhyasamaja Treasury of All Tantras
སངས་རྒྱས་རྡོ་རྗེ་འཆང་གིས་རྡོར་དྲིལ་བསྐྲུགས། ། སངས་རྒྱས་སྤྲིན་དང་རྒྱ་མཚོའི་དཀྱིལ་འཁོར་འཁྲུག། །
金刚持佛震铃杵,佛云佛海坛城动;
Buddha Vajradhara vibrates the Bell and Vajra, Mandalas, numerous as Buddha-clouds and vast as Buddha-oceans, surge and vibrate.
ཕྱི་ནང་གསང་བའི་དཀྱིལ་འཁོར་ཀུན་ཏུ་གཡོ་ཞིང་འཕྱུར། ། འོད་གསལ་རྦ་རླབས་གཡོ་འཕྱུར་ཀུན་ལ་མཉམ་པར་ཁྱབ། །
外内密坛遍震涌,光明震涌等遍涌。
Outer, Inner, and Secret Mandalas vibrate and surge everywhere, Luminous waves vibrate and surge, equally pervading all.
།ཕྱག་མཚན་བསྐྲུགས་ཏེ་ཡི་དམ་ཟུང་དུ་བསྒྲུབ། ། གར་སྟབས་བསྐྱོད་དེ་འཁྲུག་ཅིང་གཡོ་བས་ཡུམ་དང་ཟུང་དུ་བསྒྲུབ། །
振动法器修本尊,舞韵涌震修佛母;
Vibrating ritual implements, practicing in union with the Yidam Buddha,Amidst the surging vibration of dancing grace, practicing in union with the Tathagatamatri.
འཁོར་ཞིང་གཡོ་བས་མཁའ་འགྲོ་ཟུང་དུ་བསྒྲུབ། ། མྱུར་མགྱོགས་གཡོ་བས་ཆོས་སྐྱོང་ཟུང་དུ་བསྒྲུབ། །
旋转震动修空行,速疾震动修护法。
Vibrating while rotating, practicing in union with the Dakini,Vibrating with swiftness, practicing in union with the Dharmapala.
ཕྱི་གཡོ་ནང་གཡོ་རྩ་འཁོར་ནུས་པ་ཐོགས། ། གཡོ་འཕྱུར་ཀུན་ཁྱབ་གཡོ་བས་ཏིང་འཛིན་ཞུགས། །
外动内动脉轮通,震涌遍动入三昧;
Outer and Inner vibrations open the Chakras, Engulfed by universal surges and vibrations, enter Samadhi.
སངས་རྒྱས་དེ་བཞིན་གཤེགས་པའི་དཀྱིལ་འཁོར་དང་མཉམ་པར་སྦྱོར་ཞིང་། ། རྡོ་རྗེ་འཆང་གི་ལམ་མངོན་སུམ་འགྲུབ་པར་ཤོག ། །། ༈ །།
相应一切佛坛城,金刚持道愿实证。
In union with all Buddha Tathagata Mandalas, May this path of Vajradhara be attained through Direct Experience.
藏密修海 www.zmxh.com Aogula加密社区 www.aogula.org
#金刚持#实证#传承#Aogula#噢咕拉#坛城#法藏#震动#密钥#脉轮#中脉