Material-ui: [문서] 문서 번역

다른 사람들이 문제를 처리하고 최상의 솔루션을 복사하는 방법을 벤치마킹해야 합니다. Vue는 문서를 분기하는 것 같습니다.

• https://github.com/vuejs-ru/old.ru.vuejs.org
• https://github.com/vuejs/cn.vuejs.org

@oliviertassinari 하지만 API 문서는 어떻습니까?

API 문서는 어떻습니까?

@mbrooks 나도 몰라. 번역 키를 사용하여 수행할 수 있습니다. api.componentName.propertyName 처럼. 그러나 이것은 i18n을 지원하기 위한 오버헤드입니다.

솔직히 말해서, 대부분의 개발 리소스가 영어로 된 세상에서 문서의 여러 번역을 유지하려는 시도는 무익하고 한계 이익을 위한 연습이 될 것이라고 생각합니다.

Crowdin은 번역 서비스를 제공하는 회사입니다. 오픈 소스 프로젝트의 경우 Crowdin은 무료 문자열 번역을 제공합니다.

https://docusaurus.io/docs/en/translation.html

Docusaurus는 좋은 해결책이 될 수 있습니다

@TorzuoliH Docusaurus는 옵션이 아닙니다. 구성 요소를 dogfood하는 것이 중요합니다.

안녕. 문서를 스페인어로 번역하는 것을 기꺼이 도와드리고 싶습니다.

나는 대부분의 소프트웨어 문서가 영어로 되어 있다는 것을 알고 있습니다. 이는 이상적으로는 모든 개발자가 읽을 수 있어야 한다는 것을 의미합니다. 그러나 이것은 사실이 아닙니다. 자신의 언어로 된 "공식" 문서가 없을 때 블로그, 비디오 등이 그 자리를 대신하게 되며 권위가 다소 의심됩니다. 스페인어로 React를 배우기 위해 제안된 리소스를 살펴보세요: https://github.com/jlobos /반응-에스파뇰 . 여러 언어로 된 문서를 보유하면 Material-UI를 훨씬 더 쉽게 사용할 수 있다고 생각합니다.

필요한 경우 스페인어/포르투갈어 번역도 기꺼이 도와드립니다!

중국 시장 점유율을 보면 Material-UI의 번역 스토리를 앞으로 밀어붙여야 한다고 생각합니다. 예를 들어, 프랑스보다 중국에서 오는 트래픽이 더 적습니다...

업계가 하는 일을 벤치마킹하기 시작했습니다. 아키텍처 관점에서 볼 때 흥미로운 몇 가지 솔루션은 다음과 같습니다.

• 뷰 . 그들은 내부적으로 Hexo 를 사용하지만 라이브러리의 i18n 기능 을 사용하지 않는다고 생각합니다.
  그들의 워크플로는 https://github.com/vuejs/vuejs.org/issues/271#issuecomment -266476746에 설명되어 있습니다. 커뮤니티에서 문서를 분기하고 번역을 자체적으로 수행하도록 권장하고 있습니다. 예를 들어, vuejs-fr/vuejs.org , vuejs-ru/vuejs.org .
  이것은 우리 측의 작업이 덜 필요한 솔루션입니다. 그러나 나는 그것이 비효율적이라고 생각합니다. Bootstrap에서 사용하는 접근 방식이기도 합니다.
• Nuxt 는 이를 위해 다양한 도구 를 사용하고 있습니다. 바라건대, 우리를 위해 몇 가지 세부 사항이 있습니다 :). GitLocalize 를 시도해 볼 가치가 있다고 생각합니다.
• Jest 는 문서를 구축하기 위해 Docusaurus 를 사용하고 있습니다. 그들은 또한 문서를 번역하기 위해 crowdin 을 사용합니다. 나는 crowdin이 GitLocalize의 경쟁자라고 생각합니다. 시도해 볼 일이기도 합니다.

또한: https://www.transifex.com

커뮤니티에서 문서를 분기하고 번역을 자체적으로 수행하도록 권장하고 있습니다. [...] 비효율적이라고 생각합니다.

동의합니다. 귀하가 의견을 제출하기 전에 우리가 무엇을 하든 변경 추적을 자동화해야 한다는 취지로 의견을 작성하기 시작했습니다. 그렇지 않으면 번역 기여자가 변경 사항을 최신 상태로 유지할 수 있는 간단한 방법이 없으며 번역된 문서의 사용자가 어떤 부분이 오래된 것인지 알 수 있는 방법이 없습니다.

이상적으로는 사용자가 오래된 텍스트로 플래그가 지정된 텍스트 위로 마우스를 가져가면 최신 영어 원본을 볼 수 있고 상황에 따라 업데이트된 번역을 제출할 수도 있습니다. 마찬가지로 새로 추가된 텍스트의 경우 영어를 표시하고 번역을 인라인으로 제출할 수 있습니다.

이를 지원하는 데 사용할 수 있는 것이 있다고 가정해야 합니다. 살아있는 문서의 여러 번역을 최신 상태로 유지하면서 사용자가 컨텍스트에서 원본을 볼 수 있도록 하는 유일한 실용적인 솔루션이기 때문입니다... 우리는 그것을 찾기만 하면 됩니다. -)

필요한 경우 프랑스어 번역을 도와드리겠습니다.

여기 중국어! 또한 Hai를 위해 일하고 있습니다 ... 중국어 문서를 기꺼이 도와줍니다.

포르투갈어 번역을 도와드릴 수 있습니다.

제 주요 언어는 스페인어이며 번역을 도와드릴 수 있습니다.

@oliviertassinari material-ui 는 중국의 개발자들에게 매우 인기가 있지만 많은 회사에서 이를 좋아하지 않습니다. React를 사용하기 때문입니다! 나는 중국에서 왔습니다. 0.x 버전부터 material-ui를 사용하기 시작했습니다. 나는 그를 아주 좋아한다. 참고로 친구들도 Material-ui를 좋아합니다. 필요하다면 문서를 중국어로 변환하는 능력에 기여하고 싶습니다. 그러나 현재 공식 문서 구조가 다른 언어로 포크 수정되는 데 도움이 되지 않는다는 것을 알았습니다!

GitHub의 트래픽 출처를 보면 처음에는 영어와 중국어 에만 집중해야 한다고 생각합니다.

https://www.similarweb.com/website/github.com

Bootstrap에서 사용하는 접근 방식을 벤치마킹했습니다. 그들은 그것을 하기 위해 커뮤니티에 의존합니다. 중국 버전은 전 세계 트래픽의 약 10%를 차지합니다. 나쁘지 않아.

@medz 피드백 주셔서 감사합니다. 예, 핵심 문서 구조에서 작업해야 합니다.
한 가지 중요한 과제는 최신 상태를 유지하는 것입니다. 어떤 프로세스를 사용해야 합니까?
Google 번역에 의존하는 일부 웹사이트를 보았지만 사람들은 Google 번역을 사용하기 위해 우리를 필요로 하지 않습니다.

@oliviertassinari 언어 패키지의 i18n 구조나 디렉토리 구조가 다 좋거나, 포크 변형 언어를 제공할 수 있는 구조도 좋은 선택이지만, 포크 변형 언어의 구조는 배포할 새 도메인 이름이 필요합니다. 사용자 사용의 관점에서 i18n 언어 패키지 구조 또는 디렉토리 구조가 더 나은 선택입니다.

중국 문서가 있으면 중국에서 material-ui가 더 인기가 있을 것입니다. 작은 사실을 밝히자면, 중국의 많은 영어 개발자들은 매우 나쁩니다. 영어를 보면 포기하고 싶은 충동이 들며, 영어실력도 많이 떨어지고, 답글에 문법 문제가 많이 나오는 것 같아요!

