普贤教程 › 包参考

slug 包

slug / URL 友好标识

项	值
包名	`slug`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`slug.px`
分类	`文本与中文处理`
文件数 / 行数	`1 / 262`

安装与引入

bash

pxpkg init          # 首次
pxpkg add slug@0.2.0
pxpkg install

import slug

所属分类教程：文本与中文处理

公开接口

函数	参数
`sl_slug`	`s`
`sl_slug_ascii`	`s`

其余 18 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`sl_is_ascii_alnum`	`c`
`sl_is_cjk`	`c`
`sl_build`	`s, keep_cjk`
`sl_slug_sep`	`s, sep`
`sl_slug_max`	`s, max_len`
`sl_slug_prefix`	`s, prefix`
`sl_is_valid`	`s`
`sl_slug_unique`	`s, existing`
`sl_contains`	`arr, v`
`sl_unslug`	`s`
`sl_slug_id`	`s, suffix`
`sl_strip_accents`	`text`
`sl_transliterate`	`text`
`sl_slugify_unicode`	`text, separator = "-"`
`sl_custom_map`	`text, char_map`
`sl_slugify`	`text, separator = "-"`
`sl_truncate_slug`	`slug, max_len`
`sl_make_unique`	`slug, existing`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/slug —— slug / URL 友好标识
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
sl_slug(s)        → str   默认：ASCII 字母数字小写 + 中文 CJK 保留，
其余分隔字符折叠为单个 "-"（首尾去除）
sl_slug_ascii(s)  → str   严格 ASCII：非 ASCII 一律折叠为 "-"
说明：
- 未做拉丁变音转写（á→a 需要 unicode 表，无 native 见登记 PX-DEF-015 一族），
非 ASCII 默认策略 = 保留 CJK / 丢弃其它
============================================================