CopyDoc은 두 가지 방식으로 Gemini를 지원해요.

• Gemini API: 플러그인 안에서 번역과 가져오기를 자동으로 처리해요.
• Gemini Prompt: Gemini 앱에서 직접 복사해 붙여 넣는 수동 워크플로예요.

Gemini API 사용하기

1. CopyDoc에서 Localize Frames 버튼을 클릭하세요.
2. Gemini API를 선택하세요.
3. Google AI Studio API 키를 붙여 넣으세요.
4. CopyDoc에서 사용할 Gemini 모델을 선택하세요.
5. 번역할 Figma 프레임과 대상 로캘을 선택하세요.
6. 번역하는 동안 인라인 굵게, 기울임꼴, 링크 텍스트를 유지해야 한다면 Use Markdown을 켜세요.
7. Translate & Import를 클릭하세요.

CopyDoc이 선택한 프레임의 텍스트를 Gemini로 보내 번역한 다음, 번역 결과를 복제된 현지화 프레임으로 Figma에 자동으로 가져와요.

Gemini API 키는 Figma 사용자별로 내 기기에 저장되며, Figma 파일 자체에는 저장되지 않아요.

Gemini Prompt 사용하기

1. 현지화 옵션에서 Gemini Prompt를 선택하세요.
2. 번역할 Figma 프레임과 로캘을 선택하세요.
3. Generate Prompt를 클릭하세요.
4. Copy Prompt to Clipboard를 클릭하세요.
5. Gemini에서 프롬프트를 실행하고, 응답에 다른 내용 없이 CSV 원문만 들어 있는지 확인하세요.
6. CSV 응답을 CopyDoc에 다시 붙여 넣으세요.
7. Translate Figma Frames를 클릭해 번역된 콘텐츠를 Figma로 가져오세요.

수동 프롬프트 워크플로에서는 Gemini에서 Gemini 모델을 직접 선택해요. CopyDoc은 번역된 프레임을 Figma로 가져오기 전에 CSV 구조를 검증해요.

생성된 프롬프트는 Gemini에 지원되는 인라인 Markdown 서식을 유지하고 Markdown 기호, URL, 플레이스홀더를 바꾸지 말라고 지시해요. 그래야 번역된 콘텐츠를 Figma로 제대로 다시 가져올 수 있어요.

CSV 응답에서 id, frame_id, layer_name, figma_text 열을 삭제하거나 이름을 바꾸지 마세요. CopyDoc은 이 열을 사용해 번역된 행을 올바른 Figma 레이어와 다시 연결해요.