diff --git a/docs/translations/README.sa.md b/docs/translations/README.sa.md new file mode 100644 index 00000000..7a88911f --- /dev/null +++ b/docs/translations/README.sa.md @@ -0,0 +1,169 @@ +[![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) +[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) +[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) + + +# प्रथमः योगदानः (First Contributions) + +एषः परियोजनः नूतनानां योगदानकर्तṝणां कृते प्रथमं योगदानं सरलतया कर्तुं मार्गदर्शनं च यच्छति। यदि त्वं प्रथमं योगदानं कर्तुं इच्छसि, अधोलिखितान् चरणान् अनुसर। + +_यदि त्वं आदेशपङ्क्त्या (command line) सह सुखं न अनुभवसि, तर्हि [GUI उपकरणं उपयुज्य एते मार्गदर्शकाः सन्ति।](#tutorials-using-other-tools)_ + +fork this repository + +#### यदि ते संगणके git अस्ति न चेत्, [तत् स्थापय।](https://docs.github.com/en/get-started/quickstart/set-up-git) + +## एतत् भण्डारं (repository) फोर्क् कुरु + +पृष्ठस्य उपरिस्थे फोर्क् (fork) बटनं नुद। +एवं कृत्वा एषः भण्डारः तव GitHub खातायाम् प्रतिलिपिरूपेण रच्यते। + +## भण्डारं क्लोनं कुरु + +clone this repository + +GitHub गत्वा, स्वीयं फोर्क्-भण्डारं उद्घाट्य, ‘Code’ बटनं नुद। ततः SSH चयनं कृत्वा ‘copy URL to clipboard’ चिह्नं नुद। + +पश्चात् टर्मिनल् उद्घाट्य, एषः आदेशः प्रयोज्यः — + +```bash +git clone "url you just copied" +``` + +yatra "url you just copied" (चिन्हविना) अस्ति, सः एषः भण्डारस्य url (तव fork कृत परियोजनायाः)। पूर्वं निर्दिष्टं चरणं पश्य। + +copy URL to clipboard + +उदाहरणार्थ — + +```bash +git clone git@github.com:this-is-you/first-contributions.git +``` + +`this-is-you` इत्येतत् तव `GitHub` उपयोगकर्तृनाम (username) अस्ति। अत्र त्वं `GitHub` स्थित `first-contributions` नामकस्य भण्डारस्य सामग्रीं स्वयम् यन्त्रे अनुकलयसि। + +## शाखां (branch) रचय + +स्वयम् यन्त्रे भण्डारस्य निर्देशिकायाम् प्रवेशं कुरु (यदि तत्र पूर्वमेव न स्थितः)। + +```bash +cd first-contributions +``` +इदानीं `git switch` आदेशं उपयुज्य शाखां निर्मारय। + +```bash +git switch -c your-new-branch-name +``` + +उदाहरणतः — + +```bash +git switch -c add-alonzo-church +``` + +
+यदि git switch कार्यं न करोति, तर्हि एतत् प्रयोज्यं: + +यदि एषः दोषसन्देशः दृश्यते— "Git: switch git-आदेशः नास्ति। git –help पश्य।", तर्हि सम्भवतः त्वं git-नामकस्य पुरातन-संस्करणं उपयोगसि। + +एतादृशे स्थितौ git checkout इत्ययं आदेशः प्रयुज्यताम्। + +```bash +git checkout -b your-new-branch-name +``` + +
+ +## परिवर्तनं कुरु च commit अपि कुरु + +इदानीं `Contributors.md` नामकं सञ्चिकां पाठसम्पादके उद्घाटय। तत्र स्वस्य नाम योजय। सञ्चिकायाः आरम्भे वा अन्ते च नाम न योजय। मध्ये कतरेषु अपि योजय। अनन्तरं तां सञ्चिकां संरक्षय। + +git status + +यदि त्वं परियोजनायाः निर्देशिकायां गत्वा `git status` आदेशं प्रवर्तयसि, तर्हि परिवर्तनानि दृश्यन्ते। + +git add आदेशं उपयुज्य त्वया नूतनया निर्मिता शाखा यत्र, तत्र एतानि परिवर्तनानि योजय। + +```bash +git add Contributors.md +``` + +इदानीं `git commit` आदेशं उपयुज्य एतानि परिवर्तनानि सङ्ग्रहीतुं `commit` कुरु। + +```bash +git commit -m "Add your-name to Contributors list" +``` + +`your-name` इत्येतत् स्वनाम्ना परिवर्तय। + +## GitHub इत्यत्र परिवर्तनं प्रेषय + +git push आदेशं उपयुज्य स्वीयं परिवर्तनं GitHub इत्यत्र प्रेषय। + +```bash +git push -u origin your-branch-name +``` + +`your-branch-name` इत्येतत् पूर्वं त्वया निर्मितायाः शाखायाः नाम्ना परिवर्तय। + +
+यदि push समये दोषः जायते तर्हि: + +- ### प्रमाणीकरण-दोषः (Authentication Error) + 
remote: कूटशब्द-आधारित प्रमाणीकरणस्य समर्थनं 2021 अगस्त् 13 दिनाङ्के निष्कासितम्। कृपया तस्य स्थाने personal access token उपयुज्यताम्।
+  remote: अधिकविवरणाय https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ पश्यतु।
+  fatal: 'https://github.com//first-contributions.git/' इत्यत्र प्रमाणीकरणं असफलम्।
+ स्वखाते SSH key निर्माणं तथा विन्यासं कर्तुं [GitHub इत्यस्य शिक्षणं](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) पश्य। + + अपि च, त्वं 'git remote -v' इत्येतं आदेशं प्रवर्तयन् स्वस्य remote address ज्ञातुं इच्छेयाः। + + यदि एषः परिणामः दृश्यते— + 
origin	https://github.com/your-username/your_repo.git (fetch)
+  origin	https://github.com/your-username/your_repo.git (push)
+ + तर्हि एतेन आदेशेन तं परिवर्तय: +```bash +git remote set-url origin git@github.com:your-username/your_repo.git +``` + अन्यथा त्वं पुनः username तथा च password प्रवेशयितुं प्रेरितः भविष्यसि, तथा च प्रमाणीकरण-दोषः अपि प्राप्तः भविष्यति। +
+ +## समीक्षायै परिवर्तनं समर्पय + +यदि त्वं स्वं GitHub भण्डारं गच्छसि, तर्हि `Compare & pull request` इत्यः बटनः दृष्टव्यः भविष्यति। तं बटनं नुद। + +create a pull request + +तदनन्तरं pull request समर्पय। + +submit pull request + +शीघ्रं अहं तव सर्वाणि परिवर्तनानि अस्य परियोजनायाः मुख्यशाखायां संयोजयिष्यामि। यदा ते परिवर्तनानि संयोजितानि भविष्यन्ति, तदा तव इमेल्-पत्रे एकं सूचना-सन्देशं लप्स्यसे। + +## इतः परं कुत्र गन्तव्यम्? + +साधु! त्वं सफलतया सामान्यं _fork → clone → edit → pull request_ इत्येतत् कार्यप्रवाहं पूर्णीकृतवान् यं योगदानकर्तृभिः प्रायः अनुभवते। + +स्वीयं योगदानं उत्सवेन चिनोतु च स्वमित्रैः अनुयायिभिश्च सह साझां कुरु [web app](https://firstcontributions.github.io/#social-share) इत्यत्र गत्वा। + +यदि त्वं अधिकं अभ्यासं कर्तुम् इच्छसि, तर्हि [code contributions](https://github.com/roshanjossey/code-contributions) इत्येतत् पश्य। + +अद्य वयं त्वां अन्येषु परियोजनासु योगदानं कर्तुं आरब्धुं सज्जीकरोमः। वयं सरलैः समस्याभिः युक्तानां परियोजनानां सूचीं सङ्कलितवन्तः। +[web app इत्यस्य परियोजना-सूची](https://firstcontributions.github.io/#project-list) अपि पश्य। + + +### [अधिकवस्तु](docs/additional-material/git_workflow_scenarios/additional-material.md) + +## दृश्योपकरणं उपयोग्य शिक्षणम् + +| GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + +| [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) | + +

एषः परियोजनः एतेन समर्थितः अस्ति:

+

+ + + +

\ No newline at end of file