کتابخانه‌ی استاندارد · کدگذاری و داده

اسلاگ encoding.slug

تولید اسلاگ آدرس با جدول‌های آوانویسی داخلی برای فارسی، عربی، سیریلیک، یونانی، حرف‌های لاتین دارای نشانه، عبری، هندی، تایی، کانای ژاپنی و کره‌ای.

واردسازی کدگذاری.اسلاگ

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

اسلاگ بخش خوانای یک آدرس است، مثل my-first-post در /blog/my-first-post. این بسته عنوان را به هر زبانی به اسلاگ تبدیل می‌کند. به زبان سلام نوشته شده، فقط جدول‌های ثابت دارد (بدون مدل، شبکه و پرونده)، هیچ وضعیتی نگه نمی‌دارد و از چند نخ هم‌زمان با خیال راحت قابل‌استفاده است.

برای بیشتر برنامه‌ها ساخت کافی است: به حروف لاتین برمی‌گرداند، کوچک می‌کند، شکلک‌ها را حذف می‌کند، & و % را با کلمه می‌نویسد و واژه‌ها را با خط تیره به هم می‌پیوندد. وقتی جداکننده‌ی دیگر، محدودیت طول، کلمه‌های توقف، جایگزینی‌های خودتان یا حرف‌های بومی لازم دارید، ساخت با گزینه یک مقدار گزینه ها می‌گیرد.

عنوان به اسلاگ در یک فراخوانی

