팁
Phrase Strings에서 Contentful 통합에 대한 정보는 Contentful (Strings)을 참조하십시오.
Contentful은 모든 플랫폼이나 장치에 콘텐츠를 생성, 관리 및 배포할 수 있는 헤드리스 콘텐츠 관리 인프라를 제공합니다. Phrase는 보다 맞춤화된 사용자 경험을 위해 Contentful 마켓플레이스에서 커넥터 기반 통합과 플러그인을 모두 제공합니다.
참고
커넥터는 JSON 객체의 번역을 지원하지 않습니다.
지원되는 지역화 방법
Contentful은 여러 지역화 방법을 지원합니다. 자세한 설명은 Contentful 문서를 참조하십시오.
입문 수준 지역화 (레거시)
Contentful (입문 수준) 커넥터를 사용하십시오.
입문 수준 커넥터는 지역화된 참조 필드가 있는 콘텐츠 유형에서만 작동합니다 (예: 지역화가 활성화된 참조 필드).
필드 수준 지역화 (레거시)
Contentful (필드 수준) 커넥터를 사용하십시오.
필드 수준 커넥터는 번역 가능한 필드가 있는 콘텐츠 유형에서만 작동합니다 (예: 지역화가 활성화된 텍스트 또는 리치 텍스트 필드) 및 미디어 자산. 커넥터가 참조된 항목을 가져오도록 구성된 경우, 중첩된 콘텐츠의 전체 계층을 탐색하고 모든 번역 가능한 필드를 번역을 위해 가져옵니다. 참조 필드가 지역화에 대해 활성화된 경우, 프로젝트의 소스 언어와 일치하는 참조를 가져옵니다.
다음과 같은 여러 사용 사례가 있습니다 커넥터:
-
프로젝트 관리자는 온라인 리포지토리에서 프로젝트에 파일을 직접 추가할 수 있습니다. 콘텐츠는 항목 ID로 검색할 수 있습니다.
-
제출자가 온라인 리포지토리에서 요청에 파일을 직접 추가할 수 있도록 제출자 포털을 설정하십시오. 콘텐츠는 항목 ID로 검색할 수 있습니다.
-
자동화된 프로젝트 생성(APC)을 사용하여 모니터링된 문서나 폴더의 컨텐츠 크기에 변화가 감지될 때 새로운 프로젝트가 자동으로 생성되도록 합니다.
-
선택한 파일은 APC 처음 실행되는 경우에 가져옵니다.
-
애플리케이션의 사용 사례:
-
컨텐츠 편집자는 Contentful 내에서 직접 로컬라이제이션을 위한 가입을 제출할 수 있습니다. 이것은 컨텐츠 편집자나 관리자가 로컬라이제이션 흐름을 완전히 제어하고 가입을 볼 때 실시간으로 상태 업데이트를 받을 수 있게 합니다.
가입이 최종화되면:
-
로컬라이제이션을 위한 원하는 대상 언어를 선택합니다.
-
선택한 언어로만 가입을 Phrase TMS에 제출하거나 필드 선택 탭을 사용하여 필드를 선택합니다.
-
필드가 선택되지 않으면 모든 로컬라이즈 가능한 필드가 번역을 위해 제출됩니다.
-
로컬라이즈할 수 없는 필드가 선택되면 해당 필드는 여전히 번역을 위해 제출되지 않습니다. 오직 로컬라이즈 가능한 필드만 제출됩니다.
-
일부 로컬라이즈 가능한 필드만 선택된 경우, 오직 해당 필드만 번역을 위해 제출됩니다.
-
-
APC 설정에 따라, 제출된 컨텐츠에서 작업이 자동으로 생성됩니다. APC 실행 중에는 제출됨 상태의 가입만 작업 생성에 선택됩니다.
-
제출된 가입에서 작업이 생성되면 상태가 진행 중으로 변경됩니다. 번역이 Contentful로 다시 푸시되면 상태가 완료됨으로 변경됩니다.
-
이전에 번역된 가입은 원본 복사본에 변경이 있을 경우 다시 제출할 수 있습니다.
-
-
컨텐츠 편집자는 Phrase TMS 홈 화면을 사용하여:
-
가입을 대량으로 제출합니다.
-
대량 제출 시 개별 대상 언어를 지정합니다.
-
활성 번역 작업에 대한 개요를 확인합니다.
-
콘텐츠풀 설정
Phrase TMS 애플리케이션 작업 시:
-
마켓플레이스에서 Phrase TMS 애플리케이션을 다운로드합니다.
-
현재 활성 공간에 애플리케이션을 설치하고 애플리케이션이 설치를 요구하는 콘텐츠 모델을 선택합니다.
-
Phrase TMS 내에서 커넥터를 생성할 때 획득한 Phrase TMS 인증 토큰을 입력합니다.
-
설치을 클릭합니다.
선택 사항 - 앱 시작
Contentful의 앱 시작을 통해 워크플로 지원을 사용하는 경우, 다음 단계를 따르십시오:
-
하나 이상의 공간에 Contentful의 Launch 애플리케이션을 설치합니다.
참고
공간당 하나의 워크플로만 생성할 수 있습니다. 하나의 Contentful 공간 내에서 콘텐츠 유형에 대한 다양한 접근 방식이 필요한 경우, 전담 고객 성공 관리자에게 문의하십시오.
-
필요한 지역화 워크플로를 설정합니다.
-
설명된 워크플로를 따르는 콘텐츠 유형 또는 유형을 선택합니다.
커넥터에 워크플로가 설정된 경우, 자동화된 프로젝트 생성(APC)은 모니터링된 기사 또는 콘텐츠 유형의 워크플로 단계에서 변경 사항이 감지될 때 새로운 프로젝트를 자동으로 생성합니다.
제출된 작업은 취소할 수 있으며, 변경 후 콘텐츠를 다시 제출할 수 있습니다. 이 작업은 여전히 Phrase에 존재하며 프로젝트 관리자가 삭제해야 합니다.
중요 사항
사용자 지정 도메인(예: mydomain.phrase.jp
)에서 접근하는 경우, 시크릿 브라우저 창을 열고 cloud.memsource.com
또는 us.cloud.memsource.com
을 통해 로그인하여 커넥터 생성 또는 저장에 필요한 인증을 적용합니다. 저장 후, 커넥터는 사용자 지정 도메인을 통해 접근할 수 있습니다.
-
설정
페이지에서 섹션으로 스크롤하십시오.
-
커넥터을 클릭합니다.
페이지가 열립니다.
-
새 커넥터를 클릭합니다.
페이지가 열립니다.
-
연결의 이름을 제공하고 유형을 Contentful (항목 수준) 또는 Contentful (필드 수준)로 변경하십시오.
-
앱과 함께 커넥터를 사용하는 경우 구문 Contentful 앱 체크박스를 선택하십시오.
-
Contentful 앱 토큰
Phrase TMS Contentful 애플리케이션에 입력할 애플리케이션 토큰을 생성하십시오. 토큰을 생성한 후 커넥터를 저장하고 Contentful 앱에 복사하십시오.
참고
Contentful의 애플리케이션 구성에 토큰이 추가되면 Contentful 내에서 변경할 수 없습니다. 토큰을 변경하려면 커넥터 구성에서 이를 취소하고 Phrase TMS에 대한 새 커넥터를 생성하기 위해 새 토큰을 생성하십시오.
-
-
언어에 구애받지 않는 설정을 구성하십시오.
-
공백 선택
기본 Contentful 공간의 언어를 덮어쓸 소스 언어를 구성할 공간을 선택하십시오.
-
환경 선택
설정된 공간의 환경을 선택하십시오.
-
소스 언어
Contentful 기본 언어를 덮어쓸 소스 언어를 선택하십시오. 커넥터 구성에서 설정된 언어의 콘텐츠를 가져옵니다.
예:
참고
애플리케이션을 사용할 때는 적용되지 않습니다.
-
-
중첩 콘텐츠를 처리하는 방법을 항목 가져오기 모드를 선택하십시오. 콘텐츠는 다른 콘텐츠를 참조하는 참조 필드를 사용할 수 있어 엔터티의 계층 구조를 생성할 수 있습니다.
-
Contentful (항목 수준)
항목 수준 커넥터는 중첩 콘텐츠의 전체 계층 구조를 자동으로 탐색합니다.
-
Contentful (필드 수준)
필드 수준 커넥터가 중첩 콘텐츠를 가져오는 방법을 선택하십시오.
-
-
저장소에서 추가할 때 명시적으로 선택된 콘텐츠가 가져옵니다.
-
APC에 의해 감지된 변경 사항이 번역을 위해 가져옵니다.
-
-
참조된 항목 가져오기
-
커넥터는 중첩된 콘텐츠의 전체 계층을 탐색하고 번역을 위해 모든 번역 가능한 필드를 가져옵니다.
-
-
-
-
번역 가능한 필드 생략에서 필드를 생략하기 위해 쉼표로 구분된 목록을 생성하여 에 대해 체크된 필드를 Phrase TMS로 가져오지 않습니다. 다음 구조를 사용하십시오:
contentTypeID:fieldID
.-
나열된 필드를 비워 두어야 하는 경우 생략된 필드를 비워 두기를 선택하십시오. 이 설정은 나열된 항목에 모두 적용됩니다.
-
나열된 필드에 소스 값을 포함해야 하는 경우 소스를 대상으로 복사를 선택하십시오. 이 설정은 나열된 항목에 모두 적용됩니다.
-
-
소스 언어의 특정 필드에 데이터가 누락된 경우
을 선택하십시오.필요한 경우 드롭다운 목록에서
를 선택하십시오. 데이터가 누락된 경우 이 언어 로캘이 사용됩니다.참고
Contentful 대체 언어와 이 설정 간에는 관계가 없습니다.
-
필요한 경우
을 제공하십시오 (베타).이것은 Contentful에서 렌더링된 콘텐츠로 이어지는 URL 템플릿입니다. 다음 자리 표시자가 지원됩니다:
-
{env_id}
: Environment ID -
{entry.sys.id}
: Entry ID -
{space_id}
: 공백 ID
URL 템플릿은 다음과 같을 수 있습니다:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
참고
URL은 Contentful 콘텐츠를 렌더링하는 배포된 애플리케이션으로 이어져야 합니다. 실시간 미리보기를 사용하려면 URL 템플릿에서
contentfulapp.tld
를 애플리케이션의 실제 도메인으로 바꾸십시오.콘텐츠 미리보기 설정에 대한 자세한 내용은 Contentful 문서를 참조하십시오.
로캘은 자리 표시자로 지원되지 않습니다. URL에서 로캘을 사용하려면 고정 값을 지정하고 여러 커넥터 인스턴스를 생성하십시오.
-
-
기술 지원 팀에서 디버그 정보 로깅을 요청하는 경우
을 선택하십시오. -
Contentful에 연결을 클릭하세요.
연결이 성공하면 커넥터 설정에 체크 표시가 나타납니다. 그렇지 않으면 빨간색 느낌표가 나타납니다. 자세한 내용을 보려면 아이콘 위로 고정하세요.
-
Contentful (입문 수준) 전용:
소스 언어를 설정하세요.
참고
이 언어는 Contentful의 로케일 설정에서 구성된 Contentful 공간의 기본 로케일과 일치해야 합니다.
-
저장을 클릭합니다.
커넥터는
페이지의 목록에 추가됩니다. -
선택적으로 커넥터를 편집하여
를 선택하세요.-
:
커넥터가 선택된 단계(예: 번역)에서 문서를 모니터링합니다. 작성자는 번역 준비가 되면 이 라벨을 문서에 적용할 수 있습니다.
Contentful에서 가져올 때:
-
커넥터는 소스 기사가 다운로드될 때 워크플로를 선택한 단계(예: 진행 중인 번역)로 진행합니다.
Contentful로 내보낼 때:
-
커넥터는 번역이 내보내질 때 소스 기사의 워크플로 단계를 선택한 단계(예: 번역 완료)로 설정합니다.
참고
Contentful은 2023년 6월 1일에 워크플로 지원을 중단했습니다. 계속 사용은 지원되지 않습니다.
-
참고
Contentful Launch App은 2.0 커넥터에서 지원되지 않습니다.
-
설정
페이지에서 섹션으로 스크롤하십시오.
-
커넥터을 클릭합니다.
페이지가 열립니다.
-
새 커넥터를 클릭합니다.
페이지가 열립니다.
-
유형을 Contentful 2.0으로 변경하세요.
-
커넥터의 이름을 제공하세요.
-
Contentful 2.0에 연결을 클릭하세요.
Contentful 로그인 창이 열립니다.
-
로그인 세부정보를 제공하고 로그인을 클릭하세요(또는 대체 로그인 방법을 사용하세요). 로그인 창이 닫히고 이 표시됩니다.
-
앱과 함께 커넥터를 사용하는 경우 구문 Contentful 앱 체크박스를 선택하십시오.
-
토큰 생성을 클릭하세요.
창이 열립니다.
-
토큰 생성을 클릭하세요.
토큰이 생성되며 클립보드나 텍스트 파일에 복사해야 합니다. 창을 닫기 전에 토큰이 복사되었는지 확인하세요. 다시는 보이지 않습니다. 이 토큰은 앱에 연결할 때 사용됩니다.
-
창을 닫으면
이 표시됩니다.
-
-
Contentful 태그를 사용하여 콘텐츠를 식별하는 경우 태그 ID를 입력하고 Enter를 누르세요.
ID가 표시되며 더 추가할 수 있습니다.
-
필요한 경우
을 선택하세요 (중첩 콘텐츠).모든 중첩 콘텐츠는 작업의 가져오기 및 생성 중에 포함됩니다.
-
필요한 경우
를 선택하세요.모든 APC 모니터링 및 작업 재가져오기/내보내기에 별칭이 사용됩니다. 미래에 별칭 대상이 변경되면 APC는 새로운 대상의 콘텐츠를 모니터링하고 작업은 새로운 별칭 대상으로 재가져오기/내보내기됩니다.
-
(기본값 및 권장)
APC 및 생성된 작업은 작업/APC 생성 시 별칭이 가리키고 있던 환경에 연결됩니다. APC는 해당 환경과 콘텐츠만 모니터링하며, 작업은 해당 환경으로 내보내지고 재가져오기됩니다.
-
APC와 생성된 작업은 별칭 자체에 연결되어 있습니다. APC는 해당 별칭과 콘텐츠만 모니터링하며, 작업은 내보내지고 다시 가져옵니다.
별칭 대상이 변경되면, APC는 새로운 별칭 대상(환경)을 모니터링합니다; 작업은 이제 그것으로 내보내고 다시 가져옵니다.
-
-
필요한 경우,
을 제공하십시오.이것은 Contentful에서 렌더링된 콘텐츠로 이어지는 URL 템플릿입니다. 다음 자리 표시자가 지원됩니다:
-
{env_id}
: Environment ID -
{entry.id}
: Entry ID -
{space_id}
: 공백 ID
URL 템플릿은 다음과 같을 수 있습니다:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
참고
URL은 Contentful 콘텐츠를 렌더링하는 배포된 애플리케이션으로 이어져야 합니다. 실시간 미리보기를 사용하려면 URL 템플릿에서
contentfulapp.tld
를 애플리케이션의 실제 도메인으로 바꾸십시오.콘텐츠 미리보기 설정에 대한 자세한 내용은 Contentful 문서를 참조하십시오.
로캘은 자리 표시자로 지원되지 않습니다. URL에서 로캘을 사용하려면 고정 값을 지정하고 여러 커넥터 인스턴스를 생성하십시오.
-
-
필요한 경우, Phrase로 가져오는 것을 생략해야 하는 ContentID를 제공하십시오.
-
및 을 에 제공하십시오.
미리 보기 API는 이러한 필드를 요구합니다. Contentful 2.0 통합은 콘텐츠를 가져오고 변경 사항을 모니터링하기 위해 이 API를 사용합니다 (APC).
-
Contentful에서 모니터링/가져올 각 공간과 환경을 선택하십시오.
-
설정 및 액세스는 Contentful 내에서 관리됩니다.
-
-
저장을 클릭합니다.
커넥터는
페이지의 목록에 추가됩니다.