라라벨 한국어 문서

라라벨 공식 문서 | 라라벨 한국어 문서

소개

라라벨 공식 문서를 한국어로 번역하고 최신 상태를 유지합니다.

이 프로젝트는 문서 번역을 관리하며, 번역된 마크다운 문서는 laravel-docs-web에서 호스팅됩니다.

• 지원 버전 : master, 12.x, 11.x, 10.x, 9.x, 8.x
• 업데이트 주기 : 매일 04시 (KST) #
• 번역 엔진 : OpenAI 및 번역 프롬프트

필터링

마크다운 번역 문서에 다음과 같은 필터링을 적용합니다.

• 코드 블록 변환 : 들여쓰기 코드 블록을 펜스(백틱) 코드 블록으로 변환합니다.
• 스타일 태그 제거 : <style> 태그와 그 내용을 제거합니다.
• 이미지 태그 수정 : 이미지 태그(<img>)를 닫는 태그(<img />)로 변환합니다.
• 제목 중괄호 제거 : 제목 옆에 있는 클래스 옵션을 제거합니다 (### 'after()' {.collection-method} -> ### 'after()').
• 툴팁 형식 표준화 : 다양한 형태의 툴팁/노트(> {note}, > **Note**)를 > [!NOTE]\n> message 형식으로 통일합니다.
• 버전 플레이스홀더 치환 : 문서 내 {{version}} 플레이스홀더를 해당 버전 문자열(master, 12.x 등)로 치환합니다.

실행

.env.example 파일을 복사하여 .env 파일을 만들고 번역 제공자를 설정합니다.

1. OpenAI

   TRANSLATION_PROVIDER=openai
   TRANSLATION_MODEL=gpt-4.1
   
   OPENAI_API_KEY=your_openai_api_key

2. Azure OpenAI

   TRANSLATION_PROVIDER=azure
   TRANSLATION_MODEL=gpt-4.1
   
   AZURE_OPENAI_API_KEY=your_azure_api_key
   AZURE_OPENAI_API_VERSION=2025-05-01-preview
   AZURE_OPENAI_ENDPOINT=https://your-endpoint.openai.azure.com/

전체 번역 및 동기화 스크립트를 로컬 도커 환경에서 간편하게 실행해 볼 수 있습니다.

chmod +x run.sh
./run.sh

라이선스

• 번역 코드 : MIT License
• 라라벨 문서 : MIT License (Copyright (c) Taylor Otwell)