Merge branch 'master' into rafa

shoaibrehmandanish · Oct 28, 2018 · b4993ac · b4993ac
2 parents a39e154 + 6a20289
commit b4993ac
Show file tree

Hide file tree

Showing 13 changed files with 966 additions and 93 deletions.
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
@@ -5,9 +5,7 @@ Welcome to your first contribution. :heart:
 #### Before Contributing:
 You need to run it locally on your desktop.
 
-In order to do that:
-
-Move to the desired location where package.json file is located
+In order to do that, move to the desired location where package.json file is located
 
 - Install npm(latest version) -
     npm is distributed with Node.js - which means that when you download Node.js,
@@ -17,12 +15,12 @@ Move to the desired location where package.json file is located
    Use this command:  `install npm`
 
 - Run these final commands to run it locally:
-
+  `npm install`
   `npm run build`
 
   `npm start`
 
-#### Table Of Contents
+### Table Of Contents
 - [Code of Conduct](#code-of-conduct)
 - [Translation Guide](#translation-guide)
 
@@ -34,7 +32,7 @@ If you want to contribute, you need to know a few things.
 ## Translation Guide
 We have some rules for translation. If you make the first translation for your language, you must add your language list on `Translations.md`.
 
-#### Example
+### Example
 
 `Translations.md`
 ```markdown

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -11,7 +11,7 @@ orientation.
 
 ## Our Standards
 
-Examples of behavior that contributes to creating a positive environment
+Examples of behaviour that contributes to creating a positive environment
 include:
 
 *   Using welcoming and inclusive language.

diff --git a/Contributors.md b/Contributors.md
diff --git a/README.md b/README.md
@@ -63,14 +63,14 @@ If you don't have git on your machine, [install it]( https://help.github.com/art
 
 ## Fork this repository
 
-Fork this repo by clicking on the fork button on the top of this page.
+Fork this repository by clicking on the fork button on the top of this page.
 This will create a copy of this repository in your account.
 
 ## Clone the repository
 
 <img align="right" width="300" src="assets/clone.png" alt="clone this repository" />
 
-Now clone the forked repo to your machine. Go to your GitHub account, open the forked repo, click on the clone button and then click the *copy to clipboard* icon.
+Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the clone button and then click the *copy to clipboard* icon.
 
 Open a terminal and run the following git command:
 

diff --git a/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md b/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md
@@ -1,6 +1,6 @@
 # Useful Links
 
-This document is dedicated to all the blog posts, helpful sites, tips and tricks websites that makes our lives easier. That we refer to for all our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more.
+This document is dedicated to all the tips and tricks websites, blog posts, and helpful sites that make our lives easier. They are a great reference to serve all of our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more.
 
 ## The List
 1.  [Interactive tutorial to git](https://try.github.io)

diff --git a/additional-material/git_workflow_scenarios/additional-material.md b/additional-material/git_workflow_scenarios/additional-material.md
@@ -1,6 +1,6 @@
 # Additional information
 
-We assume that you have already finished with the basic tutorial before coming here. The additional information will give you some information about advanced Git techniques.
+We assume that you have already finished with the basic tutorial before coming here. This document will give you some additional information about advanced Git techniques.
 
 ### [Amending a commit](amending-a-commit.md)
 This document provides information about how to amend a commit on the remote repository.
@@ -31,7 +31,7 @@ This document provides information about how to resolve merge conflicts.
 > Take these steps to resolve the annoying merge conflicts.
 
 ### [Reverting a commit](reverting-a-commit.md)
-This document provides information about how to revert a commit on the remote repository. It comes in handy in case for when you need to undo a commit that has already been pushed to Github.
+This document provides information about how to revert a commit on the remote repository. It will come in handy in case you need to undo a commit that has already been pushed to Github.
 > Take these steps if you want to reverse a commit.
 
 ### [Squashing Commits](squashing-commits.md)
@@ -43,4 +43,4 @@ This document provides information about how to undo a commit on your local repo
 > Take these steps if you want to undo/reset a local commit.
 
 ### [Useful Links](Useful-links-for-further-learning.md)
-This document is dedicated to all the blog posts, helpful sites, tips and tricks websites that makes our lives easier. That we refer to for all our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more.
+This document is dedicated to all the tips and tricks websites, blog posts, and helpful sites that make our lives easier. They are a great reference to serve all of our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more.
diff --git a/additional-material/translations/removing-a-file.ua.md b/additional-material/translations/removing-a-file.ua.md
@@ -0,0 +1,23 @@
+# Видалення файлу з-під GIT контролю
+
+Іноді може виникнути необхідність видалити файл з-під GIT контролю, але зберегти його на комп'ютері. Це може бути досягнуто за допомогою наступної команди:
+
+`` Git rm <файл> --cached``
+
+## Що ж сталося?
+
+GIT більш не контролює зміни у віддаленому файлі. З точки зору GIT'а, його немає, але якщо ви спробуєте локалізувати цей файл в файловій системі, то ви побачите, що він все ще на місці.
+
+Зауважте, що в наведеній вище комманде використовується ключ `--cached`. Якби ми не додали цей ключ, GIT знищив би файл не тільки зі сховищ, але також і з файлової системи.
+
+Якщо ви зробите Комміт за допомогою команди `git commit -m" Видалити file1.js "` і потім запущено його в віддалений репозиторій командою `git push origin master`, файл буде стертий також і з віддаленого сховища.
+
+## Додаткова інформація
+
+- Якщо ви хочете видалити більше одного файлу, це можна зробити, перерахувавши всі файли в одній команді:
+
+    `Git rm file1.js file2.js file3.js --cached`
+
+- Ви можете використовувати шаблон (*) для видалення файлів з близькими іменами, наприклад, якщо ви хочете видалити всі .txt файли з локального сховища, наберіть:
+
+    `Git rm * .txt --cached`
diff --git a/translations/README.bg.md b/translations/README.bg.md
@@ -0,0 +1,176 @@
+[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
+[<img align="right" width="150" src="assets/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY)
+[![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)
+
+
+# Първи стъпки
+
+Трудно е. Когато правиш нещо за пръв път винаги е трудно. Още повече, когато се работи съвместно с други хора. Затова решихме да опростим процеса на учене за новобранците в допринасянето към отворен софтуеър.
+
+Четенето на статии и гледането на видео уроци помага, но има ли по-добър учител от практиката в защитена среда? Целта на този проект е да напътства и опрости първите стъпки на новобранците в участието и приноса към отворен софтуеър. Ако искате да направите първата си контрибуция и да станете част от обществото на отворен софтуеър, следвайте стъпките по-долу.
+
+#### *Ако не се чувствате комфортно използвайки command line (терминал), [ето и уроци за използването на програми с графичен интерфейс]( #tutorials-using-other-tools )*
+
+#### *Можете да прочетете тази статия и на [други езици](translations/Translations.md).*
+
+[🇮🇳](translations/README.hi.md)
+[🇲🇲](translations/README.mm_unicode.md)
+[🇮🇩](translations/README.id.md)
+[🇫🇷](translations/README.fr.md)
+[🇪🇸](translations/README.es.md)
+[<img src="assets/catalan1.png" width="22">](translations/README.ca.md)
+[🇳🇱](translations/README.nl.md)
+[🇱🇹](translations/README.lt.md)
+[🇷🇺](translations/README.ru.md)
+[:slovakia:](translations/README.slk.md)
+[🇯🇵](translations/README.ja.md)
+[🇻🇳](translations/README.vn.md)
+[🇵🇱](translations/README.pl.md)
+[🇮🇷](translations/README.fa.md)
+[🇮🇷](translations/README.fa.en.md)
+[🇰🇷 🇰🇵](translations/README.ko.md)
+[🇩🇪](translations/README.de.md)
+[🇩🇰](translations/README.da.md)
+[🇨🇳](translations/README.chs.md)
+[🇹🇼](translations/README.cht.md)
+[🇬🇷](translations/README.gr.md)
+[🇪🇬](translations/README.eg.md)
+[🇸🇦](translations/README.ar.md)
+[🇺🇦](translations/README.ua.md)
+[🇧🇷](translations/README.pt_br.md)
+[🇵🇹](translations/README.pt-pt.md)
+[🇮🇹](translations/README.it.md)
+[🇹🇭](translations/README.th.md)
+[🏴](translations/README.gl.md)
+[🇵🇰](translations/README.ur.md)
+[:bangladesh:](translations/README.bn.md)
+[🇲🇩 🇷🇴](translations/README.ro.md)
+[🇹🇷](translations/README.tr.md)
+[🇸🇪](translations/README.se.md)
+[:slovenia:](translations/README.sl.md)
+[🇮🇱](translations/README.hb.md)
+[🇨🇿](translations/README.cs.md)
+[<img src="assets/pirate.png" width="22">](translations/README.en-pirate.md)
+[🇲🇽](translations/README.mx.md)
+
+
+
+<img align="right" width="300" src="assets/fork.png" alt="fork this repository" />
+
+Ако нямате git на вашия компютър, [инсталирайте го]( https://help.github.com/articles/set-up-git/).
+
+## Направете Разклонение (Fork) на това хранилище (repository)
+
+Направете разклонение на хранилището като натиснете бутона "Fork" в горната част на тази страница.
+Това ще направи копие на това хранилище във вашия GitHub профил.
+
+## Клонирайте това хранилище
+
+<img align="right" width="300" src="assets/clone.png" alt="clone this repository" />
+
+Сега клонирайте локално на вашия компютър разклоненото хранилище. Отидете във вашия GitHub профил, отворете разклоненото хранилище,
+кликнете на бутона 'Clone' и копирайте линка или натиснете иконката 'copy to clipboard' (копирай в клипборда).
+
+Отворете терминал и въведете следната команда
+
+```
+git clone "линка който току-що копирахте"
+```
+като на мястото на  "URL-а който току-що копирахте" (без кавичките) поставете линка към това хранилище (Вашето Разклонение на този проект). Вижте
+предните стъпки за това как да се сдобиете с линка.
+<img align="right" width="300" src="assets/copy-to-clipboard.png" alt="copy URL to clipboard" />
+
+Например:
+```
+git clone https://github.com/this-is-you/first-contributions.git
+```
+Като на мястото на `this-is-you` се намира вашето потребителско име. В тази стъпка вие направихте копие на съдържанието на GitHub хванилището на 'first contributions' във вашия компютър.
+
+## Създайте клон (branch)
+
+Стигнете до местоположението във вашия компютър, където копирахте хранилището (ако вече не се намирате там):
+
+```
+cd first-contributions
+```
+Сега създайте клон използвайки командата `git checkout`:
+```
+git checkout -b <add-your-new-branch-name>
+```
+
+Например:
+```
+git checkout -b add-alonzo-church
+```
+(Името на клона не е задължително да съдържа думата *add*, но е препоръчително, защото целта на този клон е да добавите името си към списък.)
+
+## Направете нужните промени и ги commit-нете
+
+Сега отворете файла `Contributors.md` в текстов редактор и добавете името си вн его. Не го добавяйте в началото или края на файла. Поставете го някъде посредата. Сега запазете промените.
+
+<img align="right" width="450" src="assets/git-status.png" alt="git status" />
+
+
+Ако навигирате през терминала до директорията на проекта и въведете командата `git status`, ще видите че има променени файлове.
+
+
+ДОбавете тези промени към клона, който създадохте, използвайки командата `git add`:
+
+```
+git add Contributors.md
+```
+
+Сега commit-нете тези промени с командата `git commit`:
+```
+git commit -m "Add <your-name> to Contributors list"
+```
+като смените `<your-name>` с вашето име.
+
+## Качете (Push) промените в GitHub
+
+Качете вашите промени като въведете командата `git push`:
+```
+git push origin <add-your-branch-name>
+```
+сменяйки `<add-your-branch-name>` с името на клона, който създадохте по-рано.
+
+## Предайте вашите промени за рецензия
+
+Ако отидете във вашето хранилище в GitHub, ще видите бутона  `Compare & pull request`. Натиснете го.
+
+<img style="float: right;" src="assets/compare-and-pull.png" alt="create a pull request" />
+
+Сега предайте вашите промени за рецензия.
+
+<img style="float: right;" src="assets/submit-pull-request.png" alt="submit pull request" />
+
+Скоро аз ще слея (merge) всички ваши промени в главния клон (мастер branch) на този проект. Вие ще бъдете уведомени по електронната поща когато това се случи.
+
+## От тук накъде?
+
+Поздравления!  Вие току що изпълнихте стандарните _fork -> clone -> edit -> PR_ операции, които ще срещнете като сътрудник!
+
+Отпразнувайте вашия принос и го споделете с приятели и последователи като посетите [уеб приложението](https://roshanjossey.github.io/first-contributions/#social-share).
+
+Можете да се присъедините към нашия slack team в случай, че имате допълнителни въпроси или нужда от помощ [Присъединете се към slack team](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY).
+
+Време да започнете да допринасяте и към други приекти. Ние сме съставили списък с проекти съдържащи лесни проблеми, които са лесни за начало. Проверете  [списъка от приекти в уеб приложението](https://roshanjossey.github.io/first-contributions/#project-list).
+
+### [Допълнителни материали](additional-material/git_workflow_scenarios/additional-material.md)
+
+
+## Уроци за иползването на други приложения
+
+|<a href="github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a>|<a href="github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://www.visualstudio.com/wp-content/uploads/2017/11/microsoft-visual-studio.svg" width="100"></a>|<a href="gitkraken-tutorial.md"><img alt="GitKraken" src="/assets/gk-icon.png" width="100"></a>|<a href="github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a>|
+|---|---|---|---|
+|[GitHub Desktop](github-desktop-tutorial.md)|[Visual Studio 2017](github-windows-vs2017-tutorial.md)|[GitKraken](gitkraken-tutorial.md)|[Visual Studio Code](github-windows-vs-code-tutorial.md)|
+
+## Реклама
+
+Ако този проект ви хареса, хасайте го в [GitHub](https://github.com/Roshanjossey/first-contributions).
+Ако сме ви харесали изключително много, последвайте [Roshan](https://roshanjossey.github.io/) в
+[Twitter](https://twitter.com/sudo__bangbang) и
+[GitHub](https://github.com/roshanjossey).
+
+<a href="http://saasgrids.com"> <img alt="https://app.saasgrids.com" src="assets/saasgrids-banner.png" width="500"></a>