Madeorsk
d7a8db9d90
+ Add `slugify` and `slugifySeparator` to convert a provided string to a slugged version of it. + Add tests. + Write a tiny documentation with examples.
102 lines
2.5 KiB
Markdown
102 lines
2.5 KiB
Markdown
<h1 align="center">
|
||
zlugify
|
||
</h1>
|
||
|
||
<p align="center">
|
||
Generate ASCII slugs from unicode strings
|
||
</p>
|
||
|
||
zlugify is part of [_zedd_](https://code.zeptotech.net/zedd), a collection of useful libraries for zig.
|
||
|
||
## zlugify
|
||
|
||
_zlugify_ is a library to generate slugs from all types of UTF-8 encoded strings. It uses [anyascii.zig](https://code.zeptotech.net/zedd/anyascii.zig) to convert UTF-8 encoded strings into ASCII-only strings.
|
||
|
||
## Versions
|
||
|
||
ZRM 1.0.0 is made and tested with zig 0.13.0.
|
||
|
||
## How to use
|
||
|
||
### Install
|
||
|
||
In your project directory:
|
||
|
||
```shell
|
||
$ zig fetch --save https://code.zeptotech.net/zedd/zlugify/archive/v1.0.0.tar.gz
|
||
```
|
||
|
||
In `build.zig`:
|
||
|
||
```zig
|
||
// Add zlugify dependency.
|
||
const zlugify = b.dependency("zlugify", .{
|
||
.target = target,
|
||
.optimize = optimize,
|
||
});
|
||
exe.root_module.addImport("zlugify", zlugify.module("zlugify"));
|
||
```
|
||
|
||
### Examples
|
||
|
||
These examples are highly inspired from the test cases that you can find at the end of [`lib.zig`](https://code.zeptotech.net/zedd/zlugify/src/branch/main/src/lib.zig).
|
||
|
||
#### trim and normalize
|
||
|
||
```zig
|
||
const slugify = @import("zlugify").slugify;
|
||
|
||
const slug = try slugify(allocator, " This is a test.\t\n");
|
||
defer allocator.free(slug);
|
||
try std.testing.expectEqualStrings("this-is-a-test", slug);
|
||
```
|
||
|
||
#### remove diacritics and unnecessary spaces
|
||
|
||
```zig
|
||
const slugify = @import("zlugify").slugify;
|
||
|
||
const slug = try slugify(allocator, "SôMÈThing \t ÉLSÈ");
|
||
defer allocator.free(slug);
|
||
try std.testing.expectEqualStrings("something-else", slug);
|
||
```
|
||
|
||
#### convert non-latin characters
|
||
|
||
```zig
|
||
const slugify = @import("zlugify").slugify;
|
||
|
||
const slug = try slugify(allocator, "埼玉 県");
|
||
defer allocator.free(slug);
|
||
try std.testing.expectEqualStrings("qiyu-xian", slug);
|
||
```
|
||
|
||
#### convert ascii-like characters
|
||
|
||
```zig
|
||
const slugify = @import("zlugify").slugify;
|
||
|
||
const slug = try slugify(allocator, "𝒔𝒍𝒖𝒈𝒊𝒇𝒚 𝒂 𝒔𝒕𝒓𝒊𝒏𝒈");
|
||
defer allocator.free(slug);
|
||
try std.testing.expectEqualStrings("slugify-a-string", slug);
|
||
```
|
||
|
||
#### convert emojis
|
||
|
||
```zig
|
||
const slugify = @import("zlugify").slugify;
|
||
|
||
const slug = try slugify(allocator, "hello 🦊");
|
||
defer allocator.free(slug);
|
||
try std.testing.expectEqualStrings("hello-fox", slug);
|
||
```
|
||
|
||
#### customized separator
|
||
|
||
```zig
|
||
const slugifySeparator = @import("zlugify").slugify;
|
||
|
||
const slug = try slugifySeparator(allocator, "tôi yêu những chú kỳ lân", '_');
|
||
defer allocator.free(slug);
|
||
try std.testing.expectEqualStrings("toi_yeu_nhung_chu_ky_lan", slug);
|
||
```
|