Teks & alat harian · Kit Alat Teks
URL konvensyen slug: sempang, huruf kecil dan apa yang RFC 3986 dibenarkan
· Latar belakang
url-slug pengurusan kandungan alat teks
Menjelaskan dari mana slug berasal, aksara RFC 3986 yang tidak disimpan, sebab tanda sempang memenangi garis bawah dan sebab huruf kecil penting, dan cara peraturan ini membentuk perkara yang dihasilkan oleh penjana siput.
URL tiada siapa boleh membaca dengan kuat — ruang sebagai %20, huruf besar yang memutuskan pautan dan sebab slug wujud
Laluan halaman seperti `New Product Launch 2026` adalah janggal apabila disalin terus ke dalam URL. Ruang memerlukan perwakilan lain, huruf besar bercampur mengundang penaipan yang tidak konsisten dan tanda baca boleh menjadikan alamat lebih sukar untuk diimbas. Slug memberikan halaman segmen laluan padat yang boleh dikenali orang di sebelah nama tapak.
Repositori tidak mendokumenkan apabila slug berasal atau membuktikan sebab universal untuk penggunaannya, jadi soalan berguna di sini adalah beroperasi. Pemilik tapak memerlukan satu transformasi berulang daripada tajuk boleh diedit kepada laluan boleh diterbitkan. ToolAcre membekalkan transformasi itu tanpa berpura-pura hasilnya mengekalkan setiap butiran tipografi.
URL tiada siapa yang boleh membaca dengan kuat, tanpa memberikan cerita asal tanpa dokumen kepada slug
ToolAcre tidak melaksanakan penghurai atau pengesah RFC 3986 umum. Fungsi `slugify`nya menormalkan input, mengalih keluar tanda gabungan, huruf kecil hasilnya, menggantikan larian aksara selain huruf dan nombor dengan pemisah yang dipilih dan memangkas pemisah dari kedua-dua hujungnya. Peraturan yang disokong sumber tersebut mentakrifkan penjana ini dengan lebih tepat daripada label piawaian yang luas.
Perbezaan itu penting apabila menetapkan dasar pengurusan kandungan. Aksara mungkin boleh digunakan di suatu tempat dalam URL sementara masih dialih keluar oleh transformasi slug tertentu ini. Anggap laluan yang dijana sebagai konvensyen editorial, bukan sebagai inventori lengkap setiap aksara URL sah, pembatas terpelihara atau perwakilan berkod peratus yang diterima oleh sistem lain.
Perkara yang diterima oleh pelaksanaan slug ini, bukannya tafsiran RFC 3986 yang lengkap
Tanda sempang ialah pemisah lalai dalam `slugify` dan tanda baca atau ruang kosong berturut-turut runtuh ke dalam larian pemisah yang sama. Oleh itu, tajuk `Quarterly report: costs & margins` menjadi `quarterly-report-costs-margins`, dan bukannya mendedahkan titik bertindih, ampersand atau ruang dalam laluan. Keluaran kekal terbahagi kepada perkataan.
Sumber itu tidak menetapkan bahawa tanda sempang yang dikalahkan menggariskan melalui keputusan enjin carian tertentu, supaya sejarah tidak harus dibentangkan sebagai fakta di sini. Panduan yang boleh dipertahankan adalah lebih mudah: pilih satu pemisah untuk tapak, gunakannya secara konsisten dan elakkan mencampurkan borang secara manual yang berbeza sahaja kerana editor berasingan mengikut tabiat berasingan.
Tanda sempang sebagai pemisah penjana ini, tanpa menuntut sejarah enjin carian yang tidak disokong
Huruf kecil digunakan sebelum slug dikembalikan. Itu menjadikan `About Our Team`, `ABOUT OUR TEAM` dan `about our team` bertumpu pada `about-our-team` di bawah perubahan ini. Laluan huruf kecil yang boleh diramal adalah lebih mudah untuk dihasilkan semula daripada tajuk dan mengelakkan daripada mencipta varian editorial yang perbezaannya sahaja boleh dilihat ialah huruf besar.
Sama ada dua laluan fail yang berbeza diselesaikan kepada sumber yang sama bergantung pada peraturan hos, penghala, penempatan dan ubah hala di sekeliling; utiliti teks ini tidak dapat menentukan tingkah laku itu. Peraturan CMS yang praktikal ialah menerbitkan satu laluan berkanun huruf kecil dan membuat sebarang dasar ubah hala jelas di tempat lain, dan bukannya bergantung pada andaian yang tidak disahkan tentang pengendalian kes.
Panjang, menghentikan perkataan dan kestabilan — panduan praktikal tentang perkara yang perlu disimpan dalam slug dan perkara yang perlu digugurkan
Lebih pendek tidak secara automatik lebih baik. Simpan perkataan yang membolehkan editor membezakan halaman daripada kandungan berdekatan, terutamanya produk, tugas atau nama subjek. Gugurkan perkataan sahaja apabila laluan yang tinggal masih khusus. Slug yang ringkas tetapi samar-samar mencipta kerja penyelenggaraan apabila beberapa artikel kemudian bersaing untuk laluan calon yang sama.
ToolAcre menyokong pilihan `maxLength` dalam fungsi asasnya, tetapi konfigurasi penukar kes menerangkan tindakan slug teks keseluruhan dan bukannya kawalan panjang yang boleh dilihat. Lebih penting lagi, pemotongan bukan strategi editorial. Tentukan perkataan yang penting sebelum diterbitkan, kemudian pastikan slug yang dipilih stabil apabila kata-kata tajuk kosmetik berubah selepas pelancaran.
Contoh yang berkesan — menukar tiga tajuk sebenar kepada slug dan menyemak setiap satu daripada peraturan
Pertimbangkan tiga tajuk 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 adalah huruf kecil, menggunakan tanda sempang antara larian perkataan yang dikekalkan dan mengalih keluar tanda baca yang bukan huruf atau nombor.
Contoh pertama adalah sengaja ASCII, tetapi peraturan sumber yang sama boleh melipat loghat terurai daripada huruf Latin ke bentuk asasnya. Semak setiap hasil carian sebelum memberikannya kepada kandungan: fungsi itu tidak mempunyai pengetahuan tentang ejaan jenama, singkatan pilihan, laluan pendua atau perkataan yang dianggap boleh dibelanjakan oleh pasukan editorial.
Perkara ini tidak meliputi — nama domain antarabangsa dan pilihan untuk menyimpan skrip bukan Latin dalam URL
Huruf bukan Latin tidak dibuang secara universal oleh pelaksanaan ini. Ungkapan biasa mengekalkan huruf dan nombor merentas skrip, manakala konfigurasi menyatakan bahawa slug mengekalkan skrip bukan Latin dalam huruf kecil tanpa transliterasi. Mendakwa bahawa alat itu sentiasa menukar tajuk kepada ASCII oleh itu akan bercanggah dengan kedua-dua sumber dan had alat yang diterbitkan.
Transformasi ini juga tidak mengkonfigurasi nama domain antarabangsa, memilih nama hos, atau mentransliterasi perkataan antara sistem penulisan. Itu adalah keputusan dasar yang berasingan. Untuk tapak berbilang bahasa, uji laluan yang dijana dalam CMS dan timbunan penghalaan sebenar, kemudian tentukan sama ada skrip yang dikekalkan atau terjemahan yang dikarang berasingan berfungsi dengan baik untuk tapak tersebut.
Huruf bukan Latin dikekalkan; transliterasi dan nama domain berada di luar perubahan ini
Dasar slug yang berguna boleh ringkas: mulakan dengan tajuk halaman, huruf kecil, sertai larian perkataan yang diiktiraf dengan tanda sempang, alih keluar pemisah sekeliling, kekalkan nombor yang bermakna dan semak keputusan untuk kejelasan sebelum diterbitkan. Merekodkan perlanggaran dan tingkah laku ubah hala dalam peraturan CMS, kerana transformasi teks tidak boleh memeriksa laluan sedia ada atau melindungi pautan masuk.
Penukar kes teks menggunakan bahagian mekanikal dalam satu tindakan. Tampalkan tajuk, pilih transformasi slug dan periksa output sebelum menyalinnya ke laluan halaman. Ia melipat aksen yang disokong, mengalih keluar simbol, meruntuhkan pemisah dan menghasilkan teks huruf kecil, meninggalkan makna kandungan dan kestabilan URL jangka panjang dengan editor.