diff --git a/banner-dark.png b/banner-dark.png new file mode 100644 index 0000000..f2bcc86 Binary files /dev/null and b/banner-dark.png differ diff --git a/banner.png b/banner.png new file mode 100644 index 0000000..f93dda5 Binary files /dev/null and b/banner.png differ diff --git a/readme.md b/readme.md index 33c5180..b352f60 100644 --- a/readme.md +++ b/readme.md @@ -1,38 +1,46 @@ -# PHP Türkçe Paketi 🇹🇷 + + + + + + +
+ +# PHP Türkçe Dil Paketi ![](https://github.com/aozisik/turkce/workflows/run-tests/badge.svg) +[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md) +[![Total Downloads](https://img.shields.io/packagist/dt/aozisik/php-turkce.svg?style=flat-square)](https://packagist.org/packages/aozisik/php-turkce) ## Ne yapar? -- Türkçe sözcüğün içindeki harfleri bozmadan büyültür/küçültür veya başlık yapar. +- PHP'nin `strtoupper` ve `strtolower` fonksiyonları Türkçe ile uyumsuzdur. Bu paket, i ve I harflerini bozmadan büyük ve küçük harfe çevirir. - Verilen Türkçe sözcüğü veya özel ismi, istenen eke göre çekimler. (-e, -i, -in, -de, -den) ## Kurulum - composer require aozisik/php-turkce +```bash +composer require aozisik/php-turkce +``` ## Kullanım -### Sözcükleri Büyültme/Küçültme ve Başlık Yapma +### Basit kullanım: -PHP'de `strtoupper` ve `strtolower` fonksiyonları Türkçe ile uyumsuzdur. Yerine tavsiye edilen `mb_strtoupper` ve `mb_strtolower` ise neredeyse çalışır, ama i ve I harflerini düzgün çeviremez. +Büyük/küçük harfe çevirme metotlarının başına `tr_` ekleyerek kullanın. -Bu kütüphane size düzgün şekilde büyültme/küçültme yapan metotlar verir. +- `strtoupper` -> `tr_strtoupper` +- `strtolower` -> `tr_strtolower` -```php -// Normal strtoupper ile: -strtoupper('izmirin ılık ilkbaharları'); // IZMIRIN ıLıK ILKBAHARLARı +### Alternatif kullanım: +```php // Büyültme turkce('izmirin ılık ilkbaharları')->buyuk(); // İZMİRİN ILIK İLKBAHARLARI -// veya -tr_strtoupper('izmirin ılık ilkbaharları'); // İZMİRİN ILIK İLKBAHARLARI // Küçültme turkce('İZMİRİN ILIK İLKBAHARLARI')->kucuk(); // izmirin ılık ilkbaharları -// veya -tr_strtolower('İZMİRİN ILIK İLKBAHARLARI'); // izmirin ılık ilkbaharları // Başlık turkce('İZMİRİN ILIK İLKBAHARLARI')->baslik(); // İzmirin Ilık İlkbaharları @@ -43,16 +51,14 @@ turkce('İZMİRİN ILIK İLKBAHARLARI')->baslik(); // İzmirin Ilık İlkbaharla İsimlerin yanına gelen ekleri koda gömersek "Ahmet'nin" veya "Hikmet'ye" gibi Türkçe'ye uygun olmayan ve hiç doğal gözükmeyen bir sonuç elde ederiz. Onun yerine, bırakın Türkçe paketi ismi uygun haline çeksin. ```php +// Çekimleme turkce('İstanbul')->den(); // "İstanbul'dan" turkce('Hatice')->i(); // "Hatice'yi" turkce('Kemal')->in(); // "Kemal'in" turkce('Kazım')->e(); // "Kazım'a" turkce('Asu')->de(); // "Asu'da" -``` -Hatta bunu bir önceki metotla da birleştirebilirsiniz: - -```php +// Hatta bunu diğer özelliklerle de birleştirebilirsiniz: turkce('güzel istanbul')->dan()->baslik(); // "Güzel İstanbul'dan" ```