How-to guides
v0.0.1
Each guide covers one task with Mishka Slug: keep the scripts your site allows, change how accents, separators and length are written, write the slug in an Ash resource, handle each error and translate its message, and add a language the built-in table does not know.
Pick the guide for the job in front of you. The pages below show each one with a short summary.
- Keep the scripts your site allows Set the language of a title and the languages of a site so Mishka Slug keeps the right scripts, folds Arabic into Persian and spells German accents.
- Control accents, separators and length Keep or remove Latin accents, keep underscores and dots, glue or split the Persian half-space, refuse mixed-script words and cap a slug with max_length.
- Write the slug in an Ash resource Add MishkaSlug.Change to an Ash action so the slug follows the title, uses the record's language and the site's locales, and fails on the title field.
- Handle errors and translate messages Handle every error slugify/2 returns, turn a reason into a message for a form, translate the messages with Gettext and know what raises instead.
- Add a language with a script resolver Teach Mishka Slug a language code its table does not know with a script resolver, per call or in config, or take the scripts from CLDR with Localize.