نشانه‌گذاری و فاصله به یک جداکننده تبدیل می‌شوند، آپاستروف بدون شکاف حذف می‌شود (what's می‌شود whats)، نشانه‌های روی حرف برداشته می‌شوند، نمادهایی مثل &، @، %، + و علامت‌های پول با کلمه نوشته می‌شوند و شکلک‌ها می‌افتند.

encoding-slug-guide-basics.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    سرچاپ اسلاگ.ساخت("Hello, World!")
    سرچاپ اسلاگ.ساخت("  10 Tips & Tricks for 100% Better Code  ")
    سرچاپ اسلاگ.ساخت("What's new in v2.0? (Release Notes)")
    سرچاپ اسلاگ.ساخت("Café crème brûlée")
    سرچاپ اسلاگ.ساخت("user@example.com")
    سرچاپ اسلاگ.ساخت("Launch day 🚀🎉")
پایان
خروجیhello-world 10-tips-and-tricks-for-100-percent-better-code whats-new-in-v2-0-release-notes cafe-creme-brulee user-at-example-com launch-day

زبان‌های بسیار، برای هر خط یک جدول

خط متن جدول را انتخاب می‌کند. تشخیص خط خطِ غالب یک متن را نام می‌برد: latin، cyrillic، greek، arabic، hebrew، devanagari، thai، japanese، korean یا han، و برای متنی که فقط رقم و نماد دارد رشته‌ی خالی. جدول‌ها از قاعده‌های رایج هر زبان پیروی می‌کنند، پس نتیجه همان املایی است که خواننده انتظار دارد، نه یک کد حرف‌به‌حرف.

خطچه چیزی پوشش داده می‌شود
لاتینلاتین-۱، افزوده‌ی الف و ب، ویتنامی، لهستانی، چک، شمال اروپا، ترکی؛ ß می‌شود ss، æ می‌شود ae، þ می‌شود th و حرف‌های تمام‌عرض و لیگاتورها باز می‌شوند. با زبان de، ä ö ü می‌شوند ae oe ue؛ با da یا no، å ø می‌شوند aa oe.
سیریلیکبه‌طور پیش‌فرض روسی، اوکراینی (г می‌شود h، и می‌شود y، ї اول واژه yi و میان واژه i)، بلغاری (ъ می‌شود a و щ می‌شود sht)، صربی و مقدونی بدون نشانه، بلاروسی.
یونانیبه سبک ELOT 743: ου می‌شود ou، μπ اول واژه b و میان واژه mp، نشانه‌های تکیه و چندتکیه برداشته می‌شوند.
خط عربیفارسی و عربی، بخش بعد را ببینید.
عبریفقط همخوان‌ها (متن واکه ندارد)، نقطه‌گذاری‌های روی حرف نادیده گرفته می‌شوند.
دیوناگریهندی: هر همخوان یک «a» ذاتی دارد که آخر واژه و بعد از ویراما حذف می‌شود.
تاییجدول ساده: همخوان‌ها، واکه‌ها، واکه‌های پیش‌نشین که بعد از همخوانشان می‌آیند، نشانه‌های آهنگ نادیده گرفته می‌شوند.
ژاپنیهیراگانا و کاتاکانا به هپبورن: きょ می‌شود kyo، っ همخوان بعدی را دوبار می‌نویسد و نشانه‌ی کشش نادیده گرفته می‌شود.
کره‌ایهجاهای هانگول به‌صورت الگوریتمی به حرف‌هایشان باز می‌شوند و به رومی‌سازی بازنگری‌شده نوشته می‌شوند، بدون تغییر صدا میان هجاها.
چینیجدول پین‌یین ندارد: نویسه‌های هان بدون تغییر می‌مانند (نگه داشتن هان را ببینید).
encoding-slug-guide-languages.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع نمایش(عنوان: رشته):
    سرچاپ اسلاگ.تشخیص خط(عنوان) + ":"، اسلاگ.ساخت(عنوان)
پایان

تابع ریشه:
    نمایش("Привет, мир! Щука и Ёж")
    نمایش("Київ Їжак Ґанок")
    نمایش("Ελληνικά: Καλημέρα κόσμε")
    نمایش("Ağaç ışık İstanbul şeker")
    نمایش("Zażółć gęślą jaźń Łódź")
    نمایش("Nguyễn Thị Minh Khai Đà Nẵng")
    نمایش("שלום עולם")
    نمایش("हिन्दी भारत नमस्ते")
    نمایش("สวัสดี ครับ")
    نمایش("こんにちは ラーメン")
    نمایش("안녕하세요 한국어")
    نمایش("你好 世界")
پایان
خروجیcyrillic: privet-mir-shchuka-i-yozh cyrillic: kyiv-yizhak-ganok greek: ellinika-kalimera-kosme latin: agac-isik-istanbul-seker latin: zazolc-gesla-jazn-lodz latin: nguyen-thi-minh-khai-da-nang hebrew: shlvm-avlm devanagari: hindi-bharat-namaste thai: swasdi-khrab japanese: konnichiha-ramen korean: annyeonghaseyo-hangukeo han: 你好-世界

فارسی و عربی

فارسی و عربی یک خط دارند، پس زبان از روی حرف‌ها تشخیص داده می‌شود: هر یک از پ چ ژ گ ک ی یا رقم‌های ۰ تا ۹ یعنی فارسی؛ ة ى ي ك أ إ بدون آن‌ها یعنی عربی؛ متنی که هیچ‌کدام را ندارد فارسی خوانده می‌شود. با زبان متن = "fa" یا "ar" خودتان تصمیم بگیرید.

  • رقم‌های فارسی و عربی-هندی همه‌جا به 0 تا 9 تبدیل می‌شوند.
  • اعراب، تشدید، کشیده و نشانه‌های قرآنی برداشته می‌شوند؛ شکل‌های نمایشی (ﻻ، ﺳ) نخست به حرف ساده تبدیل می‌شوند.
  • نیم‌فاصله مرز واژه است: می‌خواهم می‌شود mi-khvahm.
  • ي و ك عربی همان ی و ک فارسی‌اند.
  • حرف‌ها از قاعده‌های رایج پیروی می‌کنند: خ می‌شود kh، ش می‌شود sh، چ می‌شود ch، ژ می‌شود zh، گ می‌شود g و ع می‌شود a؛ در فارسی ق می‌شود gh و ث ذ ض می‌شوند s z z، در عربی ق می‌شود q و ث ذ ض می‌شوند th dh d.
  • و و ی از روی همسایه‌هایشان حدس زده می‌شوند. در فارسی و اول واژه یا پیش از حرف واکه v است و در غیر این صورت u، و وقتی تنها به معنی «و» بیاید va؛ ی اول واژه و کنار حرف واکه y است و در غیر این صورت i؛ ای اول واژه i است (ایران می‌شود iran). در عربی و می‌شود w.
  • واکه‌های کوتاه در متن فارسی و عربی نوشته نمی‌شوند و حدس زده نمی‌شوند، پس سلام می‌شود slam و محمد می‌شود mhmd. وقتی املای زیبای انگلیسی مهم است (نام آدم یا جا)، با افزودن جایگزین خودتان تعیین کنید.
encoding-slug-guide-persian.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    سرچاپ اسلاگ.ساخت("سلام دنیا")
    سرچاپ اسلاگ.ساخت("می‌خواهم ایران را ببینم")
    سرچاپ اسلاگ.ساخت("ژاله و گلی، چای شیرین")
    سرچاپ اسلاگ.ساخت("قیمت: ۱۲۳٫۵۰ ریال")
    سرچاپ اسلاگ.ساخت("كتاب علي")
    سرچاپ اسلاگ.ساخت("مَدرَسه ـــ کِتاب")

    سرچاپ اسلاگ.نویسه گردانی("خوب است، دوستان!"، "")
    سرچاپ اسلاگ.نویسه گردانی("قطر ثلاثة"، "ar")
    سرچاپ اسلاگ.نویسه گردانی("قطر ثلاثة"، "fa")
پایان
خروجیslam-dnya mi-khvahm-iran-ra-bbinm zhalh-va-gli-chay-shirin ghimt-123-50-ryal ktab-ali mdrsh-ktab khub ast, dustan! qtr thlatht ghtr slast

گزینه‌ها

از گزینه های پیش فرض (یا یک پیش‌تنظیم) شروع کنید و هر چه لازم است عوض کنید. کلمه‌های توقف با واژه‌های نهایی مقایسه می‌شوند، پس به هر خط و هر حالتی بنویسید: همان آوانویسی متن را می‌گذرانند. اگر همه‌ی واژه‌های یک عنوان کلمه‌ی توقف باشند، واژه‌ها نگه داشته می‌شوند تا اسلاگ خالی نشود. جایگزین‌ها متن ساده‌اند و پیش از هر کار دیگر از چپ به راست اعمال می‌شوند، پس C++ می‌تواند پیش از آن‌که علامت‌های جمع به کلمه تبدیل شوند cpp شود. وقتی چیزی نماند، جایگزین خالی برگردانده می‌شود.

encoding-slug-guide-options.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    عنوان := "The Quick Brown Fox & the Lazy Dog"
    سرچاپ اسلاگ.ساخت(عنوان)

    ناپایا وپتس := اسلاگ.گزینه ها {}
    وپتس.جداکننده = "_"
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    وپتس.حروف کوچک = نادرست
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    اسلاگ.افزودن کلمه های توقف(وپتس، "the a an and of")
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    وپتس.نمادها = نادرست
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)
    وپتس.زبان متن = "de"
    وپتس.نمادها = درست
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    اسلاگ.افزودن جایگزین(وپتس، "C++"، "cpp")
    اسلاگ.افزودن جایگزین(وپتس، "C#"، "csharp")
    سرچاپ اسلاگ.ساخت با گزینه("C++ versus C#"، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    وپتس.نویسه های مجاز = "."
    سرچاپ اسلاگ.ساخت با گزینه("Report v1.2.final"، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    وپتس.جایگزین خالی = "untitled"
    سرچاپ اسلاگ.ساخت با گزینه("???"، وپتس)
    اسلاگ.آزادسازی گزینه ها(وپتس)
پایان
خروجیthe-quick-brown-fox-and-the-lazy-dog the_quick_brown_fox_and_the_lazy_dog The-Quick-Brown-Fox-and-the-Lazy-Dog quick-brown-fox-lazy-dog the-quick-brown-fox-the-lazy-dog the-quick-brown-fox-und-the-lazy-dog cpp-versus-csharp report-v1.2.final untitled

محدود کردن طول

بیشینه طول نویسه می‌شمارد، نه بایت. اسلاگ میان واژه‌ها بریده می‌شود، هرگز وسط یک واژه: تا وقتی جا هست واژه‌های کامل با جداکننده‌هایشان نگه داشته می‌شوند. فقط اگر همان واژه‌ی اول از حد بلندتر باشد بریده می‌شود، پس برای عنوان ناتهی نتیجه هرگز خالی نیست. پیش‌تنظیم آدرس وب اسلاگ را به ۱۰۰ نویسه محدود می‌کند.

encoding-slug-guide-length.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    عنوان := "How to build a fast and friendly web server in Salam"
    ناپایا وپتس := اسلاگ.گزینه ها {}
    وپتس = اسلاگ.گزینه های پیش فرض()
    سرچاپ اسلاگ.ساخت(عنوان)
    وپتس.بیشینه طول = 30
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)
    وپتس.بیشینه طول = 12
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، وپتس)
    وپتس.بیشینه طول = 5
    سرچاپ اسلاگ.ساخت با گزینه("extraordinary"، وپتس)
    سرچاپ اسلاگ.ساخت با گزینه(عنوان، اسلاگ.آدرس وب())
