@intlayer/docs 6.0.0 → 6.0.2-canary.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.
Files changed (104) hide show
  1. package/dist/cjs/blog.cjs.map +1 -1
  2. package/dist/cjs/common.cjs +6 -5
  3. package/dist/cjs/common.cjs.map +1 -1
  4. package/dist/cjs/generated/blog.entry.cjs +318 -1863
  5. package/dist/cjs/generated/blog.entry.cjs.map +1 -1
  6. package/dist/cjs/generated/docs.entry.cjs +1317 -6282
  7. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  8. package/dist/cjs/generated/frequentQuestions.entry.cjs +197 -1182
  9. package/dist/cjs/generated/frequentQuestions.entry.cjs.map +1 -1
  10. package/dist/cjs/generated/legal.entry.cjs +43 -84
  11. package/dist/cjs/generated/legal.entry.cjs.map +1 -1
  12. package/dist/esm/blog.mjs.map +1 -1
  13. package/dist/esm/common.mjs +2 -5
  14. package/dist/esm/common.mjs.map +1 -1
  15. package/dist/esm/generated/blog.entry.mjs +318 -1863
  16. package/dist/esm/generated/blog.entry.mjs.map +1 -1
  17. package/dist/esm/generated/docs.entry.mjs +1317 -6282
  18. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  19. package/dist/esm/generated/frequentQuestions.entry.mjs +197 -1182
  20. package/dist/esm/generated/frequentQuestions.entry.mjs.map +1 -1
  21. package/dist/esm/generated/legal.entry.mjs +43 -84
  22. package/dist/esm/generated/legal.entry.mjs.map +1 -1
  23. package/dist/types/blog.d.ts +1 -1
  24. package/dist/types/blog.d.ts.map +1 -1
  25. package/dist/types/common.d.ts +1 -1
  26. package/dist/types/common.d.ts.map +1 -1
  27. package/dist/types/generated/blog.entry.d.ts +1 -1
  28. package/dist/types/generated/blog.entry.d.ts.map +1 -1
  29. package/dist/types/generated/docs.entry.d.ts +2 -1
  30. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  31. package/dist/types/generated/frequentQuestions.entry.d.ts +1 -1
  32. package/dist/types/generated/frequentQuestions.entry.d.ts.map +1 -1
  33. package/dist/types/generated/legal.entry.d.ts +1 -1
  34. package/dist/types/generated/legal.entry.d.ts.map +1 -1
  35. package/docs/ar/intlayer_CMS.md +261 -85
  36. package/docs/ar/releases/v6.md +273 -0
  37. package/docs/ar/roadmap.md +1 -3
  38. package/docs/ar/vs_code_extension.md +94 -63
  39. package/docs/de/intlayer_CMS.md +247 -65
  40. package/docs/de/releases/v6.md +298 -0
  41. package/docs/de/roadmap.md +1 -3
  42. package/docs/de/vs_code_extension.md +89 -58
  43. package/docs/en/configuration.md +9 -2
  44. package/docs/en/intlayer_CMS.md +205 -23
  45. package/docs/en/intlayer_cli.md +4 -4
  46. package/docs/en/intlayer_visual_editor.md +7 -6
  47. package/docs/en/intlayer_with_nextjs_14.md +17 -1
  48. package/docs/en/intlayer_with_nextjs_15.md +17 -1
  49. package/docs/en/releases/v6.md +268 -0
  50. package/docs/en/roadmap.md +1 -3
  51. package/docs/en/vs_code_extension.md +79 -49
  52. package/docs/en-GB/intlayer_CMS.md +216 -52
  53. package/docs/en-GB/releases/v6.md +297 -0
  54. package/docs/en-GB/roadmap.md +1 -3
  55. package/docs/en-GB/vs_code_extension.md +79 -48
  56. package/docs/es/intlayer_CMS.md +257 -84
  57. package/docs/es/releases/v6.md +274 -0
  58. package/docs/es/roadmap.md +1 -3
  59. package/docs/es/vs_code_extension.md +90 -60
  60. package/docs/fr/intlayer_CMS.md +250 -68
  61. package/docs/fr/releases/v6.md +274 -0
  62. package/docs/fr/roadmap.md +1 -3
  63. package/docs/fr/vs_code_extension.md +94 -63
  64. package/docs/hi/intlayer_CMS.md +253 -77
  65. package/docs/hi/releases/v6.md +273 -0
  66. package/docs/hi/roadmap.md +1 -3
  67. package/docs/hi/vs_code_extension.md +92 -61
  68. package/docs/it/intlayer_CMS.md +251 -73
  69. package/docs/it/releases/v6.md +273 -0
  70. package/docs/it/roadmap.md +1 -3
  71. package/docs/it/vs_code_extension.md +94 -63
  72. package/docs/ja/intlayer_CMS.md +282 -97
  73. package/docs/ja/releases/v6.md +273 -0
  74. package/docs/ja/roadmap.md +1 -3
  75. package/docs/ja/vs_code_extension.md +99 -68
  76. package/docs/ko/intlayer_CMS.md +267 -93
  77. package/docs/ko/releases/v6.md +273 -0
  78. package/docs/ko/roadmap.md +1 -3
  79. package/docs/ko/vs_code_extension.md +88 -57
  80. package/docs/pt/intlayer_CMS.md +261 -83
  81. package/docs/pt/releases/v6.md +273 -0
  82. package/docs/pt/roadmap.md +1 -3
  83. package/docs/pt/vs_code_extension.md +89 -58
  84. package/docs/ru/intlayer_CMS.md +240 -65
  85. package/docs/ru/releases/v6.md +274 -0
  86. package/docs/ru/roadmap.md +1 -1
  87. package/docs/ru/vs_code_extension.md +83 -52
  88. package/docs/tr/intlayer_CMS.md +278 -96
  89. package/docs/tr/intlayer_with_nextjs_page_router.md +1 -1
  90. package/docs/tr/intlayer_with_tanstack.md +3 -0
  91. package/docs/tr/releases/v6.md +273 -0
  92. package/docs/tr/roadmap.md +1 -1
  93. package/docs/tr/vs_code_extension.md +100 -71
  94. package/docs/zh/intlayer_CMS.md +257 -76
  95. package/docs/zh/releases/v6.md +273 -0
  96. package/docs/zh/roadmap.md +1 -3
  97. package/docs/zh/vs_code_extension.md +99 -68
  98. package/package.json +9 -8
  99. package/src/blog.ts +1 -1
  100. package/src/common.ts +2 -6
  101. package/src/generated/blog.entry.ts +323 -1864
  102. package/src/generated/docs.entry.ts +1317 -6278
  103. package/src/generated/frequentQuestions.entry.ts +202 -1183
  104. package/src/generated/legal.entry.ts +48 -85
