Korean translation of the Keras documentation

This is the repository for the Korean-language .md sources files of keras.io.

Existing files in sources/ should be edited in-line.

케라스 공식 문서 한국어판

케라스 공식 문서의 한국어판입니다. 이미 딥러닝에 익숙한 연구자 및 개발자 외에도 처음 딥러닝을 접하는 사용자들이 최대한 쉽게 이해하고 사용할 수 있도록 그 의미와 용법, 용례가 정확하고 명료하게 그리고 최대한 자연스러운 문장으로 나타나도록 작성되었습니다. 📖✍️🌝

번역 가이드라인

• 모든 번역문은 한국어 정서법을 준수합니다.
• 번역은 문서화 내에 있는 본문 내용과 코드 주석들을 대상으로 합니다.
• 번역시 문장 끝에 붙는 격식체는 '-ㅂ니다'체를 따르며 비속어나 반말은 쓰지 않습니다.
• 큰 따옴표나 작은 따옴표는('，") 특수문자를 사용하지 않고 기본적으로 제공된 것을 사용합니다.
• 코드 강조(syntax highlight) 뒤에 조사가 붙는 경우, 공백을 넣지 않습니다(e.g. model.fit()을 실행하면).
• 키워드를 번역할 때 아래에 있는 작성 규칙 및 용어 통일안을 최우선으로 사용합니다.
• 과한 복문의 경우 단문으로 나누어서 씁니다.
• 원문 내용이 불충분한 경우 원문이 전달하고자 하는 내용을 충실히 전달하는 범위 내에서 사용자가 이해할 수 있도록 간략한 설명을 보충합니다.
• 번역은 다른 언어로 된 문서의 의미를 이해하고 한국어로 다시 표현하는 것이니 번역체는 자제해 주시기 바랍니다(우리는 한다 번역을).

작성 규칙

• 용어 번역의 경우 문서 내에서 처음 나온 경우에 한해 subscript로 원어를 병행표기합니다. (예: 층_layer)
  • 발음만 한글로 옮긴 경우 subscript는 생략합니다. (예: 스트라이드)
  • 특수한 경우를 제외하면 subscript는 소문자로 작성합니다. (특수한 경우: 1. 대문자 고유명사 및 대문자 약칭, 2. 제목의 경우 관사와 접속사, 전치사를 제외한 단어와 제목 첫 단어의 첫글자는 대문자로 작성)
• list, dict 등 파이썬 기본 자료형의 경우 발음대로 표기하고 원어는 병기하지 않습니다.
• int, float, integer 등 자료형 키워드/단어의 경우
  • 문장 내에 등장하는 경우 한국어로 번역합니다. (예: "~ is tuple of integers" → "~는 정수형 튜플입니다.")
  • argument등 변수 설명에서 입력값의 자료형을 나타내는 경우 highlight로 표시하고 파이썬 자료형 표기대로 적습니다. (예: X: Integer, → int.)
• 문장 끝의 colon(:)은 마침표로 대체합니다.
  • 문장 끝의 semicolon(;)은 문장을 두 개로 분리하고 필요한 경우 적합한 접속사를 추가합니다.
• Keras를 제외한 모든 API 및 서비스 등의 이름(TensorFlow, NumPy, CNTK, Amazon, Google 등)은 원문 그대로 사용합니다
• 함수 인자 설명시 [인자: data type, 설명 내용, 기본값 ]의 형식을 따릅니다. (예: batch_size: int 혹은 None. 손실로부터 그래디언트를 구하고 가중치를 업데이트하는 과정 한 번에 사용할 표본의 개수입니다. 기본값은 32입니다.)
• Raises란의 경우 오류로 번역하며, 본문은 "(~하는 경우, ~하면, ~가) 발생합니다."로 정리합니다.

용어 통일안

• 이하 통일안은 케라스 코리아 번역팀의 논의를 거쳐 합의된 표현의 목록입니다.
• 통일안 선정은 다음과 같은 리소스를 참고하였습니다.
  • 국립국어원 언어정보 나눔터 언어 정보화 용어
  • 국립국어원 표준국어대사전 / 우리말샘
  • 한국정보통신기술협회 정보통신용어사전
  • 대한수학회 수학용어집
  • 한국어 위키백과
• 참조대상이 없는 어휘의 경우 의미를 살리되 보편적으로 사용되는 표현을 우선 선정하였습니다. 서로 다른 대상을 가리키는 번역 어휘가 중복되어 쓰이던 경우 최대한 가까운 새로운 어휘로 대체하였습니다.
• 용어집은 새로 도출한 합의안과 함께 개정됩니다.