|
| 1 | +<div dir="rtl"> |
| 2 | + |
| 3 | +[](https://github.com/ellerbrock/open-source-badges/) |
| 4 | +[](https://opensource.org/licenses/MIT) |
| 5 | +[](https://www.codetriage.com/roshanjossey/first-contributions) |
| 6 | + |
| 7 | +# ืชืจืืืืช ืจืืฉืื ืืช (First Contributions) |
| 8 | + |
| 9 | +| <img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200"> | ืืืืืจืช GitHub Desktop | |
| 10 | +| ---------------------------------------------------------------------------------------------- | --------------------- | |
| 11 | + |
| 12 | +ืื ืงืฉื. ืื ืชืืื ืงืฉื ืืคืขื ืืจืืฉืื ื ืฉืขืืฉืื ืืฉืื. ืืืืืื ืืืฉืจ ืืชื ืืฉืชืคืื ืคืขืืื, ืืขืืืืช ืืื ื ืืืจ ื ืื. ืืื ืงืื ืคืชืื (Open Source) ืืื ืืืื ืฉืืชืืฃ ืคืขืืื ืืขืืืื ืืืื. ืจืฆืื ื ืืคืฉื ืืช ืืืจื ืฉืื ืชืืจืืื ืืืฉืื ืืงืื ืคืชืื ืืืืืื ืืชืืจืืื ืืคืขื ืืจืืฉืื ื ืฉืืื. |
| 13 | + |
| 14 | +ืงืจืืื ืฉื ืืืืจืื ืืฆืคืืื ืืืืจืืืื ืืืืืื ืืขืืืจ, ืืื ืื ืืืื ืืืืืช ืืื ืืืชืจ ืืืฉืจ ืืืืช ืืืฆืข ืืช ืืืืจืื ืืืื ืืืจืืก ืฉืื ืืืจ. ืืืจืช ืืคืจืืืงื ืืื ืืกืคืง ืืืืื ื ืืืคืฉื ืืช ืืืจื ืฉืื ืืชืืืืื ืืืฆืขืื ืืช ืืชืจืืื ืืจืืฉืื ื ืฉืืื. ืืืจื, ืืื ืฉืชืืื ืจืืืขืื ืืืชืจ, ืื ืชืืืื ืืื ืืืชืจ. ืื ืืชื ืืขืื ืืื ืื ืืืฆืข ืืช ืืชืจืืื ืืจืืฉืื ื ืฉืืื, ืคืฉืื ืขืงืื ืืืจื ืืฉืืืื ืืืืื. ืื ื ืืืืืืื ืฉืื ืืืื ืืื ื. |
| 15 | + |
| 16 | +ืื GitHub Desktop ืืื ื ืืืชืงื ืืฆืืื ืืืืฉื, [ืืชืงืื ื ืืืชื](https://desktop.github.com/). |
| 17 | + |
| 18 | +ืื ืืชื ืืฉืชืืฉืื ืืืจืกื ืฉื GitHub Desktop ืืืคื ื 1.0, [ืขืืื ื ืืืืจืื ืืื](github-desktop-old-version-tutorial.md). |
| 19 | + |
| 20 | +<img align="left" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" /> |
| 21 | + |
| 22 | +## ืืฆืขื Fork ืืืืืจ ืื |
| 23 | + |
| 24 | +ืืฆืขื Fork ืืืืืจ ืื ืขื ืืื ืืืืฆื ืขื ืืคืชืืจ ื-fork ืืืืง ืืขืืืื ืืืื ื ืฉื ืืืฃ. |
| 25 | +ืคืขืืื ืื ืชืืฆืืจ ืขืืชืง ืฉื ืืืืืจ ืชืืช ืืืฉืืื ืฉืืื. |
| 26 | + |
| 27 | +## ืฉืืคืื (Clone) ืืช ืืืืืจ |
| 28 | + |
| 29 | +ืืขืช ืฉืืคืื ืืช ืืืืืจ ืืืืฉื ืฉืืื. |
| 30 | + |
| 31 | +**ืืฉืื: ืืื ืืฉืืคื (Clone) ืืช ืืืืืจ ืืืงืืจื. ืืฉื ื-Fork ืฉืืื ืืฉืืคืื ืืืชื.** |
| 32 | + |
| 33 | +ืืื ืืฉืืคื, ืืืฆื ืขื "Code" ืืืืืจ ืืื ืขื "Open in Github Desktop". |
| 34 | + |
| 35 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone this repository" /> |
| 36 | + |
| 37 | +ืืืคืชื ืืืื ืงืืคืฅ. ืืืฆื ืขื "Open GitHubDesktop.exe". |
| 38 | + |
| 39 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone this repository" /> |
| 40 | + |
| 41 | +ืืืืจ ืืืืืฆื ืขื "Open GitHubDesktop.exe", ืืืคืืข ืืืื 'Clone a repository'. ืืืฆื ืขื 'Clone'. |
| 42 | + |
| 43 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/clone-repository.png" alt="clone this repository" height="400" /> |
| 44 | + |
| 45 | +ืืืืจ ืืื ืืืคืืข ืืืื ื ืืกืฃ: 'How are you planning to use this fork?' |
| 46 | +ืืืจื: **To contribute to the parent project** ืืืืฆื ืขื **Continue**. |
| 47 | + |
| 48 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/repository-clone-purpose.png" alt="Use of repository" height="500" /> |
| 49 | + |
| 50 | +ืืขืช ืืขืชืงืชื ืืช ืชืืื ืืืืจ first-contributions ืืืืฉื ืฉืืื. |
| 51 | + |
| 52 | +## ืืฆืืจืช Branch |
| 53 | + |
| 54 | +ืืขืช ืฆืจื Branch ืขื ืืื ืืืืฆื ืขื ืืืืืงืื **Current branch** ืืืขืื, ืืื ืืืฆื ืขื **New branch**: |
| 55 | + |
| 56 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch.png" alt="make a branch" /> |
| 57 | + |
| 58 | +ืงืจืื ื-branch ืฉืืื ืืฉื `<add-your-name>`. ืืืืืื: `add-james-smith` |
| 59 | + |
| 60 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="name your branch" /> |
| 61 | + |
| 62 | +ืืืฆื ืขื `Create branch`. |
| 63 | + |
| 64 | +## ืืฆืขื ืืช ืืฉืื ืืืื ืื ืืจืฉืื ื-Commit ืืฉืื ืืืื |
| 65 | + |
| 66 | +ืืขืช, ืขืืจื ืืืฉืื ืืช History ืืคืชืื ืืช ืืงืืืฅ `Contributors.md` ืืขืืจื ืืงืกื ืขื ืืื ืงืืืง ืืื ื ื-Open in text editor. |
| 67 | +ืืืื ืืชืืชืืช ืืืฃ, ืืืกืืคื ืืช ืฉืืื, ืืฉืืจื ืืช ืืงืืืฅ. |
| 68 | + |
| 69 | +ืืืืื: ืื ืฉืืื ืืื James Smith, ืื ืืืืจ ืืืืจืืืช ืื: |
| 70 | + |
| 71 | +``` |
| 72 | +[James Smith](https://github.com/jamessmith) |
| 73 | +``` |
| 74 | + |
| 75 | +ืชืืืื ืืจืืืช ืฉืืฉืื ืืืื ืืงืืืฅ Contributors.md ื ืืกืคื ื-GitHub Desktop. |
| 76 | + |
| 77 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="check status" /> |
| 78 | + |
| 79 | +ืืขืช ืืฆืขื Commit ืืฉืื ืืืื: |
| 80 | + |
| 81 | +ืืฉืื ื-summary ืืชืื: |
| 82 | + |
| 83 | +``` |
| 84 | +Add <your-name> to Contributors list |
| 85 | +``` |
| 86 | + |
| 87 | +ืืืืืคื ืืช `<your-name>` ืืฉืืื. |
| 88 | + |
| 89 | +ืืืฆื ืขื ืืืคืชืืจ `Commit to add-your-name`. |
| 90 | + |
| 91 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit your changes" /> |
| 92 | + |
| 93 | +ืืชืืชืืช ืชืืืื ืืจืืืช ืฉื-commit ื ืืฆืจ. |
| 94 | + |
| 95 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit2.png" alt="commit your changes" /> |
| 96 | + |
| 97 | +## ืืืืคืช ืืฉืื ืืืื ื-GitHub |
| 98 | + |
| 99 | +ืืืฆื ืขื File -> Options ืืืชืืืจื ื-Github.com. |
| 100 | +ืืืื ื ืืช ืฉื ืืืฉืชืืฉ ืืืกืืกืื ืฉืืื. |
| 101 | + |
| 102 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt="log-in to Github" /> |
| 103 | + |
| 104 | +ืืืฆื ืขื ืืคืชืืจ `Publish` ืืคืื ื ืืฉืืืืืช ืืขืืืื ื. |
| 105 | + |
| 106 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt="push your changes" /> |
| 107 | + |
| 108 | +## ืืืฉืช ืืฉืื ืืืื ืืืืืงื |
| 109 | + |
| 110 | +ืื ืชืืื ืกื ืืืืืจ ืฉืืื ื-GitHub, ืชืจืื ืืช ืืืคืชืืจ `Compare & pull request`. ืืืฆื ืขืืื. |
| 111 | + |
| 112 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" /> |
| 113 | + |
| 114 | +ืืขืช ืืืืฉื ืืช ื-pull request. |
| 115 | + |
| 116 | +<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" /> |
| 117 | + |
| 118 | +ืืงืจืื ืืืื ืืช ืืฉืื ืืืื ืฉืืื ื-branch ืืจืืฉื ืฉื ืืคืจืืืงื. |
| 119 | +ืชืงืืื ืืชืจืื ืืืืื ืืืืจ ืืืืืื. |
| 120 | + |
| 121 | +## ืืื ืืืฉืืืื ืืืื? |
| 122 | + |
| 123 | +ืื ืืืืื! ืืฉืืืชื ืืช ืชืืืื ืืขืืืื ืืกืื ืืจืื ืฉื: |
| 124 | +_fork -> clone -> edit -> PR_ |
| 125 | +ืชืืืื ืฉืื ืชืืชืงืื ืคืขืืื ืจืืืช ืืชืืจืืื! |
| 126 | + |
| 127 | +ืืืื ืืช ืืชืจืืื ืฉืืื ืืฉืชืคื ืืืชื ืขื ืืืจืื ืืขืืงืืื ืืจื [ืืคืืืงืฆืืืช ื-Web](https://firstcontributions.github.io#social-share). |
| 128 | + |
| 129 | +### [ืืืืจ ื ืืกืฃ](../additional-material/git_workflow_scenarios/additional-material.md) |
| 130 | + |
| 131 | +## ืืืจืืืื ืืฉืืืืฉ ืืืืื ื ืืกืคืื |
| 132 | + |
| 133 | +[ืืืจื ืืืฃ ืืจืืฉื](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) |
| 134 | + |
| 135 | +</div> |
0 commit comments