Slugify

Slugify टूल क्या है?#

एक Slugify टूल मानव-पठनीय शीर्षक को URL-सुरक्षित slug में बदलता है — वह सघन, लोअरकेस, विराम-चिह्न-रहित स्ट्रिंग जो वेब पते में डोमेन के बाद रहती है। How to Brew Coffee at Home, how-to-brew-coffee-at-home बनता है; Café Münchën, cafe-munchen बनता है; 你好世界, ni-hao-shi-jie बनता है। Slug वह तरीका है जिससे ब्लॉग, ई-कॉमर्स साइटें और प्रलेखन सिस्टम URL के दिमाग से कभी न लिखे गए शीर्षकों से पठनीय, साझा करने योग्य, SEO-अनुकूल URL बनाते हैं।

मुश्किल हिस्से ठीक वे अक्षर हैं जो लोग वास्तव में उपयोग करते हैं: उच्चारण चिह्न (café), युग्मक (ß, æ), em-dash और स्मार्ट उद्धरण, और CJK भावचित्र जिनका कोई ASCII निरूपण ही नहीं। एक साधारण “हर चीज़ हटा दो जो a-z नहीं” 你好世界 को खाली स्ट्रिंग बना देता है, जो एक टूटा URL उत्पन्न करता है। यह टूल तीनों को ठीक संभालता है: यह उच्चारण-युक्त अक्षरों को विघटित करता है और संयोजी चिह्न हटाता है (é → e), ग़ैर-विघटनशील लातीनी युग्मक मैप करता है (ß → ss, æ → ae), और CJK भावचित्रों को बिना-स्वर pinyin में लिप्यंतरित करता है (你好世界 → ni hao shi jie) ताकि एक चीनी शीर्षक अभी भी एक सार्थक, उच्चारणीय slug उत्पन्न करे।

सब कुछ स्थानीय रूप से चलता है। Pinyin शब्दकोश केवल तब लोड होता है जब इनपुट में वास्तव में CJK हो, इसलिए एक शुद्ध-लातीनी slug कभी इसके लिए भुगतान नहीं करता।

इसका उपयोग कैसे करें#

1. बाईं ओर इनपुट फलक में शीर्षक टाइप करें या चिपकाएँ।
2. विभाजक चुनें — हाइफ़न (डिफ़ॉल्ट) या अंडरस्कोर।
3. लोअरकेस चुनें (डिफ़ॉल्ट चालू) आउटपुट को लोअरकेस में फोल्ड करने के लिए; यदि आप केस संरक्षित रखना चाहते हैं तो अचुनें।
4. CJK को पिनयिन में लिप्यांतरित करें चुनें (डिफ़ॉल्ट चालू) CJK अक्षरों को बिना-स्वर pinyin में बदलने के लिए; यदि आप CJK को लिप्यंतरित करने के बजाय हटाया चाहते हैं तो अचुनें।
5. वैकल्पिक रूप से अधिकतम लंबाई सेट करें (0 का अर्थ असीमित)। जब slug इससे अधिक हो जाता है, इसे काटा जाता है और कोई भी लटकता अनुगामी विभाजक छँटा जाता है ताकि URL कभी खाली - पर समाप्त न हो।
6. दाईं ओर आउटपुट फलक पढ़ें — slug तब प्रकट होता है जब इनपुट या कोई भी विकल्प बदलता है। इसे लेने के लिए कॉपी दबाएँ।

स्थिति पंक्ति slug लंबाई रिपोर्ट करती है और दो विशेष मामलों को चिह्नित करती है: जब CJK लिप्यंतरित किया गया, और जब परिणाम को अधिकतम लंबाई में फ़िट करने के लिए छोटा किया गया।

मुख्य विशेषताएँ#

• उच्चारण और युग्मक प्रबंधन। NFKD विघटन और एक छोटी लातीनी संगतता मानचित्र café, Münchën, straße, œuvre को साफ़ ASCII (cafe, munchen, strasse, oeuvre) में बदलता है, बजाय अक्षरों को पूरी तरह हटाने के।
• CJK से pinyin। चीनी भावचित्र बंडल किए गए शब्दकोश द्वारा बिना-स्वर pinyin में लिप्यंतरित होते हैं, इसलिए 你好世界, ni-hao-shi-jie बनता है — एक उच्चारणीय, सार्थक slug, बजाय खाली या विकृत के।
• साफ़ शब्द सीमाएँ। CJK रन को विभाजक पास से पहले रिक्ति में लपेटा जाता है, इसलिए लिप्यंतरित आउटपुट शब्दों में अलग होता है (ni-hao), बजाय एक साथ चिपकने (nihao) के।
• साफ़ छँटाई के साथ लंबाई टोपी। एक अधिकतम लंबाई slug को काटती है और फिर किसी भी लटकते अनुगामी विभाजक को हटाती है, इसलिए आप कभी ऐसा URL नहीं पाते जो - पर समाप्त हो।
• हाइफ़न या अंडरस्कोर। अपने प्लेटफ़ॉर्म की अपेक्षा के अनुसार विभाजक चुनें — अधिकांश आधुनिक वेब slug हाइफ़न उपयोग करते हैं, किंतु कुछ सिस्टम और फ़ाइल-नाम परिपाटियाँ अंडरस्कोर उपयोग करती हैं।
• आलसी pinyin लोड। Pinyin शब्दकोश केवल पहली बार तब आयात होता है जब इनपुट में वास्तव में CJK हो, इसलिए एक सभी-लातीनी slug कभी इसे डाउनलोड नहीं करता।
• स्थानीय और कभी throw नहीं। खाली इनपुट empty रिपोर्ट करता है; ऐसा इनपुट जो पूरी तरह छँट जाता है (उदाहरण के लिए, केवल इमोजी) no-output रिपोर्ट करता है। विफलताएँ एक स्पष्ट संदेश बनती हैं, कभी अपवाद नहीं।

