Teks & alat sehari-hari · Perangkat Teks
URL konvensi slug: tanda hubung, huruf kecil, dan apa yang diizinkan oleh RFC 3986
· Latar belakang
url-siput manajemen konten alat teks
Menjelaskan dari mana slug berasal, karakter mana yang RFC 3986 tidak dicadangkan, mengapa tanda hubung menang atas garis bawah dan mengapa huruf kecil penting, dan bagaimana aturan ini membentuk apa yang dihasilkan oleh generator slug.
URL yang tidak dapat dibaca oleh siapa pun — spasi sebagai %20, huruf kapital yang memutus tautan, dan alasan keberadaan slug
Jalur laman seperti `New Product Launch 2026` terasa janggal bila disalin langsung ke URL. Spasi memerlukan representasi lain, huruf kapital campuran menyebabkan pengetikan tidak konsisten, dan tanda baca dapat membuat alamat lebih sulit dipindai. Siput memberikan halaman segmen jalur ringkas yang dapat dikenali orang di samping nama situs.
Repositori tidak mendokumentasikan kapan slug berasal atau membuktikan alasan universal penerapannya, jadi pertanyaan yang berguna di sini adalah operasional. Pemilik situs memerlukan satu transformasi berulang dari judul yang dapat diedit menjadi jalur yang dapat dipublikasikan. ToolAcre menyediakan transformasi tersebut tanpa berpura-pura bahwa hasilnya mempertahankan setiap detail tipografi.
URL tidak seorang pun dapat membacakan dengan lantang, tanpa memberikan cerita asal yang tidak terdokumentasi kepada siput
ToolAcre tidak mengimplementasikan parser atau validator RFC 3986 umum. Fungsi `slugify`-nya menormalkan masukan, menghilangkan tanda penggabungan, memperkecil hasil, mengganti jaringan karakter selain huruf dan angka dengan pemisah yang dipilih, dan memangkas pemisah dari kedua ujungnya. Aturan yang didukung sumber tersebut mendefinisikan generator ini dengan lebih tepat daripada label standar yang luas.
Perbedaan tersebut penting ketika menetapkan kebijakan pengelolaan konten. Sebuah karakter mungkin dapat digunakan di suatu tempat di URL sambil masih dihapus oleh transformasi slug khusus ini. Perlakukan jalur yang dihasilkan sebagai konvensi editorial, bukan sebagai inventaris lengkap dari setiap karakter URL hukum, pembatas yang dicadangkan, atau representasi berkode persen yang diterima oleh sistem lain.
Apa yang diterima oleh implementasi slug ini, bukan interpretasi RFC 3986 yang lengkap
Tanda hubung adalah pemisah default di `slugify`, dan tanda baca atau spasi yang berurutan diciutkan ke dalam jaringan pemisah yang sama. Oleh karena itu, judul `Quarterly report: costs & margins` menjadi `quarterly-report-costs-margins`, bukan menampilkan titik dua, ampersand, atau spasi di jalur. Outputnya tetap terlihat terbagi menjadi kata-kata.
Sumber tersebut tidak menetapkan bahwa tanda hubung dikalahkan oleh garis bawah melalui keputusan mesin pencari tertentu, sehingga sejarah tidak boleh disajikan sebagai fakta di sini. Panduan yang dapat dipertahankan lebih sederhana: pilih satu pemisah untuk situs, terapkan secara konsisten, dan hindari mencampurkan formulir yang berbeda secara manual hanya karena editor yang berbeda mengikuti kebiasaan yang berbeda.
Tanda hubung sebagai pemisah generator ini, tanpa mengklaim riwayat mesin pencari yang tidak didukung
Huruf kecil diterapkan sebelum siput dikembalikan. Hal ini membuat `About Our Team`, `ABOUT OUR TEAM`, dan `about our team` berkumpul di `about-our-team` dalam transformasi ini. Jalur huruf kecil yang dapat diprediksi lebih mudah direproduksi dari judul dan menghindari pembuatan varian editorial yang perbedaannya hanya pada huruf besar.
Apakah dua jalur dengan kasus berbeda dapat diselesaikan ke sumber daya yang sama bergantung pada aturan host, router, penerapan, dan pengalihan di sekitarnya; utilitas teks ini tidak dapat menentukan perilaku itu. Aturan praktis CMS adalah mempublikasikan satu jalur kanonik huruf kecil dan membuat kebijakan pengalihan apa pun secara eksplisit di tempat lain, daripada mengandalkan asumsi yang belum diverifikasi tentang penanganan kasus.
Panjang, kata hentikan, dan stabilitas — panduan praktis tentang apa yang harus disimpan dan apa yang harus dibuang
Lebih pendek tidak otomatis lebih baik. Pertahankan kata-kata yang memungkinkan editor membedakan halaman dari konten terdekat, terutama produk, tugas, atau nama subjek. Hapus kata-kata hanya jika jalur yang tersisa masih spesifik. Siput yang singkat namun ambigu menciptakan pekerjaan pemeliharaan ketika beberapa artikel kemudian bersaing untuk jalur kandidat yang sama.
ToolAcre mendukung opsi `maxLength` dalam fungsi dasarnya, tetapi konfigurasi case-converter menjelaskan tindakan slug seluruh teks daripada kontrol panjang yang terlihat. Yang lebih penting lagi, pemotongan bukanlah strategi editorial. Putuskan kata-kata mana yang penting sebelum dipublikasikan, lalu jaga agar slug yang dipilih tetap stabil ketika kata-kata kosmetik pada judul berubah setelah peluncuran.
Contoh praktis - mengubah tiga berita utama menjadi berita utama dan memeriksa masing-masing berita tersebut melanggar aturan
Perhatikan tiga judul utama. `Cafes, Costs & Margins` menjadi `cafes-costs-margins`; `Launch Notes: Version 2` menjadi `launch-notes-version-2`; dan `A Guide to Better Page Names` menjadi `a-guide-to-better-page-names`. Setiap hasil menggunakan huruf kecil, menggunakan tanda hubung di antara jaringan kata yang dipertahankan, dan menghilangkan tanda baca yang bukan huruf atau angka.
Contoh pertama sengaja dibuat polos ASCII, namun aturan sumber yang sama dapat melipat aksen yang terurai dari huruf Latin ke bentuk dasarnya. Tinjau setiap hasil sebelum menugaskannya ke konten: fungsi tersebut tidak memiliki pengetahuan tentang ejaan merek, singkatan yang disukai, rute duplikat, atau kata-kata yang dianggap dapat dibuang oleh tim editorial.
Apa yang tidak tercakup dalam hal ini — nama domain yang diinternasionalkan dan pilihan untuk menyimpan skrip non-Latin di URL
Huruf non-Latin tidak dibuang secara universal dalam penerapan ini. Ekspresi reguler mempertahankan huruf dan angka di seluruh skrip, sedangkan konfigurasi menyatakan bahwa slug mempertahankan huruf kecil non-Latin tanpa transliterasi. Oleh karena itu, mengklaim bahwa alat tersebut selalu mengonversi judul menjadi ASCII akan bertentangan dengan sumber dan batasan alat yang dipublikasikan.
Transformasi ini juga tidak mengonfigurasi nama domain yang diinternasionalkan, memilih nama host, atau mentransliterasi kata antar sistem penulisan. Itu adalah keputusan kebijakan yang terpisah. Untuk situs multibahasa, uji jalur yang dihasilkan di CMS aktual dan tumpukan perutean, lalu putuskan apakah skrip yang dipertahankan atau terjemahan yang dibuat secara terpisah paling sesuai untuk situs tersebut.
Huruf non-Latin dipertahankan; transliterasi dan nama domain berada di luar transformasi ini
Kebijakan slug yang berguna bisa ringkas: mulai dengan judul halaman, huruf kecil, gabungkan jaringan kata yang dikenali dengan tanda hubung, hapus pemisah di sekitarnya, pertahankan nomor yang bermakna, dan tinjau hasilnya untuk kejelasan sebelum dipublikasikan. Catat perilaku tabrakan dan pengalihan dalam aturan CMS, karena transformasi teks tidak dapat memeriksa rute yang ada atau melindungi tautan masuk.
Konverter huruf besar/kecil menerapkan bagian mekanis dalam satu tindakan. Tempelkan judul, pilih transformasi slug, dan periksa hasilnya sebelum menyalinnya ke jalur halaman. Ini melipat aksen yang didukung, menghilangkan simbol, menciutkan pemisah, dan menghasilkan teks huruf kecil, meninggalkan makna konten dan stabilitas URL jangka panjang pada editor.