@intlayer/docs 5.5.8

package/ko/dictionary/condition.md

@@ -0,0 +1,213 @@
+# 조건부 콘텐츠 / Intlayer에서의 조건
+
+## 조건 작동 방식
+
+Intlayer에서 조건부 콘텐츠는 특정 조건(일반적으로 boolean 값)을 해당 콘텐츠에 매핑하는 `cond` 함수를 통해 구현됩니다. 이 접근 방식은 주어진 조건에 따라 동적으로 콘텐츠를 선택할 수 있게 합니다. React Intlayer 또는 Next Intlayer와 통합하면 런타임에 제공된 조건에 따라 적절한 콘텐츠가 자동으로 선택됩니다.
+
+## 조건부 콘텐츠 설정
+
+Intlayer 프로젝트에서 조건부 콘텐츠를 설정하려면 조건 정의를 포함하는 콘텐츠 모듈을 생성하십시오. 아래는 다양한 형식의 예제입니다.
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { cond, type Dictionary } from "intlayer";
+
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "조건이 참일 때의 콘텐츠",
+      false: "조건이 거짓일 때의 콘텐츠",
+      fallback: "조건이 실패했을 때의 콘텐츠", // 선택 사항
+    }),
+  },
+} satisfies Dictionary;
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { cond } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "조건이 참일 때의 콘텐츠",
+      false: "조건이 거짓일 때의 콘텐츠",
+      fallback: "조건이 실패했을 때의 콘텐츠", // 선택 사항
+    }),
+  },
+};
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { cond } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "조건이 참일 때의 콘텐츠",
+      false: "조건이 거짓일 때의 콘텐츠",
+      fallback: "조건이 실패했을 때의 콘텐츠", // 선택 사항
+    }),
+  },
+};
+
+module.exports = myConditionalContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myCondition": {
+      "nodeType": "condition",
+      "condition": {
+        "true": "조건이 참일 때의 콘텐츠",
+        "false": "조건이 거짓일 때의 콘텐츠",
+        "fallback": "조건이 실패했을 때의 콘텐츠", // 선택 사항
+      },
+    },
+  },
+}
+```
+
+> fallback이 선언되지 않은 경우, 조건이 유효하지 않을 때 마지막으로 선언된 키가 fallback으로 사용됩니다.
+
+## React Intlayer와 조건부 콘텐츠 사용
+
+React 컴포넌트 내에서 조건부 콘텐츠를 사용하려면 `react-intlayer` 패키지에서 `useIntlayer` 훅을 가져와 사용하십시오. 이 훅은 지정된 키에 대한 콘텐츠를 가져오며, 조건을 전달하여 적절한 출력을 선택할 수 있습니다.
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* 출력: 조건이 참일 때의 콘텐츠 */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 거짓일 때의 콘텐츠 */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* 출력: 조건이 참일 때의 콘텐츠 */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 거짓일 때의 콘텐츠 */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* 출력: 조건이 참일 때의 콘텐츠 */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 거짓일 때의 콘텐츠 */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = ConditionalComponent;
+```
+
+## 추가 리소스
+
+구성 및 사용에 대한 자세한 정보는 다음 리소스를 참조하십시오:
+
+- [Intlayer CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_cli.md)
+- [React Intlayer 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_create_react_app.md)
+- [Next Intlayer 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_nextjs_15.md)
+
+이 리소스는 다양한 환경 및 프레임워크에서 Intlayer의 설정 및 사용에 대한 추가 정보를 제공합니다.

package/ko/dictionary/content_extention_customization.md