विस्तृत उदाहरण#

इनपुट प्लेसहोल्डर से शीर्षक चिपकाएँ, सभी डिफ़ॉल्ट के साथ (हाइफ़न विभाजक, लोअरकेस चालू, लिप्यंतरण चालू):

Café Münchën — 你好世界

चरण-दर-चरण:

1. CJK पहचाना गया, इसलिए 你好世界 को ni hao shi jie में लिप्यंतरित किया गया।
2. उच्चारण हटाए गए: Café → Cafe, Münchën → Munchen।
3. Em-dash और रिक्तियाँ विभाजक में सिकुड़ते हैं।
4. परिणाम लोअरकेस किया गया और अग्रणी/अनुगामी विभाजक छँटे।

आउटपुट फलक दिखाता है:

cafe-munchen-ni-hao-shi-jie

अब अधिकतम लंबाई 20 पर सेट करें और पुनः उत्पन्न करें। Slug कटा और लटकता अनुगामी हाइफ़न हटाया गया:

cafe-munchen-ni-hao

ध्यान दें कि उच्चारण सादे ASCII बने, चीनी शीर्षक उच्चारणीय pinyin शब्दों में बँटा, और लंबाई टोपी ने एक साफ़ URL खंड उत्पन्न किया, बजाय एक ऐसे के जो शब्द के बीच या खाली हाइफ़न पर समाप्त हो।

अक्सर पूछे जाने वाले प्रश्न#

मेरा चीनी शीर्षक अक्षरों के रूप में रहने के बजाय pinyin क्यों बनता है?#

क्योंकि URL तब सबसे सुरक्षित और सबसे अधिक पोर्टेबल होते हैं जब वे ASCII उपयोग करते हैं। URL में CJK अक्षरों को प्रतिशत-एन्कोडिंग चाहिए (प्रत्येक 你, %E4%BD%A0 बनता है), जो मनुष्यों और कई विश्लेषण टूल्स के लिए अपठनीय है। बिना-स्वर pinyin slug को उच्चारणीय, सार्थक और केवल-ASCII रखता है — ni-hao-shi-jie प्रतिशत चिह्नों की एक स्ट्रिंग से बहुत बेहतर URL है। यदि आप मूल अक्षर रखना चाहते हैं, तो CJK को पिनयिन में लिप्यांतरित करें अचुनें।

इमोजी और अन्य ग़ैर-अक्षरांकीय प्रतीकों का क्या होता है?#

वे हटाए जाते हैं। इमोजी, स्मार्ट उद्धरण, कोष्ठक और अधिकांश विराम चिह्न slug पाइपलाइन में जीवित नहीं रहते — वे अक्षर नहीं हैं, इसलिए ग़ैर-अक्षरांकीय संक्षेपण पास उन्हें विभाजक बना देता है। यदि आपका इनपुट केवल इमोजी और प्रतीक है, तो सब कुछ छँट जाता है और टूल एक खाली slug उत्सर्जित करने के बजाय no-output रिपोर्ट करता है।

क्या मैं विभाजक के रूप में हाइफ़न या अंडरस्कोर उपयोग करूँ?#

URL के लिए जो मनुष्य पढ़ेंगे, हाइफ़न उपयोग करें — खोज इंजन हाइफ़न को शब्द विभाजक मानते हैं और हाइफ़न लगभग सभी आधुनिक वेब प्लेटफ़ॉर्मों में परिपाटी है। अंडरस्कोर तब उपयुक्त है जब slug वास्तव में कोई फ़ाइल नाम या पहचानकर्ता है जिसे कोई ऐसा सिस्टम उपयोग करता है जो हाइफ़न किसी और के लिए आरक्षित करता है (संस्करण श्रेणियाँ, फ़्लैग)। टूल दोनों का समर्थन करता है ताकि आप अपने लक्ष्य की अपेक्षा से मिला सकें।

अधिकतम लंबाई कट कैसे काम करती है?#

slug पहले पूर्ण बनाया जाता है, फिर अनुरोधित लंबाई तक काटा जाता है। यदि कट किसी शब्द के बीच पड़ता है, तो शब्द आंशिक छोड़ा जाता है; यदि कट एक अनुगामी विभाजक छोड़ता है, तो वह विभाजक छँटा जाता है। यह गारंटी देता है कि slug कभी सीमा से अधिक न हो और कभी खाली - या _ पर समाप्त न हो, जो URL फ़ील्ड और डेटाबेस कॉलम चौड़ाई वास्तव में माँगते हैं।

क्या यह URL-एन्कोडिंग के समान है?#

नहीं, और अंतर मायने रखता है। URL-एन्कोडिंग (प्रतिशत-एन्कोडिंग) अक्षरों को एस्केप करती है ताकि वे URL के भीतर यात्रा कर सकें — café, caf%C3%A9 बनता है। Slugify इसके बजाय पाठ को ASCII अक्षरों और विभाजकों में सामान्य करता है — café, cafe बनता है। Slug URL के मानव-पठनीय पथ खंड के लिए हैं; प्रतिशत-एन्कोडिंग क्वेरी स्ट्रिंग में यादृच्छिक मानों के सुरक्षित परिवहन के लिए है। यदि आपको बाद वाला चाहिए, तो /en/encoding/url/ टूल उपयोग करें।