Skip to content

Commit e645c5c

Browse files
[add] Korean (ko) documentation translation
- translate all 80 docs articles to Korean into i18n/ko current - preserve @getshort macros, code, links, slugs and heading anchors - add explicit Korean admonition titles (참고/팁/정보/경고/주의/중요) - use formal 합니다체 register; copy assets; write .sync marker - ko build is clean: 0 broken links, macros expand, lang=ko
1 parent 21f2c66 commit e645c5c

90 files changed

Lines changed: 6604 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
21f2c66be0e44a306e591e01e3b4872dea7bd81e
Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
---
2+
sidebar_label: defaultStyles
3+
title: defaultStyles 설정
4+
description: DHTMLX JavaScript RichText 라이브러리 문서에서 defaultStyles 설정에 대해 알아볼 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험하며, DHTMLX RichText 무료 30일 평가판을 다운로드하세요.
5+
---
6+
7+
# defaultStyles
8+
9+
### 설명 {#description}
10+
11+
@short: 선택 사항입니다. 특정 블록 유형에 대한 기본 스타일 값을 지정합니다.
12+
13+
### 사용법 {#usage}
14+
15+
~~~jsx {}
16+
defaultStyles?: {
17+
"*"?: { // 모든 블록에 적용되며, 모든 블록에 공통 속성을 설정할 수 있습니다
18+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
19+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
20+
color?: string;
21+
background?: string;
22+
},
23+
p?: {
24+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
25+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
26+
color?: string;
27+
background?: string;
28+
},
29+
blockquote?: {
30+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
31+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
32+
color?: string;
33+
background?: string;
34+
},
35+
h1?: {
36+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
37+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
38+
color?: string;
39+
background?: string;
40+
},
41+
h2?: {
42+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
43+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
44+
color?: string;
45+
background?: string;
46+
},
47+
h3?: {
48+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
49+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
50+
color?: string;
51+
background?: string;
52+
},
53+
h4?: {
54+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
55+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
56+
color?: string;
57+
background?: string;
58+
},
59+
h5?: {
60+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
61+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
62+
color?: string;
63+
background?: string;
64+
},
65+
h6?: {
66+
"font-family"?: string; // "Roboto"| "Arial" | "Georgia" | "Tahoma" | "Times New Roman" | "Verdana"
67+
"font-size"?: string; // "12px" | "14px" | "16px" | "18px" | "20px" | "24px" | "28px" | "32px" | "36px"
68+
color?: string;
69+
background?: string;
70+
}
71+
};
72+
~~~
73+
74+
:::important[중요]
75+
`defaultStyles` 속성은 영향을 받는 블록에 실제 CSS를 적용하지 않습니다. CSS 스타일은 별도로 적용해야 합니다.
76+
77+
```jsx title="index.js"
78+
new richtext.Richtext("#root", {
79+
defaultStyles: {
80+
h2: {
81+
"font-family": "Roboto",
82+
"font-size": "28px",
83+
color: "purple",
84+
background: "#FFC0CB"
85+
}
86+
}
87+
});
88+
```
89+
90+
```css title="index.css"
91+
<style>
92+
#root h2 {
93+
font-family: Roboto;
94+
font-size: 28px;
95+
color: purple;
96+
background: #FFC0CB;
97+
}
98+
</style>
99+
```
100+
101+
이 예제에서는 모든 `h2` 블록에 `"Roboto"` font-family가 지정되며, font-size는 28px로 설정되고 전경색과 배경색도 함께 변경됩니다. CSS 스타일 역시 `h2` 블록에 적용됩니다.
102+
:::
103+
104+
### 기본 설정 {#default-config}
105+
106+
~~~jsx
107+
const defaultStyles = {
108+
"*": { "font-family": "Arial" },
109+
p: { "font-size": "14px" },
110+
blockquote: { "font-size": "14px" },
111+
h1: { "font-size": "32px" },
112+
h2: { "font-size": "24px" },
113+
h3: { "font-size": "18px" },
114+
h4: { "font-size": "16px" },
115+
h5: { "font-size": "14px" },
116+
h6: { "font-size": "12px" }
117+
};
118+
~~~
119+
120+
### 예제 {#example}
121+
122+
~~~jsx {3-13}
123+
// RichText 초기화
124+
new richtext.Richtext("#root", {
125+
defaultStyles: {
126+
h4: {
127+
"font-family": "Roboto"
128+
},
129+
h5: {
130+
"font-family": "Roboto"
131+
},
132+
h6: {
133+
"font-family": "Roboto"
134+
}
135+
},
136+
// 기타 설정 속성
137+
});
138+
~~~
139+
140+
**변경 이력:** 이 속성은 v2.0에서 업데이트되었습니다.
141+
142+
**관련 문서:** [설정](guides/configuration.md)
143+
144+
**관련 샘플:** [RichText. 타이포그래피(글꼴, 글꼴 크기 등)의 기본값 변경](https://snippet.dhtmlx.com/6u3ti01s?tag=richtext)
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
sidebar_label: fullscreenMode
3+
title: fullscreenMode 설정
4+
description: DHTMLX JavaScript RichText 라이브러리 문서에서 fullscreenMode 설정에 대해 알아볼 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 직접 확인하며, DHTMLX RichText의 30일 무료 평가판을 다운로드하세요.
5+
---
6+
7+
# fullscreenMode
8+
9+
### 설명 {#description}
10+
11+
@short: 선택 사항. RichText 전체 화면 모드를 활성화합니다.
12+
13+
### 사용법 {#usage}
14+
15+
~~~jsx {}
16+
fullscreenMode?: boolean;
17+
~~~
18+
19+
### 기본 설정 {#default-config}
20+
21+
~~~jsx
22+
fullscreenMode: false;
23+
~~~
24+
25+
### 예제 {#example}
26+
27+
~~~jsx {3}
28+
// RichText 초기화
29+
new richtext.Richtext("#root", {
30+
fullscreenMode: true
31+
// 기타 구성 속성
32+
});
33+
~~~
34+
35+
**변경 이력:** 이 속성은 v2.0에서 추가되었습니다.
36+
37+
**관련 문서:** [구성](guides/configuration.md)
38+
39+
**관련 샘플:** [RichText. 전체 툴바](https://snippet.dhtmlx.com/ziynafp7?tag=richtext)
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
sidebar_label: imageUploadUrl
3+
title: imageUploadUrl 설정
4+
description: DHTMLX JavaScript RichText 라이브러리 문서에서 imageUploadUrl 설정에 대해 알아볼 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 사용해 보세요. DHTMLX RichText 무료 30일 평가판도 다운로드하실 수 있습니다.
5+
---
6+
7+
# imageUploadUrl
8+
9+
### 설명 {#description}
10+
11+
@short: 선택 사항입니다. 이미지 업로드 시 사용할 URL을 지정합니다 (툴바, 메뉴바, 클립보드 붙여넣기, 드래그 앤 드롭에서 사용됩니다).
12+
13+
이 속성이 설정되면 RichText는 삽입된 각 이미지를 지정된 엔드포인트에 업로드하고, 서버가 반환한 URL을 삽입합니다.
14+
15+
이 속성이 생략되거나 거짓 값(`""`, `null`, `undefined`)으로 설정된 경우, RichText는 **인라인 모드**로 전환됩니다. 이 경우 이미지 파일은 클라이언트에서 읽혀 base64 데이터 URL로 콘텐츠에 직접 임베드되며, 서버가 필요하지 않습니다. 1024×800보다 큰 인라인 이미지는 해당 크기에 맞게 비율을 유지하며 축소됩니다.
16+
17+
:::note[참고]
18+
인라인(base64) 이미지는 내장된 DOCX / PDF [내보내기](api/events/export.md)에서 보존되지 않습니다. 내보내기 기능을 사용하는 경우 `imageUploadUrl`을 설정하여 이미지가 외부 위치를 참조하도록 하십시오.
19+
:::
20+
21+
:::caution[주의]
22+
Base64 인코딩은 원본 파일에 비해 인코딩된 페이로드를 약 3분의 1 정도 증가시킵니다. 여러 개의 큰 인라인 이미지가 포함된 문서는 이에 따라 크기가 커지며, 이는 [`getValue()`](api/methods/get-value.md)가 반환하는 값의 크기, 에디터의 메모리 사용량, 그리고 콘텐츠를 저장하거나 전송하는 비용에 영향을 줍니다. 이미지가 많거나 큰 문서의 경우 서버 `imageUploadUrl`을 사용하는 것을 권장합니다.
23+
:::
24+
25+
### 사용법 {#usage}
26+
27+
~~~jsx {}
28+
imageUploadUrl?: string;
29+
~~~
30+
31+
### 예제 {#example}
32+
33+
서버 엔드포인트에 이미지 업로드:
34+
35+
~~~jsx {3}
36+
// RichText 초기화
37+
new richtext.Richtext("#root", {
38+
imageUploadUrl: "https://example.com/upload"
39+
// 기타 설정 속성
40+
});
41+
~~~
42+
43+
이미지를 base64로 인라인 삽입 (서버 불필요) — 속성을 생략하거나 빈 문자열을 전달합니다:
44+
45+
~~~jsx {2}
46+
new richtext.Richtext("#root", {
47+
// imageUploadUrl이 설정되지 않으면 이미지는 base64 데이터 URL로 삽입됩니다
48+
// 기타 설정 속성
49+
});
50+
~~~
51+
52+
**변경 로그:** 이 속성은 v2.0에서 추가되었습니다. v2.1부터 이 속성은 선택 사항입니다. 생략 시 이미지는 base64 데이터 URL로 인라인 삽입됩니다.
53+
54+
**관련 문서:** [설정](guides/configuration.md), [서버와 함께 사용하기](guides/working_with_server.md)
55+
56+
**관련 샘플:** [RichText. 초기화](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
sidebar_label: layoutMode
3+
title: layoutMode 구성 옵션
4+
description: DHTMLX JavaScript RichText 라이브러리의 layoutMode 구성 옵션에 대해 알아볼 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제 및 라이브 데모를 체험해 보세요. DHTMLX RichText 30일 무료 평가판도 다운로드할 수 있습니다.
5+
---
6+
7+
# layoutMode
8+
9+
### 설명 {#description}
10+
11+
@short: 선택 사항. 메인 편집기 영역의 레이아웃 모드를 지정합니다
12+
13+
### 사용법 {#usage}
14+
15+
~~~jsx {}
16+
layoutMode: "classic" | "document";
17+
~~~
18+
19+
`"classic"` 모드는 전체 편집 영역을 채웁니다. `"document"` 모드는 편집 영역을 문서 페이지 형태로 표시합니다.
20+
21+
### 기본 구성 {#default-config}
22+
23+
~~~jsx
24+
layoutMode: "classic";
25+
~~~
26+
27+
### 예제 {#example}
28+
29+
~~~jsx {3}
30+
// RichText 초기화
31+
new richtext.Richtext("#root", {
32+
layoutMode: "document" // 기본값으로 "document" 모드로 RichText를 초기화합니다
33+
// 기타 구성 속성
34+
});
35+
~~~
36+
37+
**변경 이력:** 이 속성은 제거된 `mode` 속성 대신 v2.0에서 추가되었습니다
38+
39+
**관련 문서:** [구성](guides/configuration.md)
40+
41+
**관련 예제:** [RichText. 초기화](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
sidebar_label: locale
3+
title: locale 설정
4+
description: DHTMLX JavaScript RichText 라이브러리 문서에서 locale 설정에 대해 알아볼 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 체험하며, DHTMLX RichText 무료 30일 평가판을 다운로드하십시오.
5+
---
6+
7+
# locale
8+
9+
### 설명 {#description}
10+
11+
@short: 선택 사항. RichText의 현지화 레이블을 포함하는 객체
12+
13+
:::info[정보]
14+
**locale** 객체에는 RichText의 모든 레이블과 해당 번역이 포함되어야 합니다.
15+
:::
16+
17+
### 사용법 {#usage}
18+
19+
~~~jsx {}
20+
locale?: object;
21+
~~~
22+
23+
### 기본 설정 {#default-config}
24+
25+
기본적으로 RichText는 **영어** 로케일을 사용합니다. 사용자 정의 로케일로 변경할 수도 있습니다.
26+
27+
:::tip[]
28+
현재 로케일을 동적으로 변경하려면 RichText의 [**setLocale()**](api/methods/set-locale.md) 메서드를 사용하십시오.
29+
:::
30+
31+
### 예제 {#example}
32+
33+
~~~jsx {3}
34+
// RichText 초기화
35+
const editor = new richtext.RichText("#root", {
36+
locale: richtext.locales.cn // 중국어 로케일이 초기에 설정됩니다
37+
// locale: richtext.locales.en // 영어 로케일이 초기에 설정됩니다
38+
// locale: richtext.locales.de // 독일어 로케일이 초기에 설정됩니다
39+
// 기타 구성 속성
40+
});
41+
~~~
42+
43+
**변경 로그:** 이 속성은 v2.0에서 추가되었습니다.
44+
45+
**관련 문서:** [현지화](guides/localization.md)
46+
47+
**관련 샘플:** [RichText. 현지화](https://snippet.dhtmlx.com/zxjrin3i?tag=richtext)
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
sidebar_label: menubar
3+
title: menubar 설정
4+
description: DHTMLX JavaScript RichText 라이브러리의 menubar 설정에 대해 알아볼 수 있습니다. 개발자 가이드와 API 레퍼런스를 살펴보고, 코드 예제와 라이브 데모를 직접 체험해 보세요. DHTMLX RichText 30일 무료 평가판을 다운로드하실 수 있습니다.
5+
---
6+
7+
# menubar
8+
9+
### 설명 {#description}
10+
11+
@short: 선택 사항입니다. RichText 상단 메뉴바를 활성화합니다.
12+
13+
### 사용법 {#usage}
14+
15+
~~~jsx {}
16+
menubar?: boolean;
17+
~~~
18+
19+
### 예제 {#example}
20+
21+
~~~jsx {3}
22+
// RichText 초기화
23+
new richtext.Richtext("#root", {
24+
menubar: true
25+
// 기타 구성 속성
26+
});
27+
~~~
28+
29+
**변경 로그:** 이 속성은 v2.0에서 추가되었습니다.
30+
31+
**관련 문서:** [구성](guides/configuration.md)
32+
33+
**관련 샘플:** [RichText. menubar로 초기화](https://snippet.dhtmlx.com/tjryzka7?tag=richtext)

0 commit comments

Comments
 (0)