@intlayer/docs 5.8.1 → 6.0.0-canary.0

package/docs/tr/dictionary/gender.md

@@ -0,0 +1,279 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Cinsiyete Dayalı İçerik
+description: Intlayer'da cinsiyete dayalı içeriği kullanarak cinsiyete göre içeriği dinamik olarak nasıl görüntüleyeceğinizi öğrenin. Bu dokümantasyonu takip ederek projenizde cinsiyete özel içeriği verimli bir şekilde uygulayın.
+keywords:
+  - Cinsiyete Dayalı İçerik
+  - Dinamik Oluşturma
+  - Dokümantasyon
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - content
+  - gender
+---
+
+# Cinsiyete Dayalı İçerik / Intlayer'da Cinsiyet
+
+## Cinsiyet Nasıl Çalışır
+
+Intlayer'da cinsiyete dayalı içerik, belirli cinsiyet değerlerini ('male', 'female') karşılık gelen içeriklerine eşleyen `gender` fonksiyonu aracılığıyla gerçekleştirilir. Bu yaklaşım, verilen cinsiyete göre içeriği dinamik olarak seçmenizi sağlar. React Intlayer veya Next Intlayer ile entegre edildiğinde, çalışma zamanında sağlanan cinsiyete göre uygun içerik otomatik olarak seçilir.
+
+## Cinsiyete Dayalı İçeriği Ayarlama
+
+Intlayer projenizde cinsiyete dayalı içeriği ayarlamak için, cinsiyete özel tanımlarınızı içeren bir içerik modülü oluşturun. Aşağıda çeşitli formatlarda örnekler verilmiştir.
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { gender, type Dictionary } from "intlayer";
+
+const myGenderContent = {
+  key: "my_key",
+  content: {
+    myGender: gender({
+      male: "erkek kullanıcılar için içeriğim",
+      female: "kadın kullanıcılar için içeriğim",
+      fallback: "cinsiyet belirtilmediğinde içeriğim", // İsteğe bağlı
+    }),
+  },
+} satisfies Dictionary;
+
+export default myGenderContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { gender } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myGenderContent = {
+  key: "my_key",
+  content: {
+    myGender: gender({
+      male: "erkek kullanıcılar için içeriğim",
+      female: "kadın kullanıcılar için içeriğim",
+      fallback: "cinsiyet belirtilmediğinde içeriğim", // İsteğe bağlı
+    }),
+  },
+};
+
+export default myGenderContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { gender } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myGenderContent = {
+  key: "my_key",
+  content: {
+    myGender: gender({
+      male: "erkek kullanıcılar için içeriğim",
+      female: "kadın kullanıcılar için içeriğim",
+      fallback: "cinsiyet belirtilmediğinde içeriğim", // İsteğe bağlı
+    }),
+  },
+};
+
+module.exports = myGenderContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myGender": {
+      "nodeType": "gender",
+      "gender": {
+        "male": "erkek kullanıcılar için içeriğim",
+        "female": "kadın kullanıcılar için içeriğim",
+        "fallback": "cinsiyet belirtilmediğinde içeriğim", // İsteğe bağlı
+      },
+    },
+  },
+}
+```
+
+> Eğer hiçbir fallback bildirilmezse, cinsiyet belirtilmezse veya tanımlanan herhangi bir cinsiyetle eşleşmezse bildirilen son anahtar fallback olarak alınacaktır.
+
+## React Intlayer ile Cinsiyete Dayalı İçeriği Kullanma
+
+Bir React bileşeninde cinsiyete dayalı içeriği kullanmak için, `react-intlayer` paketinden `useIntlayer` hook'unu içe aktarın ve kullanın. Bu hook, belirtilen anahtar için içeriği getirir ve uygun çıktıyı seçmek için bir cinsiyet geçmenizi sağlar.
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const GenderComponent: FC = () => {
+  const { myGender } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Çıktı: erkek kullanıcılar için içeriğim */
+          myGender("male")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: kadın kullanıcılar için içeriğim */
+          myGender("female")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: erkek kullanıcılar için içeriğim */
+          myGender("m")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: kadın kullanıcılar için içeriğim */
+          myGender("f")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: cinsiyet belirtilmediğinde içeriğim */
+          myGender("")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: cinsiyet belirtilmediğinde içeriğim */
+          myGender(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default GenderComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const GenderComponent = () => {
+  const { myGender } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Çıktı: erkek kullanıcılar için içeriğim */
+          myGender("male")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: kadın kullanıcılar için içeriğim */
+          myGender("female")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: erkek kullanıcılar için içeriğim */
+          myGender("m")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: kadın kullanıcılar için içeriğim */
+          myGender("f")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: cinsiyet belirtilmediğinde içeriğim */
+          myGender("")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: cinsiyet belirtilmediğinde içeriğim */
+          myGender(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default GenderComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const GenderComponent = () => {
+  const { myGender } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Çıktı: erkek kullanıcılar için içeriğim */
+          myGender("male")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: kadın kullanıcılar için içeriğim */
+          myGender("female")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: erkek kullanıcılar için içeriğim */
+          myGender("m")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: kadın kullanıcılar için içeriğim */
+          myGender("f")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: cinsiyet belirtilmediğinde içeriğim */
+          myGender("")
+        }
+      </p>
+      <p>
+        {
+          /* Çıktı: cinsiyet belirtilmediğinde içeriğim */
+          myGender(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = GenderComponent;
+```
+
+## Ek Kaynaklar
+
+Yapılandırma ve kullanım hakkında daha detaylı bilgi için aşağıdaki kaynaklara başvurun:
+
+- [Intlayer CLI Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
+- [React Intlayer Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_create_react_app.md)
+- [Next Intlayer Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_15.md)
+
+Bu kaynaklar, çeşitli ortamlar ve çerçevelerde Intlayer'ın kurulumu ve kullanımı hakkında daha fazla bilgi sunar.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm | Tarih      | Değişiklikler                     |
+| ----- | ---------- | --------------------------------- |
+| 5.7.2 | 2025-07-27 | Cinsiyete dayalı içerik tanıtıldı |
+
+```
+
+```

package/docs/tr/dictionary/insertion.md

@@ -0,0 +1,191 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: Ekleme
+description: İçeriğinizde ekleme yer tutucularını nasıl bildireceğinizi ve kullanacağınızı öğrenin. Bu dokümantasyon, önceden tanımlanmış içerik yapıları içinde değerleri dinamik olarak ekleme adımlarında size rehberlik eder.
+keywords:
+  - Ekleme
+  - Dinamik İçerik
+  - Yer Tutucular
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - content
+  - insertion
+---
+
+# Ekleme İçeriği / Intlayer'da Ekleme
+
+## Ekleme Nasıl Çalışır
+
+Intlayer'da ekleme içeriği, `insertion` fonksiyonu aracılığıyla gerçekleştirilir ve bir dizedeki yer tutucu alanlarını (örneğin `{{name}}` veya `{{age}}`) çalışma zamanında dinamik olarak değiştirilebilir olarak tanımlar. Bu yaklaşım, uygulamanızdan geçirilen verilere göre içeriğin belirli bölümlerinin belirlendiği esnek, şablon benzeri dizeler oluşturmanıza olanak sağlar.
+
+React Intlayer veya Next Intlayer ile entegre edildiğinde, her yer tutucu için değerleri içeren veri nesnesini sağlamanız yeterlidir ve Intlayer yer tutucuların değiştirildiği içerikle otomatik olarak işler.
+
+## Ekleme İçeriğini Ayarlama
+
+Intlayer projenizde ekleme içeriğini ayarlamak için, ekleme tanımlarınızı içeren bir içerik modülü oluşturun. Aşağıda çeşitli formatlarda örnekler verilmiştir.
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { insert, type Dictionary } from "intlayer";
+
+const myInsertionContent = {
+  key: "my_key",
+  content: {
+    myInsertion: insert("Merhaba, adım {{name}} ve {{age}} yaşındayım!"),
+  },
+} satisfies Dictionary;
+
+export default myInsertionContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { insert } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myInsertionContent = {
+  key: "my_key",
+  content: {
+    myInsertion: insert("Merhaba, adım {{name}} ve {{age}} yaşındayım!"),
+  },
+};
+
+export default myInsertionContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { insert } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myInsertionContent = {
+  key: "my_key",
+  content: {
+    myInsertion: insert("Merhaba, adım {{name}} ve {{age}} yaşındayım!"),
+  },
+};
+
+module.exports = myInsertionContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myInsertion": {
+      "nodeType": "insertion",
+      "insertion": "Merhaba, adım {{name}} ve {{age}} yaşındayım!",
+    },
+  },
+}
+```
+
+## React Intlayer ile Ekleme İçeriğini Kullanma
+
+Bir React bileşeninde ekleme içeriğini kullanmak için, `react-intlayer` paketinden `useIntlayer` hook'unu içe aktarın ve kullanın. Bu hook, belirtilen anahtar için içeriği alır ve içeriğinizdeki her yer tutucuyu görüntülemek istediğiniz değere eşleyen bir nesne geçmenizi sağlar.
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const InsertionComponent: FC = () => {
+  const { myInsertion } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Çıktı: "Merhaba, adım John ve 30 yaşındayım!" */
+          myInsertion({ name: "John", age: "30" })
+        }
+      </p>
+      <p>
+        {
+          /* Aynı eklemeyi farklı değerlerle yeniden kullanabilirsiniz */
+          myInsertion({ name: "Alice", age: "25" })
+        }
+      </p>
+    </div>
+  );
+};
+
+export default InsertionComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const InsertionComponent = () => {
+  const { myInsertion } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Çıktı: "Merhaba, adım John ve 30 yaşındayım!" */
+          myInsertion({ name: "John", age: "30" })
+        }
+      </p>
+      <p>
+        {
+          /* Aynı eklemeyi farklı değerlerle yeniden kullanabilirsiniz */
+          myInsertion({ name: "Alice", age: "25" })
+        }
+      </p>
+    </div>
+  );
+};
+
+export default InsertionComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const InsertionComponent = () => {
+  const { myInsertion } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Çıktı: "Merhaba, adım John ve 30 yaşındayım!" */
+          myInsertion({ name: "John", age: "30" })
+        }
+      </p>
+      <p>
+        {
+          /* Aynı eklemeyi farklı değerlerle yeniden kullanabilirsiniz */
+          myInsertion({ name: "Alice", age: "25" })
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = InsertionComponent;
+```
+
+## Ek Kaynaklar
+
+Yapılandırma ve kullanım hakkında daha detaylı bilgi için aşağıdaki kaynaklara başvurun:
+
+- [Intlayer CLI Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
+- [React Intlayer Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_create_react_app.md)
+- [Next Intlayer Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_15.md)
+
+Bu kaynaklar, çeşitli ortamlar ve çerçevelerde Intlayer'ın kurulumu ve kullanımı hakkında daha fazla bilgi sunar.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |
+
+```
+
+```