@@ -0,0 +1,81 @@
+# 콘텐츠 확장 커스터마이징
+
+## 콘텐츠 파일 확장자
+
+Intlayer는 콘텐츠 선언 파일의 확장자를 커스터마이징할 수 있는 기능을 제공합니다. 이 커스터마이징은 대규모 프로젝트를 관리하는 데 유연성을 제공하며, 다른 모듈과의 충돌을 방지하는 데 도움을 줍니다.
+
+### 기본 확장자
+
+기본적으로 Intlayer는 콘텐츠 선언을 위해 다음 확장자를 가진 모든 파일을 감시합니다:
+
+- `.content.json`
+- `.content.ts`
+- `.content.tsx`
+- `.content.js`
+- `.content.jsx`
+- `.content.mjs`
+- `.content.mjx`
+- `.content.cjs`
+- `.content.cjx`
+
+이 기본 확장자는 대부분의 애플리케이션에 적합합니다. 그러나 특정 요구 사항이 있는 경우, 커스텀 확장자를 정의하여 빌드 프로세스를 간소화하고 다른 구성 요소와의 충돌 위험을 줄일 수 있습니다.
+
+### 콘텐츠 확장자 커스터마이징
+
+Intlayer가 콘텐츠 선언 파일을 식별하는 데 사용하는 파일 확장자를 커스터마이징하려면 Intlayer 설정 파일에서 이를 지정할 수 있습니다. 이 접근 방식은 감시 프로세스의 범위를 제한하여 빌드 성능을 향상시키는 대규모 프로젝트에 유용합니다.
+
+다음은 설정에서 커스텀 콘텐츠 확장자를 정의하는 예제입니다:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  content: {
+    fileExtensions: [".my_content.ts", ".my_content.tsx"], // 커스텀 확장자
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // 커스텀 확장자
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // 커스텀 확장자
+  },
+};
+
+module.exports = config;
+```
+
+이 예제에서 설정은 두 개의 커스텀 확장자 `.my_content.ts`와 `.my_content.tsx`를 지정합니다. Intlayer는 이러한 확장자를 가진 파일만 감시하여 딕셔너리를 빌드합니다.
+
+### 커스텀 확장자의 이점
+
+- **빌드 성능**: 감시 파일의 범위를 줄이면 대규모 프로젝트에서 빌드 성능이 크게 향상됩니다.
+- **충돌 방지**: 커스텀 확장자는 프로젝트 내 다른 JavaScript 또는 TypeScript 파일과의 충돌을 방지합니다.
+- **조직화**: 커스텀 확장자는 프로젝트 요구 사항에 따라 콘텐츠 선언 파일을 조직화할 수 있게 합니다.
+
+### 커스텀 확장자에 대한 가이드라인
+
+콘텐츠 파일 확장자를 커스터마이징할 때 다음 가이드라인을 준수하세요:
+
+- **고유성**: 프로젝트 내에서 고유한 확장자를 선택하여 충돌을 방지하세요.
+- **일관된 명명**: 코드 가독성과 유지 관리를 위해 일관된 명명 규칙을 사용하세요.
+- **일반 확장자 피하기**: `.ts` 또는 `.js`와 같은 일반적인 확장자는 다른 모듈이나 라이브러리와의 충돌을 방지하기 위해 사용하지 마세요.
+
+## 결론
+
+Intlayer에서 콘텐츠 파일 확장자를 커스터마이징하는 것은 대규모 애플리케이션에서 성능을 최적화하고 충돌을 방지하는 데 유용한 기능입니다. 이 문서에서 설명한 가이드를 따르면 콘텐츠 선언을 효과적으로 관리하고 프로젝트의 다른 부분과 원활하게 통합할 수 있습니다.

package/ko/dictionary/enumeration.md

@@ -0,0 +1,221 @@
+# 열거 / 복수화
+
+## 열거 작동 방식
+
+Intlayer에서 열거는 특정 키를 해당 콘텐츠에 매핑하는 `enu` 함수를 통해 이루어집니다. 이러한 키는 숫자 값, 범위 또는 사용자 정의 식별자를 나타낼 수 있습니다. React Intlayer 또는 Next Intlayer와 함께 사용하면 애플리케이션의 로케일과 정의된 규칙에 따라 적절한 콘텐츠가 자동으로 선택됩니다.
+
+## 열거 설정
+
+Intlayer 프로젝트에서 열거를 설정하려면 열거 정의를 포함하는 콘텐츠 모듈을 생성해야 합니다. 다음은 자동차 수에 대한 간단한 열거 예제입니다:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { enu, type Dictionary } from "intlayer";
+
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "마이너스 한 대 미만의 자동차",
+      "-1": "마이너스 한 대의 자동차",
+      "0": "자동차 없음",
+      "1": "한 대의 자동차",
+      ">5": "몇 대의 자동차",
+      ">19": "많은 자동차",
+      "fallback": "대체 값", // 선택 사항
+    }),
+  },
+} satisfies Dictionary;
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { enu } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "마이너스 한 대 미만의 자동차",
+      "-1": "마이너스 한 대의 자동차",
+      "0": "자동차 없음",
+      "1": "한 대의 자동차",
+      ">5": "몇 대의 자동차",
+      ">19": "많은 자동차",
+      "fallback": "대체 값", // 선택 사항
+    }),
+  },
+};
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { enu } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "마이너스 한 대 미만의 자동차",
+      "-1": "마이너스 한 대의 자동차",
+      "0": "자동차 없음",
+      "1": "한 대의 자동차",
+      ">5": "몇 대의 자동차",
+      ">19": "많은 자동차",
+      "fallback": "대체 값", // 선택 사항
+    }),
+  },
+};
+
+module.exports = carEnumeration;
+```
+
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "car_count",
+  "content": {
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "마이너스 한 대 미만의 자동차",
+        "-1": "마이너스 한 대의 자동차",
+        "0": "자동차 없음",
+        "1": "한 대의 자동차",
+        ">5": "몇 대의 자동차",
+        ">19": "많은 자동차",
+        "fallback": "대체 값" // 선택 사항
+      }
+    }
+  }
+}
+```
+
+이 예제에서 `enu`는 다양한 조건을 특정 콘텐츠에 매핑합니다. React 컴포넌트에서 사용될 때, Intlayer는 주어진 변수에 따라 적절한 콘텐츠를 자동으로 선택할 수 있습니다.
+
+> Intlayer 열거에서 선언 순서는 중요합니다. 첫 번째로 유효한 선언이 선택됩니다. 여러 조건이 적용되는 경우, 예기치 않은 동작을 방지하기 위해 올바르게 순서를 지정해야 합니다.
+
+> 대체 값이 선언되지 않은 경우, 키가 일치하지 않으면 함수는 `undefined`를 반환합니다.
+
+## React Intlayer와 함께 열거 사용
+
+React 컴포넌트에서 열거를 사용하려면 `react-intlayer` 패키지의 `useIntlayer` 훅을 활용할 수 있습니다. 이 훅은 지정된 ID에 따라 올바른 콘텐츠를 검색합니다. 다음은 사용 예제입니다:
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent: FC = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // 출력: 자동차 없음
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // 출력: 몇 대의 자동차
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // 출력: 많은 자동차
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // 출력: 대체 값
+        }
+      </p>
+    </div>
+  );
+};
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // 출력: 자동차 없음
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // 출력: 몇 대의 자동차
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // 출력: 많은 자동차
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // 출력: 대체 값
+        }
+      </p>
+    </div>
+  );
+};
+
+export default CarComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // 출력: 자동차 없음
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // 출력: 몇 대의 자동차
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // 출력: 많은 자동차
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // 출력: 대체 값
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = CarComponent;
+```
+
+이 예제에서 컴포넌트는 자동차 수에 따라 동적으로 출력을 조정합니다. 지정된 범위에 따라 적절한 콘텐츠가 자동으로 선택됩니다.
+
+## 추가 자료
+
+구성 및 사용에 대한 자세한 정보는 다음 리소스를 참조하세요:
+
+- [Intlayer CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_cli.md)
+- [React Intlayer 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_create_react_app.md)
+- [Next Intlayer 문서](https://github.com/aymericzip/intlayer/blob/main/docs/ko/intlayer_with_nextjs_15.md)
+
+이 리소스는 다양한 환경 및 프레임워크에서 Intlayer를 설정하고 사용하는 방법에 대한 추가 정보를 제공합니다.