Metadata-Version: 2.4
Name: turkce-seo-slug
Version: 0.1.2
Summary: Türkçe başlıklardan SEO uyumlu URL slug'ı üretir. / Generates SEO-friendly URL slugs from Turkish titles.
Author: Evren Erten
License: MIT
Keywords: turkish,türkçe,slug,seo,url
Classifier: Programming Language :: Python :: 3
Classifier: Natural Language :: Turkish
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: turkce-harf>=0.1.1
Provides-Extra: test
Requires-Dist: pytest>=7; extra == "test"
Dynamic: license-file

# turkce-seo-slug

Türkçe başlıklardan SEO uyumlu URL slug'ı üretir.

```bash
pip install turkce-seo-slug
```

## Kullanım

```python
from turkce_seo_slug import tr_slug

tr_slug("Çok güzel başlık! İstanbul'da")
# 'cok-guzel-baslik-istanbulda'

tr_slug("Uzun bir SEO başlığı örneği", max_length=15)
# 'uzun-bir-seo'   (kelime sınırında kesilir)

tr_slug("Café Ünlü", lang="en")
# 'cafe-unlu'
```

## Parametreler

- `lang`: `"tr"` (varsayılan) Türkçe harfleri aksansız karşılığına çevirir. `"en"` yalnızca aksanları kaldırır.
- `separator`: Kelimeler arasındaki ayırıcı. Varsayılan `"-"`.
- `max_length`: Slug'ın en fazla uzunluğu. Kelime sınırında keser, tek kelime bile sığmıyorsa sertçe keser.

Kesme işaretleri kelimeyi bölmez: `İstanbul'da` → `istanbulda`.

Harf dönüşümleri `turkce-harf` paketinden gelir.

## Geliştirme

```bash
pip install -e ".[test]"
pytest
```

## Lisans

MIT

---

# turkce-seo-slug (English)

Generates SEO-friendly URL slugs from Turkish titles.

```bash
pip install turkce-seo-slug
```

## Usage

```python
from turkce_seo_slug import tr_slug

tr_slug("Çok güzel başlık! İstanbul'da")
# 'cok-guzel-baslik-istanbulda'

tr_slug("Uzun bir SEO başlığı örneği", max_length=15)
# 'uzun-bir-seo'   (cut at a word boundary)

tr_slug("Café Ünlü", lang="en")
# 'cafe-unlu'
```

## Parameters

- `lang`: `"tr"` (default) converts Turkish letters to their plain ASCII forms. `"en"` only removes accents.
- `separator`: Separator between words. Default `"-"`.
- `max_length`: Maximum slug length. Cuts at a word boundary; if a single word does not fit, it is cut hard.

Apostrophes do not split words: `İstanbul'da` → `istanbulda`.

Letter conversions come from the `turkce-harf` package.

## Development

```bash
pip install -e ".[test]"
pytest
```

## License

MIT
