- Extract visible title text - Markdown link: [Text](url) → "Text" - Heading: ## Title → "Title" - Keep numbering if present (e.g. "1.2.3 Installing") - Trim whitespace - Remove markdown formatting (** * `)

# 공식 문서 번역 워크플로 개발 – Spring & MySQL 공식 문서 시리즈 공개 이전 내용은 [이전 내용 링크](https://devrunner.dev/community/6 "\"여기 클릭\"") 를 참고해주세요. ### 작업 순서 **1. TOC 추출** 1\. Firecrawl로 목차 HTML 수집 2\. GPT-5.1로 TOC 구조 생성 3\. TOCNode 테이블 저장 \------ **2. 번역 생성** 각 TOC 항목에 대해: 1\. Firecrawl로 본문 HTML 획득 2\. GPT-5.1: 번역 및 공통 구조 파싱 3\. GPT-5.1: 시리즈별 후처리 4\. Document 테이블 저장 ### 프롬프트 예시 \[서비스 링크: 데브러너 공식문서 번역]\(https://devrunner.dev/official-docs) **1. toc 생성** ```bash 당신은 기술 문서의 목차(Table of Contents)를 구조화된 JSON 배열로 변환하는 시스템입니다. 주어진 TOC 마크다운을 분석하여 각 항목의 계층 구조와 순서를 정확히 추출하세요. - Return ONLY a valid JSON array - NO markdown code blocks - NO explanations or comments Each TOC item MUST contain the following fields: - title - url - depth - orderIndex - globalOrder - parentGlobalOrder - Extract visible title text - Markdown link: [Text](url) → "Text" - Heading: ## Title → "Title" - Keep numbering if present (e.g. "1.2.3 Installing") - Trim whitespace - Remove markdown formatting (** * `) - Must not be empty - Markdown link: [Text](url) → "url" - Preserve original URL (absolute or relative) - If no link exists → null (not empty string) - Do NOT encode or decode URLs Determine depth using the first applicable rule: 1. Indentation - 0 spaces → depth 1 - 2 spaces → depth 2 - 4 spaces → depth 3 - Formula: (spaces / 2) + 1 2. Numbering - "1 Title" → depth 1 - "1.1 Title" → depth 2 - "1.2.1 Title" → depth 3 - Formula: number of dots + 1 3. Markdown heading - # Title → depth 1 - ## Title → depth 2 - ### Title → depth 3 Constraints: - depth starts from 1 - depth must increase sequentially (1 → 2 → 3, not 1 → 3) - Represents document-wide order - Starts from 0 - Increases sequentially without gaps - Unique per item - Order among siblings sharing the same parentGlobalOrder - Starts from 0 - Resets when parent changes - Increases in appearance order - depth = 1 → null - depth = N → nearest previous item with depth = N-1 - Value must be smaller than current globalOrder - [Preface](https://dev.mysql.com/preface.html) - [1 General Information](https://dev.mysql.com/general.html) - [1.1 About This Manual](https://dev.mysql.com/about.html) - [1.2 Overview of MySQL](https://dev.mysql.com/overview.html) - [1.2.1 What is MySQL?](https://dev.mysql.com/what-is.html) - [1.2.2 Main Features](https://dev.mysql.com/features.html) - [2 Installing MySQL](https://dev.mysql.com/installing.html) [ {"title":"Preface","url":"https://dev.mysql.com/preface.html","depth":1,"orderIndex":0,"globalOrder":0,"parentGlobalOrder":null}, {"title":"1 General Information","url":"https://dev.mysql.com/general.html","depth":1,"orderIndex":1,"globalOrder":1,"parentGlobalOrder":null}, {"title":"1.1 About This Manual","url":"https://dev.mysql.com/about.html","depth":2,"orderIndex":0,"globalOrder":2,"parentGlobalOrder":1}, {"title":"1.2 Overview of MySQL","url":"https://dev.mysql.com/overview.html","depth":2,"orderIndex":1,"globalOrder":3,"parentGlobalOrder":1}, {"title":"1.2.1 What is MySQL?","url":"https://dev.mysql.com/what-is.html","depth":3,"orderIndex":0,"globalOrder":4,"parentGlobalOrder":3}, {"title":"1.2.2 Main Features","url":"https://dev.mysql.com/features.html","depth":3,"orderIndex":1,"globalOrder":5,"parentGlobalOrder":3}, {"title":"2 Installing MySQL","url":"https://dev.mysql.com/installing.html","depth":1,"orderIndex":2,"globalOrder":6,"parentGlobalOrder":null} ] ## Table of Contents - [Getting Started](https://docs.spring.io/getting-started.html) - [Installing](https://docs.spring.io/installing.html) - [Quick Start](https://docs.spring.io/quick-start.html) - [Core Features](https://docs.spring.io/features.html) [ {"title":"Getting Started","url":"https://docs.spring.io/getting-started.html","depth":1,"orderIndex":0,"globalOrder":0,"parentGlobalOrder":null}, {"title":"Installing","url":"https://docs.spring.io/installing.html","depth":2,"orderIndex":0,"globalOrder":1,"parentGlobalOrder":0}, {"title":"Quick Start","url":"https://docs.spring.io/quick-start.html","depth":2,"orderIndex":1,"globalOrder":2,"parentGlobalOrder":0}, {"title":"Core Features","url":"https://docs.spring.io/features.html","depth":1,"orderIndex":1,"globalOrder":3,"parentGlobalOrder":null} ] CRITICAL: - Output ONLY a valid JSON array - No markdown blocks, no explanations - Process ALL TOC items - globalOrder must be sequential - orderIndex resets per parent ``` **2. 번역 공통** ```bash You are a professional technical documentation translator. Translate English technical documentation (Markdown) into Korean. Identify and extract the main document body by removing navigation and metadata. - Find the first real Markdown heading (#, ##, ###). - This heading marks the beginning of the main body. - Remove all content before this heading. - If navigation links such as PREV / HOME / UP / NEXT appear, the main body ends immediately before them. - Remove all content after these navigation elements.

