Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gosimple/slug
URL-friendly slugify with multiple languages support.
https://github.com/gosimple/slug
go slug
Last synced: 24 days ago
JSON representation
URL-friendly slugify with multiple languages support.
- Host: GitHub
- URL: https://github.com/gosimple/slug
- Owner: gosimple
- License: mpl-2.0
- Created: 2014-03-31T06:24:51.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-27T19:16:12.000Z (3 months ago)
- Last Synced: 2024-04-18T18:43:00.484Z (about 1 month ago)
- Topics: go, slug
- Language: Go
- Size: 98.6 KB
- Stars: 1,082
- Watchers: 16
- Forks: 105
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go-cn - slug
- awesome-go-extra - slug - friendly slugify with multiple languages support.|850|86|13|2014-03-31T06:24:51Z|2022-08-23T05:48:57Z| (Bot Building / Slugifiers)
- awesome-go-zh - slug
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-stars - slug - friendly slugify with multiple languages support. | gosimple | 886 | (Go)
- awesome-go - slug - URL-friendly slugify with multiple languages support. Stars:`1.1K`. (Natural Language Processing / Slugifiers)
- awesome-go-cn - slug
- awesome-golang-repositories - slug - friendly slugify with multiple languages support. (Repositories)
- fucking-awesome-go - :octocat: slug - URL-friendly slugify with multiple languages support. :star: 77 :fork_and_knife: 10 (Text Processing / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go-projects - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go - slug - friendly slugify with multiple languages support. | - | - | - | (Text Processing / HTTP Clients)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go-with-framework - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go-cn - slug
- go-awesome-cn-star - slug
- zero-alloc-awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go-stars - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go. - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (<span id="文字处理-text-processing">文字处理 Text Processing</span> / <span id="高级控制台用户界面-advanced-console-uis">高级控制台用户界面 Advanced Console UIs</span>)
- awesome-go-with-stars - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- repo-1316-awesome-go-cn - slug
- repo-1211-awesome-go-cn - slug
- awesome-Char - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-reader - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- Go-awesome - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go-cn - slug - friendly slugify with multiple languages support.) (文本处理 / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go-handwritten - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go - slug - URL-friendly slugify with multiple languages support. - :arrow_down:168 - :star:80 (Text Processing / HTTP Clients)
- awesome-go2 - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / Advanced Console UIs)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Text Processing / HTTP Clients)
- awesome-go-zh - slug
- awesome-go-cn - slug
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. (Natural Language Processing / Slugifiers)
- awesome-go - slug - URL-friendly slugify with multiple languages support. - ★ 240 (Text Processing)
README
# slug
Package `slug` generate slug from Unicode string, URL-friendly slugify with
multiple languages support.[![Go Reference](https://pkg.go.dev/badge/github.com/gosimple/slug.svg)](https://pkg.go.dev/github.com/gosimple/slug)
[![Tests](https://github.com/gosimple/slug/actions/workflows/tests.yml/badge.svg)](https://github.com/gosimple/slug/actions/workflows/tests.yml)
[![codecov](https://codecov.io/gh/gosimple/slug/branch/master/graph/badge.svg?token=FT2kEZHQW7)](https://codecov.io/gh/gosimple/slug)
[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/gosimple/slug?logo=github&sort=semver)](https://github.com/gosimple/slug/releases)## Example
```go
package mainimport (
"fmt"
"github.com/gosimple/slug"
)func main() {
text := slug.Make("Hellö Wörld хелло ворлд")
fmt.Println(text) // Will print: "hello-world-khello-vorld"someText := slug.Make("影師")
fmt.Println(someText) // Will print: "ying-shi"enText := slug.MakeLang("This & that", "en")
fmt.Println(enText) // Will print: "this-and-that"deText := slug.MakeLang("Diese & Dass", "de")
fmt.Println(deText) // Will print: "diese-und-dass"slug.Lowercase = false // Keep uppercase characters
deUppercaseText := slug.MakeLang("Diese & Dass", "de")
fmt.Println(deUppercaseText) // Will print: "Diese-und-Dass"slug.CustomSub = map[string]string{
"water": "sand",
}
textSub := slug.Make("water is hot")
fmt.Println(textSub) // Will print: "sand-is-hot"
}
```## Design
This library will always returns clean output from any Unicode string
containing only the following ASCII characters:* numbers: `0-9`
* small letters: `a-z`
* big letters: `A-Z` (only if you set `Lowercase` to `false`)
* minus sign: `-`
* underscore: `_`Minus sign and underscore characters will never appear at the beginning or
the end of the returned string.Thanks to context-insensitive transliteration of Unicode characters to ASCII
output returned string is safe for URL slugs and filenames.## Requests or bugs?
If your language is missing you could add it in `languages_substitution.go`
file.In case of missing proper Unicode characters transliteration to ASCII you could
add them to underlying library:
.## Installation
```shell
go get -u github.com/gosimple/slug
```## Benchmarking
```shell
go test -run=NONE -bench=. -benchmem -count=6 ./... > old.txt
# make changes
go test -run=NONE -bench=. -benchmem -count=6 ./... > new.txtgo install golang.org/x/perf/cmd/benchstat@latest
benchstat old.txt new.txt
```## License
The source files are distributed under the
[Mozilla Public License, version 2.0](http://mozilla.org/MPL/2.0/),
unless otherwise noted.
Please read the [FAQ](http://www.mozilla.org/MPL/2.0/FAQ.html)
if you have further questions regarding the license.