پایان
خروجیhow-to-build-a-fast-and-friendly-web-server-in-salam how-to-build-a-fast-and how-to-build extra how-to-build-a-fast-and-friendly-web-server-in-salam

نگه داشتن حرف‌های بومی

با نگه داشتن یونیکد حرف‌های همه‌ی خط‌ها همان‌طور که هستند می‌مانند: فقط حالت حرف یکی می‌شود (لاتین، یونانی و سیریلیک)، شکل‌های فارسی یکدست می‌شوند (ي به ی و ك به ک)، رقم‌ها ASCII می‌شوند، نشانه‌هایی که جزو واژه نیستند برداشته می‌شوند و جداکننده‌ها مثل همیشه کار می‌کنند. مرورگرها و موتورهای جست‌وجوی امروزی چنین آدرس‌هایی را می‌فهمند و برای سایت‌های فارسی، روسی یا یونانی خواناتر هستند. ورودی باید به شکل نرمال NFC باشد. بدون نگه داشتن یونیکد هم نویسه‌های هان نگه داشته می‌شوند چون جدولی برایشان نیست؛ نگه داشتن هان را نادرست کنید تا حذف شوند.

encoding-slug-guide-unicode.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    ناپایا وپتس := اسلاگ.گزینه ها {}
    وپتس = اسلاگ.یونیکد()
    سرچاپ اسلاگ.ساخت با گزینه("سلام دنیا، ۱۲۳ ك ي"، وپتس)
    سرچاپ اسلاگ.ساخت با گزینه("Привет, Мир!"، وپتس)
    سرچاپ اسلاگ.ساخت با گزینه("Crème Brûlée Ñandú"، وپتس)
    سرچاپ اسلاگ.ساخت با گزینه("你好 世界"، وپتس)
    وپتس.حروف کوچک = نادرست
    سرچاپ اسلاگ.ساخت با گزینه("Привет, Мир!"، وپتس)

    وپتس = اسلاگ.گزینه های پیش فرض()
    سرچاپ اسلاگ.ساخت با گزینه("abc 你好 def"، وپتس)
    وپتس.نگه داشتن هان = نادرست
    سرچاپ اسلاگ.ساخت با گزینه("abc 你好 def"، وپتس)
