Skip to content

Conversation

@FKgk
Copy link
Contributor

@FKgk FKgk commented Oct 1, 2019

added swift tutorial is korean translation of swift/docs/site/tutorials/python_interoperability.ipynb

@googlebot googlebot added the cla: yes CLA has been signed label Oct 1, 2019
@tfdocsbot tfdocsbot added ko translation Community-provided translation for certain languages labels Oct 1, 2019
@tfdocsbot
Copy link
Collaborator

Preview and run these notebook edits with Google Colab:

Notebook diffs available on ReviewNB.com.

@tfdocsbot
Copy link
Collaborator

Reviewers added, please take a look.
@rickiepark, @cre8tor, @Choiuijin1125, @JKIsaacLee, @NoelBird

When your review is finished, approve the pull request or include "LGTM" in your comment.

Copy link
Contributor

@wckim wckim left a 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",
Copy link
Contributor

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 '텐서플로'.

Copy link
Contributor Author

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"
Copy link
Contributor

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'

Copy link
Contributor Author

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)을 참고하세요."
Copy link
Contributor

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.

Copy link
Contributor Author

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",
Copy link
Contributor

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 '파이썬'

Copy link
Contributor Author

@FKgk FKgk Oct 1, 2019

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",
Copy link
Contributor

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.

Copy link
Contributor Author

@FKgk FKgk Oct 1, 2019

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",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just typo '내장객체' -> '내장 객체'

Copy link
Contributor Author

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",
Copy link
Contributor

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 '사용합니다.'

Copy link
Contributor Author

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",
Copy link
Contributor

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.

Copy link
Contributor Author

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`를 이용해 이미지를 일렬로 표시할 수 있습니다."
Copy link
Contributor

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 '결과창에'.

Copy link
Contributor Author

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",
Copy link
Contributor

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 '준비'.

Copy link
Contributor Author

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": {
Copy link
Member

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.

Copy link
Contributor Author

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

@FKgk FKgk requested a review from lamberta October 3, 2019 11:54
Copy link
Contributor

@wckim wckim left a 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)로 메일을 보내주시기 바랍니다."
Copy link
Contributor

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.

Copy link
Contributor Author

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",
Copy link
Contributor

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 "파이썬 상호 호환성을 지원합니다." -> "파이썬과 상호 호환됩니다."

Copy link
Contributor Author

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",
Copy link
Contributor

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 "설치하고자 할 때" -> " 설치하려면"

Copy link
Contributor Author

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`함수를 호출할 수 있습니다."
Copy link
Contributor

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 "동일한".

Copy link
Contributor Author

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",
Copy link
Contributor

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 "정적으로 튜플의 길이" -> "정확한 튜플 크기".

Copy link
Contributor Author

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

@FKgk
Copy link
Contributor Author

FKgk commented Oct 28, 2019

Thank you for your excellent and accurate review.
We will soon proceed with the final review.

@wckim
Copy link
Contributor

wckim commented Oct 29, 2019

@FKgk please let me know when you are done with your final review.

@FKgk
Copy link
Contributor Author

FKgk commented Oct 29, 2019

Yes, I'll tell you as soon as the end of the review.

@FKgk
Copy link
Contributor Author

FKgk commented Oct 31, 2019

@wckim I've finished my final review.
Thank you for your review so far.

@wckim
Copy link
Contributor

wckim commented Oct 31, 2019

@FKgk Thank you for your great contribution to Korean translation of TensorFlow. 👍
LGTM

@tfdocsbot tfdocsbot added kokoro:force-run lgtm Community-added approval labels Oct 31, 2019
@cre8tor
Copy link
Contributor

cre8tor commented Oct 31, 2019

LGTM 👍
Thank you for your contribution

@FKgk
Copy link
Contributor Author

FKgk commented Nov 10, 2019

@lamberta Thanks for waiting
I got an LGTM, could you merge it?

@MarkDaoust MarkDaoust added ready to pull Start merge process and removed awaiting-translation-review labels Nov 10, 2019
Copy link
Member

@MarkDaoust MarkDaoust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks.

lamberta added a commit that referenced this pull request Nov 11, 2019
@lamberta lamberta merged commit f78414c into tensorflow:master Nov 11, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla: yes CLA has been signed ko lgtm Community-added approval ready to pull Start merge process translation Community-provided translation for certain languages

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants