From ffe39f54c8721eabb9d2d7bbec63cb2df1250dc7 Mon Sep 17 00:00:00 2001 From: j1wu <ji.wu@outlook.com> Date: Sun, 12 Feb 2017 21:15:48 +0900 Subject: [PATCH 1/3] Added the Traditional Chinese translation --- README.cht.md | 119 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 README.cht.md diff --git a/README.cht.md b/README.cht.md new file mode 100644 index 0000000000..dfa7d5510d --- /dev/null +++ b/README.cht.md @@ -0,0 +1,119 @@ +# First Contributions + +<img align="right" width="300" src="assets/fork.png" alt="fork this repository" /> + +*其他語言版本: [英語](README.md), [西ç牙語](README.es.md), [è·è˜èªž](README.nl.md), [å°åº¦èªž](README.hi.md), [俄語](README.ru.md), [日語](README.ja.md), [è¶Šå—語](README.vn.md), [æ³¢è˜èªž](README.pl.md), [漢語](README.ko.md), [德語](README.de.md).* + +å¦‚æžœä½ çš„é›»è…¦ä¸Šå°šæœªå®‰è£ git, 請按照這個[ å®‰è£æŒ‡å¼• ]( https://help.github.com/articles/set-up-git/ )進行安è£ã€‚ + +## Fork(複製)本代碼倉庫 + +通éŽé»žæ“Šåœ–示ä¸çš„æŒ‰éˆ•,Fork 這個代碼倉庫。 +這個æ“ä½œæœƒå°‡é€™å€‹ä»£ç¢¼å€‰åº«è¤‡è£½åˆ°ä½ çš„è³¬æˆ¶å下。 + +## Clone(克隆)代碼倉庫 + +<img align="right" width="300" src="assets/clone.png" alt="clone this repository" /> + +æŽ¥ä¸‹ä¾†å°‡è¤‡è£½å¾Œçš„ä»£ç¢¼å€‰åº«å…‹éš†åˆ°ä½ çš„é›»è…¦ä¸Šï¼Œé»žæ“Šåœ–ç¤ºä¸çš„ç¶ è‰²æŒ‰éˆ•ï¼ŒæŽ¥è‘—å†é»žæ“Šè¤‡è£½åˆ°å‰ªåˆ‡ç‰ˆæŒ‰éˆ•(將代碼倉庫地å€è¤‡è£½ä¸‹ä¾†ï¼‰ + +隨後打開命令行窗å£ï¼Œæ•²å…¥å¦‚下 git 命令: + +``` +git clone "æ‰è¤‡è£½çš„ url éˆæŽ¥" +``` +"æ‰è¤‡è£½çš„ url éˆæŽ¥"ï¼ˆåŽ»æŽ‰é›™å¼•è™Ÿï¼‰å°±æ˜¯è¤‡è£½åˆ°ä½ è³¬æˆ¶å下的代碼倉庫地å€ã€‚如何ç²å–é€™å€‹éˆæŽ¥åœ°å€è«‹è¦‹ä¸Šä¸€æ¥ã€‚ + +<img align="right" width="300" src="assets/copy-to-clipboard.png" alt="copy URL to clipboard" /> + +è¬å¦‚: +``` +git clone https://github.com/ä½ çš„Github用戶å/first-contributions.git +``` +'ä½ çš„ Github 用戶å' æŒ‡çš„å°±æ˜¯ä½ çš„ Github 用戶å。在這一æ¥ä¸ï¼Œä½ æ˜¯å°‡è¤‡è£½åˆ°ä½ è³¬æˆ¶å下的 first-contributions 這個代碼倉庫克隆到本地電腦上。 + +## 新建一個分支 + +通éŽä¸‹é¢é€™å€‹å‘½ä»¤åœ¨å‘½ä»¤è¡Œçª—å£ä¸åˆ‡æ›åˆ° first-contributions é€™å€‹ç›®éŒ„ä¸‹é¢ + +``` +cd first-contributions +``` +接下來使用 `git checkout` 命令新建一個代碼分支 +``` +git checkout -b <新分支的å稱> +``` + +è¬å¦‚: +``` +git checkout -b 新分支的å稱 +``` + +## å°ä»£ç¢¼é€²è¡Œä¿®æ”¹ï¼Œè€Œå¾Œ commit 修改 + +打開 `Contributors.md` é€™å€‹æ–‡ä»¶ï¼Œæ›´æ–°æ–‡ä»¶å…§å®¹ï¼Œå°‡ä½ çš„åå—åŠ ä¸ŠåŽ»ï¼Œä¿å˜ä¿®æ”¹ã€‚é€šéŽ `git status` é€™å€‹å‘½ä»¤ä½ å¯ä»¥çœ‹åˆ°è¢«æ”¹å‹•äº†çš„æ–‡ä»¶è¢«åˆ—äº†å‡ºä¾†ã€‚æŽ¥è‘—é€šéŽ `git add` 命令則å¯ä»¥æ·»åŠ ä½ çš„æ”¹å‹•ï¼ˆä»¥ä¾¿éš¨å¾Œæäº¤æ”¹å‹•),就åƒå¦‚下這æ¢å‘½ä»¤ã€‚ +``` +git add Contributors.md +``` + +ç¾åœ¨å°±å¯ä»¥ä½¿ç”¨ `git commit` 命令 commit ä½ çš„ä¿®æ”¹äº†ã€‚ +``` +git commit -m "Add <ä½ çš„åå—> to Contributors list" +``` +å°‡ `<ä½ çš„åå—>` 替æ›ç‚ºä½ çš„åå— + +## 將改動 Push(æäº¤ï¼‰åˆ° Github + +使用 `git push` 命令æäº¤ä»£ç¢¼ +``` +git push origin <分支的å稱> +``` +å°‡ `<分支的å稱>` 替æ›ç‚ºä¹‹å‰æ–°å»ºçš„分支å稱 + +## æäº¤ä½ 的變動供他人審閱 + +å‰å¾€ Github ä½ çš„ä»£ç¢¼å€‰åº«ï¼Œä½ æœƒçœ‹åˆ°ä¸€å€‹ `Compare & pull request` 的按鈕。點擊該按鈕。 + +<img style="float: right;" src="assets/compare-and-pull.png" alt="create a pull request" /> + +接著å†é»žæ“Š `Create pull request` 按鈕,æ£å¼æäº¤ pull request。 + +<img style="float: right;" src="assets/submit-pull.png" alt="submit pull request" /> + +## è®“ä½ è¤‡è£½çš„ä»£ç¢¼å€‰åº«å’Œæœ¬å€‰åº«ä¿æŒä¸€è‡´ + +æ”¶åˆ°ä½ æäº¤çš„è®Šå‹•å¾Œï¼Œæˆ‘æœƒå°‡ä½ æäº¤åˆ°æ–°åˆ†æ”¯ä¸çš„æ”¹å‹•,åˆä½µåˆ° master(主分支)ä¸ã€‚è€Œä½ è¤‡è£½çš„ä»£ç¢¼å€‰åº«ä¸æœƒè‡ªå‹•ç²å–到åˆä½µå¾Œçš„æ›´æ–°å…§å®¹ã€‚ç‚ºäº†è®“ä½ è¤‡è£½çš„ä»£ç¢¼å€‰åº«å’Œæˆ‘çš„ä»£ç¢¼å€‰åº«å…§å®¹ä¿æŒä¸€è‡´ï¼Œé¦–å…ˆä½ éœ€è¦å°‡æˆ‘的代碼倉庫的地å€ä½¿ç”¨ `upstream remote url` å‘½ä»¤æ·»åŠ åˆ°ä½ çš„å€‰åº«é…置信æ¯ä¸ã€‚ +``` +git remote add upstream https://github.com/multunus/first-contributions +``` +如æ¤ä¸€ä¾†ï¼Œä½ 就讓 git 知é“äº†ä½ æœ¬åœ°çš„é€™å€‹ä»£ç¢¼å€‰åº«åœ¨é 端還å˜åœ¨å¦ä¸€å€‹ç‰ˆæœ¬ï¼ˆå³æˆ‘的代碼倉庫),而那個版本我們將其å«åš upstream。一旦我åˆä½µäº†ä½ æäº¤çš„æ”¹å‹•åˆ°æˆ‘çš„ä»£ç¢¼å€‰åº«å¾Œï¼Œä½ åœ¨æœ¬åœ°é€šéŽä¸‹é¢é€™å€‹å‘½ä»¤ä¾¿èƒ½å°‡æ›´æ–°çš„å…§å®¹åŒæ¥åˆ°æœ¬åœ°ã€‚ +``` +git fetch upstream +``` + +通éŽä¸Šé¢é€™å€‹å‘½ä»¤ï¼Œæˆ‘們便將é 端我的代碼倉庫(upstream remoteï¼‰ä¸æ‰€æœ‰æ–°å¢žçš„æ”¹å‹•æŠ“å›žåˆ°äº†æœ¬åœ°ã€‚ä½†é€™æ¨£é‚„æ²’æœ‰çµæŸï¼ŒæŽ¥ä¸‹ä¾†ï¼Œä½ 也需è¦å°‡æ›´æ–° rebase(按照 git 䏿–‡æ–‡æª”將其翻è¯ç‚º 'è¡åˆ'ï¼‰é€²å…¥ä½ æœ¬åœ°çš„ master 主分支ä¸ã€‚ +``` +git rebase upstream/master +``` +通éŽä¸Šé¢é€™å€‹å‘½ä»¤ï¼Œä½ å°±èƒ½å¤ å°‡å¾žé 端抓下來的所有改動è¡åˆåˆ°æœ¬åœ°çš„ master 主分支ä¸ã€‚æŽ¥è‘—å¦‚æžœä½ å†åšä¸€æ¬¡ push master æäº¤ä½ æœ¬åœ°ä»£ç¢¼åˆ°ä½ è‡ªå·±çš„é 端主分支的æ“ä½œï¼Œä½ åœ¨ Github 上複製的é ç«¯ä»£ç¢¼å€‰åº«å°±ä¹ŸåŒ…å«æœ€æ–°çš„代碼了。 +``` +git push origin master +``` +注æ„,上é¢é€™å€‹å‘½ä»¤ä¸ï¼Œä½ é 端的代碼倉庫的åå—å«åš origin。 + +## 接下來åšä»€éº¼å‘¢ï¼Ÿ + +ä½ åœ¨é€™å€‹éˆæŽ¥é é¢ä¸å¯ä»¥çœ‹åˆ°å¾ˆå¤šåˆå¸è€…å‹å¥½çš„ issues(å•題): +[contributor.ninja](https://contributor.ninja). + +通éŽä¸‹é¢é€™äº›éˆæŽ¥ï¼Œä½ èƒ½çœ‹åˆ°ç•¶å‰æµè¡Œçš„眾多代碼倉庫ä¸ï¼Œé©åˆåˆå¸è€…解決的å•題列表,還ç‰ä»€éº¼ï¼ŒåŽ»å§ :) + +|[](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[<img width="100" src="https://cdn.worldvectorlogo.com/logos/react.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[<img width="100" src="https://camo.githubusercontent.com/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| +|---|---|---|---|---|---|---|---| +|[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| +|[](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| +|[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| +|[](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[<img width="100" src="https://github.com/adobe/brackets/blob/gh-pages/images/brackets_128.png?raw=true">](https://github.com/adobe/brackets/labels/Starter%20bug)| +|[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[brackets](https://github.com/adobe/brackets/labels/Starter%20bug)| +| [](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|[<img width="100" src="https://github.com/Semantic-Org/Semantic-UI-React/raw/master/docs/app/logo.png">](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)| +| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | -- GitLab From f668f0ab27111d12301f700ae4f1c797ebd98f4b Mon Sep 17 00:00:00 2001 From: j1wu <ji.wu@outlook.com> Date: Mon, 13 Feb 2017 11:50:49 +0900 Subject: [PATCH 2/3] Add link to both Simplified and Traditional Chinese version --- README.cht.md | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.cht.md b/README.cht.md index dfa7d5510d..e9f87b9135 100644 --- a/README.cht.md +++ b/README.cht.md @@ -2,7 +2,7 @@ <img align="right" width="300" src="assets/fork.png" alt="fork this repository" /> -*其他語言版本: [英語](README.md), [西ç牙語](README.es.md), [è·è˜èªž](README.nl.md), [å°åº¦èªž](README.hi.md), [俄語](README.ru.md), [日語](README.ja.md), [è¶Šå—語](README.vn.md), [æ³¢è˜èªž](README.pl.md), [漢語](README.ko.md), [德語](README.de.md).* +*其他語言版本: [英語](README.md), [西ç牙語](README.es.md), [è·è˜èªž](README.nl.md), [å°åº¦èªž](README.hi.md), [俄語](README.ru.md), [日語](README.ja.md), [è¶Šå—語](README.vn.md), [æ³¢è˜èªž](README.pl.md), [韓語](README.ko.md), [德語](README.de.md), [ç°¡é«”ä¸æ–‡](README.chs.md), [ç¹é«”䏿–‡](README.cht.md).* å¦‚æžœä½ çš„é›»è…¦ä¸Šå°šæœªå®‰è£ git, 請按照這個[ å®‰è£æŒ‡å¼• ]( https://help.github.com/articles/set-up-git/ )進行安è£ã€‚ diff --git a/README.md b/README.md index c1fb6df2b0..2b3e4a990a 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Reading articles & watching tutorials can help, but what comes better than actua <img align="right" width="300" src="assets/fork.png" alt="fork this repository" /> -*Read this in other languages: [English](README.md), [Spanish](README.es.md), [Dutch](README.nl.md), [Hindi](README.hi.md), [Russian](README.ru.md), [Japanese](README.ja.md), [Vietnamese](README.vn.md), [Polish](README.pl.md), [Korean](README.ko.md), [German](README.de.md).* +*Read this in other languages: [English](README.md), [Spanish](README.es.md), [Dutch](README.nl.md), [Hindi](README.hi.md), [Russian](README.ru.md), [Japanese](README.ja.md), [Vietnamese](README.vn.md), [Polish](README.pl.md), [Korean](README.ko.md), [German](README.de.md), [Simplified Chinese](README.chs.md), [Traditional Chinese](README.cht.md).* If you don't have git on your machine, [ install it ]( https://help.github.com/articles/set-up-git/ ) -- GitLab From 896cf70bbe4e29b8a39f22c4a6812bc6a1dd6d26 Mon Sep 17 00:00:00 2001 From: j1wu <ji.wu@outlook.com> Date: Mon, 13 Feb 2017 11:59:38 +0900 Subject: [PATCH 3/3] Update contributors list --- Contributors.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Contributors.md b/Contributors.md index e4d4acb652..2441787c61 100644 --- a/Contributors.md +++ b/Contributors.md @@ -47,4 +47,5 @@ - [Aditya Vishwekar](https://github.com/adityavishwekar) - [Eloisa Guerrero] (http:s//github.com/grrrero) - [Santhosh] (https://github.com/sanreddevils) -- [Prakhar tripathi] \ No newline at end of file +- [Prakhar tripathi] +- [Ji Wu](https://github.com/j1wu) -- GitLab