پایان
خروجیسلام-دنیا-123-ک-ی привет-мир crème-brûlée-ñandú 你好-世界 Привет-Мир abc-你好-def abc-def

اسلاگ یکتا

یکتا تابعی می‌گیرد که می‌گوید اسلاگ پیش‌تر استفاده شده یا نه (جست‌وجو در پایگاه داده، یک مجموعه، فهرست یک پوشه) و خودِ اسلاگ را برمی‌گرداند یا نخستین slug-2، slug-3 و ... که آزاد باشد. یکتا با جداکننده جداکننده را انتخاب می‌کند و شماره دار یک نام شماره‌دار می‌سازد. پس از ده هزار تلاش شماره‌ای که به آن رسیده برگردانده می‌شود، پس تابعی که همیشه «بله» بگوید برنامه را قفل نمی‌کند.

encoding-slug-guide-unique.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع تاکین(س: رشته): منطقی:
    برگشت س برابر "post" یا س برابر "post-2" یا س برابر "post-3"
پایان

تابع ریشه:
    سرچاپ اسلاگ.یکتا("fresh"، (س: رشته): برگشت تاکین(س) پایان)
    سرچاپ اسلاگ.یکتا("post"، (س: رشته): برگشت تاکین(س) پایان)
    سرچاپ اسلاگ.یکتا با جداکننده("post"، "_"، (س: رشته): برگشت تاکین(س) پایان)
    سرچاپ اسلاگ.شماره دار("post"، 7، "-")
