라라벨 공식 문서를 한국어로 번역하고 최신 상태를 유지합니다.
이 프로젝트는 문서 번역을 관리하며, 번역된 마크다운 문서는 laravel-docs-web에서 호스팅됩니다.
마크다운 번역 문서에 다음과 같은 필터링을 적용합니다.
- 코드 블록 변환 : 들여쓰기 코드 블록을 펜스(백틱) 코드 블록으로 변환합니다.
- 스타일 태그 제거 :
<style>
태그와 그 내용을 제거합니다. - 이미지 태그 수정 : 이미지 태그(
<img>
)를 닫는 태그(<img />
)로 변환합니다. - 제목 중괄호 제거 : 제목 옆에 있는 클래스 옵션을 제거합니다 (
### 'after()' {.collection-method}
->### 'after()'
). - 툴팁 형식 표준화 : 다양한 형태의 툴팁/노트(
> {note}
,> **Note**
)를> [!NOTE]\n> message
형식으로 통일합니다. - 버전 플레이스홀더 치환 : 문서 내
{{version}}
플레이스홀더를 해당 버전 문자열(master
,12.x
등)로 치환합니다.
.env.example
파일을 복사하여 .env
파일을 만들고 번역 제공자를 설정합니다.
-
OpenAI
TRANSLATION_PROVIDER=openai TRANSLATION_MODEL=gpt-4.1 OPENAI_API_KEY=your_openai_api_key
-
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)