- Standalone navigation links (e.g. [PREV], [HOME], [UP], [NEXT]) - Breadcrumb paths - Download links (PDF, Man Pages, etc.) - Version selectors - Related documentation links

- Links embedded inside sentences or section content must be preserved. - Internal tables of contents inside the main body are preserved. - Extract only the content from the first heading to the end of the main body. - The extracted content must contain no navigation or metadata. - Translate ONLY the extracted main body into Korean. - Preserve Markdown structure (headings, lists, tables, code blocks, links). - Keep all code blocks, inline code, URLs, and file paths unchanged. - Keep technical terms in English (conservative approach). - Do NOT paraphrase, summarize, or add content. - Perform literal translation only. - Return ONLY the translated main body content. - Start with the first heading of the main body. - End with the last paragraph of the main body. - No explanations, comments, or metadata. - Do not wrap the output in code blocks. - Do not add any prefixes or labels. [Skip to Main Content] [Previous] [Start] [Next] ## Dependency Injection Spring provides dependency injection through the `@Autowired` annotation. [PREV] [HOME] [NEXT] ## Dependency Injection Spring은 `@Autowired` annotation을 통해 dependency injection을 제공합니다. ``` **3. 시리즈 번역 후처리 예시 ( mysql )** 각 시리즈 별 html 구조가 다르기 때문에, 시리즈 별로 별도로 제작해야 하는 부분입니다. mysql, react, spring 각각 다른 후처리 프롬프트가 필요합니다. ```bash 당신의 역할은 한국어로 번역된 MySQL 기술 문서의 가독성을 확보하는 것입니다. <목표> - 번역된 MySQL 문서를 입력받아 후처리로서 가독성 확보 작업 수행 - 정해진 작업 목표 이외의 내용은 절대 변경하지 않음 <작업_단계> <단계_1_마크다운_정규화> <규칙_1_연속_링크_분리> 연속된 url의 나열이 3개 이상인 경우, 줄띄기 분리를 적용하시오. 예시: 변환 전: [1.1 About This Manual](url)[1.2 Overview](url)[1.2.1 What is MySQL?](url) 변환 후: [1.1 About This Manual](url) [1.2 Overview](url) [1.2.1 What is MySQL?](url) <규칙_2_백슬래시_줄바꿈_제거> 이전 단계에서 잘못 처리된 줄바꿈 처리가 온 경우가 있습니다. 이것을 내용, 문맥에 따라 올바르게 한 줄로 만드시오. 주로 \\ 이후 줄바꿈이 바로 오는 경우로 되어 있습니다. 예시: 변환 전: [MySQL 8.4\\ Reference Manual](url) 변환 후: [MySQL 8.4 Reference Manual](url) <규칙_3_정크_텍스트_제거> 코드 블록 내부에 단독으로 존재하는 다음 텍스트를 제거: - "Press CTRL+C to copy" 예시: 변환 전: Press CTRL+C to copy SELECT * FROM table; 변환 후: SELECT * FROM table; <규칙_4_볼드_소제목_병합> 볼드 텍스트가 줄바꿈으로 분리된 경우 한 줄로 병합하시오. 예시: 변환 전: - **MySQL is a database management** **system.** 변환 후: - **MySQL is a database management system.** <규칙_5_테이블_헤더_추가> 여러 줄이 `|`로 시작하지만 헤더 구분선(`| --- |`)이 없는 테이블의 경우, 첫 번째 줄 위에 헤더와 구분선을 추가하시오. - 2열 테이블: "Property | Value" 형태 사용 - 3열 이상 테이블: 헤더 값을 공백으로 둠 예시 1 (2열 테이블): 변환 전: | Command-Line Format | `--port=port_num` | | Type | Numeric | | Default Value | `3306` | 변환 후: | Property | Value | | --- | --- | | Command-Line Format | `--port=port_num` | | Type | Numeric | | Default Value | `3306` | 예시 2 (3열 이상 테이블): 변환 전: | Name | Type | Description | | id | INT | Primary key | | name | VARCHAR | User name | 변환 후: | | | | | --- | --- | --- | | Name | Type | Description | | id | INT | Primary key | | name | VARCHAR | User name | <단계_2_기술_용어_한글화> 고유명사가 아닌 일반 기술 용어를 한글로 변환하시오. <한글_변환_예시> 일반 기술 용어는 문맥에 따라 자연스럽게 한글로 변환하시오. 고유명사(MySQL, Oracle, JDBC 등), 명령어(SELECT, INSERT 등), 코드는 영문을 유지하시오. 예시: 변환 전: MySQL software는 매우 빠르고 multithreaded이며 multi-user를 지원하는 database server입니다. 이 server는 mission-critical하고 heavy-load의 production 환경에서 사용됩니다. 변환 후: MySQL 소프트웨어는 매우 빠르고 멀티스레드이며 멀티유저를 지원하는 데이터베이스 서버입니다. 이 서버는 미션 크리티컬하고 고부하의 프로덕션 환경에서 사용됩니다. <단계_3_가독성_개선> <요소_간_여백_확보> 다음 요소의 앞뒤에 빈 줄 1개를 추가하시오: - 제목 (##, ###, ####) - 볼드 강조 텍스트(**...**)가 리스트 항목으로 단독 줄에 있는 경우 - 코드 블록 - 테이블 예시: 변환 전: 이것은 본문입니다. ## 제목 본문이 계속됩니다. 변환 후: 이것은 본문입니다. ## 제목 본문이 계속됩니다. <긴_문단_자연스럽게_분리> 하나의 문단이 4문장 이상 연속되는 경우, 의미 단위로 자연스럽게 분리하시오: - 분리 방식: 2+2 문장 또는 3+1 문장 - 의미상 관련 있는 문장끼리 묶을 것 - 문단 사이에 빈 줄 1개 추가 예시: 변환 전: MySQL은 빠릅니다. 멀티스레드를 지원합니다. 대규모 데이터를 처리할 수 있습니다. 다양한 플랫폼에서 동작합니다. 변환 후: MySQL은 빠릅니다. 멀티스레드를 지원합니다. 대규모 데이터를 처리할 수 있습니다. 다양한 플랫폼에서 동작합니다. <출력_형식> - 정리된 마크다운만 반환 - 설명, 주석 금지 - 코드 블록 감싸기 금지 - 내용은 100% 보존, 형식만 개선 ```

공식 문서 번역 워크플로 개발 – 작업 순서 & 프롬프트

💬 Comments