Slugify

Что делает инструмент Slugify

Этот инструмент превращает любой заголовок или фразу в чистый, безопасный для URL «слаг» — читаемый идентификатор, стоящий в веб-адресе, как my-first-post в example.com/blog/my-first-post. Вы вставляете текст, а он убирает пунктуацию, пробелы и неудобные символы, соединяя оставшиеся слова выбранным вами разделителем (дефисом или подчёркиванием). Опции позволяют принудительно перевести в нижний регистр и, что важно для многоязычной аудитории, транслитерировать кириллицу в латиницу, чтобы русский или украинский заголовок стал произносимым ASCII-слагом, а не исчез. Он работает вживую по мере ввода. Обращайтесь к нему всякий раз, когда нужен стабильный идентификатор, производный от человеческого текста: URL блогов и статей, имена файлов, классы или идентификаторы CSS, якорные ссылки, ключи базы данных или имена изображений — везде, где пробелы и акценты иначе вызывали бы проблемы.

Как это работает технически

Конвейер выполняется в фиксированном порядке. Если транслитерация включена, каждая кириллическая буква сначала сопоставляется со своим латинским эквивалентом через таблицу поиска — привет становится privet, а многобуквенные соответствия вроде ж → zh или щ → sch разворачиваются корректно, с сохранением заглавных букв. Далее строка нормализуется по Unicode с помощью NFKD, а комбинирующие знаки убираются, что сворачивает акцентированные латинские буквы к их базовой форме, так что café становится cafe, а Málaga становится Malaga. Далее идёт необязательный перевод в нижний регистр. Наконец, каждая последовательность символов, не являющихся буквой или цифрой, заменяется вашим разделителем, а начальные, конечные и повторяющиеся разделители обрезаются, так что беспорядочный Hello, World! сворачивается в аккуратный hello-world. Результат содержит только a–z, 0–9 и разделитель — безопасный в любом URL без процентного кодирования.

Конкретные примеры и сценарии использования

• URL блогов: My Awesome Blog Post! становится my-awesome-blog-post.
• Кириллические заголовки: Привет мир становится privet-mir с включённой транслитерацией.
• Имена с акцентами: Crème Brûlée становится creme-brulee.
• Имена файлов и идентификаторы: превратите Q3 Report (final) в q3-report-final для безопасного имени файла или якоря.

Практические советы и подводные камни

Слаг полезен только тогда, когда он стабилен, поэтому определитесь с разделителем и регистром один раз и придерживайтесь их последовательно по всему сайту; дефисы — это традиционный, дружественный к SEO выбор для URL, тогда как подчёркивания распространены для имён файлов и идентификаторов в коде. Транслитерация охватывает русский и украинский кириллический набор, но системы письма без латинского соответствия — китайская, японская, арабская и подобные — не имеют очевидного ASCII-эквивалента, поэтому эти символы отбрасываются, а не угадываются; если весь заголовок на такой системе письма, вы можете предпочесть написание слага вручную. Остерегайтесь того, что два разных заголовка сворачиваются в один слаг (например, C++ и C оба сводятся к c) — добавьте различающее слово или число, когда такое случается. И поскольку инструмент выводит только буквы, цифры и разделитель, результат всегда безопасно вставлять прямо в ссылку без дальнейшего кодирования.

Приватность: Slugify выполняется на 100% локально в вашем браузере. Ваш текст транслитерируется и очищается полностью с помощью JavaScript на вашем устройстве — ничего не загружается, ничего не логируется, и ни один запрос не покидает вашу машину, поэтому неопубликованные заголовки остаются приватными, пока вы не решите их выпустить. Если вы генерируете слаги как часть большего конвейера сборки или публикации, наша документация API показывает, как платформа s4m должна автоматизироваться сценариями.