@@ -0,0 +1,273 @@
1
+ ---
2
+ createdAt: 2025-09-22
3
+ updatedAt: 2025-09-22
4
+ title: Yeni Intlayer v6 - Yenilikler neler?
5
+ description: Intlayer v6'daki yenilikleri keşfedin. Performans, geliştirici deneyimi ve uluslararasılaştırma iş akışınızı geliştirecek yeni özelliklerde büyük iyileştirmeler.
6
+ keywords:
7
+ - Intlayer
8
+ - Yerelleştirme
9
+ - Geliştirme
10
+ - Performans
11
+ - Geliştirici Deneyimi
12
+ - Özellikler
13
+ - React
14
+ - Next.js
15
+ - JavaScript
16
+ - TypeScript
17
+ slugs:
18
+ - doc
19
+ - releases
20
+ - v6
21
+ ---
22
+
23
+ # Yeni Intlayer v6 - Yenilikler neler?
24
+
25
+ Intlayer v6'ya hoş geldiniz! Bu sürüm performans, geliştirici deneyimi ve güvenilirliğe odaklanıyor. Aşağıda, geçiş notları ve kopyala-yapıştır yapılabilir örneklerle birlikte önemli noktalar yer almaktadır.
26
+
27
+ ## Öne Çıkanlar
28
+
29
+ - Yeni komut: `npx intlayer content test` eksik çevirileri tespit etmek için
30
+ - Yeni global `autoFill` seçeneği ile eksik çeviriler otomatik olarak oluşturulur
31
+ - Fill komutu varsayılan olarak mevcut çevirileri atlar: `npx intlayer fill`
32
+ - VS Code eklentisi: yeni Intlayer Aktivite Çubuğu (Arama & Sözlükler), araç çubuğu/bağlam menüsü işlemleri, otomatik görünürlük, Fill/Test komutları
33
+ - Promise paralelleştirmesi sayesinde 10 kat daha hızlı derlemeler
34
+ - Uygulama başlangıcında yeniden getirmeyi önlemek için uzak sözlük önbellekleme
35
+ - Geliştirilmiş günlükleme: davranışı incelemek için `log.mode: 'verbose'` ayarlayın
36
+ - Sözlük sorunlarında uygulama çökmelerini önlemek için daha güçlü doğrulama
37
+ - CMS ile canlı güncellemeler için `build.importMode = 'live'` ve `pnpm intlayer live` kullanımı
38
+ - Düzeltmeler: Vue.js entegrasyonu, Lynx adaptörü, Windows'ta Görsel Editör
39
+
40
+ ---
41
+
42
+ ## Yeni: Eksik çevirileri test etme
43
+
44
+ Projenizi hızlıca denetleyerek hangi anahtarların/dillerin eksik olduğunu bulun.
45
+
46
+ ```bash
47
+ npx intlayer content test
48
+ ```
49
+
50
+ Çıktı:
51
+
52
+ ```bash
53
+ pnpm intlayer content test
54
+ Eksik çeviriler:
55
+ - blog-data - Japonca (ja), Korece (ko), Çince (zh), Almanca (de), İtalyanca (it) - src/components/BlogPage/blogData.content.ts
56
+ - demo-page - Fransızca (fr), İtalyanca (it) - src/components/DemoPage/demo.content.ts
57
+ - locale-switcher - İtalyanca (it), Portekizce (pt) - src/components/LocaleSwitcher/localeSwitcher.content.ts
58
+ Diller: İngilizce (en), Rusça (ru), Japonca (ja), Fransızca (fr), Korece (ko), Çince (zh), İspanyolca (es), Almanca (de), Arapça (ar), İtalyanca (it), İngiliz İngilizcesi (en-GB), Portekizce (pt), Hintçe (hi)
59
+ Gerekli diller: İngilizce (en)
60
+ Eksik diller: Japonca (ja), Korece (ko), Çince (zh), Almanca (de), İtalyanca (it), Fransızca (fr), Portekizce (pt)
61
+ Gerekli eksik diller: -
62
+ Toplam eksik diller: 7
63
+ Toplam gerekli eksik diller: 0
64
+ ```
65
+
66
+ Daha fazla seçenek için CLI dokümantasyonuna bakınız: [CLI referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_cli.md) → "Eksik çevirileri test et". Ayrıca [Test Etme](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/testing.md) rehberine de göz atabilirsiniz.
67
+
68
+ ---
69
+
70
+ ## Yeni: Eksik çevirileri tamamlamak için global autoFill
71
+
72
+ Artık auto-fill özelliğini global olarak etkinleştirebilirsiniz, böylece eksik çevirisi olan herhangi bir sözlük otomatik olarak tamamlanır.
73
+
74
+ ```ts fileName="intlayer.config.ts"
75
+ import { type IntlayerConfig, Locales } from "intlayer";
76
+
77
+ const config: IntlayerConfig = {
78
+ internationalization: {
79
+ locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
80
+ defaultLocale: Locales.ENGLISH,
81
+ requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
82
+ },
83
+ content: {
84
+ // Tüm sözlükler için eksik çevirileri otomatik oluştur
85
+ autoFill: "./{{fileName}}.content.ts",
86
+ //
87
+ // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
88
+ //
89
+ // autoFill: true, // "./{{fileName}}.content.json" kullanımı gibi tüm sözlükler için eksik çevirileri otomatik oluştur
90
+ //
91
+ // autoFill: {
92
+ // en: "./{{fileName}}.en.content.json",
93
+ // fr: "./{{fileName}}.fr.content.json",
94
+ // es: "./{{fileName}}.es.content.json",
95
+ // },
96
+ },
97
+ };
98
+
99
+ export default config;
100
+ ```
101
+
102
+ İçerik dosyalarındaki `autoFill` alanını kullanarak her sözlük için ince ayar yapmaya devam edebilirsiniz. Tam referans için `doc/autoFill` ve `doc/dictionary/content_file` dosyalarına bakınız.
103
+
104
+ ---
105
+
106
+ ## Fill komutu: daha güvenli varsayılanlar
107
+
108
+ Fill komutu artık varsayılan olarak sadece eksik çevirileri doldurur ve mevcut içeriği atlar.
109
+
110
+ ```bash
111
+ npx intlayer fill
112
+ ```
113
+
114
+ ```bash
115
+ İşlenecek sözlük anahtarları: access-key-creation-form-schema, doc-search-metadata, doc-search-page
116
+ - [access-key-creation-form-schema] Sözlüğün dosya yolu yok. Atlanıyor.
117
+ - [access-key-creation-form-schema] İçerik bildirimi işleniyor: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts
118
+ - [access-key-creation-form-schema] Doldurulacak yerel ayar yok - Sözlük atlanıyor
119
+ - [doc-search-metadata] Sözlüğün dosya yolu yok. Atlanıyor.
120
+ - [doc-search-metadata] İçerik bildirimi işleniyor: src/app/[locale]/(docs)/doc/search/metadata.content.ts
121
+ - [doc-search-metadata] Doldurulacak yerel ayar yok - Sözlük atlanıyor
122
+ - [doc-search-page] Sözlüğün dosya yolu yok. Atlanıyor.
123
+ - [doc-search-page] İçerik bildirimi işleniyor: src/app/[locale]/(docs)/doc/search/page.content.ts
124
+ - [doc-search-page] [Rusça (ru)] İngilizce (en) dilinden Rusça (ru) diline sözlük çevirisi hazırlanıyor
125
+ [intlayer] src/app/[locale]/(docs)/doc/search/page.content.ts dosyasına Prettier biçimlendirmesi uygulandı
126
+ - [doc-search-page] İçerik bildirimi src/app/[locale]/(docs)/doc/search/page.content.ts dosyasına yazıldı
127
+ ```
128
+
129
+ CI örnekleri [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/CI_CD.md) sayfasında mevcuttur.
130
+
131
+ ---
132
+
133
+ ## Güncellenmiş VS Code eklentisi
134
+
135
+ Eklenti artık Aktivite Çubuğunda özel bir Intlayer sekmesi ve çeşitli iş akışı iyileştirmeleri içermektedir:
136
+
137
+ - İki görünüm içeren Intlayer Aktivite Çubuğu:
138
+ - Canlı sözlük/içerik araması için Arama web görünümü (`intlayer.searchBar`)
139
+ - Ortamları, sözlükleri ve katkıda bulunan dosyaları listeleyen Sözlükler ağacı (`intlayer.dictionaries`)
140
+ - Sözlükler görünümünde araç çubuğu: Derle, Çek, Gönder, Doldur, Yenile, Test Et, Sözlük Dosyası Oluştur
141
+ - Bağlam menüleri: Sözlüklerde Çek/Gönder; dosyalarda Doldur
142
+ - Otomatik gösterim: Geçerli düzenleyici dosyası, uygun olduğunda Sözlükler ağacında vurgulanır
143
+ - Komut Paletinden kullanılabilen yeni komutlar: Sözlükleri Doldur ve Sözlükleri Test Et
144
+
145
+ Detaylar için [Resmi VS Code Eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/vs_code_extension.md) dokümantasyonuna bakınız.
146
+
147
+ ---
148
+
149
+ ## Performans: 10× daha hızlı
150
+
151
+ - Yerel ve uzak sözlüklerin paralel çözümü
152
+ - Uzak sözlükler, uygulama başlangıcında yeniden getirilmemesi için önbelleğe alınır
153
+
154
+ ```bash
155
+ npx intlayer build
156
+ ```
157
+
158
+ Çıktı:
159
+
160
+ ```bash
161
+ [intlayer] Intlayer hazırlanıyor (v6.0.1)
162
+ [intlayer] Sözlükler:
163
+ [intlayer] ✓ Yerel içerik: 163/163
164
+ [intlayer] ✓ Uzak içerik: 100/100
165
+ [intlayer] - access-key-creation-form [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
166
+ [intlayer] - access-key-creation-form-schema [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
167
+ [intlayer] - access-key-form [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
168
+ [intlayer] - ai-ab-testing-section [uzak: ✔ içe aktarıldı]
169
+ [intlayer] - application-not-running-view [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
170
+ [intlayer] - application-template-message [yerel: ✔ oluşturuldu] [uzak: ✔ alındı]
171
+ [intlayer] - aside-navigation [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
172
+ [intlayer] - ask-reset-password [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
173
+ [intlayer] - ask-reset-password-schema [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
174
+ [intlayer] - otomatik tamamlama bölümü [yerel: ✔ oluşturuldu] [uzak: ✔ alındı]
175
+ [intlayer] - mevcut teknoloji bölümü [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
176
+ [intlayer] - blog verisi [yerel: ✔ oluşturuldu]
177
+ [intlayer] - blog meta verisi [yerel: ✔ oluşturuldu]
178
+ [intlayer] - blog navigasyon listesi [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
179
+ [intlayer] - blog sayfası [uzak: ✔ alındı]
180
+ [intlayer] - blog arama meta verisi [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
181
+ [intlayer] - blog arama sayfası [yerel: ✔ oluşturuldu] [uzak: ✔ içe aktarıldı]
182
+ ...
183
+ [intlayer] İçerik yüklendi (Toplam: 8401ms - Yerel: 4050ms - Uzak: 4222ms)
184
+ ```
185
+
186
+ ---
187
+
188
+ ## Günlükleme iyileştirmeleri
189
+
190
+ Günlükleme sistemi, derleme ve çalışma zamanı dönüşümleri sırasında neler olduğunu daha ayrıntılı şekilde sağlamak için geliştirildi.
191
+
192
+ > Derleme ve çalışma zamanı dönüşümleri sırasında neler olduğunu daha iyi anlamak için ayrıntılı günlükleri etkinleştirin.
193
+
194
+ ```ts fileName="intlayer.config.ts"
195
+ export default {
196
+ log: {
197
+ mode: "verbose", // seçenekler: "default" | "verbose" | "disabled"
198
+ },
199
+ };
200
+ ```
201
+
202
+ Tüm günlükleme seçenekleri için [Yapılandırma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) sayfasına bakınız.
203
+
204
+ ---
205
+
206
+ ## Daha güçlü doğrulama
207
+
208
+ Sözlük işleme artık daha sağlam doğrulama yapmaktadır. Bir sözlük işlenemediğinde, Intlayer uygulamanızın çökmesini önler ve uygulanabilir hataları gösterir.
209
+
210
+ ---
211
+
212
+ ## CMS ile Canlı Güncellemeler (Üretim Güvenli)
213
+
214
+ Canlı içerik güncellemelerini (örneğin, editoryal güncellemeler) uygulamanızı yeniden derlemeden üretimde sunun.
215
+
216
+ 1. Canlı import modunu etkinleştirin:
217
+
218
+ ```ts fileName="intlayer.config.ts"
219
+ import { type IntlayerConfig } from "intlayer";
220
+
221
+ const config: IntlayerConfig = {
222
+ build: {
223
+ importMode: "live", // "static" | "dynamic" | "live"
224
+ },
225
+ editor: {
226
+ liveSync: true, // sunucu tarafında canlı senkronizasyonu etkinleştir
227
+ },
228
+ };
229
+
230
+ export default config;
231
+ ```
232
+
233
+ 2. Uygulamanızı çalıştırın ve canlı işlemi yan yana yürütün:
234
+
235
+ ```bash
236
+ npx intlayer live --process 'vite preview'
237
+ ```
238
+
239
+ Notlar:
240
+
241
+ - Sadece canlı mod kullanımı için işaretlenmiş sözlükler canlı olarak alınacaktır. Diğerleri performans için optimize edilmiştir.
242
+ - Canlı API erişilemezse dinamik import'a geri dönülür.
243
+
244
+ Tam rehberlik için [CMS ve Canlı Senkronizasyon](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md) ve [Yapılandırma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) sayfalarına bakın.
245
+
246
+ ---
247
+
248
+ ## Geçiş notları
249
+
250
+ - Kaldırıldı: `dictionaryOutput` (önceden `i18next` veya `next-intl`). Bu, gelecekteki sürümlerde takılabilir adaptörler olarak geri gelecek. Yapılandırmanızdan bu alanı kaldırın.
251
+ - İlgili kaldırma: `i18nextResourcesDir` (bkz. `doc/configuration` değişiklik günlüğü).
252
+ - Eksik çevirileri toplu olarak oluşturmak için yeni global `content.autoFill` seçeneğini tercih edin.
253
+ - Eksik çeviriler için PR'ları kontrol etmek amacıyla `npx intlayer content test` komutunu kullanın.
254
+ - Ayrıntılı tanılama için `log.mode = 'verbose'` olarak ayarlayın.
255
+
256
+ ---
257
+
258
+ ## Düzeltmeler
259
+
260
+ - Vue.js entegrasyon kararlılığı
261
+ - Lynx adaptör iyileştirmeleri
262
+ - Windows üzerinde Görsel Düzenleyici
263
+
264
+ ---
265
+
266
+ ## Faydalı bağlantılar
267
+
268
+ - [CLI referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_cli.md)
269
+ - [Otomatik doldurma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/autoFill.md)
270
+ - [Yapılandırma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
271
+ - [İçerik dosyası referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/content_file.md)
272
+ - [Resmi VS Code Eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/vs_code_extension.md)
273
+ - [CMS ve Canlı Senkronizasyon](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
@@ -121,7 +121,7 @@ Intlayer içerik bildirmek için **TypeScript** (ayrıca JavaScript) ve **JSON**
121
121
 
122
122
  > Kaynaklar:
123
123
  >
124
- > - [İçerik Bildirim Formatları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_extention_customization.md)
124
+ > - [İçerik Bildirim Formatları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md)
125
125
 
126
126
  ### 7. Temizleme, paket optimizasyonu ve dinamik içe aktarmalar
127
127
 
@@ -1,8 +1,8 @@
1
1
  ---
2
- createdAt: 2025-09-07
3
- updatedAt: 2025-09-07
2
+ createdAt: 2025-03-17
3
+ updatedAt: 2025-09-22
4
4
  title: Resmi VS Code Uzantısı
5
- description: Geliştirme iş akışınızı geliştirmek için VS Code'da Intlayer uzantısının nasıl kullanılacağını öğrenin. Yerelleştirilmiş içerik arasında hızlıca gezinin ve sözlüklerinizi verimli bir şekilde yönetin.
5
+ description: Geliştirme iş akışınızı geliştirmek için VS Code'da Intlayer uzantısını nasıl kullanacağınızı öğrenin. Yerelleştirilmiş içerikler arasında hızlıca gezin ve sözlüklerinizi verimli bir şekilde yönetin.
6
6
  keywords:
7
7
  - VS Code Uzantısı
8
8
  - Intlayer
@@ -21,7 +21,7 @@ slugs:
21
21
 
22
22
  ## Genel Bakış
23
23
 
24
- [**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), projelerinizde yerelleştirilmiş içerikle çalışırken geliştirici deneyimini iyileştirmek için tasarlanmış **Intlayer** için resmi Visual Studio Code uzantısıdır.
24
+ [**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), projelerinizde yerelleştirilmiş içeriklerle çalışırken geliştirici deneyimini iyileştirmek için tasarlanmış **Intlayer**'ın resmi Visual Studio Code uzantısıdır.
25
25
 
26
26
  ![Intlayer VS Code Uzantısı](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
27
27
 
@@ -31,59 +31,109 @@ Uzantı bağlantısı: [https://marketplace.visualstudio.com/items?itemName=Intl
31
31
 
32
32
  ### Anında Gezinme
33
33
 
34
- **Tanım Git Desteği** – Karşılık gelen içerik dosyasını anında açmak için bir `useIntlayer` anahtarında `Cmd+Click` (Mac) veya `Ctrl+Click` (Windows/Linux) kullanın.
35
- **Sorunsuz Entegrasyon** – **react-intlayer** ve **next-intlayer** projeleriyle zahmetsizce çalışır.
36
- **Çok Dilli Destek** – Farklı diller arasında yerelleştirilmiş içeriği destekler.
37
- **VS Code Entegrasyonu** – VS Code'un gezinme ve komut paletiyle sorunsuz entegre olur.
34
+ **Tanıma Git Desteği** – `useIntlayer` anahtarında `⌘ + Tıklama` (Mac) veya `Ctrl + Tıklama` (Windows/Linux) kullanarak ilgili içerik dosyasını anında açın.
35
+ **Sorunsuz Entegrasyon** – **react-intlayer** ve **next-intlayer** projeleriyle sorunsuz çalışır.
36
+ **Çok Dilli Destek** – Farklı dillerde yerelleştirilmiş içerikleri destekler.
37
+ **VS Code Entegrasyonu** – VS Codeun gezinme ve komut paleti ile sorunsuz entegre olur.
38
38
 
39
- ### Sözlük Yönetimi Komutları
39
+ ### Sözlük Yönetim Komutları
40
40
 
41
- İçerik sözlüklerinizi doğrudan VS Code'dan yönetin:
41
+ İçerik sözlüklerinizi doğrudan VS Codedan yönetin:
42
42
 
43
- - **Sözlükleri Oluştur** (`extension.buildDictionaries`) – Proje yapınıza göre içerik dosyaları oluşturun.
44
- - **Sözlükleri Gönder** (`extension.pushDictionaries`) – En son sözlük içeriğini deponuza yükleyin.
45
- - **Sözlükleri Çek** (`extension.pullDictionaries`) – En son sözlük içeriğini deponuzdan yerel ortamınıza senkronize edin.
43
+ - **Sözlükleri Oluştur** – Proje yapınıza göre içerik dosyaları oluşturur.
44
+ - **Sözlükleri Gönder** – En son sözlük içeriğini deponuza yükler.
45
+ - **Sözlükleri Çek** – En son sözlük içeriğini deponuzdan yerel ortamınıza senkronize eder.
46
+ - **Sözlükleri Doldur** – Sözlükleri projenizden içerik ile doldurur.
47
+ - **Sözlükleri Test Et** – Eksik veya tamamlanmamış çevirileri tespit eder.
46
48
 
47
- ### İçerik Bildirim Oluşturucu
49
+ ### İçerik Beyanı Oluşturucu
48
50
 
49
- Farklı formatlarda yapılandırılmış sözlük dosyaları kolayca oluşturun:
51
+ Farklı formatlarda yapılandırılmış sözlük dosyalarını kolayca oluşturun:
50
52
 
51
- - **TypeScript (`.ts`)** `extension.createDictionaryFile.ts`
52
- - **ES Modülü (`.esm`)** – `extension.createDictionaryFile.esm`
53
- - **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
54
- - **JSON (`.json`)** – `extension.createDictionaryFile.json`
53
+ Eğer şu anda bir bileşen üzerinde çalışıyorsanız, sizin için `.content.{ts,tsx,js,jsx,mjs,cjs,json}` dosyasını oluşturacaktır.
55
54
 
56
- ## Kurulum
55
+ Bileşen örneği:
57
56
 
58
- **Intlayer**'ı doğrudan VS Code Marketplace'ten yükleyebilirsiniz:
57
+ ```tsx fileName="src/components/MyComponent/index.tsx"
58
+ const MyComponent = () => {
59
+ const { myTranslatedContent } = useIntlayer("my-component");
59
60
 
60
- 1. **VS Code**'u açın.
61
- 2. **Uzantılar Marketplace**'e gidin.
62
- 3. **"Intlayer"** arayın.
63
- 4. **Yükle**'ye tıklayın.
61
+ return <span>{myTranslatedContent}</span>;
62
+ };
63
+ ```
64
64
 
65
- Alternatif olarak, komut satırı aracılığıyla yükleyin:
65
+ TypeScript formatında oluşturulan dosya:
66
66
 
67
- ```sh
68
- code --install-extension intlayer
67
+ ```tsx fileName="src/components/MyComponent/index.content.ts"
68
+ import { t, type Dictionary } from "intlayer";
69
+
70
+ const componentContent = {
71
+ key: "my-component",
72
+ content: {
73
+ myTranslatedContent: t({
74
+ en: "Hello World",
75
+ es: "Hola Mundo",
76
+ fr: "Bonjour le monde",
77
+ }),
78
+ },
79
+ };
80
+
81
+ export default componentContent;
69
82
  ```
70
83
 
84
+ Mevcut formatlar:
85
+
86
+ - **TypeScript (`.ts`)**
87
+ - **ES Modülü (`.esm`)**
88
+ - **CommonJS (`.cjs`)**
89
+ - **JSON (`.json`)**
90
+
91
+ ### Intlayer Sekmesi (Aktivite Çubuğu)
92
+
93
+ VS Code Aktivite Çubuğundaki Intlayer simgesine tıklayarak Intlayer sekmesini açın. Bu sekme iki görünüm içerir:
94
+
95
+ - **Arama**: Sözlükleri ve içeriklerini hızlıca filtrelemek için canlı bir arama çubuğu. Yazdıkça sonuçlar anında güncellenir.
96
+ - **Sözlükler**: Ortamlarınız/projeleriniz, sözlük anahtarları ve giriş sağlayan dosyaların ağaç görünümü. Şunları yapabilirsiniz:
97
+ - Bir dosyaya tıklayarak düzenleyicide açabilirsiniz.
98
+ - Araç çubuğunu kullanarak şu işlemleri yapabilirsiniz: Derle (Build), Çek (Pull), Gönder (Push), Doldur (Fill), Yenile (Refresh), Test Et (Test) ve Sözlük Dosyası Oluştur (Create Dictionary File).
99
+ - Öğeye özel işlemler için bağlam menüsünü kullanabilirsiniz:
100
+ - Bir sözlük üzerinde: Çek (Pull) veya Gönder (Push)
101
+ - Bir dosya üzerinde: Sözlüğü Doldur (Fill Dictionary)
102
+ - Düzenleyiciler arasında geçiş yaptığınızda, dosya bir sözlüğe aitse ağaç görünümü ilgili dosyayı gösterecektir.
103
+
104
+ ## Kurulum
105
+
106
+ **Intlayer**'ı doğrudan VS Code Marketplace'ten yükleyebilirsiniz:
107
+
108
+ 1. **VS Code**'u açın.
109
+ 2. **Extensions Marketplace**'e gidin.
110
+ 3. **"Intlayer"** için arama yapın.
111
+ 4. **Install** (Yükle) butonuna tıklayın.
112
+
71
113
  ## Kullanım
72
114
 
73
115
  ### Hızlı Gezinme
74
116
 
75
- 1. **react-intlayer** kullanan bir proje açın.
76
- 2. Aşağıdaki gibi bir `useIntlayer()` çağrısı bulun:
117
+ 1. **react-intlayer** kullanan bir projeyi açın.
118
+ 2. `useIntlayer()` çağrısını bulun, örneğin:
77
119
 
78
120
  ```tsx
79
121
  const content = useIntlayer("app");
80
122
  ```
81
123
 
82
- 3. Anahtar üzerinde (ör. `"app"`) **Command-tıklayın** (`⌘+Click` macOS'ta) veya **Ctrl+Click** (Windows/Linux'ta).
83
- 4. VS Code otomatik olarak karşılık gelen sözlük dosyasını açacaktır, ör. `src/app.content.ts`.
124
+ 3. Anahtar üzerinde **Command-click** (`⌘+Click` macOS'ta) veya **Ctrl+Click** (Windows/Linux'ta) yapın (örneğin, `"app"`).
125
+ 4. VS Code otomatik olarak ilgili sözlük dosyasını açacaktır, örneğin `src/app.content.ts`.
84
126
 
85
127
  ### İçerik Sözlüklerini Yönetme
86
128
 
129
+ ### Intlayer Sekmesi (Activity Bar)
130
+
131
+ Sözlükleri gözden geçirmek ve yönetmek için yan sekmeyi kullanın:
132
+
133
+ - Activity Bar'daki Intlayer simgesini açın.
134
+ - **Arama** bölümünde, sözlükleri ve girdileri gerçek zamanlı olarak filtrelemek için yazın.
135
+ - **Sözlükler** bölümünde, ortamları, sözlükleri ve dosyaları gezinin. Araç çubuğunu Kullanarak Oluştur, Çek, Gönder, Doldur, Yenile, Test Et ve Sözlük Dosyası Oluştur işlemlerini yapabilirsiniz. Bağlam menüsü için sağ tıklayın (sözlüklerde Çek/Gönder, dosyalarda Doldur). Geçerli düzenleyici dosyası, uygun olduğunda ağaçta otomatik olarak gösterilir.
136
+
87
137
  #### Sözlükleri Oluşturma
88
138
 
89
139
  Tüm sözlük içerik dosyalarını oluşturmak için:
@@ -92,60 +142,39 @@ Tüm sözlük içerik dosyalarını oluşturmak için:
92
142
  Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
93
143
  ```
94
144
 
95
- **Sözlükleri Oluştur** arayın ve komutu çalıştırın.
145
+ **Sözlükleri Oluştur** komutunu arayın ve çalıştırın.
96
146
 
97
147
  #### Sözlükleri Gönderme
98
148
 
99
- En son sözlük içeriğini yükleyin:
149
+ En son sözlük içeriğini yüklemek için:
100
150
 
101
- 1. **Komut Paleti**'ni açın.
102
- 2. **Sözlükleri Gönder** arayın.
103
- 3. Gönderilecek sözlükleri seçin ve onaylayın.
151
+ 1. **Komut Paletini** açın.
152
+ 2. **Sözlükleri Gönder** araması yapın.
153
+ 3. Göndermek istediğiniz sözlükleri seçin ve onaylayın.
104
154
 
105
155
  #### Sözlükleri Çekme
106
156
 
107
157
  En son sözlük içeriğini senkronize edin:
108
158
 
109
- 1. **Komut Paleti**'ni açın.
110
- 2. **Sözlükleri Çek** arayın.
111
- 3. Çekilecek sözlükleri seçin.
112
-
113
- ## Geliştirme & Katkı
114
-
115
- Katkıda bulunmak mı istiyorsunuz? Topluluk katkılarını memnuniyetle karşılıyoruz!
116
-
117
- Repo URL: https://github.com/aymericzip/intlayer-vs-code-extension
118
-
119
- ### Başlarken
120
-
121
- Depoyu klonlayın ve bağımlılıkları yükleyin:
122
-
123
- ```sh
124
- git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
125
- cd intlayer-vs-code-extension
126
- npm install
127
- ```
128
-
129
- > `vsce` paketiyle uyumluluk için `npm` paket yöneticisini kullanın, uzantıyı oluşturmak ve yayınlamak için.
130
-
131
- ### Geliştirme Modunda Çalıştırın
132
-
133
- 1. Projeyi **VS Code**'da açın.
134
- 2. Yeni bir **Uzantı Geliştirme Ana Bilgisayarı** penceresi başlatmak için `F5`'e basın.
135
-
136
- ### Bir Pull Request Gönderin
159
+ 1. **Komut Paletini** açın.
160
+ 2. **Sözlükleri Çek** araması yapın.
161
+ 3. Çekmek istediğiniz sözlükleri seçin.
137
162
 
138
- Uzantıyı iyileştirirseniz, [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension)'da bir PR gönderin.
163
+ #### Sözlükleri Doldurma
139
164
 
140
- ## Geri Bildirim & Sorunlar
165
+ Sözlükleri projenizden gelen içerikle doldurun:
141
166
 
142
- Bir hata mı buldunuz veya özellik isteğiniz mi var? **GitHub deposumuzda** bir sorun açın:
167
+ 1. **Komut Paletini** açın.
168
+ 2. **Sözlükleri Doldur** araması yapın.
169
+ 3. Sözlükleri doldurmak için komutu çalıştırın.
143
170
 
144
- [GitHub Sorunları](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
171
+ #### Sözlükleri Test Etme
145
172
 
146
- ## Lisans
173
+ Sözlükleri doğrulayın ve eksik çevirileri bulun:
147
174
 
148
- Intlayer **MIT Lisansı** altında yayınlanmıştır.
175
+ 1. **Komut Paletini** açın.
176
+ 2. **Sözlükleri Test Et** araması yapın.
177
+ 3. Raporlanan sorunları inceleyin ve gerektiği şekilde düzeltin.
149
178
 
150
179
  ## Doküman Geçmişi
151
180