پایان
خروجیfresh post-4 post_2 post-7

بررسی یک اسلاگ

اسلاگ است فقط چیزی را می‌پذیرد که ساخت با گزینه‌های پیش‌فرض می‌تواند بسازد: حرف‌های کوچک و رقم‌های لاتین که با خط تیره‌ی تکی به هم وصل شده‌اند و در دو سر خط تیره ندارند. اسلاگ است با گزینه با همان گزینه‌هایی که به کار برده‌اید می‌سنجد، از جمله جداکننده، حد طول و حرف‌های بومی.

encoding-slug-guide-validate.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    سرچاپ اسلاگ.اسلاگ است("hello-world")
    سرچاپ اسلاگ.اسلاگ است("Hello World")
    سرچاپ اسلاگ.اسلاگ است("-hello-")
    سرچاپ اسلاگ.اسلاگ است("a--b")
    سرچاپ اسلاگ.اسلاگ است(اسلاگ.ساخت("Any title, any language: Привет"))

    سرچاپ اسلاگ.اسلاگ است با گزینه("hello_world"، اسلاگ.اسنیک())
    سرچاپ اسلاگ.اسلاگ است با گزینه("سلام-دنیا"، اسلاگ.یونیکد())
    سرچاپ اسلاگ.اسلاگ است با گزینه("9lives"، اسلاگ.شناسه())
پایان
خروجیtrue false false false true true true false

پیش‌تنظیم‌ها

آدرس وب همان پیش‌فرض با حد ۱۰۰ نویسه است. نام پرونده حالت حرف را نگه می‌دارد، از _ استفاده می‌کند، نقطه و خط تیره را مجاز می‌داند، حداکثر ۲۰۰ نویسه می‌دهد، هرگز با نقطه شروع یا تمام نمی‌شود و اگر چیزی نماند file می‌دهد، پس ../etc/passwd از پوشه بیرون نمی‌رود. اسنیک از _ استفاده می‌کند. شناسه از _ استفاده می‌کند، هرگز با رقم شروع نمی‌شود و اگر چیزی نماند _ می‌دهد، که برای نام متغیر یا ستون مناسب است. یونیکد حرف‌های بومی را نگه می‌دارد.

encoding-slug-guide-presets.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    عنوان := "My Report: Q3 2026 (final).PDF"
    سرچاپ "default   "، اسلاگ.ساخت(عنوان)
    سرچاپ "url       "، اسلاگ.ساخت با گزینه(عنوان، اسلاگ.آدرس وب())
    سرچاپ "filename  "، اسلاگ.ساخت با گزینه(عنوان، اسلاگ.نام پرونده())
    سرچاپ "snake     "، اسلاگ.ساخت با گزینه(عنوان، اسلاگ.اسنیک())
    سرچاپ "identifier"، اسلاگ.ساخت با گزینه("9 lives of a cat"، اسلاگ.شناسه())
    سرچاپ "unicode   "، اسلاگ.ساخت با گزینه("Привет мир"، اسلاگ.یونیکد())
پایان
خروجیdefault my-report-q3-2026-final-pdf url my-report-q3-2026-final-pdf filename My_Report_Q3_2026_final.PDF snake my_report_q3_2026_final_pdf identifier _9_lives_of_a_cat unicode привет-мир

آنچه مردم اشتباه می‌کنند:

  • انتظار دارند slam به صورت salam نوشته شود. متن فارسی و عربی واکه‌ی کوتاه ندارد و بسته آن را از خودش نمی‌سازد؛ برای نام‌ها از افزودن جایگزین کمک بگیرید.
  • اسلاگ را بدون یکتا کلید می‌کنند. دو عنوان متفاوت می‌توانند یک اسلاگ بدهند و عنوان خالی اسلاگ خالی می‌دهد مگر جایگزین خالی تعیین شده باشد.
  • بایت می‌شمارند. بیشینه طول نویسه می‌شمارد؛ با نگه داشتن یونیکد یک اسلاگ فارسی ۵۰ نویسه‌ای حدود ۱۰۰ بایت است.
  • انتظار دارند camelCase شکسته شود: fooBar می‌شود foobar. اگر دو واژه می‌خواهید در عنوان فاصله بگذارید.
  • یک گزینه ها را که کلمه‌های توقف یا جایگزین دارد دوبار آزاد می‌کنند. رونوشت‌های یک گزینه ها این دو فهرست را به اشتراک دارند، پس آزادسازی گزینه ها را برای کل خانواده یک بار صدا بزنید.

