javascript-tutorial / javascript-tutorial/ko.javascript.info

[개선제안] 코드 블럭으로 감싸진 내용 관련 위키 모범사례 추가

未關閉
#762 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
主要語言
HTML
星號
2k
分支
852
PR 合併指標
30 天內沒有已合併 PR

描述

## 자바스크립트 튜토리얼 한국 저장소 개선을 위해 제안할 사항

- [ ] 코드 블럭으로 감싸진 내용 관련하여 위키 모범사례에 추가

## 제안한 이유

번역 진행 시 코드 블럭으로 감싸진 document 관련 내용이 종종 들어있습니다.

ex) Drag'n'Drop 페이지
https://javascript.info/mouse-drag-and-drop

Another important aspect – we track ```mousemove``` on ```document```, not on ```ball```. From the first sight it may seem that the mouse is always over the ball, and we can put ```mousemove``` on it.
But as we remember, ```mousemove``` triggers often, but not for every pixel. So after swift move the pointer can jump from the ball somewhere in the middle of document (or even outside of the window).
So we should listen on ```document``` to catch it.

위 글에서 document를 '문서'로 번역하게 될 경우 번역문이 매끄럽지 않고, 사용자로 하여금 오해할 수 있는 여지가 발생합니다.
따라서, 코드 블럭에 하여금 번역을 하지 않거나, 문장을 그대로 쓰는 음차 번역을 하여 'document'로 작성하고, 이와 같은 내용을 wiki에 추가하려고 합니다.

## 추가적으로 논의할 사항

貢獻指南

開啟貢獻指南

研究方向

首先查看 repository wiki 中的指南,以及 javascript.info/mouse-drag-and-drop 上引用的 Drag'n'Drop 頁面。檢查韓文翻譯中如何處理 `mousemove` 和 `document` 等程式碼格式術語。完成的標準是 wiki 中包含一項明確的最佳實務,說明如何保留或音譯這類術語,而不是將它們當作一般散文翻譯。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
javascript
領域
documentation, localization
Issue 類型
文件
難度
2/5
預估耗時
1-3 小時
活躍度
停滯
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。