😄죄송합니다, 무슨 말인지 이해합니다. 당신이 의미하는 바는 다른 언어로 된 문서를 최신 상태로 유지하는 것입니다. i18n 구조를 사용하여 파일을 생성한 후 Docusaurus가 번역을 위해 Crowdin을 사용하는 것을 보았습니다. 나는 Crowdin의 번역의 매우 특이한 버전을 경험했습니다! docusaurus에 따르면 Crowdin은 오픈 소스 프로젝트에 대한 무료 번역 지원을 제공할 수 있습니다. 이러한 방식으로 번역가는 문서에 번역을 제출하는 데 참여하기만 하면 됩니다. Crowdin은 웨어하우스 파일의 빌드를 기반으로 업데이트해야 하는 부품을 자동으로 식별합니다.

감사 해요.

솔직히 말해서, 대부분의 개발 리소스가 영어로 된 세상에서 문서의 여러 번역을 유지하려는 시도는 무익하고 한계 이익을 위한 연습이 될 것이라고 생각합니다.

소리가 좋다!

@oliviertassinari 이해는 되지만 다른 나라에서 안쓰는 이유는 영어라서 그런거 같아요. 예를 들어 포르투갈어 버전을 사용하면 브라질 사람들이 프로젝트에서 더 많이 사용할 것이라고 확신합니다.

@fizzvr

문서의 여러 번역을 유지하려고 시도하는 것은 헛된 연습이 될 것입니다.

소리가 좋다!

아마도 더 나은 단어 선택은 " 수동으로 유지하려고 시도하는 것"이었을 것입니다. 그렇지 않으면 원본 자료의 변경 사항이 번역에서 누락되거나 번역이 원본(또는 다른) 언어에 포함되지 않은 콘텐츠로 보완될 수 있습니다.

이후에 이상적인 솔루션(https://github.com/mui-org/material-ui/issues/9511#issuecomment-377815552)에 대해 설명했으며 이를 제공하려는 타사 서비스가 있는 것 같습니다.

Material-UI 문서 사이트와 구조에 대대적인 점검 없이 통합할 수 있지만 가치가 있는 충분한 유틸리티를 제공하는 것을 찾아야 합니다.

@fpudo 우리가 올바른 솔루션을 찾을 수 있다면 언어 수는 번역 노력을 기울이는 사람들의 의지에 따라 제한될 뿐입니다.

중국어 번역에 도움이 되었으면 합니다. @ 나 필요합니다. :)

@earvinLi @medz @xiaoyu-tamu 기다려주셔서 감사합니다 - 드디어 준비가 된 것 같아요! https://crowdin.com/project/material-ui-docs

@earvinLi 중국어 번역의 주인이 되셔서 다행입니까?

@mbrookes 안녕하세요 Matt, 오랜만입니다. 저는 여전히 기꺼이 도와드릴 의향이 있습니다. 하지만 다른 두 명의 좋은 친구에게 주인이 되고 싶은지 물어봐도 될까요?

필요한 스페인어 번역을 도와드릴 수 있습니다!

나는 돌아서서 그것을 포르투갈어로 번역하기 위해 나 자신을 다시 제안하고 있습니다.

@opusartificis @fpudo , 감사합니다. 중국어로 시작하지만 이 공간을 보세요.

@earvinLi , 물론입니다. 감사합니다. 프로세스를 테스트하고 진행 상황을 알려주기 위해 한두 페이지를 번역할 수 있습니까?

@mbrooks 맞아요!

