@intlayer/docs 6.0.2 → 6.1.0

package/docs/ko/packages/lynx-intlayer/index.md

@@ -1,83 +0,0 @@
----
-createdAt: 2025-03-13
-updatedAt: 2025-06-29
-title: 패키지 문서 | lynx-intlayer
-description: lynx-intlayer 패키지 사용 방법 보기
-keywords:
-  - Intlayer
-  - lynx-intlayer
-  - 국제화
-  - 문서
-  - Next.js
-  - JavaScript
-  - React
-slugs:
-  - doc
-  - packages
-  - lynx-intlayer
----
-
-# lynx-intlayer: Lynx 애플리케이션 국제화(i18n)
-
-**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 패키지 모음입니다. React, React, Express.js와 같은 프레임워크와 호환됩니다.
-
-**`lynx-intlayer` 패키지**는 Vite 애플리케이션을 국제화할 수 있게 해줍니다. 이 패키지에는 환경 변수를 통해 설정을 [Lynx 번들러](https://lynxjs.org/index.html)에 전달하는 Metro 플러그인이 포함되어 있습니다.
-
-## 왜 Lynx 애플리케이션을 국제화해야 하나요?
-
-Lynx 애플리케이션을 국제화하는 것은 전 세계 사용자에게 효과적으로 서비스를 제공하기 위해 필수적입니다. 이를 통해 애플리케이션은 각 사용자가 선호하는 언어로 콘텐츠와 메시지를 전달할 수 있습니다. 이러한 기능은 사용자 경험을 향상시키고, 다양한 언어적 배경을 가진 사람들에게 더 접근 가능하고 관련성 높은 애플리케이션으로 만들어 애플리케이션의 범위를 넓힙니다.
-
-## 구성
-
-`lynx-intlayer` 패키지는 [`react-intlayer` 패키지](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/index.md) 및 [`intlayer` 패키지](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/index.md)와 원활하게 작동합니다. 자세한 내용은 관련 문서를 참조하세요.
-
-## 설치
-
-선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
-
-```bash packageManager="npm"
-npm install lynx-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add lynx-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add lynx-intlayer
-```
-
-## 사용 예시
-
-vite 구성에 플러그인을 포함하는 방법의 예시를 확인하세요.
-
-```ts
-// lynx.config.ts
-import { defineConfig } from "@lynx-js/rspeedy";
-import { pluginIntlayerLynx } from "lynx-intlayer/plugin";
-
-export default defineConfig({
-  plugins: [
-    // ... 다른 플러그인들
-    pluginIntlayerLynx(),
-  ],
-});
-```
-
-## Vite 애플리케이션의 국제화 마스터하기
-
-Intlayer는 Vite 애플리케이션을 국제화하는 데 도움이 되는 다양한 기능을 제공합니다.
-
-**이 기능들에 대해 더 알아보려면 Lynx 애플리케이션용 [Intlayer와 Lynx를 이용한 React 국제화(i18n)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_lynx+react.md) 가이드를 참고하세요.**
-
-## Intlayer에 대해 알아보기
-
-- [Intlayer 웹사이트](https://intlayer.org)
-- [Intlayer 문서](https://intlayer.org/doc)
-- [Intlayer GitHub](https://github.com/aymericzip/intlayer)
-
-- [스마트 문서에 질문하기](https://intlayer.org/doc/chat)
-
-## 문서 이력
-
-- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/next-intlayer/index.md

@@ -1,286 +0,0 @@
----
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: 패키지 문서 | next-intlayer
-description: next-intlayer 패키지 사용 방법 보기
-keywords:
-  - Intlayer
-  - next-intlayer
-  - 국제화
-  - 문서
-  - Next.js
-  - JavaScript
-  - React
-slugs:
-  - doc
-  - packages
-  - next-intlayer
----
-
-# next-intlayer: Next.js 애플리케이션 국제화(i18n)를 위한 NPM 패키지
-
-**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 패키지 모음입니다. React, Next.js, Express.js와 같은 프레임워크와 호환됩니다.
-
-**`next-intlayer` 패키지**는 Next.js 애플리케이션을 국제화할 수 있게 해줍니다. Next.js 국제화를 위한 컨텍스트 제공자와 훅을 제공합니다. 또한 Intlayer를 [Webpack](https://webpack.js.org/) 또는 [Turbopack](https://nextjs.org/docs/app/api-reference/turbopack)과 통합하기 위한 Next.js 플러그인과, 사용자의 선호 로케일을 감지하고 쿠키를 관리하며 URL 리디렉션을 처리하는 미들웨어도 포함하고 있습니다.
-
-## 왜 Next.js 애플리케이션을 국제화해야 할까요?
-
-Next.js 애플리케이션을 국제화하는 것은 전 세계 사용자에게 효과적으로 서비스를 제공하기 위해 필수적입니다. 이를 통해 애플리케이션은 각 사용자가 선호하는 언어로 콘텐츠와 메시지를 전달할 수 있습니다. 이러한 기능은 사용자 경험을 향상시키고, 다양한 언어적 배경을 가진 사람들에게 더 접근 가능하고 관련성 높은 애플리케이션으로 만들어 애플리케이션의 도달 범위를 넓혀줍니다.
-
-## Intlayer를 통합해야 하는 이유
-
-- **JavaScript 기반 콘텐츠 관리**: JavaScript의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리할 수 있습니다.
-- **타입 안전 환경**: TypeScript를 활용하여 모든 콘텐츠 정의가 정확하고 오류가 없도록 보장합니다.
-- **통합된 콘텐츠 파일**: 번역을 해당 컴포넌트와 가까이 유지하여 유지보수성과 명확성을 향상시킵니다.
-
-## 설치
-
-선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
-
-```bash packageManager="npm"
-npm install next-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add next-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add next-intlayer
-```
-
-## 사용 예시
-
-Intlayer를 사용하면 코드베이스 어디에서나 구조화된 방식으로 콘텐츠를 선언할 수 있습니다.
-
-기본적으로 Intlayer는 확장자가 `.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}`인 파일을 스캔합니다.
-
-> 기본 확장자는 [설정 파일](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 `contentDir` 속성을 설정하여 변경할 수 있습니다.
-
-```bash codeFormat="typescript"
-.
-├── intlayer.config.ts
-└── src
-    └── components
-        ├── ClientComponent
-        │   ├── index.content.ts
-        │   └── index.tsx
-        └── ServerComponent
-            ├── index.content.ts
-            └── index.tsx
-```
-
-```bash codeFormat="esm"
-.
-├── intlayer.config.mjs
-└── src
-    └── components
-        ├── ClientComponent
-        │   ├── index.content.mjs
-        │   └── index.mjx
-        └── ServerComponent
-            ├── index.content.mjs
-            └── index.mjx
-```
-
-```bash codeFormat="commonjs"
-.
-├── intlayer.config.cjs
-└── src
-    └── components
-        ├── ClientComponent
-        │   ├── index.content.cjs
-        │   └── index.cjx
-        └── ServerComponent
-            ├── index.content.cjs
-            └── index.cjx
-```
-
-### 콘텐츠 선언하기
-
-`next-intlayer`는 [`intlayer` 패키지](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/index.md)와 함께 작동하도록 만들어졌습니다. `intlayer`는 코드 어디에서나 콘텐츠를 선언할 수 있게 해주는 패키지입니다. 다국어 콘텐츠 선언을 구조화된 사전으로 변환하여 애플리케이션에 원활하게 통합할 수 있습니다.
-
-다음은 콘텐츠 선언의 예시입니다:
-
-```tsx fileName="src/ClientComponent/index.content.ts" codeFormat="typescript"
-import { t, type Dictionary } from "intlayer";
-
-const clientComponentContent = {
-  key: "client-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-    numberOfCar: enu({
-      "<-1": "Less than minus one car",
-      "-1": "자동차 마이너스 1대",
-      "0": "자동차 없음",
-      "1": "자동차 1대",
-      ">5": "몇 대의 자동차",
-      ">19": "많은 자동차",
-    }),
-  },
-} satisfies Dictionary;
-
-export default clientComponentContent;
-```
-
-```jsx fileName="src/ClientComponent/index.content.mjs" contentDeclarationFormat="esm"
-import { t } from "intlayer";
-
-/** @type {import('intlayer').Dictionary} */
-const clientComponentContent = {
-  key: "client-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-    numberOfCar: enu({
-      "<-1": "자동차 마이너스 1대 미만",
-      "-1": "자동차 마이너스 1대",
-      "0": "자동차 없음",
-      "1": "자동차 1대",
-      ">5": "몇 대의 자동차",
-      ">19": "많은 자동차",
-    }),
-  },
-};
-
-export default clientComponentContent;
-```
-
-```jsx fileName="src/ClientComponent/index.content.cjs" contentDeclarationFormat="commonjs"
-const { t } = require("intlayer");
-
-/** @type {import('intlayer').Dictionary} */
-// 클라이언트 컴포넌트 콘텐츠 정의
-const clientComponentContent = {
-  key: "client-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-    numberOfCar: enu({
-      "<-1": "Less than minus one car", // -1보다 작은 자동차 수
-      "-1": "Minus one car", // 마이너스 1대 자동차
-      "0": "No cars", // 자동차 없음
-      "1": "One car", // 자동차 1대
-      ">5": "Some cars", // 몇 대의 자동차
-      ">19": "Many cars", // 많은 자동차
-    }),
-  },
-};
-
-module.exports = clientComponentContent;
-```
-
-```json fileName="src/ClientComponent/index.content.json" codeFormat="json"
-{
-  "key": "client-component",
-  "content": {
-    "myTranslatedContent": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Hello World",
-        "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
-      }
-    },
-    "numberOfCar": {
-      "nodeType": "enumeration",
-      "enumeration": {
-        "<-1": "마이너스 1대 미만의 자동차",
-        "-1": "마이너스 1대의 자동차",
-        "0": "자동차 없음",
-        "1": "자동차 1대",
-        ">5": "몇 대의 자동차",
-        ">19": "많은 자동차"
-      }
-    }
-  }
-}
-```
-
-### 코드에서 콘텐츠 활용하기
-
-콘텐츠를 선언한 후에는 코드에서 이를 사용할 수 있습니다. 다음은 React 컴포넌트에서 콘텐츠를 사용하는 예시입니다:
-
-```tsx {4,7} fileName="src/components/ClientComponentExample.tsx" codeFormat="typescript"
-"use client";
-
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-export const ClientComponentExample: FC = () => {
-  const { myTranslatedContent } = useIntlayer("client-component"); // 관련 콘텐츠 선언 생성
-
-  return (
-    <div>
-      <p>{myTranslatedContent}</p>
-    </div>
-  );
-};
-```
-
-```jsx {3,6} fileName="src/components/ClientComponentExample.mjx" codeFormat="esm"
-"use client";
-
-import { useIntlayer } from "next-intlayer";
-
-const ClientComponentExample = () => {
-  const { myTranslatedContent } = useIntlayer("client-component"); // 관련 콘텐츠 선언 생성
-
-  return (
-    <div>
-      <p>{myTranslatedContent}</p>
-    </div>
-  );
-};
-```
-
-```jsx {3,6} fileName="src/components/ClientComponentExample.csx" codeFormat="commonjs"
-"use client";
-
-const { useIntlayer } = require("next-intlayer");
-
-const ClientComponentExample = () => {
-  const { myTranslatedContent } = useIntlayer("client-component"); // 관련 콘텐츠 선언 생성
-
-  return (
-    <div>
-      <p>{myTranslatedContent}</p>
-    </div>
-  );
-};
-```
-
-## Next.js 애플리케이션의 국제화 마스터하기
-
-Intlayer는 Next.js 애플리케이션의 국제화를 돕기 위한 다양한 기능을 제공합니다. 주요 기능은 다음과 같습니다:
-
-- **서버 컴포넌트의 국제화**: Intlayer는 클라이언트 컴포넌트와 동일한 방식으로 서버 컴포넌트의 국제화를 지원합니다. 즉, 클라이언트와 서버 컴포넌트 모두에 동일한 콘텐츠 선언을 사용할 수 있습니다.
-- **로케일 감지를 위한 미들웨어**: Intlayer는 사용자의 선호 로케일을 감지하는 미들웨어를 제공합니다. 이 미들웨어는 사용자의 선호 로케일을 감지하고, [설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에 명시된 대로 적절한 URL로 리디렉션하는 데 사용됩니다.
-- **메타데이터의 국제화**: Intlayer는 Next.js에서 제공하는 `generateMetadata` 함수를 사용하여 페이지 제목과 같은 메타데이터를 국제화할 수 있는 방법을 제공합니다. `getTranslation` 함수를 사용하여 메타데이터를 번역할 수 있습니다.
-- **sitemap.xml 및 robots.txt의 국제화**: Intlayer는 sitemap.xml 및 robots.txt 파일을 국제화할 수 있도록 지원합니다. `getMultilingualUrls` 함수를 사용하여 다국어 URL을 생성할 수 있습니다.
-- **URL의 국제화**: Intlayer는 `getMultilingualUrls` 함수를 사용하여 URL을 국제화할 수 있습니다. 이 함수는 sitemap용 다국어 URL을 생성합니다.
-
-**이 기능들에 대해 더 알아보려면 [Next.js 15 App Router와 함께하는 Intlayer의 Next.js 국제화(i18n)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_15.md) 가이드를 참고하세요.**
-
-## `next-intlayer` 패키지에서 제공하는 함수들
-
-`next-intlayer` 패키지는 애플리케이션을 국제화하는 데 도움이 되는 몇 가지 함수도 제공합니다.
-
-- [`t()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/t.md)
-- [`useIntlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/useIntlayer.md)
-- [`useDictionary()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/useDictionary.md)
-- [`useLocale()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/useLocale.md)
-
-## 문서 이력
-
-- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/nuxt-intlayer/index.md

@@ -1,53 +0,0 @@
----
-createdAt: 2025-06-18
-updatedAt: 2025-06-29
-title: 패키지 문서 | nuxt-intlayer
-description: nuxt-intlayer 패키지 사용 방법 보기
-keywords:
-  - Intlayer
-  - nuxt-intlayer
-  - 국제화
-  - 문서
-  - 자바스크립트
-  - Nuxt
-slugs:
-  - doc
-  - packages
-  - nuxt-intlayer
----
-
-# nuxt-intlayer: Vue 애플리케이션을 국제화(i18n)하기 위한 NPM 패키지
-
-**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 패키지 모음입니다. Vue, Vue, Express.js와 같은 프레임워크와 호환됩니다.
-
-**`nuxt-intlayer` 패키지**는 Vue 애플리케이션을 국제화할 수 있도록 해줍니다. Vue 국제화를 위한 컨텍스트 제공자와 훅을 제공합니다.
-
-## Vue 애플리케이션을 국제화해야 하는 이유
-
-Vue 애플리케이션을 국제화하는 것은 전 세계 사용자를 효과적으로 서비스하기 위해 필수적입니다. 이를 통해 각 사용자가 선호하는 언어로 콘텐츠와 메시지를 전달할 수 있습니다. 이러한 기능은 사용자 경험을 향상시키고, 다양한 언어 배경을 가진 사람들에게 더 접근 가능하고 관련성 높은 애플리케이션으로 만들어 애플리케이션의 범위를 넓혀줍니다.
-
-## Intlayer를 통합해야 하는 이유
-
-- **자바스크립트 기반 콘텐츠 관리**: 자바스크립트의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리할 수 있습니다.
-- **타입 안전 환경**: TypeScript를 활용하여 모든 콘텐츠 정의가 정확하고 오류가 없도록 보장합니다.
-- **통합 콘텐츠 파일**: 번역을 해당 컴포넌트와 가깝게 유지하여 유지보수성과 명확성을 향상시킵니다.
-
-## 설치
-
-선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
-
-```bash packageManager="npm"
-npm install nuxt-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add nuxt-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add nuxt-intlayer
-```
-
-## 문서 이력
-
-- 5.5.10 - 2025-06-29: 초기 이력

package/docs/ko/packages/preact-intlayer/index.md

@@ -1,53 +0,0 @@
----
-createdAt: 2025-04-18
-updatedAt: 2025-06-29
-title: 패키지 문서 | preact-intlayer
-description: preact-intlayer 패키지 사용 방법 보기
-keywords:
-  - Intlayer
-  - preact-intlayer
-  - 국제화
-  - 문서
-  - 자바스크립트
-  - Preact
-slugs:
-  - doc
-  - packages
-  - preact-intlayer
----
-
-# preact-intlayer: Preact 애플리케이션을 국제화(i18n)하기 위한 NPM 패키지
-
-**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 패키지 모음입니다. Preact, Preact, Express.js와 같은 프레임워크와 호환됩니다.
-
-**`preact-intlayer` 패키지**는 Preact 애플리케이션을 국제화할 수 있게 해줍니다. 이 패키지는 Preact 국제화를 위한 컨텍스트 프로바이더와 훅을 제공합니다.
-
-## 왜 Preact 애플리케이션을 국제화해야 할까요?
-
-Preact 애플리케이션을 국제화하는 것은 전 세계 사용자에게 효과적으로 서비스를 제공하는 데 필수적입니다. 이를 통해 애플리케이션은 각 사용자가 선호하는 언어로 콘텐츠와 메시지를 전달할 수 있습니다. 이러한 기능은 사용자 경험을 향상시키고, 다양한 언어적 배경을 가진 사람들에게 더 접근 가능하고 관련성 높은 애플리케이션으로 만들어 애플리케이션의 도달 범위를 넓혀줍니다.
-
-## 왜 Intlayer를 통합해야 할까요?
-
-- **자바스크립트 기반 콘텐츠 관리**: 자바스크립트의 유연성을 활용하여 콘텐츠를 효율적으로 정의하고 관리할 수 있습니다.
-- **타입 안전 환경**: TypeScript를 활용하여 모든 콘텐츠 정의가 정확하고 오류가 없도록 보장합니다.
-- **통합 콘텐츠 파일**: 번역을 해당 컴포넌트와 가깝게 유지하여 유지보수성과 명확성을 향상시킵니다.
-
-## 설치
-
-선호하는 패키지 관리자를 사용하여 필요한 패키지를 설치하세요:
-
-```bash packageManager="npm"
-npm install preact-intlayer
-```
-
-```bash packageManager="yarn"
-yarn add preact-intlayer
-```
-
-```bash packageManager="pnpm"
-pnpm add preact-intlayer
-```
-
-## 문서 이력
-
-- 5.5.10 - 2025-06-29: 초기 이력