هر رشته‌ای که برمی‌گردد تازه است و مال فراخواننده. برای درصدنویسی آدرس encoding.url و برای گریز متن در صفحه encoding.html را ببینید.

گونه‌ها

گزینه ها Options

ساختار گزینه ها
هر چه تعیین می‌کند اسلاگ چگونه ساخته شود. از گزینه های پیش فرض یا یک پیش‌تنظیم شروع کنید و تک‌تک فیلدها را عوض کنید.
نامانگلیسیگونهتوضیح
جداکنندهseparatorرشته = "-"متنی که میان واژه‌ها گذاشته می‌شود، به‌طور پیش‌فرض خط تیره. می‌تواند بلندتر از یک نویسه یا خالی باشد.
حروف کوچکlowercaseمنطقی = درستحرف‌ها را کوچک می‌کند. به‌طور پیش‌فرض روشن است.
بیشینه طولmax_lengthصحیح = 0بیشترین طول بر حسب نویسه، با بریدن میان واژه‌ها. صفر یعنی بدون حد.
زبان متنlangرشته = ""کد زبانی که میان قاعده‌ها انتخاب می‌کند (de، da، no، uk، bg، sr، fa، ar، ru و ...). خالی یعنی از روی خط تشخیص بده. پسوند منطقه مثل pt-BR نادیده گرفته می‌شود.
نگه داشتن یونیکدkeep_unicodeمنطقی = نادرستحرف‌های همه‌ی خط‌ها را نگه می‌دارد، به‌جای آوانویسی.
نگه داشتن هانkeep_hanمنطقی = درستنویسه‌های هان را که جدول ندارند نگه می‌دارد. به‌طور پیش‌فرض روشن است؛ اگر خاموش باشد حذف می‌شوند.
کلمه های توقفstop_wordsوکتور<رشته>واژه‌هایی که از اسلاگ کنار گذاشته می‌شوند. با افزودن کلمه های توقف (افزودن کلمه های توقف) پر کنید.
جایگزین هاreplacementsوکتور<رشته>جفت‌های الگو و مقدار که ابتدا روی عنوان اعمال می‌شوند. با افزودن جایگزین (افزودن جایگزین) پر کنید.
پیرایشtrimمنطقی = درستجداکننده‌ها و نشانه‌گذاری مجاز را از دو سر برمی‌دارد. به‌طور پیش‌فرض روشن است.
یکی کردن جداکننده هاcollapseمنطقی = درسترشته‌ی جداکننده‌ها را یکی می‌کند. به‌طور پیش‌فرض روشن است؛ اگر خاموش باشد هر نویسه‌ی نگه‌داشته‌نشده جداکننده‌ی خودش را می‌دهد.
نویسه های مجازallowرشته = ""نشانه‌گذاری ASCII که در اسلاگ می‌ماند، مثل ._~ . کنار نویسه‌ی مجاز جداکننده گذاشته نمی‌شود.
نمادهاsymbolsمنطقی = درستنمادهای & @ % + $ و علامت‌های پول را با کلمه می‌نویسد. به‌طور پیش‌فرض روشن است؛ اگر خاموش باشد فقط جداکننده‌اند.
شناسهidentifierمنطقی = نادرستنتیجه را برای نام در کد قابل‌استفاده می‌کند: اگر با رقم شروع شود یک زیرخط جلویش می‌گذارد.
جایگزین خالیfallbackرشته = ""وقتی اسلاگ خالی می‌شد این برگردانده می‌شود.
encoding-slug-Options.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    ناپایا وپتس := اسلاگ.گزینه ها {}
    وپتس = اسلاگ.گزینه های پیش فرض()
    وپتس.جداکننده = "_"
    وپتس.بیشینه طول = 20
    وپتس.زبان متن = "de"
    اسلاگ.افزودن کلمه های توقف(وپتس، "the of")
    اسلاگ.افزودن جایگزین(وپتس، "&"، " und ")
    سرچاپ اسلاگ.ساخت با گزینه("The Best of Müller & Söhne in Köln"، وپتس)
    اسلاگ.آزادسازی گزینه ها(وپتس)

    سرچاپ اسلاگ.ساخت با گزینه("Report (final).pdf"، اسلاگ.نام پرونده())
    سرچاپ اسلاگ.ساخت با گزینه("9 lives"، اسلاگ.شناسه())
    سرچاپ اسلاگ.ساخت با گزینه("Привет мир"، اسلاگ.یونیکد())
    سرچاپ اسلاگ.ساخت با گزینه("a b c"، اسلاگ.آدرس وب())
