- Notifications
You must be signed in to change notification settings - Fork 5.4k
KO: add site/ko/swift/python_interoperability.ipynb #1062
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
| Preview and run these notebook edits with Google Colab: Notebook diffs available on ReviewNB.com. |
| Reviewers added, please take a look. When your review is finished, approve the pull request or include "LGTM" in your comment. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @FKgk
It's a great translation.
Most sentences are reasonable.
Please check my comments. :)
Thank you!
| "source": [ | ||
| "# 파이썬 상호 호환성\n", | ||
| "\n", | ||
| "텐서플로우를 위한 스위프트는 파이썬 상호 호환성을 지원합니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
'tensorflow' is translated as '텐서플로' in TF docs.
Please replace '텐서플로우' with '텐서플로'.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you for review
I changed it from '텐서플로우' to '텐서플로'.
| "metadata": {}, | ||
| "source": [ | ||
| "_노트: \n", | ||
| "파이썬을 임포트한 직후, 파이썬 코드를 호출하기 전에`PythonLibrary.useVersion`을 실행해야 합니다._\n" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
'Note' is a style element used on tensorflow.org for callout boxes. So, don't need to translate the word.
I suggest to replace '_노트' with 'Note'
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I changed it from '노트' to 'Note'
Also 267th line was changed same.
| "cell_type": "markdown", | ||
| "metadata": {}, | ||
| "source": [ | ||
| "`PYTHON_LOADER_LOGGING=1` 설정은 [debug output for Python library loading](https://github.com/apple/swift/pull/20674#discussion_r235207008)을 참고하세요." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The words for site link, 'debug... loading', seems to be translated.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I translate it from 'debug output for Python library loading' to '파이썬 라이브러리 로딩을 위한 디버그 출력'
Or should I not translate?
| }, | ||
| "source": [ | ||
| "## 기본\n", | ||
| "스위프트에서, `PythonObject`는 파이썬에서 객체를 나타냅니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
'~에서' ... '~에서' doesn't looks natural.
I suggest to replace '파이썬에서' with '파이썬'
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I changed it from '파이썬에서' to '파이썬
And I suggest to replace '스위프트에서,' with '스위프트에서'
(But the en doc says 'in swift,' )
| "* `변할 수 있는 수집`\n", | ||
| "* `리터럴에 의해 표현가능한` 모든 프로토콜\n", | ||
| "\n", | ||
| "노트: 이러한 형식은 안전하지 않습니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In the original English document, the word, 'Note', is not used but 'Note that'.
'Note' is a style element but not 'Note that'.
I suggest to rewrite this sentence.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I suggest to rewrite '노트: 이러한 형식은 안전하지 않습니다.' with '이러한 형식은 안전하지 않다는 점에 유의해야 합니다.'
| } | ||
| ], | ||
| "source": [ | ||
| "// `Python.builtins`은 모든 파이썬 내장객체의 딕셔너리입니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just typo '내장객체' -> '내장 객체'
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I Correctly fixed. ('내장객체' -> '내장 객체')
| "// `Python.builtins`은 모든 파이썬 내장객체의 딕셔너리입니다.\n", | ||
| "_ = Python.builtins\n", | ||
| "\n", | ||
| "// 파이썬 내장 객체를 시도합니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The literal translation of 'Try' seems to be not good.
I suggest to replace '시도합니다' with '사용합니다.'
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I replaced it from '시도합니다.' to '사용합니다.'
| "- `Array<Element>`\n", | ||
| "- `ShapedArray<Scalar>`\n", | ||
| "- `Tensor<Scalar>`\n", | ||
| "\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Line 487-491 is the English document and should be removed.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I remove them
| "source": [ | ||
| "## 이미지 표시\n", | ||
| "\n", | ||
| "파이썬 노트북에서처럼 `matplotlib`를 이용해 이미지를 일렬로 표시할 수 있습니다." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In this case, the meaning of 'in-line' might be 'same-line', 'same-page' or 'output line'
I suggest to replace '일렬로' with '같은 화면에' or '결과창에'.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I changed it '일렬로' to '결과 창에'
Thank you for information
| } | ||
| ], | ||
| "source": [ | ||
| "// 세트 업.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I suggest to replace '세트 업' with '준비'.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I changed it from '세트 업' to '준비'
Thank you for letting me know about many changes.
After this translation, I will try to be better next time I participate.
| "toc_visible": true, | ||
| "version": "0.3.2" | ||
| }, | ||
| "kernelspec": { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Swift notebooks are a bit different than Python notebooks. You need to manually set the kernel to use Swift in Colab (there's not a UI option, yet).
See the original notebook (at the bottom): https://raw.githubusercontent.com/tensorflow/swift/master/docs/site/tutorials/python_interoperability.ipynb
I would recommend starting a translation by copying that notebook instead of starting a new one. These should execute in Colab.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Meta data has been modified for Swift.
Perhaps the kernel changed while checking on local notebook after work in colab
Thank you
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you for your great translation. 👍
My review is almost finished.
My final suggestion is, after checking all comments, carefully review the final version yourself to keep tone and manner.
| "colab_type": "text" | ||
| }, | ||
| "source": [ | ||
| "Note: 이 문서는 텐서플로 커뮤니티에서 번역했습니다. 커뮤니티 번역 활동의 특성상 정확한 번역과 최신 내용을 반영하기 위해 노력함에도 불구하고 [공식 영문 문서](https://github.com/tensorflow/docs/blob/master/site/en/guide/distribute_strategy.ipynb)의 내용과 일치하지 않을 수 있습니다. 이 번역에 개선할 부분이 있다면 [tensorflow/docs](https://github.com/tensorflow/docs) 깃허브 저장소로 풀 리퀘스트를 보내주시기 바랍니다. 문서 번역이나 리뷰에 참여하려면 [docs-ko@tensorflow.org](https://groups.google.com/a/tensorflow.org/forum/#!forum/docs-ko)로 메일을 보내주시기 바랍니다." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please change the "[공식 영문 문서]" link into your original document.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I changed url link
Thanks
| "source": [ | ||
| "# 파이썬 상호 호환성\n", | ||
| "\n", | ||
| "텐서플로를 위한 스위프트는 파이썬 상호 호환성을 지원합니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To read easily, I suggest "파이썬 상호 호환성을 지원합니다." -> "파이썬과 상호 호환됩니다."
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As suggested, the sentence was reflected.
Thanks
| }, | ||
| "source": [ | ||
| "기본적으로 파이썬을 임포트 하면, 스위프트는 시스템 라이브러리 경로에 따라 설치된 최신 버전의 파이썬을 검색합니다.\n", | ||
| "특정한 파이썬을 설치하고자 할 때, `PYTHON_LIBRARY` 환경변수에 설치시 제공받은 `libpython` 공유 라이브러리를 설정합니다. 예를 들어:\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To read easily, I suggest "설치하고자 할 때" -> " 설치하려면"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As suggested, the sentence was reflected.
Thanks.
| "source": [ | ||
| "또는 스위프트가 시스템 라이브러리 경로에서 알맞은 파이썬 버전을 찾도록 해서 `PYTHON_VERSION` 환경변수를 설정할 수 있습니다. `PYTHON_LIBRARY`가 `PYTHON_VERSION`보다 우선한다는 점을 유의해야 합니다.\n", | ||
| "\n", | ||
| "또한 코드에서 `PYTHON_VERSION` 설정과 동일한 `PythonLibrary.useVersion`함수를 호출할 수 있습니다." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For readability, Please add "기능을 하는" after "동일한".
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I add "기능을 하는" after "동일한"
Thanks
| "id": "w3lmTRCWT5sS" | ||
| }, | ||
| "source": [ | ||
| "튜플을 파이썬에서 스위프트로 변환하려면, 정적으로 튜플의 길이를 알아야 합니다.\n", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To read easily in Korean, I suggest "정적으로 튜플의 길이" -> "정확한 튜플 크기".
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As suggested, the sentence was reflected.
I changed from "정적으로" to "정확한
Thanks
| Thank you for your excellent and accurate review. |
| @FKgk please let me know when you are done with your final review. |
| Yes, I'll tell you as soon as the end of the review. |
| @wckim I've finished my final review. |
| @FKgk Thank you for your great contribution to Korean translation of TensorFlow. 👍 |
| LGTM 👍 |
| @lamberta Thanks for waiting |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks.
added swift tutorial is korean translation of swift/docs/site/tutorials/python_interoperability.ipynb