@earvinLi Gitter에서 저를 핑(ping)해 주시겠습니까? (https://gitter.im/mbrooks)

@xiaoyu-tamu 시작해주셔서 감사합니다! 위쪽 화살표로 표시된 "높은 우선 순위"로 사용량을 기준으로 상위 10개를 설정했습니다. 나는 또한 하위 10개 파일과 하위 3개 디렉토리의 우선 순위를 낮췄습니다.

첫 번째(마크다운 파일)는 getting-started/installation 입니다. 또한 별도로 홈 페이지를 번역해야 하지만 먼저 코딩해야 합니다.

다음은 핫리스트입니다.

문서 번역에 도움을 요청하는 알림을 푸시하겠습니다. 중국어로 적절한 "행동 촉구"를 생각해낼 수 있다고 생각하십니까?

엄청난! 중국어에 도움이 되어 기쁩니다.

@akaxiaok 당신은 https://translate.material-ui.com/project/material-ui-docs에서 우리의 노력을 따르고 우리를 도울 수 있습니다 :).

안녕하세요, mui 웹 사이트의 자동 번역을 끄는 방법이 있습니까? 원본 영어 문서를 보고 싶지만 어떻게 해야할지 모르겠습니다.

안녕하세요, mui 웹 사이트의 자동 번역을 끄는 방법이 있습니까? 원본 영어 문서를 보고 싶지만 어떻게 해야할지 모르겠습니다.

@mbrookes 상자 밖에서 이 사용 사례를 지원하려면 하위 폴더 접근 방식으로 나아가야 할 수도 있습니다. @marsonmao ?lang=en 를 추가하는 것은 작동하기로 되어 있었습니다 🤔, 그렇지 않으면 브라우저에서 허용되는 언어를 변경해야 합니다./.

@oliviertassinari 흠 다음과 같은 URL을 시도했지만 작동하지 않습니다. https://material-ui.com/demos/chips/?lang=en 또한 Chrome 브라우저의 언어 설정을 변경하려고 시도했지만 작동하지 않습니다. 이제 IE edge lol을 사용하여 문서 웹사이트를 엽니다.

그치만, 이 번역 기능은 수동으로 제어해야 하는 것 아닌가? 모든 사람이 항상 모국어로 문서를 보고 싶어하는지 잘 모르겠습니다. 나 자신을 위해 나는 영어 문서가 소스 코드와 더 일관성이 있기 때문에 대부분의 시간을 읽습니다. 나는 새로운 것을 빨리 배워야 할 때만 Chiese 문서를 읽습니다. 그래서 수동 스위치가 더 합리적인 접근 방식이라고 생각합니까?

@marsonmao 우리는 종단 간 작동을 위해 가능한 가장 간단한 솔루션을 사용했습니다. 문서를 개선하기 위해 활용할 수 있는 것은 이와 같은 피드백입니다. 그래, 난 동의.

@oliviertassinari 훌륭합니다. 그러면 나중에 사용할 수 있기를 바랍니다. 해결 방법을 위해 IE를 사용하여 문서를 열겠습니다 😄 또한 재료 UI 작업에 감사드립니다!

@marsonmao - @oliviertassinari 가 맞습니다. 말씀하신 대로 웹사이트를 영어로 읽는 것이 기본 설정이라면 브라우저 언어 기본 설정을 변경해야 합니다. Firefox, Safari 및 Chrome으로 다시 테스트했는데 예상대로 작동합니다.

앞으로 브라우저에 설정된 언어 기본 설정을 재정의하는 옵션을 추가할 수 있지만 지금은 브라우저 설정을 사용합니다.

모든 포르투갈어 번역을 도와드릴 수 있습니다. 브라질의 대부분의 초급 및 중급 개발자는 영어 공부에 흥미가 없습니다.

@andreacornaglia @fpudo @caiobessa 도움을 주셔서 감사합니다. 브라질 포르투갈어 번역이 시작되었습니다 !

안녕하세요, 포르투갈어 번역도 도와드릴 수 있습니다. Crowdin에서 문자열을 번역하는 과정이 어떻게 생겼는지 궁금합니다. 누가 번역을 승인하고, 누가 새로운 번역으로 풀 리퀘스트를 생성해야 합니까? 검토자 또는 작성자는 무엇입니까?

죄송합니다! 번역 변경 사항을 리포지토리로 푸시하는 봇이 있다는 것을 방금 깨달았습니다. 그래서 승인된 후에 번역이 검토를 위한 새로운 풀 요청에 자동으로 포함되는 것 같습니다. 맞나요?

@nicolasiensen 맞습니다! 첫 페이지부터 참여해주셔서 감사합니다 :).