پایان
خروجیbest_mueller_und Report_final.pdf _9_lives привет-мир a-b-c

تابع‌ها

تشخیص خط DetectScript

تابع تشخیص خط(text: رشته): رشته
خطی را که بیشتر حرف‌های متن به آن تعلق دارند نام می‌برد: latin، cyrillic، greek، arabic، hebrew، devanagari، thai، japanese، korean یا han. اگر حرفی نباشد رشته‌ی خالی برمی‌گرداند. متن برگردانده را آزاد کنید.
encoding-slug-Make.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع ریشه:
    سرچاپ اسلاگ.ساخت("Hello, World! Ünïcödé & Co.")
    سرچاپ اسلاگ.ساخت با گزینه("Hello, World!"، اسلاگ.اسنیک())
    سرچاپ اسلاگ.نویسه گردانی("Привет, мир! Zürich"، "")
    سرچاپ اسلاگ.نویسه گردانی("Müller Größe"، "de")
    سرچاپ اسلاگ.تشخیص خط("こんにちは")
    سرچاپ اسلاگ.تشخیص خط("Καλημέρα")
پایان
خروجیhello-world-unicode-and-co hello_world Privet, mir! Zurich Mueller Groesse japanese greek

گزینه های پیش فرض DefaultOptions

تابع گزینه های پیش فرض(): گزینه ها
انتخاب معمول: جداکننده‌ی خط تیره، حروف کوچک، بدون حد طول، زبان تشخیص داده‌شده، نمادها با کلمه، جداکننده‌ها پیراسته و یکی‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

آدرس وب URL

تابع آدرس وب(): گزینه ها
گزینه‌های پیش‌فرض با طول محدود به ۱۰۰ نویسه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

نام پرونده Filename

تابع نام پرونده(): گزینه ها
برای نام پرونده: جداکننده‌ی زیرخط، حالت حرف نگه داشته می‌شود، نقطه و خط تیره مجاز است، حداکثر ۲۰۰ نویسه، هرگز با نقطه شروع یا تمام نمی‌شود و اگر چیزی نماند file می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

اسنیک Snake

تابع اسنیک(): گزینه ها
گزینه‌های پیش‌فرض با جداکننده‌ی زیرخط.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

شناسه Identifier

تابع شناسه(): گزینه ها
برای نام در کد: جداکننده‌ی زیرخط، حروف کوچک، هرگز با رقم شروع نمی‌شود (یک زیرخط جلویش می‌آید) و اگر چیزی نماند زیرخط می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

یونیکد Unicode

تابع یونیکد(): گزینه ها
گزینه‌های پیش‌فرضی که به‌جای آوانویسی، حرف‌های بومی همه‌ی خط‌ها را نگه می‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

افزودن کلمه های توقف AddStopWords

تابع افزودن کلمه های توقف(o &: گزینه ها، words: رشته)
کلمه‌هایی را که با فاصله یا ویرگول جدا شده‌اند و از اسلاگ‌ها کنار گذاشته می‌شوند اضافه می‌کند. پس از آوانویسی و بدون توجه به حالت حرف مقایسه می‌شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

افزودن جایگزین AddReplacement

تابع افزودن جایگزین(o &: گزینه ها، pattern: رشته، value: رشته)
یک جایگزین اضافه می‌کند: هر رخداد الگو در عنوان پیش از هر کار دیگر با مقدار عوض می‌شود. الگوها به ترتیب افزودن آزموده می‌شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

