파일 유형
-
.MD
-
.MARKDOWN
-
.MDX
가져오기 옵션
-
파일을 가져올 때 파서가 사용할 Markdown 방언을 선택하십시오. 이는 가져오기 및 내보내기 시 자동으로 이스케이프/이스케이프 해제되는 문자에도 영향을 미칩니다.
-
기본 Markdown 구조(제목, 단락, 목록, 기본 강조)만 구문 분석합니다.
-
PHP Markdown Extra / Python-Markdown "Extra" 방언을 사용하여 구문 분석하며, 표, 정의 목록, 각주, 약어 및 속성 목록에 대한 지원을 추가합니다.
-
GitHub Flavored Markdown(GFM) 사양을 사용하여 구문 분석하며, 표, 작업 목록, 취소선 및 자동 링크에 대한 지원을 추가합니다.
-
파일을 MDX로 구문 분석합니다: Markdown에 JSX 컴포넌트, JSX 표현식(
{...}), ESMimport/export문을 더한 형식입니다. 표, 작업 목록, 취소선, 자동 링크는 GitHub Flavored Markdown과 동일하게 작동합니다. MDX는 들여쓰기를 사용하여 컴포넌트를 중첩하고 해당 구문을 구문 분석하지 않으므로, 들여쓰기된 코드 블록과 꺾쇠괄호 자동 링크(<url>)는 지원되지 않습니다.MDX는 JSX로 확장된 Markdown이므로 콘텐츠에 컴포넌트와 JavaScript 표현식을 포함할 수 있습니다(예: Docusaurus 또는 Next.js로 빌드된 문서). MDX 필터는 자동으로 선택되지 않습니다. .MDX 파일과 MDX 구문이 포함된 .MD 파일 모두에 대해 파일 가져오기 설정에서 선택해야 합니다. 파일 확장자나 콘텐츠를 기준으로 자동 감지하지 않습니다.
참고
조직에 MDX 지원이 활성화되어 있어야 합니다. 목록에서 MDX를 사용할 수 없는 경우, 고객 성공 관리자(Customer Success Manager) 또는 Phrase 지원팀에 문의하십시오.
중요 사항
기존 프로젝트의 Markdown 필터를 MDX로 전환하면 콘텐츠가 분할되는 방식이 변경됩니다. 전환 후 번역 메모리 활용도가 한 차례 감소할 것으로 예상됩니다.
-
-
각 하드 줄 바꿈에서 새 세그먼트를 시작합니다.
-
대상 문서에서 동일한 공백 구조(예: 간격, 줄 바꿈 등)를 유지합니다.
-
파일 상단의 YAML 프런트 매터를 처리합니다. 선택 시 .YAML 가져오기 설정이 적용됩니다.
-
번역을 위해 코드 블록의 내용을 추출합니다. MDX 필터를 사용하면 이는 JSX 컴포넌트 내부에 중첩된 펜스 코드 블록에도 적용됩니다(예:
<CodeGroup>내부). -
이 옵션을 선택하면 코드 요소를 단일 Phrase TMS 태그로 가져옵니다.
-
URL을 번역할 수 있도록 설정합니다.
-
지정된 텍스트를 태그로 변환하려면 정규식을 적용하십시오.
-
태그로 변환할 파일 내 요소를 정의합니다.
-
가져오지 않아야 할 파일 내 섹션을 정의합니다.
예:
-
완성된 파일에서 이스케이프 처리되지 않아야 하는 문자 목록(예:
#,-,[,<,\,`,.MDX 필터를 사용하면
<와{모두 번역된 텍스트에서 기본적으로 이스케이프 처리됩니다. 이스케이프 처리되지 않은<또는{가 번역문에 포함되면 MDX 구문이 손상되기 때문입니다. 출력에 이스케이프 처리되지 않은 원본 문자가 특별히 필요한 경우에만 여기에 추가하십시오.
MDX 관련 옵션
다음 네 가지 옵션은 에서 MDX가 선택된 경우에만 사용할 수 있습니다.
-
HTML 필터의 설정과 동일한
태그/속성형식을 사용하여 번역할 추가 JSX 태그/속성 쌍을 정의합니다. 예를 들어,Figure/title는Figure구성 요소의title속성만 번역하는 반면,title(범위 지정되지 않음)은 모든 태그의 title 속성을 번역합니다.사용자 지정 구성 요소(
<Figure>와 같이 대문자로 시작하는 태그 이름)는 기본적으로 번역 가능한 속성이 없으므로 여기에 명시적으로 나열하십시오. 소문자/HTML 스타일 태그(<img>,<a>등)에는 이미 표준 속성 기본값이 있습니다. -
기본적으로 활성화되어 있습니다.
에 나열된 항목 외에도 소문자/HTML 스타일 태그에 표준 HTML 번역 가능 속성 기본값(예:
<img>의alt,<a>의title)을 적용합니다. 사용자 지정 구성 요소는 이 설정과 관계없이 이러한 기본값을 받지 않습니다. 해당 속성은 에 추가된 경우에만 번역할 수 있습니다.비활성화된 경우 소문자 태그에서도 에 나열된 속성만 번역할 수 있습니다.
-
기본적으로 활성화되어 있습니다.
JSX 구성 요소 내부의 텍스트를 기본적으로 번역할 수 있는지 여부를 설정합니다.
-
활성화된 경우: 에 나열된 컴포넌트를 제외하고, 모든 컴포넌트(예:
<Tabs>,<Note>) 내부의 텍스트를 번역할 수 있습니다. -
비활성화된 경우: 에 나열된 컴포넌트를 제외하고, 컴포넌트 내부의 텍스트는 번역할 수 없습니다.
-
-
설정과 반대로 처리할 컴포넌트 이름을 쉼표로 구분한 목록입니다.
여기에 나열된 구성 요소는 전체적으로 전환됩니다. 즉, 내부에 중첩된 모든 구성 요소를 포함한 전체 콘텐츠가 재정의를 따르며 개별적으로 평가되지 않습니다. 재정의를 통해 구성 요소를 번역할 수 없게 설정하면 해당 콘텐츠는 작성된 그대로 보존됩니다. 이 목록을 사용하여 다음을 수행하십시오:
-
가 활성화된 경우 몇 가지 비산문 구성 요소(예:
CodeGroup,Mermaid)를 제외하거나, -
해당 설정이 비활성화된 경우 산문이 포함된 구성 요소 몇 가지를 허용 목록에 추가하십시오.
-
JSX 콘텐츠가 처리되는 방식
이는 에서 MDX가 선택된 경우에 적용됩니다.
-
JSX 태그(
<Component>,<Component attr="value" />)와 태그 및 속성 이름은 절대 번역할 수 없습니다. 요소 콘텐츠와 명시적으로 설정된 속성 값만 번역할 수 있습니다. -
중괄호(
{...}) 내의 표현식, JavaScript 표현식, 스프레드 속성({...props}) 및 주석({/* comment */})은 절대 번역할 수 없습니다. 이들은 속성이나 텍스트 중간, 또는 별도의 줄 등 어디에 나타나든 작성된 그대로 보존됩니다. -
import및export문은 파일 내 어디에 나타나든 항상 번역에서 제외됩니다.