내일부터 번역 시작합니다!!! 슈퍼 쿨!

누군가 포르투갈어로 된 알림 문구를 제안해 주시면 문서에 추가하겠습니다.

중국어의 경우 "Material-UI 문서를 중국어로 번역하는 데 도움"을 제안했는데 번역은 "Material-UI 문서를 중국어로 번역하는 데 도움이 됩니다"로 돌아오므로 해당 라인에 있는 모든 것이 좋을 것입니다. 자유롭게 창의력을 발휘하십시오. 가장 도움이 될 것이라고 생각하는 것이 무엇이든 상관없습니다.

또한 다음은 더 쉽게 번역할 수 있는 몇 가지 팁입니다.

• 복사 버튼은 당신의 친구입니다! 텍스트를 번역하기 전에 서식이 있는 원본 텍스트를 복사하는 데 사용합니다.
• Material-UI, React 등과 같은 프로젝트 이름을 문자 그대로 번역하지 마십시오.
• 코드 샘플에서 주석 및 렌더링된 문자열(예: 버튼 레이블)을 번역합니다.
• "Button"과 같은 구성 요소 이름을 번역하지 마십시오. (예를 들어 "버튼을 사용할 수 있습니다" 또는 일반적으로 버튼을 가리키는 제목으로 "버튼"과 같이 일반 개체를 참조할 때 번역하는 것이 좋습니다.)
• 키보드 단축키를 확인하면 시간을 절약할 수 있습니다. (에디터에서 앱바 오른쪽에 있는 키보드 아이콘) 원하는 대로 커스터마이징 할 수 있습니다.
• 당신과 함께 일할 수 있는 한 많은 사람들을 초대하십시오. 큰일이야!
• 뭔가 제대로 작동하지 않는 것 같으면 저희에게 알려주십시오. 조정할 수 있는 설정이 많이 있습니다.

교정자인 경우 데모 개체와 같이 소스에서 직접 복사한 것 외에는 자신의 번역을 승인하지 마십시오 {{"demo": "pages/demos/app-bar/SimpleAppBar.js"}} 즉시 승인될 수 있습니다.

@mbrooks 감사합니다 :)

@mbrookes 포르투갈어 번역은 스페인어 "조금"과 비슷합니다. 어떤 사람들은 스페인어 번역을 도울 수 있습니다. 나는 포함했다.

@fizzvr 브라질 포르투갈어 번역에 대한 Traction은 말할 것도 없이 실망스러웠지만 아직 포기할 수도 있습니다. 저도 스페인어에 대해 잘 모릅니다. 나는 대부분의 (유럽) 스페인어 사용자가 영어에 꽤 유창하다고 생각합니다.

@mbrookes 브라질 포르투갈어 번역을 진행하지 않을 경우를 대비하여 중단하려면 12월 31일까지 기다려 주십시오. 그것은 내에서 매우 조용 해집니다
올해 이맘때 직장에 가는데 많은 시간을 할애할 것입니다.

@mbrookes @fpudo 내가 아는 한, 포르투갈어 번역은 어디에도 등장하지 않습니다. 나는 우리가 중국어처럼 편집 버튼 없이는 작동할 수 없다고 생각합니다.

        if (userLanguage === 'zh') {
          return (
            <Button component="a" href="https://translate.material-ui.com/project/material-ui-docs">
              {'将此页面翻译成中文'}
            </Button>
          );
        }

        return (
          <Button component="a" href={`${sourceCodeRootUrl}${markdownLocation}`}>
            {'Edit this page'}
          </Button>
        );

번역이 누락된 경우 배너가 있으면 더욱 좋습니다.

@oliviertassinari 처음에 중국어로 도움이 된 것은 알림이었지만 CrowdIn과 여기에서 자원 봉사자에게 포르투갈어로 제안된 문구를 요청했지만(예를 들어 중국어 알림의 영어 번역 제공) 제안을 받지 못했습니다.

