@intlayer/docs 7.5.9 → 7.5.10
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 +9 -2
- 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/cli/push.md +1 -1
- package/docs/ar/configuration.md +3 -3
- package/docs/ar/interest_of_intlayer.md +1 -1
- package/docs/ar/intlayer_CMS.md +5 -5
- package/docs/ar/intlayer_with_express.md +1 -0
- package/docs/ar/intlayer_with_fastify.md +516 -0
- package/docs/ar/readme.md +1 -1
- package/docs/de/cli/push.md +1 -1
- package/docs/de/configuration.md +3 -3
- package/docs/de/interest_of_intlayer.md +1 -1
- package/docs/de/intlayer_CMS.md +5 -5
- package/docs/de/intlayer_with_express.md +1 -0
- package/docs/de/intlayer_with_fastify.md +449 -0
- package/docs/de/readme.md +1 -1
- package/docs/en/cli/push.md +1 -1
- package/docs/en/configuration.md +3 -3
- package/docs/en/interest_of_intlayer.md +1 -1
- package/docs/en/intlayer_CMS.md +5 -5
- package/docs/en/intlayer_with_express.md +1 -0
- package/docs/en/intlayer_with_fastify.md +439 -0
- package/docs/en/readme.md +3 -1
- package/docs/en-GB/cli/push.md +1 -1
- package/docs/en-GB/configuration.md +3 -3
- package/docs/en-GB/interest_of_intlayer.md +1 -1
- package/docs/en-GB/intlayer_CMS.md +5 -5
- package/docs/en-GB/intlayer_with_express.md +1 -0
- package/docs/en-GB/intlayer_with_fastify.md +445 -0
- package/docs/en-GB/readme.md +3 -1
- package/docs/es/cli/push.md +1 -1
- package/docs/es/configuration.md +3 -3
- package/docs/es/interest_of_intlayer.md +1 -1
- package/docs/es/intlayer_CMS.md +5 -5
- package/docs/es/intlayer_with_express.md +1 -0
- package/docs/es/intlayer_with_fastify.md +480 -0
- package/docs/es/readme.md +1 -1
- package/docs/fr/cli/push.md +1 -1
- package/docs/fr/configuration.md +3 -3
- package/docs/fr/interest_of_intlayer.md +1 -1
- package/docs/fr/intlayer_CMS.md +5 -5
- package/docs/fr/intlayer_with_express.md +1 -0
- package/docs/fr/intlayer_with_fastify.md +439 -0
- package/docs/fr/readme.md +1 -1
- package/docs/hi/cli/push.md +1 -1
- package/docs/hi/configuration.md +3 -3
- package/docs/hi/interest_of_intlayer.md +1 -1
- package/docs/hi/intlayer_CMS.md +5 -5
- package/docs/hi/intlayer_with_express.md +1 -0
- package/docs/hi/intlayer_with_fastify.md +540 -0
- package/docs/hi/readme.md +1 -1
- package/docs/id/cli/push.md +1 -1
- package/docs/id/configuration.md +3 -3
- package/docs/id/interest_of_intlayer.md +1 -1
- package/docs/id/intlayer_CMS.md +5 -5
- package/docs/id/intlayer_with_express.md +1 -0
- package/docs/id/intlayer_with_fastify.md +470 -0
- package/docs/id/readme.md +1 -1
- package/docs/it/cli/push.md +1 -1
- package/docs/it/configuration.md +3 -3
- package/docs/it/interest_of_intlayer.md +1 -1
- package/docs/it/intlayer_CMS.md +5 -5
- package/docs/it/intlayer_with_express.md +1 -0
- package/docs/it/intlayer_with_fastify.md +445 -0
- package/docs/it/readme.md +1 -1
- package/docs/ja/cli/push.md +1 -1
- package/docs/ja/configuration.md +3 -3
- package/docs/ja/interest_of_intlayer.md +1 -1
- package/docs/ja/intlayer_CMS.md +5 -5
- package/docs/ja/intlayer_with_express.md +1 -0
- package/docs/ja/intlayer_with_fastify.md +516 -0
- package/docs/ja/readme.md +1 -1
- package/docs/ko/cli/push.md +1 -1
- package/docs/ko/configuration.md +3 -3
- package/docs/ko/interest_of_intlayer.md +1 -1
- package/docs/ko/intlayer_CMS.md +5 -5
- package/docs/ko/intlayer_with_express.md +1 -0
- package/docs/ko/intlayer_with_fastify.md +463 -0
- package/docs/ko/readme.md +1 -1
- package/docs/pl/cli/push.md +1 -1
- package/docs/pl/configuration.md +3 -3
- package/docs/pl/interest_of_intlayer.md +1 -1
- package/docs/pl/intlayer_CMS.md +5 -5
- package/docs/pl/intlayer_with_express.md +1 -0
- package/docs/pl/intlayer_with_fastify.md +457 -0
- package/docs/pl/readme.md +1 -1
- package/docs/pt/cli/push.md +1 -1
- package/docs/pt/configuration.md +3 -3
- package/docs/pt/interest_of_intlayer.md +1 -1
- package/docs/pt/intlayer_CMS.md +5 -5
- package/docs/pt/intlayer_with_express.md +1 -0
- package/docs/pt/intlayer_with_fastify.md +502 -0
- package/docs/pt/readme.md +1 -1
- package/docs/ru/cli/push.md +1 -1
- package/docs/ru/configuration.md +3 -3
- package/docs/ru/interest_of_intlayer.md +1 -1
- package/docs/ru/intlayer_CMS.md +5 -5
- package/docs/ru/intlayer_with_express.md +1 -0
- package/docs/ru/intlayer_with_fastify.md +468 -0
- package/docs/ru/readme.md +1 -1
- package/docs/tr/cli/push.md +1 -1
- package/docs/tr/configuration.md +3 -3
- package/docs/tr/interest_of_intlayer.md +1 -1
- package/docs/tr/intlayer_CMS.md +5 -5
- package/docs/tr/intlayer_with_express.md +1 -0
- package/docs/tr/intlayer_with_fastify.md +471 -0
- package/docs/tr/readme.md +1 -1
- package/docs/vi/cli/push.md +1 -1
- package/docs/vi/configuration.md +3 -3
- package/docs/vi/interest_of_intlayer.md +1 -1
- package/docs/vi/intlayer_CMS.md +5 -5
- package/docs/vi/intlayer_with_express.md +1 -0
- package/docs/vi/intlayer_with_fastify.md +490 -0
- package/docs/vi/readme.md +1 -1
- package/docs/zh/cli/push.md +1 -1
- package/docs/zh/configuration.md +3 -3
- package/docs/zh/interest_of_intlayer.md +1 -1
- package/docs/zh/intlayer_CMS.md +5 -5
- package/docs/zh/intlayer_with_express.md +1 -0
- package/docs/zh/intlayer_with_fastify.md +451 -0
- package/docs/zh/readme.md +1 -1
- package/package.json +6 -6
- package/src/generated/docs.entry.ts +19 -0
|
@@ -0,0 +1,463 @@
|
|
|
1
|
+
---
|
|
2
|
+
createdAt: 2025-12-30
|
|
3
|
+
updatedAt: 2025-12-30
|
|
4
|
+
title: Fastify 백엔드를 번역하는 방법 – i18n 가이드 2026
|
|
5
|
+
description: Fastify 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역 절차를 따르세요.
|
|
6
|
+
keywords:
|
|
7
|
+
- 국제화 (i18n)
|
|
8
|
+
- 문서
|
|
9
|
+
- Intlayer
|
|
10
|
+
- Fastify
|
|
11
|
+
- JavaScript
|
|
12
|
+
- 백엔드
|
|
13
|
+
slugs:
|
|
14
|
+
- doc
|
|
15
|
+
- environment
|
|
16
|
+
- fastify
|
|
17
|
+
applicationTemplate: https://github.com/aymericzip/intlayer-fastify-template
|
|
18
|
+
history:
|
|
19
|
+
- version: 7.6.0
|
|
20
|
+
date: 2025-12-31
|
|
21
|
+
changes: init 명령 추가
|
|
22
|
+
- version: 7.6.0
|
|
23
|
+
date: 2025-12-31
|
|
24
|
+
changes: 초기 히스토리
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
# Intlayer로 Fastify 백엔드 웹사이트 번역하기 | 국제화(i18n)
|
|
28
|
+
|
|
29
|
+
`fastify-intlayer`은 Fastify 애플리케이션을 위한 강력한 국제화(i18n) 플러그인으로, 클라이언트의 선호에 따라 로컬라이즈된 응답을 제공하여 백엔드 서비스를 전 세계적으로 접근 가능하게 만듭니다.
|
|
30
|
+
|
|
31
|
+
### 실용적인 사용 사례
|
|
32
|
+
|
|
33
|
+
- **사용자 언어로 백엔드 오류 표시하기**: 오류가 발생했을 때 사용자 모국어로 메시지를 표시하면 이해를 돕고 좌절감을 줄여줍니다. 이는 토스트나 모달 같은 프론트엔드 컴포넌트에 표시될 수 있는 동적 오류 메시지에 특히 유용합니다.
|
|
34
|
+
- **다국어 콘텐츠 제공**: 데이터베이스에서 콘텐츠를 가져오는 애플리케이션의 경우, 국제화는 이러한 콘텐츠를 여러 언어로 제공할 수 있도록 보장합니다. 이는 e-commerce 사이트나 콘텐츠 관리 시스템(CMS)처럼 제품 설명, 기사 및 기타 콘텐츠를 사용자가 선호하는 언어로 표시해야 하는 플랫폼에 매우 중요합니다.
|
|
35
|
+
- **다국어 이메일 발송**: 거래 관련 이메일, 마케팅 캠페인 또는 알림 등 수신자의 언어로 이메일을 발송하면 참여도와 효과를 크게 높일 수 있습니다.
|
|
36
|
+
- **다국어 푸시 알림**: 모바일 애플리케이션의 경우 사용자가 선호하는 언어로 푸시 알림을 보내면 상호작용과 유지율을 높일 수 있습니다. 이러한 개인화된 접근은 알림이 더 관련성 있고 실행 가능하게 느껴지도록 합니다.
|
|
37
|
+
- **기타 커뮤니케이션**: SMS 메시지, 시스템 경고 또는 사용자 인터페이스 업데이트와 같은 백엔드의 모든 형태의 커뮤니케이션은 사용자의 언어로 제공될 때 명확성을 보장하고 전체적인 사용자 경험을 향상시킵니다.
|
|
38
|
+
|
|
39
|
+
백엔드를 국제화하면 애플리케이션이 문화적 차이를 존중할 뿐만 아니라 글로벌 시장 요구에 더 잘 부합하게 되어 서비스를 전 세계로 확장하는 데 중요한 단계가 됩니다.
|
|
40
|
+
|
|
41
|
+
## 시작하기
|
|
42
|
+
|
|
43
|
+
### 설치
|
|
44
|
+
|
|
45
|
+
`fastify-intlayer`를 사용하기 시작하려면 npm을 사용해 패키지를 설치하세요:
|
|
46
|
+
|
|
47
|
+
```bash packageManager="npm"
|
|
48
|
+
npm install intlayer fastify-intlayer
|
|
49
|
+
npx intlayer init
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
```bash packageManager="pnpm"
|
|
53
|
+
pnpm add intlayer fastify-intlayer
|
|
54
|
+
pnpm intlayer init
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
```bash packageManager="yarn"
|
|
58
|
+
yarn add intlayer fastify-intlayer
|
|
59
|
+
yarn intlayer init
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
```bash packageManager="bun"
|
|
63
|
+
bun add intlayer fastify-intlayer
|
|
64
|
+
bunx intlayer init
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### 설정
|
|
68
|
+
|
|
69
|
+
프로젝트 루트에 `intlayer.config.ts` 파일을 생성하여 국제화 설정을 구성합니다:
|
|
70
|
+
|
|
71
|
+
```typescript fileName="intlayer.config.ts" codeFormat="typescript"
|
|
72
|
+
import { Locales, type IntlayerConfig } from "intlayer";
|
|
73
|
+
|
|
74
|
+
const config: IntlayerConfig = {
|
|
75
|
+
internationalization: {
|
|
76
|
+
locales: [
|
|
77
|
+
Locales.ENGLISH,
|
|
78
|
+
Locales.FRENCH,
|
|
79
|
+
Locales.SPANISH_MEXICO,
|
|
80
|
+
Locales.SPANISH_SPAIN,
|
|
81
|
+
],
|
|
82
|
+
defaultLocale: Locales.ENGLISH,
|
|
83
|
+
},
|
|
84
|
+
};
|
|
85
|
+
|
|
86
|
+
export default config;
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
```javascript fileName="intlayer.config.mjs" codeFormat="esm"
|
|
90
|
+
import { Locales } from "intlayer";
|
|
91
|
+
|
|
92
|
+
/** @type {import('intlayer').IntlayerConfig} */
|
|
93
|
+
const config = {
|
|
94
|
+
internationalization: {
|
|
95
|
+
locales: [
|
|
96
|
+
Locales.ENGLISH,
|
|
97
|
+
Locales.FRENCH,
|
|
98
|
+
Locales.SPANISH_MEXICO,
|
|
99
|
+
Locales.SPANISH_SPAIN,
|
|
100
|
+
],
|
|
101
|
+
defaultLocale: Locales.ENGLISH,
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
|
|
105
|
+
export default config;
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
|
|
109
|
+
const { Locales } = require("intlayer");
|
|
110
|
+
|
|
111
|
+
/** @type {import('intlayer').IntlayerConfig} */
|
|
112
|
+
const config = {
|
|
113
|
+
internationalization: {
|
|
114
|
+
locales: [
|
|
115
|
+
Locales.ENGLISH,
|
|
116
|
+
Locales.FRENCH,
|
|
117
|
+
Locales.SPANISH_MEXICO,
|
|
118
|
+
Locales.SPANISH_SPAIN,
|
|
119
|
+
],
|
|
120
|
+
defaultLocale: Locales.ENGLISH,
|
|
121
|
+
},
|
|
122
|
+
};
|
|
123
|
+
|
|
124
|
+
module.exports = config;
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### 콘텐츠 선언
|
|
128
|
+
|
|
129
|
+
번역을 저장하기 위한 콘텐츠 선언을 생성하고 관리하세요:
|
|
130
|
+
|
|
131
|
+
```typescript fileName="src/index.content.ts" contentDeclarationFormat="typescript"
|
|
132
|
+
import { t, type Dictionary } from "intlayer";
|
|
133
|
+
|
|
134
|
+
const indexContent = {
|
|
135
|
+
key: "index",
|
|
136
|
+
content: {
|
|
137
|
+
exampleOfContent: t({
|
|
138
|
+
ko: "영어로 반환된 콘텐츠 예시",
|
|
139
|
+
en: "Example of returned content in English",
|
|
140
|
+
fr: "Exemple de contenu renvoyé en français",
|
|
141
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
142
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)",
|
|
143
|
+
}),
|
|
144
|
+
},
|
|
145
|
+
} satisfies Dictionary;
|
|
146
|
+
|
|
147
|
+
export default indexContent;
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
```javascript fileName="src/index.content.mjs" contentDeclarationFormat="esm"
|
|
151
|
+
import { t } from "intlayer";
|
|
152
|
+
|
|
153
|
+
typescript fileName="src/index.content.ts" contentDeclarationFormat="typescript"
|
|
154
|
+
import { t, type Dictionary } from "intlayer";
|
|
155
|
+
|
|
156
|
+
/** @type {import('intlayer').Dictionary} */
|
|
157
|
+
const indexContent = {
|
|
158
|
+
key: "index",
|
|
159
|
+
content: {
|
|
160
|
+
exampleOfContent: t({
|
|
161
|
+
ko: "영어로 반환된 콘텐츠 예시",
|
|
162
|
+
en: "Example of returned content in English",
|
|
163
|
+
fr: "Exemple de contenu renvoyé en français",
|
|
164
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
165
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)",
|
|
166
|
+
}),
|
|
167
|
+
},
|
|
168
|
+
} satisfies Dictionary;
|
|
169
|
+
|
|
170
|
+
export default indexContent;
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
```javascript fileName="src/index.content.cjs" contentDeclarationFormat="commonjs"
|
|
174
|
+
const { t } = require("intlayer");
|
|
175
|
+
|
|
176
|
+
/** 인덱스 콘텐츠의 타입을 지정합니다. @type {import('intlayer').Dictionary} */
|
|
177
|
+
const indexContent = {
|
|
178
|
+
key: "index",
|
|
179
|
+
content: {
|
|
180
|
+
exampleOfContent: t({
|
|
181
|
+
ko: "영어로 반환된 콘텐츠 예시",
|
|
182
|
+
en: "Example of returned content in English",
|
|
183
|
+
fr: "Exemple de contenu renvoyé en français",
|
|
184
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
185
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)",
|
|
186
|
+
}),
|
|
187
|
+
},
|
|
188
|
+
};
|
|
189
|
+
|
|
190
|
+
module.exports = indexContent;
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
```json fileName="src/index.content.json" contentDeclarationFormat="json"
|
|
194
|
+
{
|
|
195
|
+
"$schema": "https://intlayer.org/schema.json",
|
|
196
|
+
"key": "index",
|
|
197
|
+
"content": {
|
|
198
|
+
"exampleOfContent": {
|
|
199
|
+
"nodeType": "translation",
|
|
200
|
+
"translation": {
|
|
201
|
+
"ko": "영어로 반환된 콘텐츠 예시",
|
|
202
|
+
"en": "Example of returned content in English",
|
|
203
|
+
"fr": "Exemple de contenu renvoyé en français",
|
|
204
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
205
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)"
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
> 콘텐츠 선언(content declarations)은 애플리케이션 내 어디에든 정의할 수 있으며, 단 `contentDir` 디렉터리(기본값 `./src`)에 포함되어 있어야 합니다. 또한 콘텐츠 선언 파일 확장자(기본값 `.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}`)와 일치해야 합니다.
|
|
213
|
+
|
|
214
|
+
> 자세한 내용은 [콘텐츠 선언 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)를 참조하세요.
|
|
215
|
+
|
|
216
|
+
### Fastify 애플리케이션 설정
|
|
217
|
+
|
|
218
|
+
fastify-intlayer를 사용하도록 Fastify 애플리케이션을 설정하세요:
|
|
219
|
+
|
|
220
|
+
```typescript fileName="src/index.ts" codeFormat="typescript"
|
|
221
|
+
import Fastify from "fastify";
|
|
222
|
+
import { intlayer, t, getDictionary, getIntlayer } from "fastify-intlayer";
|
|
223
|
+
import dictionaryExample from "./index.content";
|
|
224
|
+
|
|
225
|
+
const fastify = Fastify({ logger: true });
|
|
226
|
+
|
|
227
|
+
javascript fileName="src/index.mjs" codeFormat="esm"
|
|
228
|
+
// 국제화 플러그인 로드
|
|
229
|
+
await fastify.register(intlayer);
|
|
230
|
+
|
|
231
|
+
// 라우트
|
|
232
|
+
fastify.get("/t_example", async (_req, reply) => {
|
|
233
|
+
return t({
|
|
234
|
+
ko: "영어로 반환된 콘텐츠의 예시",
|
|
235
|
+
en: "Example of returned content in English",
|
|
236
|
+
fr: "Exemple de contenu renvoyé en français",
|
|
237
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
238
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)",
|
|
239
|
+
});
|
|
240
|
+
});
|
|
241
|
+
|
|
242
|
+
fastify.get("/getIntlayer_example", async (_req, reply) => {
|
|
243
|
+
return getIntlayer("index").exampleOfContent;
|
|
244
|
+
});
|
|
245
|
+
|
|
246
|
+
fastify.get("/getDictionary_example", async (_req, reply) => {
|
|
247
|
+
return getDictionary(dictionaryExample).exampleOfContent;
|
|
248
|
+
});
|
|
249
|
+
|
|
250
|
+
// 서버 시작
|
|
251
|
+
const start = async () => {
|
|
252
|
+
try {
|
|
253
|
+
await fastify.listen({ port: 3000 });
|
|
254
|
+
} catch (err) {
|
|
255
|
+
fastify.log.error(err);
|
|
256
|
+
process.exit(1);
|
|
257
|
+
}
|
|
258
|
+
};
|
|
259
|
+
|
|
260
|
+
start();
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
```javascript fileName="src/index.mjs" codeFormat="esm"
|
|
264
|
+
import Fastify from "fastify";
|
|
265
|
+
import { intlayer, t, getDictionary, getIntlayer } from "fastify-intlayer";
|
|
266
|
+
import dictionaryExample from "./index.content";
|
|
267
|
+
|
|
268
|
+
const fastify = Fastify({ logger: true });
|
|
269
|
+
|
|
270
|
+
// 국제화 플러그인 로드
|
|
271
|
+
await fastify.register(intlayer);
|
|
272
|
+
|
|
273
|
+
// 라우트
|
|
274
|
+
fastify.get("/t_example", async (_req, reply) => {
|
|
275
|
+
return t({
|
|
276
|
+
ko: "영어로 반환된 콘텐츠 예시",
|
|
277
|
+
en: "Example of returned content in English",
|
|
278
|
+
fr: "Exemple de contenu renvoyé en français",
|
|
279
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
280
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)",
|
|
281
|
+
});
|
|
282
|
+
});
|
|
283
|
+
|
|
284
|
+
fastify.get("/getIntlayer_example", async (_req, reply) => {
|
|
285
|
+
return getIntlayer("index").exampleOfContent;
|
|
286
|
+
});
|
|
287
|
+
|
|
288
|
+
fastify.get("/getDictionary_example", async (_req, reply) => {
|
|
289
|
+
return getDictionary(dictionaryExample).exampleOfContent;
|
|
290
|
+
});
|
|
291
|
+
|
|
292
|
+
// 서버 시작
|
|
293
|
+
const start = async () => {
|
|
294
|
+
try {
|
|
295
|
+
await fastify.listen({ port: 3000 });
|
|
296
|
+
} catch (err) {
|
|
297
|
+
fastify.log.error(err);
|
|
298
|
+
process.exit(1);
|
|
299
|
+
}
|
|
300
|
+
};
|
|
301
|
+
|
|
302
|
+
start();
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
```javascript fileName="src/index.cjs" codeFormat="commonjs"
|
|
306
|
+
const Fastify = require("fastify");
|
|
307
|
+
const { intlayer, t, getDictionary, getIntlayer } = require("fastify-intlayer");
|
|
308
|
+
const dictionaryExample = require("./index.content");
|
|
309
|
+
|
|
310
|
+
const fastify = Fastify({ logger: true });
|
|
311
|
+
|
|
312
|
+
// async/await를 위한 서버 시작 래퍼
|
|
313
|
+
const start = async () => {
|
|
314
|
+
try {
|
|
315
|
+
// 국제화 플러그인 로드
|
|
316
|
+
await fastify.register(intlayer);
|
|
317
|
+
|
|
318
|
+
// 라우트
|
|
319
|
+
fastify.get("/t_example", async (_req, reply) => {
|
|
320
|
+
return t({
|
|
321
|
+
ko: "반환된 콘텐츠 예시 (한국어)",
|
|
322
|
+
en: "Example of returned content in English",
|
|
323
|
+
fr: "Exemple de contenu renvoyé en français",
|
|
324
|
+
"es-ES": "Ejemplo de contenido devuelto en español (España)",
|
|
325
|
+
"es-MX": "Ejemplo de contenido devuelto en español (México)",
|
|
326
|
+
});
|
|
327
|
+
});
|
|
328
|
+
|
|
329
|
+
fastify.get("/getIntlayer_example", async (_req, reply) => {
|
|
330
|
+
return getIntlayer("index").exampleOfContent;
|
|
331
|
+
});
|
|
332
|
+
|
|
333
|
+
fastify.get("/getDictionary_example", async (_req, reply) => {
|
|
334
|
+
return getDictionary(dictionaryExample).exampleOfContent;
|
|
335
|
+
});
|
|
336
|
+
|
|
337
|
+
await fastify.listen({ port: 3000 });
|
|
338
|
+
} catch (err) {
|
|
339
|
+
fastify.log.error(err);
|
|
340
|
+
process.exit(1);
|
|
341
|
+
}
|
|
342
|
+
};
|
|
343
|
+
|
|
344
|
+
start();
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
### 호환성
|
|
348
|
+
|
|
349
|
+
`fastify-intlayer`은 다음과 완전히 호환됩니다:
|
|
350
|
+
|
|
351
|
+
- [`react-intlayer`](<https://www.google.com/search?q=%5Bhttps://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/index.md%5D(https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/index.md)>) React 애플리케이션용
|
|
352
|
+
- [`next-intlayer`](<https://www.google.com/search?q=%5Bhttps://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/index.md%5D(https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/index.md)>) Next.js 애플리케이션용
|
|
353
|
+
|
|
354
|
+
- [`react-intlayer`](<https://www.google.com/search?q=%5Bhttps://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/index.md%5D(https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/index.md)>) React 애플리케이션용
|
|
355
|
+
- [`next-intlayer`](<https://www.google.com/search?q=%5Bhttps://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/index.md%5D(https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/index.md)>) Next.js 애플리케이션용
|
|
356
|
+
- [`vite-intlayer`](<https://www.google.com/search?q=%5Bhttps://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/index.md%5D(https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/index.md)>) for Vite 애플리케이션용
|
|
357
|
+
|
|
358
|
+
또한 브라우저와 API 요청을 포함한 다양한 환경에서 어떤 국제화 솔루션과도 원활하게 작동합니다. 미들웨어를 통해 헤더나 쿠키로 로케일을 감지하도록 커스터마이즈할 수 있습니다:
|
|
359
|
+
|
|
360
|
+
```typescript fileName="intlayer.config.ts" codeFormat="typescript"
|
|
361
|
+
import { Locales, type IntlayerConfig } from "intlayer";
|
|
362
|
+
|
|
363
|
+
const config: IntlayerConfig = {
|
|
364
|
+
// ... 기타 구성 옵션
|
|
365
|
+
middleware: {
|
|
366
|
+
headerName: "my-locale-header",
|
|
367
|
+
cookieName: "my-locale-cookie",
|
|
368
|
+
},
|
|
369
|
+
};
|
|
370
|
+
|
|
371
|
+
export default config;
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
```javascript fileName="intlayer.config.mjs" codeFormat="esm"
|
|
375
|
+
import { Locales } from "intlayer";
|
|
376
|
+
|
|
377
|
+
/** @type {import('intlayer').IntlayerConfig} */
|
|
378
|
+
const config = {
|
|
379
|
+
// ... 기타 구성 옵션
|
|
380
|
+
middleware: {
|
|
381
|
+
headerName: "my-locale-header",
|
|
382
|
+
cookieName: "my-locale-cookie",
|
|
383
|
+
},
|
|
384
|
+
};
|
|
385
|
+
|
|
386
|
+
export default config;
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
```javascript fileName="intlayer.config.mjs" codeFormat="esm"
|
|
390
|
+
import { Locales } from "intlayer";
|
|
391
|
+
|
|
392
|
+
/** @type {import('intlayer').IntlayerConfig} */
|
|
393
|
+
const config = {
|
|
394
|
+
// ... 기타 구성 옵션
|
|
395
|
+
middleware: {
|
|
396
|
+
headerName: "my-locale-header",
|
|
397
|
+
cookieName: "my-locale-cookie",
|
|
398
|
+
},
|
|
399
|
+
};
|
|
400
|
+
|
|
401
|
+
export default config;
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
|
|
405
|
+
const { Locales } = require("intlayer");
|
|
406
|
+
|
|
407
|
+
/** @type {import('intlayer').IntlayerConfig} */
|
|
408
|
+
const config = {
|
|
409
|
+
// ... 기타 구성 옵션
|
|
410
|
+
middleware: {
|
|
411
|
+
headerName: "my-locale-header",
|
|
412
|
+
cookieName: "my-locale-cookie",
|
|
413
|
+
},
|
|
414
|
+
};
|
|
415
|
+
|
|
416
|
+
module.exports = config;
|
|
417
|
+
```
|
|
418
|
+
|
|
419
|
+
기본적으로 `fastify-intlayer`는 클라이언트의 선호 언어를 결정하기 위해 `Accept-Language` 헤더를 해석합니다.
|
|
420
|
+
|
|
421
|
+
> 구성 및 고급 주제에 대한 자세한 내용은 [문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
|
|
422
|
+
|
|
423
|
+
### TypeScript 구성
|
|
424
|
+
|
|
425
|
+
`fastify-intlayer`는 국제화 프로세스를 향상시키기 위해 TypeScript의 강력한 기능을 활용합니다. TypeScript의 정적 타이핑은 모든 번역 키가 타입으로 관리되도록 보장하여 누락된 번역의 위험을 줄이고 유지보수성을 향상시킵니다.
|
|
426
|
+
|
|
427
|
+
자동 생성된 타입(기본 경로: ./types/intlayer.d.ts)이 tsconfig.json 파일에 포함되어 있는지 확인하세요.
|
|
428
|
+
|
|
429
|
+
```json5 fileName="tsconfig.json"
|
|
430
|
+
{
|
|
431
|
+
// ... 기존 TypeScript 구성
|
|
432
|
+
"include": [
|
|
433
|
+
// ... 기존 TypeScript 구성
|
|
434
|
+
".intlayer/**/*.ts", // 자동 생성된 타입 포함
|
|
435
|
+
],
|
|
436
|
+
}
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
### VS Code 확장
|
|
440
|
+
|
|
441
|
+
Intlayer 개발 경험을 향상시키려면 공식 **Intlayer VS Code Extension**을 설치할 수 있습니다.
|
|
442
|
+
|
|
443
|
+
[VS Code Marketplace에서 설치](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
|
|
444
|
+
|
|
445
|
+
이 확장 기능은 다음을 제공합니다:
|
|
446
|
+
|
|
447
|
+
- **번역 키에 대한 자동 완성**
|
|
448
|
+
- **누락된 번역에 대한 실시간 오류 감지**
|
|
449
|
+
- **번역된 콘텐츠의 인라인 미리보기**
|
|
450
|
+
- **번역을 손쉽게 생성하고 업데이트할 수 있는 빠른 작업(Quick actions)**
|
|
451
|
+
|
|
452
|
+
확장 기능 사용 방법에 대한 자세한 내용은 [Intlayer VS Code Extension 문서](https://intlayer.org/doc/vs-code-extension)를 참조하세요.
|
|
453
|
+
|
|
454
|
+
### Git 설정
|
|
455
|
+
|
|
456
|
+
Intlayer에서 생성된 파일은 무시(ignored)하는 것을 권장합니다. 이렇게 하면 해당 파일들이 Git 리포지토리에 커밋되는 것을 방지할 수 있습니다.
|
|
457
|
+
|
|
458
|
+
이를 위해 다음 지침을 `.gitignore` 파일에 추가할 수 있습니다:
|
|
459
|
+
|
|
460
|
+
```plaintext fileName=".gitignore"
|
|
461
|
+
# Intlayer에서 생성된 파일 무시
|
|
462
|
+
.intlayer
|
|
463
|
+
```
|
package/docs/ko/readme.md
CHANGED
|
@@ -50,7 +50,7 @@ Intlayer는 웹 및 모바일 앱을 위한 **최신 i18n 솔루션**입니다.
|
|
|
50
50
|
| 기능 | 설명 |
|
|
51
51
|
| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
52
52
|
| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="기능" width="700"> | **크로스 프레임워크 지원**<br><br>Intlayer는 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 등 주요 프레임워크와 라이브러리를 모두 지원합니다. |
|
|
53
|
-
| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.
|
|
53
|
+
| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700"> | **JavaScript 기반 콘텐츠 관리**<br><br>JavaScript의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리하세요. <br><br> - [콘텐츠 선언](https://intlayer.org/doc/concept/content) |
|
|
54
54
|
| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **로케일별 콘텐츠 선언 파일**<br><br>자동 생성 전에 콘텐츠를 한 번 선언하여 개발 속도를 높이세요.<br><br> - [로케일별 콘텐츠 선언 파일](https://intlayer.org/doc/concept/per-locale-file) |
|
|
55
55
|
| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700"> | **타입 안전 환경**<br><br>TypeScript를 활용하여 콘텐츠 정의와 코드가 오류 없이 작성되도록 보장하고, IDE 자동 완성 기능의 이점도 누리세요.<br><br> - [TypeScript 설정](https://intlayer.org/doc/environment/vite-and-react#configure-typescript) |
|
|
56
56
|
| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="기능" width="700"> | **간편한 설정**<br><br>최소한의 구성으로 빠르게 시작하세요. 국제화, 라우팅, AI, 빌드 및 콘텐츠 처리 설정을 손쉽게 조정할 수 있습니다. <br><br> - [Next.js 통합 탐색](https://intlayer.org/doc/environment/nextjs) |
|
package/docs/pl/cli/push.md
CHANGED
|
@@ -23,7 +23,7 @@ slugs:
|
|
|
23
23
|
npx intlayer dictionary push
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
Jeśli [edytor intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) jest zainstalowany, możesz również wysyłać słowniki do edytora. To polecenie pozwoli udostępnić słowniki w [edytorze](https://intlayer.org/
|
|
26
|
+
Jeśli [edytor intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) jest zainstalowany, możesz również wysyłać słowniki do edytora. To polecenie pozwoli udostępnić słowniki w [edytorze](https://app.intlayer.org/). W ten sposób możesz dzielić się swoimi słownikami z zespołem i edytować treści bez konieczności modyfikowania kodu aplikacji.
|
|
27
27
|
|
|
28
28
|
## Alias:
|
|
29
29
|
|
package/docs/pl/configuration.md
CHANGED
|
@@ -268,14 +268,14 @@ Definiuje ustawienia związane z zintegrowanym edytorem, w tym port serwera i st
|
|
|
268
268
|
- **clientId**:
|
|
269
269
|
- _Typ_: `string` | `undefined`
|
|
270
270
|
- _Domyślnie_: `undefined`
|
|
271
|
-
- _Opis_: clientId i clientSecret pozwalają pakietom intlayer na uwierzytelnianie się z backendem za pomocą uwierzytelniania oAuth2. Token dostępu jest używany do uwierzytelniania użytkownika związanego z projektem. Aby uzyskać token dostępu, przejdź do https://intlayer.org/
|
|
271
|
+
- _Opis_: clientId i clientSecret pozwalają pakietom intlayer na uwierzytelnianie się z backendem za pomocą uwierzytelniania oAuth2. Token dostępu jest używany do uwierzytelniania użytkownika związanego z projektem. Aby uzyskać token dostępu, przejdź do https://app.intlayer.org/project i załóż konto.
|
|
272
272
|
- _Przykład_: `true`
|
|
273
273
|
- _Uwaga_: Ważne: clientId i clientSecret powinny być przechowywane w tajemnicy i nie udostępniane publicznie. Upewnij się, że są przechowywane w bezpiecznym miejscu, na przykład w zmiennych środowiskowych.
|
|
274
274
|
|
|
275
275
|
- **clientSecret**:
|
|
276
276
|
- _Typ_: `string` | `undefined`
|
|
277
277
|
- _Domyślnie_: `undefined`
|
|
278
|
-
- _Opis_: clientId i clientSecret pozwalają pakietom intlayer na uwierzytelnianie się z backendem za pomocą uwierzytelniania oAuth2. Token dostępu jest używany do uwierzytelniania użytkownika związanego z projektem. Aby uzyskać token dostępu, przejdź do https://intlayer.org/
|
|
278
|
+
- _Opis_: clientId i clientSecret pozwalają pakietom intlayer na uwierzytelnianie się z backendem za pomocą uwierzytelniania oAuth2. Token dostępu jest używany do uwierzytelniania użytkownika związanego z projektem. Aby uzyskać token dostępu, przejdź do https://app.intlayer.org/project i załóż konto.
|
|
279
279
|
- _Przykład_: `true`
|
|
280
280
|
- _Uwaga_: Ważne: clientId i clientSecret powinny być przechowywane w tajemnicy i nie udostępniane publicznie. Upewnij się, że są przechowywane w bezpiecznym miejscu, na przykład w zmiennych środowiskowych.
|
|
281
281
|
|
|
@@ -607,7 +607,7 @@ Ustawienia kontrolujące logger, w tym prefiks do użycia.
|
|
|
607
607
|
|
|
608
608
|
Ustawienia kontrolujące funkcje AI w Intlayer, w tym dostawcę, model i klucz API.
|
|
609
609
|
|
|
610
|
-
Ta konfiguracja jest opcjonalna, jeśli jesteś zarejestrowany na [Intlayer Dashboard](https://intlayer.org/
|
|
610
|
+
Ta konfiguracja jest opcjonalna, jeśli jesteś zarejestrowany na [Intlayer Dashboard](https://app.intlayer.org/project) i korzystasz z klucza dostępu. Intlayer automatycznie zarządza najbardziej efektywnym i opłacalnym rozwiązaniem AI dla Twoich potrzeb. Korzystanie z domyślnych opcji zapewnia lepszą długoterminową utrzymalność, ponieważ Intlayer stale aktualizuje się, aby korzystać z najbardziej odpowiednich modeli.
|
|
611
611
|
|
|
612
612
|
Jeśli wolisz używać własnego klucza API lub konkretnego modelu, możesz zdefiniować własną konfigurację AI.
|
|
613
613
|
Ta konfiguracja AI będzie używana globalnie w całym środowisku Intlayer. Polecenia CLI będą korzystać z tych ustawień jako domyślnych dla poleceń (np. `fill`), a także SDK, Visual Editor i CMS. Możesz nadpisać te domyślne wartości dla konkretnych przypadków użycia, korzystając z parametrów poleceń.
|
|
@@ -228,7 +228,7 @@ To podejście pozwala na:
|
|
|
228
228
|
| Funkcja | Opis |
|
|
229
229
|
| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
230
230
|
|  | **Wsparcie dla wielu frameworków**<br><br>Intlayer jest kompatybilny ze wszystkimi głównymi frameworkami i bibliotekami, w tym Next.js, React, Vite, Vue.js, Nuxt, Preact, Express i wieloma innymi. |
|
|
231
|
-
|  | **Zarządzanie treścią oparte na JavaScript**<br><br>Wykorzystaj elastyczność JavaScript do efektywnego definiowania i zarządzania swoją treścią. <br><br> - [Deklaracja treści](https://intlayer.org/doc/concept/content) |
|
|
232
232
|
|  | **Plik Deklaracji Treści dla Każdego Języka**<br><br>Przyspiesz swój rozwój, deklarując treść tylko raz, przed automatycznym generowaniem.<br><br> - [Plik Deklaracji Treści dla Każdego Języka](https://intlayer.org/doc/concept/per-locale-file) |
|
|
233
233
|
|  | **Środowisko z Bezpieczeństwem Typów**<br><br>Wykorzystaj TypeScript, aby zapewnić, że definicje treści i kod są wolne od błędów, jednocześnie korzystając z autouzupełniania w IDE.<br><br> - [Konfiguracja TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript) |
|
|
234
234
|
|  | **Uproszczona konfiguracja**<br><br>Rozpocznij pracę szybko przy minimalnej konfiguracji. Łatwo dostosuj ustawienia dotyczące internacjonalizacji, routingu, AI, budowania i obsługi treści. <br><br> - [Poznaj integrację z Next.js](https://intlayer.org/doc/environment/nextjs) |
|
package/docs/pl/intlayer_CMS.md
CHANGED
|
@@ -98,7 +98,7 @@ const config: IntlayerConfig = {
|
|
|
98
98
|
*
|
|
99
99
|
* Client ID oraz client secret są wymagane do włączenia edytora.
|
|
100
100
|
* Pozwalają one zidentyfikować użytkownika, który edytuje zawartość.
|
|
101
|
-
* Można je uzyskać tworząc nowego klienta w Intlayer Dashboard - Projects (https://intlayer.org/
|
|
101
|
+
* Można je uzyskać tworząc nowego klienta w Intlayer Dashboard - Projects (https://app.intlayer.org/projects).
|
|
102
102
|
* clientId: process.env.INTLAYER_CLIENT_ID,
|
|
103
103
|
* clientSecret: process.env.INTLAYER_CLIENT_SECRET,
|
|
104
104
|
*/
|
|
@@ -148,7 +148,7 @@ const config = {
|
|
|
148
148
|
*
|
|
149
149
|
* Client ID oraz client secret są wymagane do włączenia edytora.
|
|
150
150
|
* Pozwalają one na identyfikację użytkownika edytującego zawartość.
|
|
151
|
-
* Można je uzyskać tworząc nowego klienta w Intlayer Dashboard - Projects (https://intlayer.org/
|
|
151
|
+
* Można je uzyskać tworząc nowego klienta w Intlayer Dashboard - Projects (https://app.intlayer.org/projects).
|
|
152
152
|
* clientId: process.env.INTLAYER_CLIENT_ID,
|
|
153
153
|
* clientSecret: process.env.INTLAYER_CLIENT_SECRET,
|
|
154
154
|
*/
|
|
@@ -198,7 +198,7 @@ const config = {
|
|
|
198
198
|
*
|
|
199
199
|
* Client ID oraz client secret są wymagane do włączenia edytora.
|
|
200
200
|
* Pozwalają one na identyfikację użytkownika, który edytuje zawartość.
|
|
201
|
-
* Można je uzyskać, tworząc nowego klienta w Intlayer Dashboard - Projects (https://intlayer.org/
|
|
201
|
+
* Można je uzyskać, tworząc nowego klienta w Intlayer Dashboard - Projects (https://app.intlayer.org/projects).
|
|
202
202
|
* clientId: process.env.INTLAYER_CLIENT_ID,
|
|
203
203
|
* clientSecret: process.env.INTLAYER_CLIENT_SECRET,
|
|
204
204
|
*/
|
|
@@ -230,7 +230,7 @@ const config = {
|
|
|
230
230
|
module.exports = config;
|
|
231
231
|
```
|
|
232
232
|
|
|
233
|
-
> Jeśli nie masz client ID i client secret, możesz je uzyskać, tworząc nowego klienta w [Intlayer Dashboard - Projects](https://intlayer.org/
|
|
233
|
+
> Jeśli nie masz client ID i client secret, możesz je uzyskać, tworząc nowego klienta w [Intlayer Dashboard - Projects](https://app.intlayer.org/projects).
|
|
234
234
|
|
|
235
235
|
> Aby zobaczyć wszystkie dostępne parametry, zapoznaj się z [dokumentacją konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
|
|
236
236
|
|
|
@@ -270,7 +270,7 @@ To polecenie przesyła Twoje początkowe słowniki treści, udostępniając je d
|
|
|
270
270
|
|
|
271
271
|
### Edytuj słownik
|
|
272
272
|
|
|
273
|
-
Następnie będziesz mógł zobaczyć i zarządzać swoim słownikiem w [Intlayer CMS](https://intlayer.org/
|
|
273
|
+
Następnie będziesz mógł zobaczyć i zarządzać swoim słownikiem w [Intlayer CMS](https://app.intlayer.org/content).
|
|
274
274
|
|
|
275
275
|
## Synchronizacja na żywo
|
|
276
276
|
|