@intlayer/docs 7.1.9 → 7.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/dist/cjs/generated/docs.entry.cjs +19 -0
- package/dist/cjs/generated/docs.entry.cjs.map +1 -1
- package/dist/esm/generated/docs.entry.mjs +19 -0
- package/dist/esm/generated/docs.entry.mjs.map +1 -1
- package/dist/types/generated/docs.entry.d.ts +1 -0
- package/dist/types/generated/docs.entry.d.ts.map +1 -1
- package/docs/ar/intlayer_with_svelte_kit.md +730 -0
- package/docs/ar/intlayer_with_vite+svelte.md +288 -104
- package/docs/de/intlayer_with_svelte_kit.md +730 -0
- package/docs/de/intlayer_with_vite+svelte.md +302 -101
- package/docs/en/intlayer_with_svelte_kit.md +560 -0
- package/docs/en/intlayer_with_vite+svelte.md +22 -6
- package/docs/en/introduction.md +2 -0
- package/docs/en-GB/intlayer_with_svelte_kit.md +730 -0
- package/docs/en-GB/intlayer_with_vite+svelte.md +262 -84
- package/docs/es/intlayer_with_svelte_kit.md +730 -0
- package/docs/es/intlayer_with_vite+svelte.md +300 -107
- package/docs/fr/intlayer_with_svelte_kit.md +762 -0
- package/docs/fr/intlayer_with_vite+svelte.md +297 -101
- package/docs/hi/intlayer_with_svelte_kit.md +730 -0
- package/docs/hi/intlayer_with_vite+svelte.md +298 -108
- package/docs/id/intlayer_with_svelte_kit.md +730 -0
- package/docs/id/intlayer_with_vite+svelte.md +277 -99
- package/docs/it/intlayer_with_svelte_kit.md +762 -0
- package/docs/it/intlayer_with_vite+svelte.md +275 -99
- package/docs/ja/intlayer_with_svelte_kit.md +730 -0
- package/docs/ja/intlayer_with_vite+svelte.md +295 -110
- package/docs/ko/intlayer_with_svelte_kit.md +730 -0
- package/docs/ko/intlayer_with_vite+svelte.md +286 -199
- package/docs/pl/intlayer_with_svelte_kit.md +732 -0
- package/docs/pl/intlayer_with_vite+svelte.md +273 -101
- package/docs/pt/intlayer_with_svelte_kit.md +764 -0
- package/docs/pt/intlayer_with_vite+svelte.md +290 -96
- package/docs/ru/intlayer_with_svelte_kit.md +730 -0
- package/docs/ru/intlayer_with_vite+svelte.md +275 -99
- package/docs/tr/intlayer_with_svelte_kit.md +730 -0
- package/docs/tr/intlayer_with_vite+svelte.md +297 -119
- package/docs/vi/intlayer_with_svelte_kit.md +730 -0
- package/docs/vi/intlayer_with_vite+svelte.md +275 -102
- package/docs/zh/intlayer_with_svelte_kit.md +730 -0
- package/docs/zh/intlayer_with_vite+svelte.md +309 -107
- package/package.json +6 -6
- package/src/generated/docs.entry.ts +19 -0
|
@@ -0,0 +1,730 @@
|
|
|
1
|
+
---
|
|
2
|
+
createdAt: 2025-11-20
|
|
3
|
+
updatedAt: 2025-11-20
|
|
4
|
+
title: SvelteKit uygulamanızı nasıl çevirirsiniz – i18n rehberi 2025
|
|
5
|
+
description: SvelteKit web sitenizi çok dilli hale nasıl getireceğinizi keşfedin. Server-Side Rendering (SSR) kullanarak uluslararasılaştırma (i18n) ve çeviri yapmak için dokümantasyonu takip edin.
|
|
6
|
+
keywords:
|
|
7
|
+
- Uluslararasılaştırma
|
|
8
|
+
- Dokümantasyon
|
|
9
|
+
- Intlayer
|
|
10
|
+
- SvelteKit
|
|
11
|
+
- JavaScript
|
|
12
|
+
- SSR
|
|
13
|
+
slugs:
|
|
14
|
+
- doc
|
|
15
|
+
- environment
|
|
16
|
+
- sveltekit
|
|
17
|
+
applicationTemplate: https://github.com/aymericzip/intlayer-sveltekit-template
|
|
18
|
+
history:
|
|
19
|
+
- version: 7.1.10
|
|
20
|
+
date: 2025-11-20
|
|
21
|
+
changes: Başlangıç geçmişi
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
# Intlayer kullanarak SvelteKit web sitenizi çevirin | Uluslararasılaştırma (i18n)
|
|
25
|
+
|
|
26
|
+
## İçindekiler
|
|
27
|
+
|
|
28
|
+
<TOC/>
|
|
29
|
+
|
|
30
|
+
## Intlayer nedir?
|
|
31
|
+
|
|
32
|
+
**Intlayer**, modern web uygulamalarında çok dilli desteği basitleştirmek için tasarlanmış yenilikçi, açık kaynaklı bir uluslararasılaştırma (i18n) kütüphanesidir. **SvelteKit'in** Server-Side Rendering (SSR) yetenekleriyle sorunsuz çalışır.
|
|
33
|
+
|
|
34
|
+
Intlayer ile şunları yapabilirsiniz:
|
|
35
|
+
|
|
36
|
+
- **Bileşen seviyesinde deklaratif sözlükler kullanarak çevirileri kolayca yönetin.**
|
|
37
|
+
- **Meta verileri, rotaları ve içeriği dinamik olarak yerelleştirin.**
|
|
38
|
+
- **Otomatik oluşturulan tiplerle TypeScript desteğini sağlayın.**
|
|
39
|
+
- **SEO dostu uluslararasılaştırma için SvelteKit'in SSR'sinden yararlanın.**
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## SvelteKit Uygulamasında Intlayer Kurulumu için Adım Adım Rehber
|
|
44
|
+
|
|
45
|
+
Başlamak için yeni bir SvelteKit projesi oluşturun. İşte oluşturacağımız son yapı:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
.
|
|
49
|
+
├── intlayer.config.ts
|
|
50
|
+
├── package.json
|
|
51
|
+
├── src
|
|
52
|
+
│ ├── app.d.ts
|
|
53
|
+
│ ├── app.html
|
|
54
|
+
│ ├── hooks.server.ts
|
|
55
|
+
│ ├── lib
|
|
56
|
+
│ │ ├── getLocale.ts
|
|
57
|
+
│ │ ├── LocaleSwitcher.svelte
|
|
58
|
+
│ │ └── LocalizedLink.svelte
|
|
59
|
+
│ ├── params
|
|
60
|
+
│ │ └── locale.ts
|
|
61
|
+
│ └── routes
|
|
62
|
+
│ ├── [[locale=locale]]
|
|
63
|
+
│ │ ├── +layout.svelte
|
|
64
|
+
│ │ ├── +layout.ts
|
|
65
|
+
│ │ ├── +page.svelte
|
|
66
|
+
│ │ ├── +page.ts
|
|
67
|
+
│ │ ├── about
|
|
68
|
+
│ │ │ ├── +page.svelte
|
|
69
|
+
│ │ │ ├── +page.ts
|
|
70
|
+
│ │ │ └── page.content.ts
|
|
71
|
+
│ │ ├── Counter.content.ts
|
|
72
|
+
│ │ ├── Counter.svelte
|
|
73
|
+
│ │ ├── Header.content.ts
|
|
74
|
+
│ │ ├── Header.svelte
|
|
75
|
+
│ │ ├── home.content.ts
|
|
76
|
+
│ │ └── layout.content.ts
|
|
77
|
+
│ ├── +layout.svelte
|
|
78
|
+
│ └── layout.css
|
|
79
|
+
├── static
|
|
80
|
+
│ ├── favicon.svg
|
|
81
|
+
│ └── robots.txt
|
|
82
|
+
├── svelte.config.js
|
|
83
|
+
├── tsconfig.json
|
|
84
|
+
└── vite.config.ts
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Adım 1: Bağımlılıkları Yükleyin
|
|
88
|
+
|
|
89
|
+
Gerekli paketleri npm kullanarak yükleyin:
|
|
90
|
+
|
|
91
|
+
```bash packageManager="npm"
|
|
92
|
+
npm install intlayer svelte-intlayer
|
|
93
|
+
npm install vite-intlayer --save-dev
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
```bash packageManager="pnpm"
|
|
97
|
+
pnpm add intlayer svelte-intlayer
|
|
98
|
+
pnpm add vite-intlayer --save-dev
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
```bash packageManager="yarn"
|
|
102
|
+
yarn add intlayer svelte-intlayer
|
|
103
|
+
yarn add vite-intlayer --save-dev
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
```bash packageManager="bun"
|
|
107
|
+
bun add intlayer svelte-intlayer
|
|
108
|
+
bun add vite-intlayer --save-dev
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
- **intlayer**: Temel i18n paketi.
|
|
112
|
+
- **svelte-intlayer**: Svelte/SvelteKit için context sağlayıcıları ve store'lar sunar.
|
|
113
|
+
- **vite-intlayer**: İçerik bildirimlerini build süreciyle entegre eden Vite eklentisi.
|
|
114
|
+
|
|
115
|
+
### Adım 2: Projenizin Yapılandırması
|
|
116
|
+
|
|
117
|
+
Proje kök dizininizde bir yapılandırma dosyası oluşturun:
|
|
118
|
+
|
|
119
|
+
```typescript fileName="intlayer.config.ts"
|
|
120
|
+
import { Locales, type IntlayerConfig } from "intlayer";
|
|
121
|
+
|
|
122
|
+
const config: IntlayerConfig = {
|
|
123
|
+
internationalization: {
|
|
124
|
+
locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
|
|
125
|
+
defaultLocale: Locales.ENGLISH,
|
|
126
|
+
},
|
|
127
|
+
};
|
|
128
|
+
|
|
129
|
+
export default config;
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### Adım 3: Intlayer'ı Vite Konfigürasyonunuza Entegre Edin
|
|
133
|
+
|
|
134
|
+
`vite.config.ts` dosyanızı, Intlayer eklentisini içerecek şekilde güncelleyin. Bu eklenti, içerik dosyalarınızın transpile edilmesini yönetir.
|
|
135
|
+
|
|
136
|
+
```typescript fileName="vite.config.ts"
|
|
137
|
+
import { sveltekit } from "@sveltejs/kit/vite";
|
|
138
|
+
import { defineConfig } from "vite";
|
|
139
|
+
import { intlayer } from "vite-intlayer";
|
|
140
|
+
|
|
141
|
+
export default defineConfig({
|
|
142
|
+
plugins: [intlayer(), sveltekit()], // sıralama önemlidir, Intlayer SvelteKit'ten önce yerleştirilmelidir
|
|
143
|
+
});
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Adım 4: İçeriğinizi Bildirin
|
|
147
|
+
|
|
148
|
+
`src` klasörünüzde istediğiniz herhangi bir yerde içerik bildirim dosyalarınızı oluşturun (örneğin, `src/lib/content` veya bileşenlerinizin yanında). Bu dosyalar, uygulamanız için çevrilebilir içeriği her locale için `t()` fonksiyonunu kullanarak tanımlar.
|
|
149
|
+
|
|
150
|
+
```ts fileName="src/features/hero/hero.content.ts" contentDeclarationFormat="typescript"
|
|
151
|
+
import { t, type Dictionary } from "intlayer";
|
|
152
|
+
|
|
153
|
+
const heroContent = {
|
|
154
|
+
key: "hero-section",
|
|
155
|
+
content: {
|
|
156
|
+
title: t({
|
|
157
|
+
en: "Welcome to SvelteKit",
|
|
158
|
+
fr: "Bienvenue sur SvelteKit",
|
|
159
|
+
es: "Bienvenido a SvelteKit",
|
|
160
|
+
}),
|
|
161
|
+
},
|
|
162
|
+
} satisfies Dictionary;
|
|
163
|
+
|
|
164
|
+
export default heroContent;
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
### Adım 5: Bileşenlerinizde Intlayer'ı Kullanın
|
|
168
|
+
|
|
169
|
+
Artık `useIntlayer` fonksiyonunu herhangi bir Svelte bileşeninde kullanabilirsiniz. Bu fonksiyon, locale değiştiğinde otomatik olarak güncellenen reaktif bir store döner. Fonksiyon, mevcut locale'yi otomatik olarak dikkate alır (hem SSR sırasında hem de istemci tarafı gezinmede).
|
|
170
|
+
|
|
171
|
+
> **Not:** `useIntlayer` bir Svelte store döner, bu yüzden reaktif değerine erişmek için `---
|
|
172
|
+
> createdAt: 2025-11-20
|
|
173
|
+
> updatedAt: 2025-11-20
|
|
174
|
+
> title: SvelteKit uygulamanızı nasıl çevirirsiniz – i18n rehberi 2025
|
|
175
|
+
> description: SvelteKit web sitenizi çok dilli hale nasıl getireceğinizi keşfedin. Server-Side Rendering (SSR) kullanarak uluslararasılaştırma (i18n) ve çeviri yapmak için dokümantasyonu takip edin.
|
|
176
|
+
> keywords:
|
|
177
|
+
|
|
178
|
+
- Uluslararasılaştırma
|
|
179
|
+
- Dokümantasyon
|
|
180
|
+
- Intlayer
|
|
181
|
+
- SvelteKit
|
|
182
|
+
- JavaScript
|
|
183
|
+
- SSR
|
|
184
|
+
slugs:
|
|
185
|
+
- doc
|
|
186
|
+
- environment
|
|
187
|
+
- sveltekit
|
|
188
|
+
applicationTemplate: https://github.com/aymericzip/intlayer-sveltekit-template
|
|
189
|
+
history:
|
|
190
|
+
- version: 7.1.10
|
|
191
|
+
date: 2025-11-20
|
|
192
|
+
changes: Başlangıç geçmişi
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
# Intlayer kullanarak SvelteKit web sitenizi çevirin | Uluslararasılaştırma (i18n)
|
|
197
|
+
|
|
198
|
+
## İçindekiler
|
|
199
|
+
|
|
200
|
+
<TOC/>
|
|
201
|
+
|
|
202
|
+
## Intlayer nedir?
|
|
203
|
+
|
|
204
|
+
**Intlayer**, modern web uygulamalarında çok dilli desteği basitleştirmek için tasarlanmış yenilikçi, açık kaynaklı bir uluslararasılaştırma (i18n) kütüphanesidir. **SvelteKit'in** Server-Side Rendering (SSR) yetenekleriyle sorunsuz çalışır.
|
|
205
|
+
|
|
206
|
+
Intlayer ile şunları yapabilirsiniz:
|
|
207
|
+
|
|
208
|
+
- **Bileşen seviyesinde deklaratif sözlükler kullanarak çevirileri kolayca yönetin.**
|
|
209
|
+
- **Meta verileri, rotaları ve içeriği dinamik olarak yerelleştirin.**
|
|
210
|
+
- **Otomatik oluşturulan tiplerle TypeScript desteğini sağlayın.**
|
|
211
|
+
- **SEO dostu uluslararasılaştırma için SvelteKit'in SSR'sinden yararlanın.**
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## SvelteKit Uygulamasında Intlayer Kurulumu için Adım Adım Rehber
|
|
216
|
+
|
|
217
|
+
Başlamak için yeni bir SvelteKit projesi oluşturun. İşte oluşturacağımız son yapı:
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
.
|
|
221
|
+
├── intlayer.config.ts
|
|
222
|
+
├── package.json
|
|
223
|
+
├── src
|
|
224
|
+
│ ├── app.d.ts
|
|
225
|
+
│ ├── app.html
|
|
226
|
+
│ ├── hooks.server.ts
|
|
227
|
+
│ ├── lib
|
|
228
|
+
│ │ ├── getLocale.ts
|
|
229
|
+
│ │ ├── LocaleSwitcher.svelte
|
|
230
|
+
│ │ └── LocalizedLink.svelte
|
|
231
|
+
│ ├── params
|
|
232
|
+
│ │ └── locale.ts
|
|
233
|
+
│ └── routes
|
|
234
|
+
│ ├── [[locale=locale]]
|
|
235
|
+
│ │ ├── +layout.svelte
|
|
236
|
+
│ │ ├── +layout.ts
|
|
237
|
+
│ │ ├── +page.svelte
|
|
238
|
+
│ │ ├── +page.ts
|
|
239
|
+
│ │ ├── about
|
|
240
|
+
│ │ │ ├── +page.svelte
|
|
241
|
+
│ │ │ ├── +page.ts
|
|
242
|
+
│ │ │ └── page.content.ts
|
|
243
|
+
│ │ ├── Counter.content.ts
|
|
244
|
+
│ │ ├── Counter.svelte
|
|
245
|
+
│ │ ├── Header.content.ts
|
|
246
|
+
│ │ ├── Header.svelte
|
|
247
|
+
│ │ ├── home.content.ts
|
|
248
|
+
│ │ └── layout.content.ts
|
|
249
|
+
│ ├── +layout.svelte
|
|
250
|
+
│ └── layout.css
|
|
251
|
+
├── static
|
|
252
|
+
│ ├── favicon.svg
|
|
253
|
+
│ └── robots.txt
|
|
254
|
+
├── svelte.config.js
|
|
255
|
+
├── tsconfig.json
|
|
256
|
+
└── vite.config.ts
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
### Adım 1: Bağımlılıkları Yükleyin
|
|
260
|
+
|
|
261
|
+
Gerekli paketleri npm kullanarak yükleyin:
|
|
262
|
+
|
|
263
|
+
```bash packageManager="npm"
|
|
264
|
+
npm install intlayer svelte-intlayer
|
|
265
|
+
npm install vite-intlayer --save-dev
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
```bash packageManager="pnpm"
|
|
269
|
+
pnpm add intlayer svelte-intlayer
|
|
270
|
+
pnpm add vite-intlayer --save-dev
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
```bash packageManager="yarn"
|
|
274
|
+
yarn add intlayer svelte-intlayer
|
|
275
|
+
yarn add vite-intlayer --save-dev
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
```bash packageManager="bun"
|
|
279
|
+
bun add intlayer svelte-intlayer
|
|
280
|
+
bun add vite-intlayer --save-dev
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
- **intlayer**: Temel i18n paketi.
|
|
284
|
+
- **svelte-intlayer**: Svelte/SvelteKit için context sağlayıcıları ve store'lar sunar.
|
|
285
|
+
- **vite-intlayer**: İçerik bildirimlerini build süreciyle entegre eden Vite eklentisi.
|
|
286
|
+
|
|
287
|
+
### Adım 2: Projenizin Yapılandırması
|
|
288
|
+
|
|
289
|
+
Proje kök dizininizde bir yapılandırma dosyası oluşturun:
|
|
290
|
+
|
|
291
|
+
```typescript fileName="intlayer.config.ts"
|
|
292
|
+
import { Locales, type IntlayerConfig } from "intlayer";
|
|
293
|
+
|
|
294
|
+
const config: IntlayerConfig = {
|
|
295
|
+
internationalization: {
|
|
296
|
+
locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
|
|
297
|
+
defaultLocale: Locales.ENGLISH,
|
|
298
|
+
},
|
|
299
|
+
};
|
|
300
|
+
|
|
301
|
+
export default config;
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
### Adım 3: Intlayer'ı Vite Konfigürasyonunuza Entegre Edin
|
|
305
|
+
|
|
306
|
+
`vite.config.ts` dosyanızı, Intlayer eklentisini içerecek şekilde güncelleyin. Bu eklenti, içerik dosyalarınızın transpile edilmesini yönetir.
|
|
307
|
+
|
|
308
|
+
```typescript fileName="vite.config.ts"
|
|
309
|
+
import { sveltekit } from "@sveltejs/kit/vite";
|
|
310
|
+
import { defineConfig } from "vite";
|
|
311
|
+
import { intlayer } from "vite-intlayer";
|
|
312
|
+
|
|
313
|
+
export default defineConfig({
|
|
314
|
+
plugins: [intlayer(), sveltekit()], // sıralama önemlidir, Intlayer SvelteKit'ten önce yerleştirilmelidir
|
|
315
|
+
});
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
### Adım 4: İçeriğinizi Bildirin
|
|
319
|
+
|
|
320
|
+
`src` klasörünüzde istediğiniz herhangi bir yerde içerik bildirim dosyalarınızı oluşturun (örneğin, `src/lib/content` veya bileşenlerinizin yanında). Bu dosyalar, uygulamanız için çevrilebilir içeriği her locale için `t()` fonksiyonunu kullanarak tanımlar.
|
|
321
|
+
|
|
322
|
+
```ts fileName="src/features/hero/hero.content.ts" contentDeclarationFormat="typescript"
|
|
323
|
+
import { t, type Dictionary } from "intlayer";
|
|
324
|
+
|
|
325
|
+
const heroContent = {
|
|
326
|
+
key: "hero-section",
|
|
327
|
+
content: {
|
|
328
|
+
title: t({
|
|
329
|
+
en: "Welcome to SvelteKit",
|
|
330
|
+
fr: "Bienvenue sur SvelteKit",
|
|
331
|
+
es: "Bienvenido a SvelteKit",
|
|
332
|
+
}),
|
|
333
|
+
},
|
|
334
|
+
} satisfies Dictionary;
|
|
335
|
+
|
|
336
|
+
export default heroContent;
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
### Adım 5: Bileşenlerinizde Intlayer'ı Kullanın
|
|
340
|
+
|
|
341
|
+
ön ekini kullanmanız gerekir (örneğin, `$content.title`).
|
|
342
|
+
|
|
343
|
+
```svelte fileName="src/lib/components/Component.svelte"
|
|
344
|
+
<script lang="ts">
|
|
345
|
+
import { useIntlayer } from "svelte-intlayer";
|
|
346
|
+
|
|
347
|
+
// "hero-section", Adım 4'te tanımlanan key'e karşılık gelir
|
|
348
|
+
const content = useIntlayer("hero-section");
|
|
349
|
+
</script>
|
|
350
|
+
|
|
351
|
+
<!-- İçeriği basit içerik olarak render et -->
|
|
352
|
+
<h1>{$content.title}</h1>
|
|
353
|
+
<!-- İçeriği editör kullanarak düzenlenebilir şekilde render etmek için -->
|
|
354
|
+
<h1><svelte:component this={$content.title} /></h1>
|
|
355
|
+
<!-- İçeriği string olarak render etmek için -->
|
|
356
|
+
<div aria-label={$content.title.value}></div>
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
### (İsteğe bağlı) Adım 6: Yönlendirmeyi ayarlama
|
|
360
|
+
|
|
361
|
+
Aşağıdaki adımlar, SvelteKit'te locale tabanlı yönlendirmeyi nasıl ayarlayacağınızı gösterir. Bu, URL'lerinizin locale önekini içermesine olanak tanır (örneğin, `/en/about`, `/fr/about`) ve böylece SEO ve kullanıcı deneyimini iyileştirir.
|
|
362
|
+
|
|
363
|
+
```bash
|
|
364
|
+
.
|
|
365
|
+
└─── src
|
|
366
|
+
├── app.d.ts # Locale türünü tanımla
|
|
367
|
+
├── hooks.server.ts # Locale yönlendirmesini yönet
|
|
368
|
+
├── lib
|
|
369
|
+
│ └── getLocale.ts # Header ve çerezlerden locale kontrolü yap
|
|
370
|
+
├── params
|
|
371
|
+
│ └── locale.ts # Locale parametresini tanımla
|
|
372
|
+
└── routes
|
|
373
|
+
├── [[locale=locale]] # Locale'i ayarlamak için route grubuna sar
|
|
374
|
+
│ ├── +layout.svelte # Yönlendirme için yerel düzen
|
|
375
|
+
│ ├── +layout.ts
|
|
376
|
+
│ ├── +page.svelte
|
|
377
|
+
│ ├── +page.ts
|
|
378
|
+
│ └── about
|
|
379
|
+
│ ├── +page.svelte
|
|
380
|
+
│ └── +page.ts
|
|
381
|
+
└── +layout.svelte # Yazı tipleri ve genel stiller için kök düzen
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
### Adım 7: Sunucu Tarafı Dil Algılama (Hooks) İşlemi
|
|
385
|
+
|
|
386
|
+
SvelteKit'te, SSR sırasında doğru içeriği render etmek için sunucunun kullanıcının dilini bilmesi gerekir. URL veya çerezlerden dili algılamak için `hooks.server.ts` kullanılır.
|
|
387
|
+
|
|
388
|
+
`src/hooks.server.ts` dosyasını oluşturun veya düzenleyin:
|
|
389
|
+
|
|
390
|
+
```typescript fileName="src/hooks.server.ts"
|
|
391
|
+
import type { Handle } from "@sveltejs/kit";
|
|
392
|
+
import { getLocalizedUrl } from "intlayer";
|
|
393
|
+
import { getLocale } from "$lib/getLocale";
|
|
394
|
+
|
|
395
|
+
export const handle: Handle = async ({ event, resolve }) => {
|
|
396
|
+
const detectedLocale = getLocale(event);
|
|
397
|
+
|
|
398
|
+
// Mevcut yolun zaten bir locale ile başlayıp başlamadığını kontrol edin (örneğin /fr, /en)
|
|
399
|
+
const pathname = event.url.pathname;
|
|
400
|
+
const targetPathname = getLocalizedUrl(pathname, detectedLocale);
|
|
401
|
+
|
|
402
|
+
// URL'de locale yoksa (örneğin kullanıcı "/" adresini ziyaret ederse), yönlendirme yapın
|
|
403
|
+
if (targetPathname !== pathname) {
|
|
404
|
+
return new Response(undefined, {
|
|
405
|
+
headers: { Location: targetPathname },
|
|
406
|
+
status: 307, // Geçici yönlendirme
|
|
407
|
+
});
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
return resolve(event, {
|
|
411
|
+
transformPageChunk: ({ html }) => html.replace("%lang%", detectedLocale),
|
|
412
|
+
});
|
|
413
|
+
};
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
Ardından, kullanıcının locale bilgisini istek olayından almak için bir yardımcı oluşturun:
|
|
417
|
+
|
|
418
|
+
```typescript fileName="src/lib/getLocale.ts"
|
|
419
|
+
import {
|
|
420
|
+
configuration,
|
|
421
|
+
getLocaleFromStorage,
|
|
422
|
+
localeDetector,
|
|
423
|
+
type Locale,
|
|
424
|
+
} from "intlayer";
|
|
425
|
+
import type { RequestEvent } from "@sveltejs/kit";
|
|
426
|
+
|
|
427
|
+
/**
|
|
428
|
+
* İstek olayından kullanıcının yerel ayarını alın.
|
|
429
|
+
* Bu fonksiyon `src/hooks.server.ts` dosyasındaki `handle` kancasına kullanılır.
|
|
430
|
+
*
|
|
431
|
+
* Öncelikle Intlayer depolamasından (çerezler veya özel başlıklar) yerel ayarı almaya çalışır.
|
|
432
|
+
* Yerel ayar bulunamazsa, tarayıcının "Accept-Language" müzakeresine geri döner.
|
|
433
|
+
*
|
|
434
|
+
* @param event - SvelteKit'ten gelen istek olayı
|
|
435
|
+
* @returns Kullanıcının yerel ayarı
|
|
436
|
+
*/
|
|
437
|
+
export const getLocale = (event: RequestEvent): Locale => {
|
|
438
|
+
const defaultLocale = configuration?.internationalization?.defaultLocale;
|
|
439
|
+
|
|
440
|
+
// Intlayer depolamasından yerel ayarı almaya çalış (Çerezler veya başlıklar)
|
|
441
|
+
const storedLocale = getLocaleFromStorage({
|
|
442
|
+
// SvelteKit çerez erişimi
|
|
443
|
+
getCookie: (name: string) => event.cookies.get(name) ?? null,
|
|
444
|
+
// SvelteKit başlık erişimi
|
|
445
|
+
getHeader: (name: string) => event.request.headers.get(name) ?? null,
|
|
446
|
+
});
|
|
447
|
+
|
|
448
|
+
if (storedLocale) {
|
|
449
|
+
return storedLocale;
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
// Tarayıcı "Accept-Language" müzakeresine geri dönüş
|
|
453
|
+
const negotiatorHeaders: Record<string, string> = {};
|
|
454
|
+
|
|
455
|
+
// SvelteKit Headers nesnesini basit bir Record<string, string> nesnesine dönüştür
|
|
456
|
+
event.request.headers.forEach((value, key) => {
|
|
457
|
+
negotiatorHeaders[key] = value;
|
|
458
|
+
});
|
|
459
|
+
|
|
460
|
+
// `Accept-Language` başlığından locale kontrolü yap
|
|
461
|
+
const userFallbackLocale = localeDetector(negotiatorHeaders);
|
|
462
|
+
|
|
463
|
+
if (userFallbackLocale) {
|
|
464
|
+
return userFallbackLocale;
|
|
465
|
+
}
|
|
466
|
+
|
|
467
|
+
// Eşleşme bulunamazsa varsayılan locale döndür
|
|
468
|
+
return defaultLocale;
|
|
469
|
+
};
|
|
470
|
+
```
|
|
471
|
+
|
|
472
|
+
> `getLocaleFromStorage`, yapılandırmanıza bağlı olarak yerel ayarı header veya cookie'den kontrol edecektir. Daha fazla detay için [Configuration](https://intlayer.org/doc/configuration) sayfasına bakınız.
|
|
473
|
+
|
|
474
|
+
> `localeDetector` fonksiyonu `Accept-Language` header'ını işleyip en uygun eşleşmeyi döndürecektir.
|
|
475
|
+
|
|
476
|
+
Eğer yerel ayar yapılandırılmamışsa, 404 hatası döndürmek isteriz. Bunu kolaylaştırmak için, yerel ayarın geçerli olup olmadığını kontrol eden bir `match` fonksiyonu oluşturabiliriz:
|
|
477
|
+
|
|
478
|
+
```ts fileName="/src/params/locale.ts"
|
|
479
|
+
import { configuration, type Locale } from "intlayer";
|
|
480
|
+
|
|
481
|
+
export const match = (
|
|
482
|
+
param: Locale = configuration.internationalization.defaultLocale
|
|
483
|
+
): boolean => {
|
|
484
|
+
return configuration.internationalization.locales.includes(param);
|
|
485
|
+
};
|
|
486
|
+
```
|
|
487
|
+
|
|
488
|
+
> **Not:** `src/app.d.ts` dosyanızın yerel ayar tanımını içerdiğinden emin olun:
|
|
489
|
+
>
|
|
490
|
+
> ```typescript
|
|
491
|
+
> declare global {
|
|
492
|
+
> namespace App {
|
|
493
|
+
> interface Locals {
|
|
494
|
+
> locale: import("intlayer").Locale;
|
|
495
|
+
> }
|
|
496
|
+
> }
|
|
497
|
+
> }
|
|
498
|
+
> ```
|
|
499
|
+
|
|
500
|
+
`+layout.svelte` dosyası için, i18n ile ilgili olmayan sadece statik içeriği tutmak amacıyla her şeyi kaldırabiliriz:
|
|
501
|
+
|
|
502
|
+
```svelte fileName="src/+layout.svelte"
|
|
503
|
+
<script lang="ts">
|
|
504
|
+
import './layout.css';
|
|
505
|
+
|
|
506
|
+
let { children } = $props();
|
|
507
|
+
</script>
|
|
508
|
+
|
|
509
|
+
<div class="app">
|
|
510
|
+
{@render children()}
|
|
511
|
+
</div>
|
|
512
|
+
|
|
513
|
+
<style>
|
|
514
|
+
.app {
|
|
515
|
+
/* */
|
|
516
|
+
}
|
|
517
|
+
</style>
|
|
518
|
+
```
|
|
519
|
+
|
|
520
|
+
Sonra, `[[locale=locale]]` grubu altında yeni bir sayfa ve layout oluşturun:
|
|
521
|
+
|
|
522
|
+
```ts fileName="src/routes/[[locale=locale]]/+layout.ts"
|
|
523
|
+
import type { Load } from "@sveltejs/kit";
|
|
524
|
+
import { configuration, type Locale } from "intlayer";
|
|
525
|
+
|
|
526
|
+
export const prerender = true;
|
|
527
|
+
|
|
528
|
+
// Genel Load tipini kullan
|
|
529
|
+
export const load: Load = ({ params }) => {
|
|
530
|
+
const locale: Locale =
|
|
531
|
+
(params.locale as Locale) ??
|
|
532
|
+
configuration.internationalization.defaultLocale;
|
|
533
|
+
|
|
534
|
+
return {
|
|
535
|
+
locale,
|
|
536
|
+
};
|
|
537
|
+
};
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
```svelte fileName="src/routes/[[locale=locale]]/+layout.svelte"
|
|
541
|
+
<script lang="ts">
|
|
542
|
+
import type { Snippet } from 'svelte';
|
|
543
|
+
import { useIntlayer, setupIntlayer } from 'svelte-intlayer';
|
|
544
|
+
import Header from './Header.svelte';
|
|
545
|
+
import type { LayoutData } from './$types';
|
|
546
|
+
|
|
547
|
+
let { children, data }: { children: Snippet, data: LayoutData } = $props();
|
|
548
|
+
|
|
549
|
+
// Yönlendirmeden alınan locale ile Intlayer'ı başlat
|
|
550
|
+
setupIntlayer(data.locale);
|
|
551
|
+
|
|
552
|
+
// Layout içerik sözlüğünü kullan
|
|
553
|
+
const layoutContent = useIntlayer('layout');
|
|
554
|
+
</script>
|
|
555
|
+
|
|
556
|
+
<Header />
|
|
557
|
+
|
|
558
|
+
<main>
|
|
559
|
+
{@render children()}
|
|
560
|
+
</main>
|
|
561
|
+
|
|
562
|
+
<footer>
|
|
563
|
+
<p>
|
|
564
|
+
{$layoutContent.footer.prefix.value}{' '}
|
|
565
|
+
<a href="https://svelte.dev/docs/kit">{$layoutContent.footer.linkLabel.value}</a>{' '}
|
|
566
|
+
{$layoutContent.footer.suffix.value}
|
|
567
|
+
</p>
|
|
568
|
+
</footer>
|
|
569
|
+
|
|
570
|
+
<style>
|
|
571
|
+
/* */
|
|
572
|
+
</style>
|
|
573
|
+
```
|
|
574
|
+
|
|
575
|
+
```ts fileName="src/routes/[[locale=locale]]/+page.ts"
|
|
576
|
+
export const prerender = true;
|
|
577
|
+
```
|
|
578
|
+
|
|
579
|
+
```svelte fileName="src/routes/[[locale=locale]]/+page.svelte"
|
|
580
|
+
<script lang="ts">
|
|
581
|
+
import { useIntlayer } from 'svelte-intlayer';
|
|
582
|
+
|
|
583
|
+
// Ana sayfa içerik sözlüğünü kullan
|
|
584
|
+
const homeContent = useIntlayer('home');
|
|
585
|
+
</script>
|
|
586
|
+
|
|
587
|
+
<svelte:head>
|
|
588
|
+
<title>{$homeContent.title.value}</title>
|
|
589
|
+
</svelte:head>
|
|
590
|
+
|
|
591
|
+
<section>
|
|
592
|
+
<h1>
|
|
593
|
+
{$homeContent.title}
|
|
594
|
+
</h1>
|
|
595
|
+
</section>
|
|
596
|
+
|
|
597
|
+
<style>
|
|
598
|
+
/* */
|
|
599
|
+
</style>
|
|
600
|
+
```
|
|
601
|
+
|
|
602
|
+
### (İsteğe Bağlı) Adım 8: Uluslararasılaştırılmış Bağlantılar
|
|
603
|
+
|
|
604
|
+
SEO için, rotalarınızı locale ile öneklemeniz önerilir (örneğin, `/en/about`, `/fr/about`). Bu bileşen, herhangi bir bağlantıyı otomatik olarak mevcut locale ile önekler.
|
|
605
|
+
|
|
606
|
+
```svelte fileName="src/lib/components/LocalizedLink.svelte"
|
|
607
|
+
<script lang="ts">
|
|
608
|
+
import { getLocalizedUrl } from "intlayer";
|
|
609
|
+
import { useLocale } from 'svelte-intlayer';
|
|
610
|
+
|
|
611
|
+
let { href = "" } = $props();
|
|
612
|
+
const { locale } = useLocale();
|
|
613
|
+
|
|
614
|
+
// URL'ye mevcut locale'i öneklemek için yardımcı fonksiyon
|
|
615
|
+
$: localizedHref = getLocalizedUrl(href, $locale);
|
|
616
|
+
</script>
|
|
617
|
+
|
|
618
|
+
<a href={localizedHref}>
|
|
619
|
+
<slot />
|
|
620
|
+
</a>
|
|
621
|
+
```
|
|
622
|
+
|
|
623
|
+
Eğer SvelteKit'ten `goto` kullanıyorsanız, aynı mantığı `getLocalizedUrl` ile kullanarak lokalize edilmiş URL'ye yönlendirme yapabilirsiniz:
|
|
624
|
+
|
|
625
|
+
```typescript
|
|
626
|
+
import { goto } from "$app/navigation";
|
|
627
|
+
import { getLocalizedUrl } from "intlayer";
|
|
628
|
+
import { useLocale } from "svelte-intlayer";
|
|
629
|
+
|
|
630
|
+
const { locale } = useLocale();
|
|
631
|
+
const localizedPath = getLocalizedUrl("/about", $locale);
|
|
632
|
+
goto(localizedPath); // Yerel dile bağlı olarak /en/about veya /fr/about adresine gider
|
|
633
|
+
```
|
|
634
|
+
|
|
635
|
+
### (İsteğe Bağlı) Adım 9: Dil Değiştirici
|
|
636
|
+
|
|
637
|
+
Kullanıcıların dilleri değiştirmesine izin vermek için URL'yi güncelleyin.
|
|
638
|
+
|
|
639
|
+
```svelte fileName="src/lib/components/LanguageSwitcher.svelte"
|
|
640
|
+
<script lang="ts">
|
|
641
|
+
import { getLocalizedUrl, getLocaleName } from 'intlayer';
|
|
642
|
+
import { useLocale } from 'svelte-intlayer';
|
|
643
|
+
import { page } from '$app/stores';
|
|
644
|
+
import { goto } from '$app/navigation';
|
|
645
|
+
|
|
646
|
+
const { locale, setLocale, availableLocales } = useLocale({
|
|
647
|
+
onLocaleChange: (newLocale) => {
|
|
648
|
+
const localizedPath = getLocalizedUrl($page.url.pathname, newLocale);
|
|
649
|
+
goto(localizedPath);
|
|
650
|
+
},
|
|
651
|
+
});
|
|
652
|
+
</script>
|
|
653
|
+
|
|
654
|
+
<ul class="locale-list">
|
|
655
|
+
{#each availableLocales as localeEl}
|
|
656
|
+
<li>
|
|
657
|
+
<a
|
|
658
|
+
href={getLocalizedUrl($page.url.pathname, localeEl)}
|
|
659
|
+
onclick={(e) => {
|
|
660
|
+
e.preventDefault();
|
|
661
|
+
setLocale(localeEl); // Mağazada yerel ayarı yapacak ve onLocaleChange tetiklenecek
|
|
662
|
+
}}
|
|
663
|
+
class:active={$locale === localeEl}
|
|
664
|
+
>
|
|
665
|
+
{getLocaleName(localeEl)}
|
|
666
|
+
</a>
|
|
667
|
+
</li>
|
|
668
|
+
{/each}
|
|
669
|
+
</ul>
|
|
670
|
+
|
|
671
|
+
<style>
|
|
672
|
+
/* */
|
|
673
|
+
</style>
|
|
674
|
+
```
|
|
675
|
+
|
|
676
|
+
### (İsteğe Bağlı) Adım 10: Backend proxy ekleme
|
|
677
|
+
|
|
678
|
+
SvelteKit uygulamanıza bir backend proxy eklemek için, `vite-intlayer` eklentisi tarafından sağlanan `intlayerProxy` fonksiyonunu kullanabilirsiniz. Bu eklenti, URL, çerezler ve tarayıcı dil tercihleri temelinde kullanıcı için en iyi yereli otomatik olarak algılar.
|
|
679
|
+
|
|
680
|
+
```ts fileName="vite.config.ts"
|
|
681
|
+
import { defineConfig } from "vite";
|
|
682
|
+
import { intlayer, intlayerProxy } from "vite-intlayer";
|
|
683
|
+
import { sveltekit } from "@sveltejs/kit/vite";
|
|
684
|
+
|
|
685
|
+
// https://vitejs.dev/config/
|
|
686
|
+
export default defineConfig({
|
|
687
|
+
plugins: [intlayer(), intlayerProxy(), sveltekit()],
|
|
688
|
+
});
|
|
689
|
+
```
|
|
690
|
+
|
|
691
|
+
### (İsteğe Bağlı) Adım 11: intlayer editör / CMS kurulumu
|
|
692
|
+
|
|
693
|
+
intlayer editörünü kurmak için, [intlayer editör dokümantasyonunu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_visual_editor.md) takip etmelisiniz.
|
|
694
|
+
|
|
695
|
+
intlayer CMS'i kurmak için, [intlayer CMS dokümantasyonunu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md) takip etmelisiniz.
|
|
696
|
+
|
|
697
|
+
intlayer editör seçicisini görselleştirebilmek için, intlayer içeriğinizde bileşen sözdizimini kullanmanız gerekecektir.
|
|
698
|
+
|
|
699
|
+
```svelte fileName="Component.svelte"
|
|
700
|
+
<script lang="ts">
|
|
701
|
+
import { useIntlayer } from "svelte-intlayer";
|
|
702
|
+
|
|
703
|
+
const content = useIntlayer("component");
|
|
704
|
+
</script>
|
|
705
|
+
|
|
706
|
+
<div>
|
|
707
|
+
|
|
708
|
+
<!-- İçeriği basit içerik olarak render et -->
|
|
709
|
+
<h1>{$content.title}</h1>
|
|
710
|
+
|
|
711
|
+
<!-- İçeriği bir bileşen olarak render et (editör tarafından gereklidir) -->
|
|
712
|
+
<svelte:component this={$content.component} />
|
|
713
|
+
</div>
|
|
714
|
+
```
|
|
715
|
+
|
|
716
|
+
### Git Yapılandırması
|
|
717
|
+
|
|
718
|
+
Intlayer tarafından oluşturulan dosyaların göz ardı edilmesi önerilir.
|
|
719
|
+
|
|
720
|
+
```plaintext fileName=".gitignore"
|
|
721
|
+
# Intlayer tarafından oluşturulan dosyaları göz ardı et
|
|
722
|
+
.intlayer
|
|
723
|
+
```
|
|
724
|
+
|
|
725
|
+
---
|
|
726
|
+
|
|
727
|
+
### Daha İleri Gitmek İçin
|
|
728
|
+
|
|
729
|
+
- **Görsel Editör**: Çevirileri doğrudan kullanıcı arayüzünden düzenlemek için [Intlayer Görsel Editör](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_visual_editor.md) ile entegre olun.
|
|
730
|
+
- **CMS**: İçerik yönetiminizi dışa aktararak [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md) kullanın.
|