@fpudo , 덜 바쁠 때 이 작업을 제안해 주셔서 감사합니다. 우선적으로 문서 알림에 대한 클릭 유도문안을 제안하고 작업을 진행할 수 있는지 확인하세요!

이곳이 이곳인지는 모르겠지만 이탈리아어 번역에 대한 도움이 필요하시면 도움을 드릴 수 있습니다.

@mbrooks 알림은 여러 언어로 확장되지 않습니다. 다음을 제안합니다.

1. #13765로 진행합니다.
2. 최종적으로 지원하고자 하는 모든 언어를 추가합니다.
3. 번역을 사용할 수 없는 경우 영어 버전을 표시합니다(1. 활성화).
4. 우리는 우리가 지원하는 언어로 편집 버튼을 번역합니다

1. 폴백하면 번역에 도움을 요청하는 멋진 배너가 표시됩니다. (선택 과목)

알림은 여러 언어로 확장되지 않습니다.

뭐? 알림이 여러 릴리스로 확장되지 않을 것이라고 말하는 것과 같습니다.

모든 잠재적 번역에 대해 탭을 켜기 전에 몇 가지 언어로 물을 테스트하고 싶습니다. 알림은 중국어와 마찬가지로 포르투갈어 번역 작업을 시작하는 데 도움이 되길 바랍니다. 콘텐츠가 충분히 확보되면 현지화된 편집 버튼을 사용하여 포르투갈어를 사용할 수 있습니다.

1/3은 작동하지 않습니다. #13765 토론에서 언급했듯이 CrowdIn 동기화가 활성화되면(영구적으로 또는 주기적으로) 누락된 번역이 없습니다.

코드 단순화 외에 폴백 PR은 중복됩니다.

뭐? 알림이 여러 릴리스로 확장되지 않을 것이라고 말하는 것과 같습니다.

@mbrookes 내 말은 중국어 번역 속도가 크게 감소했다는 것입니다. 문서 알림 사용의 끝과 상관 관계가 있다고 생각합니다. 프로세스를 시작할 수는 있지만 지속하기에는 충분하지 않다고 생각합니다. 그렇기 때문에 확장할 수 없다고 생각합니다. 또한 이 문제에 전혀 관심이 없는 사람들에게 메시지를 표시하고 있습니다. 개선의 여지가 있다고 생각합니다.

누락된 번역이 없을 것입니다.

그러나 우리는 그것을 감지하려고 할 수 있습니다. 우리는 존재와 번역 길이를 비교할 수 있습니다. 대상과 소스 사이의 크기가 매우 유사하면 번역된 것이 없다고 결론을 내릴 수 있습니다.

처음 두 개의 댓글이 이상해 보입니다. 알림을 제거한(제거된 이유는 무엇입니까?)으로 인해 번역 활동이 감소하고 유지하면 계속 유지될 수 있습니다. - 이제 중국어 번역이 거의 완성되었을 것입니다.

그런데 왜 버튼 CTA가 효과가 없는지 궁금합니다.

여러 번역을 병렬로(또는 거의 비슷하게) 시작하면 현재 알림이 확장되지 않을 것이라는 데 동의합니다.

IP 위치 정보가 도움이 되는지 궁금합니다.

편집 버튼이 실제로 보이지 않는다고 생각합니다. 항상 명확한 도움이 필요한 것은 아닙니다. IP 지리적 위치가 도움이 될 수 있습니다.

번역에 관심이 있는 모든 사람을 위해 프랑스어, 독일어, 스페인어, 러시아어 및 일본어가 현재 제공됩니다(중국어 및 포르투갈어와 함께):

https://translate.material-ui.com/

지금 문제를 종료할 수 있습니다: https://next.material-ui.com/discover-more/languages/. 도움과 기여에 대해 모두 감사합니다! 대부분의 인프라 작업을 완료했습니다. 이제 번역을 최신 상태로 유지하기 위한 지속적인 노력이 필요합니다. :)