آزادسازی گزینه ها FreeOptions

تابع آزادسازی گزینه ها(o &: گزینه ها)
فهرست‌های کلمه‌ی توقف و جایگزین یک گزینه ها را آزاد می‌کند. رونوشت‌ها آن‌ها را به اشتراک دارند، پس یک بار آزاد کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Options.salam

ساخت با گزینه MakeWith

تابع ساخت با گزینه(text: رشته، o: گزینه ها): رشته
عنوان را با گزینه‌هایی که می‌دهید به اسلاگ تبدیل می‌کند. متن برگردانده را آزاد کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Make.salam

ساخت Make

تابع ساخت(text: رشته): رشته
عنوان را با گزینه‌های پیش‌فرض به اسلاگ تبدیل می‌کند: آوانویسی به ASCII، حروف کوچک، واژه‌ها با خط تیره، نمادها با کلمه و شکلک‌ها حذف. متن برگردانده را آزاد کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Make.salam

نویسه گردانی Transliterate

تابع نویسه گردانی(text: رشته، lang: رشته): رشته
متن را با حرف‌های لاتین می‌نویسد و بقیه‌چیز را به همان حال می‌گذارد: حالت حرف، فاصله و نشانه‌گذاری می‌مانند، رقم‌های خط‌های دیگر به ۰ تا ۹ تبدیل می‌شوند و شکلک و نمادی که املا ندارد به فاصله بدل می‌شود. زبان یک کد است مثل fa، ar، ru، uk، bg، sr، de، da یا tr؛ کد خالی از روی خط تشخیص داده می‌شود. متن برگردانده را آزاد کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Make.salam

شماره دار Numbered

تابع شماره دار(slug: رشته، n: صحیح، separator: رشته): رشته
اسلاگ را با جداکننده و یک شماره برمی‌گرداند، یا اگر شماره ۱ یا کمتر باشد خودِ اسلاگ را.
encoding-slug-Unique.salam
// زبان: فارسی
واردسازی کدگذاری.اسلاگ

تابع وسید(س: رشته): منطقی:
    برگشت س برابر "post" یا س برابر "post-2"
پایان

تابع ریشه:
    سرچاپ اسلاگ.یکتا("post"، (س: رشته): برگشت وسید(س) پایان)
    سرچاپ اسلاگ.یکتا با جداکننده("post"، "_"، (س: رشته): برگشت وسید(س) پایان)
    سرچاپ اسلاگ.شماره دار("post"، 5، "-")
    سرچاپ اسلاگ.اسلاگ است("post-3")
    سرچاپ اسلاگ.اسلاگ است با گزینه("Post_3"، اسلاگ.اسنیک())
پایان
خروجیpost-3 post_2 post-5 true false

یکتا با جداکننده UniqueWith

تابع یکتا با جداکننده(slug: رشته، separator: رشته، exists: تابع(رشته): منطقی): رشته
مثل Unique با جداکننده‌ای که انتخاب می‌کنید. پس از ده هزار تلاش شماره‌ای را که به آن رسیده برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Unique.salam

یکتا Unique

تابع یکتا(slug: رشته، exists: تابع(رشته): منطقی): رشته
اگر تابع بگوید اسلاگ آزاد است همان را برمی‌گرداند، وگرنه نخستین slug-2، slug-3 و ... که آزاد باشد. متن برگردانده را آزاد کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Unique.salam

اسلاگ است با گزینه IsSlugWith

تابع اسلاگ است با گزینه(s: رشته، o: گزینه ها): منطقی
می‌سنجد که متن برای گزینه‌های داده شده اسلاگ هست یا نه: جداکننده، حالت حرف، نویسه‌های مجاز، حرف‌های بومی، حد طول و قاعده‌ی شناسه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Unique.salam

اسلاگ است IsSlug

تابع اسلاگ است(s: رشته): منطقی
می‌سنجد که متن اسلاگی است که گزینه‌های پیش‌فرض می‌توانند بسازند: حرف و رقم کوچک ASCII، خط تیره‌ی تکی، بدون خط تیره در دو سر، و ناتهی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-slug-Unique.salam