Joomla! Documentation - User contributions [en]

User:Cronolio

2018-06-11T21:47:39Z

Cronolio: Blanked the page

Administration of a Plugin in Joomla/ru

2018-06-09T16:24:01Z

Cronolio:

<noinclude><languages /></noinclude>
Плагины являются одним из пяти [типов] [[S:MyLanguage/extensions|расширений]] ядра системы Joomla! ([[S:MyLanguage/Components|Компоненты]], [[S:MyLanguage/Modules|модули]], [[S:MyLanguage/Plugins|плагины]], [[S:MyLanguage/Template|шаблоны]] и [[S:MyLanguage/Languages|языки]]) и используется для добавления функционала, которое отсутствует в шаблоне. Таким образом, плагин добавляет функции в какой-либо компонент или модуль.

Например, плагин (такой как плагин профиля пользователя) может добавить в какой-либо компонент дополнительную веб-форму, добавить горячие клавиши для ссылок или другой код (как плагин 'BBCode Parser') или даже придать более расширенный функционал, вроде дополнительного метода аутентификации (например, возможность входить на сайт через соцсеть Facebook).

==Установка плагина==
Плагины устанавливаются также, как и другие [типы] расширений (шаблоны, компоненты, модули и языки). Для того чтобы [подробнее] узнать как устанавливать расширения, познакомьтесь, пожалуйста с [соответствующей вики] [[S:MyLanguage/Installing_an_extension|Установка расширений]].

==Изменение параметров плагинов==
Многие плагины обладают параметрами, которые позволяют Вам индивидуально подстраивать их функционал без изменения кода. Мы рассмотрим некоторые из таких характеристик. В административной панели Joomla пройдите в менеджер плагинов: "'''Расширения'''" -> "'''Менеджер плагинов'''". Теперь Вы увидите список всех имеющихся на Вашем веб-сайте плагинов. Для просмотра информации о том, что Вы можете делать на этой административной странице, щелкните на кнопку ''Справка''.

===Плагин навигации по странице===
В этом случае мы посетим плагин [навигации по странице] "Content - Page Navigation". Этот конкретный плагин позволит Вам добавлять в создаваемые компонентом содержимого материалы формат таблицы содержимого. Щелкая на начальные опции Вы можете увидеть, что для этого плагина существуют два параметра. Один выбирает показывать ли таблицу содержимого над главным текстом или под ним, в то время как второй позволяет Вам выбирать быть ли этой позиции над заголовком материала и его другими данными (при показе материала полностью), сразу над главным текстом.

Все что у нас здесь есть - это две простые опции в выпадающем списке. Которые мы можем выбрать и затем нажать [на кнопку] "Сохранить" на панели инструментов и сохранить эту конфигурацию.

==Полный список плагинов ядра и параметров==
Для [просмотра] полного списка плагинов и имеющихся в них параметров откройте на странице редактирования какого-либо плагина экран документации и щелкните на кнопку "Справка". Альтернативно, Вы можете просмотреть плагины ядра:
* Для J3.x, смотрите [[S:MyLanguage/{{RVer|Help}}:Extensions_Plugin_Manager_Edit|{{RVer}} Расширения - Менеджер плагинов - Изменить]]
* Для J2.5, смотрите [[S:MyLanguage/Help25:Extensions_Plugin_Manager_Edit|J2.5 Расширения - Менеджер плагинов - Изменить]]

<noinclude>
[[Category:Plugin Management/ru|Управление плагинами]]
</noinclude>

Translations:Administration of a Plugin in Joomla/2/ru

2018-06-09T16:24:01Z

Cronolio:

==Установка плагина==
Плагины устанавливаются также, как и другие [типы] расширений (шаблоны, компоненты, модули и языки). Для того чтобы [подробнее] узнать как устанавливать расширения, познакомьтесь, пожалуйста с [соответствующей вики] [[S:MyLanguage/Installing_an_extension|Установка расширений]].

Administration of a Plugin in Joomla/ru

2018-06-09T16:23:40Z

Cronolio:

<noinclude><languages /></noinclude>
Плагины являются одним из пяти [типов] [[S:MyLanguage/extensions|расширений]] ядра системы Joomla! ([[S:MyLanguage/Components|Компоненты]], [[S:MyLanguage/Modules|модули]], [[S:MyLanguage/Plugins|плагины]], [[S:MyLanguage/Template|шаблоны]] и [[S:MyLanguage/Languages|языки]]) и используется для добавления функционала, которое отсутствует в шаблоне. Таким образом, плагин добавляет функции в какой-либо компонент или модуль.

Например, плагин (такой как плагин профиля пользователя) может добавить в какой-либо компонент дополнительную веб-форму, добавить горячие клавиши для ссылок или другой код (как плагин 'BBCode Parser') или даже придать более расширенный функционал, вроде дополнительного метода аутентификации (например, возможность входить на сайт через соцсеть Facebook).

==Установка плагина==
Плагины устанавливаются также, как и другие [типы] расширений (шаблоны, компоненты, модули и языки). Для того чтобы [подробнее] узнать как устанавливать расширения, познакомтесь, пожалуйста с [соответствующей вики] [[S:MyLanguage/Installing_an_extension|Установка расширений]].

==Изменение параметров плагинов==
Многие плагины обладают параметрами, которые позволяют Вам индивидуально подстраивать их функционал без изменения кода. Мы рассмотрим некоторые из таких характеристик. В административной панели Joomla пройдите в менеджер плагинов: "'''Расширения'''" -> "'''Менеджер плагинов'''". Теперь Вы увидите список всех имеющихся на Вашем веб-сайте плагинов. Для просмотра информации о том, что Вы можете делать на этой административной странице, щелкните на кнопку ''Справка''.

===Плагин навигации по странице===
В этом случае мы посетим плагин [навигации по странице] "Content - Page Navigation". Этот конкретный плагин позволит Вам добавлять в создаваемые компонентом содержимого материалы формат таблицы содержимого. Щелкая на начальные опции Вы можете увидеть, что для этого плагина существуют два параметра. Один выбирает показывать ли таблицу содержимого над главным текстом или под ним, в то время как второй позволяет Вам выбирать быть ли этой позиции над заголовком материала и его другими данными (при показе материала полностью), сразу над главным текстом.

Все что у нас здесь есть - это две простые опции в выпадающем списке. Которые мы можем выбрать и затем нажать [на кнопку] "Сохранить" на панели инструментов и сохранить эту конфигурацию.

==Полный список плагинов ядра и параметров==
Для [просмотра] полного списка плагинов и имеющихся в них параметров откройте на странице редактирования какого-либо плагина экран документации и щелкните на кнопку "Справка". Альтернативно, Вы можете просмотреть плагины ядра:
* Для J3.x, смотрите [[S:MyLanguage/{{RVer|Help}}:Extensions_Plugin_Manager_Edit|{{RVer}} Расширения - Менеджер плагинов - Изменить]]
* Для J2.5, смотрите [[S:MyLanguage/Help25:Extensions_Plugin_Manager_Edit|J2.5 Расширения - Менеджер плагинов - Изменить]]

<noinclude>
[[Category:Plugin Management/ru|Управление плагинами]]
</noinclude>

Translations:Administration of a Plugin in Joomla/1/ru

2018-06-09T16:23:39Z

Cronolio:

Плагины являются одним из пяти [типов] [[S:MyLanguage/extensions|расширений]] ядра системы Joomla! ([[S:MyLanguage/Components|Компоненты]], [[S:MyLanguage/Modules|модули]], [[S:MyLanguage/Plugins|плагины]], [[S:MyLanguage/Template|шаблоны]] и [[S:MyLanguage/Languages|языки]]) и используется для добавления функционала, которое отсутствует в шаблоне. Таким образом, плагин добавляет функции в какой-либо компонент или модуль.

Например, плагин (такой как плагин профиля пользователя) может добавить в какой-либо компонент дополнительную веб-форму, добавить горячие клавиши для ссылок или другой код (как плагин 'BBCode Parser') или даже придать более расширенный функционал, вроде дополнительного метода аутентификации (например, возможность входить на сайт через соцсеть Facebook).

Working with git and github

2018-05-30T13:42:00Z

Cronolio:

<noinclude><languages /></noinclude>

<translate>
= Intro = 
</translate>
<translate>
This document will provide information about contributing to the Joomla! CMS with help of Git and GitHub. If you like to made a simple change (one file only), it is easier to use this documentation: [[S:MyLanguage/Using the Github UI to Make Pull Requests|Using the Github UI to Make Pull Requests]]
If you like to add more complex changes or you're just interested in this, keep reading!</translate>

<translate>
== What are Git and GitHub? == 
</translate>

<translate>
Git is a distributed version control system. It is a system that records changes in files and keeps these changes in a history file. You can always look back to an earlier version of your code and restore changes if you like. Because of the history archive, Git is very useful when you work with many people together on the same project.</translate>

<translate>
Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.</translate>

<translate>
Joomla! uses GitHub and Git to maintain its code. Everyone can contribute Joomla! software. The URL to the Joomla! CMS Project on GitHub is: https://github.com/joomla/joomla-cms</translate>

<translate>

= Getting Started = 
</translate>
<translate>
== Sign up on GitHub and install Git == 
</translate>
<translate>
First, you will need to register at [http://www.github.com GitHub]. It's free and easy to do. Just follow the provided steps.</translate>

<translate>
One we are signed up, we need to install Git. The latest version of Git can be found on http://git-scm.com. Download and open the installer. Git is an CLI (Command Line Interface) program. At the start this can be confusing and a bit scary but this document will lead you through the process.</translate>

<translate>
If you're not an advanced user, just run the installer and press the "next" buttons until the program is installed. Git won't damage your system. Later you can remove it just like any other program if you like.</translate>

<translate>
Once we installed Git, we open the program called "Git Bash". A command line will be opened. We're going to tell Git our name and email address. Git will use this information when we contribute to a project.</translate>
<translate>
With the following commands we give Git that information:</translate>

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

<translate>
In the above commands, and all other commands given in this documentation, each line is a new command. So you type the fist line, press enter and then type the second line and press enter.</translate>

<translate>
We are now ready to use Git and go farther with setting up our test installation.</translate>

<translate>

=Setting up a test installation= 
</translate>
<translate>
For our test installation we need a Web server program so that we can install and run Joomla! on our computer. There are a lot of programs that can do that such as [https://www.mamp.info/ MAMP] and [https://www.apachefriends.org/ XAMPP]. Download an install one of them.</translate>

<translate>
After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.</translate>

<translate>
== Fork and Clone Joomla! == 
</translate>
<translate>
On GitHub you can find projects, so called Repositories. Inside a project you might find several versions. Such a version is called a Branch. Joomla! has the following branches:</translate>
<translate>
* '''Staging:''' This branch contains the latest bug fixes and new features of Joomla!</translate>
<translate>
* '''Master:''' This branch is the current stable version of Joomla!</translate>
<translate>
* '''3.5-dev''' This branch contains the files for Joomla! 3.5, which is not stable at this writing.</translate>

<translate>
On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.</translate>
<translate>
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.</translate>
<translate>
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.</translate>
[[File:Github-fork-button.png|none]]

<translate>
After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.</translate>

<translate>
Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.</translate>

<source>
git clone https://github.com/username/joomla-cms.git
</source>

<translate>
For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.</translate>

<translate>
Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.</translate>

<translate>
== Install Joomla! == 
</translate>
<translate>
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.</translate>

<translate>
For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.</translate>

<translate>
The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.</translate>
<translate>

=Make Your Changes= 
</translate>
<translate>
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.</translate>

<translate>
If you made a mistake or you would like to restore a file, use this command:</translate>

<source>
git checkout path/to/file
</source>

<translate>
If you like to remove all changes you made, use the following commands:</translate>

<source>
git checkout .
git clean -f -d
</source>

<translate>
The first command resets all files. The second command removes untracked files and folders.</translate>

<translate>
==Publish Our Changes on GitHub== 
</translate>
<translate>

=Push the Change to the Fork= 
</translate>
<translate>
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.</translate>

<translate>
Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.</translate>

<translate>
So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).</translate>

<source>
git checkout -b name-new-branch
</source>

<translate>
The next command tells git that all made changes are good, and are ready to commit.</translate>

<source>
git add --all
</source>

<translate>
The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.</translate>

<source>
git commit -m "description"
</source>

<translate>
The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.</translate>

<source>
git push origin name-new-branch
</source>

<translate>
==Compare Forks and Make a Pull Request== 
</translate>
<translate>
After pushing our change to GitHub, go to your fork of the Joomla! CMS.</translate>
<translate>

=Extra information= 
</translate>
<translate>
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:</translate>

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

<translate>
We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:</translate>

<source>
git pull upstream staging
</source>

<translate>
The changes are now only made on our local fork. To upload them to GitHub use the following command:</translate>

<source>
git push
</source>

<noinclude>
<translate>

[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</translate>
</noinclude>

Working with git and github/ru

2018-05-30T13:40:53Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажимайте кнопку "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать ваш форк в обновленном состоянии. Можно сделать это добавив для своего проекта удаленный репозиторий:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в вашем форке. Если он найдет какие-либо, он добавит их в ваш форк:

<source>
git pull upstream staging
</source>

На данный момент изменения сделаны только в вашем локальном форке. Используйте следующую команду, чтобы загрузить их на GitHub:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/11/ru

2018-05-30T13:40:52Z

Cronolio:

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажимайте кнопку "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

Working with git and github/ru

2018-05-30T13:38:37Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать ваш форк в обновленном состоянии. Можно сделать это добавив для своего проекта удаленный репозиторий:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в вашем форке. Если он найдет какие-либо, он добавит их в ваш форк:

<source>
git pull upstream staging
</source>

На данный момент изменения сделаны только в вашем локальном форке. Используйте следующую команду, чтобы загрузить их на GitHub:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/51/ru

2018-05-30T13:38:37Z

Cronolio:

Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать ваш форк в обновленном состоянии. Можно сделать это добавив для своего проекта удаленный репозиторий:

Working with git and github/ru

2018-05-30T13:37:32Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную репозиторий для своего проекта:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в вашем форке. Если он найдет какие-либо, он добавит их в ваш форк:

<source>
git pull upstream staging
</source>

На данный момент изменения сделаны только в вашем локальном форке. Используйте следующую команду, чтобы загрузить их на GitHub:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/52/ru

2018-05-30T13:37:32Z

Cronolio:

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в вашем форке. Если он найдет какие-либо, он добавит их в ваш форк:

Working with git and github/ru

2018-05-30T13:35:34Z

Cronolio: Created page with "На данный момент изменения сделаны только в вашем локальном форке. Используйте следующую коман..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную репозиторий для своего проекта:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в нашем форке. Если он найдет какие-либо, он добавит их в наш форк:

<source>
git pull upstream staging
</source>

На данный момент изменения сделаны только в вашем локальном форке. Используйте следующую команду, чтобы загрузить их на GitHub:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/53/ru

2018-05-30T13:35:34Z

На данный момент изменения сделаны только в вашем локальном форке. Используйте следующую команду, чтобы загрузить их на GitHub:

Working with git and github/ru

2018-05-30T13:33:17Z

Cronolio: Created page with "Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы с..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную репозиторий для своего проекта:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в нашем форке. Если он найдет какие-либо, он добавит их в наш форк:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/52/ru

2018-05-30T13:33:16Z

Теперь мы добавили удаленный репозиторий под названием "upstream". Используя следующую команду мы скажем Git искать новые изменения (коммиты) в ветке staging, которых еще нет в нашем форке. Если он найдет какие-либо, он добавит их в наш форк:

Working with git and github/ru

2018-05-30T13:29:47Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную репозиторий для своего проекта:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/51/ru

2018-05-30T13:29:47Z

Cronolio:

Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную репозиторий для своего проекта:

Working with git and github/ru

2018-05-30T13:28:58Z

Cronolio: Created page with "Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную ветку для своего проекта:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/51/ru

2018-05-30T13:28:58Z

Так как staging версия Joomla! может изменится в любой момент, будет полезно иметь возможность держать в обновленном состоянии ваш форк. Можно сделать это добавив удаленную ветку для своего проекта:

Working with git and github/ru

2018-05-30T13:09:24Z

Cronolio: Created page with "Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохр..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/36/ru

2018-05-30T13:09:24Z

Теперь настало время сделать свои изменения в Joomla! Все изменения, которые вы делаете, будут сохранятся в Git. В любой момент вы можете ввести команду <tt>git status</tt>, чтобы увидеть какие файлы изменены или не отслеживаются. Не отслеживается значит файл в данном месте новые для Git.

Working with git and github/ru

2018-05-30T13:05:12Z

Cronolio: Created page with "Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтоб..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/34/ru

2018-05-30T13:05:11Z

Последнее отличие в последнем шаге установки. Обычно мы должны удалить установочную папку чтобы перейти к back-end (административной части) или front-end (внешнему интерфейсу веб-сайта) Joomla! Для тестовой установки мы можем пропустить эту часть и перейти непосредственно к back-end или front-end. Не удаляйте установочную папку. Она может быть очень полезной когда вы будете устанавливать Joomla снова.

Working with git and github/ru

2018-05-30T12:57:52Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/32/ru

2018-05-30T12:57:52Z

Cronolio:

Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только два небольших отличия.

Working with git and github/ru

2018-05-30T12:57:15Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только две небольшие разницы.

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/33/ru

2018-05-30T12:57:15Z

Cronolio:

В настройках базы данных имя пользователя и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Working with git and github/ru

2018-05-30T12:56:20Z

Cronolio: Created page with "В настройках базы данной пароль и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а па..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только две небольшие разницы.

В настройках базы данной пароль и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/33/ru

2018-05-30T12:56:20Z

В настройках базы данной пароль и пароль по умолчанию. Чаще всего имя пользователя <tt>root</tt>, а пароль или также <tt>root</tt> или нет пароля. Если вы все еще не можете подключится к базе данных, то поищите имя пользователя и пароль в руководство для используемого веб-сервера.

Working with git and github/ru

2018-05-30T12:45:59Z

Cronolio: Created page with "Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установ..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только две небольшие разницы.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/32/ru

2018-05-30T12:45:59Z

Установка Joomla! для нашей локальной тестовой установки в основном такая же как и обычная установка. Есть только две небольшие разницы.

User:Cronolio

2018-05-29T12:27:40Z

Cronolio:

[https://docs.joomla.org/index.php?title=Special%3ALanguageStats&x=D&language=ru&group=page-Chunk30%3AHelp+screen+column+header+Search+Term stat]

https://docs.joomla.org/Working_with_git_and_github/ru

Working with git and github/ru

2018-05-29T12:26:09Z

Cronolio: Created page with "Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/39/ru

2018-05-29T12:26:08Z

Cronolio: Created page with "Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки."

Первая команда сбрасывает все файлы. Вторая команда удаляет неотслеживаемые файлы и папки.

Working with git and github/ru

2018-05-29T12:24:45Z

Cronolio: Created page with "Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:"

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/38/ru

2018-05-29T12:24:45Z

Cronolio: Created page with "Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:"

Если вы хотите удалить все изменения которые вы сделали, используйте следующие команды:

Working with git and github/ru

2018-05-29T12:23:33Z

Cronolio: Created page with "Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:"

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/37/ru

2018-05-29T12:23:33Z

Cronolio: Created page with "Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:"

Если вы сделали ошибку или хотите восстановить файл, используйте следующую команду:

Working with git and github/ru

2018-05-29T12:19:36Z

Cronolio: Created page with "На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете на..."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

If you made a mistake or you would like to restore a file, use this command:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/20/ru

2018-05-29T12:19:35Z

На GitHub вы можете найти проекты, так называемые репозитории (repositories). Внутри проекта вы можете найти несколько версий. Такие версии называются ветками (branch). В Joomla! есть следующие ветки:

Working with git and github/ru

2018-05-29T12:03:12Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
On GitHub you can find projects, so called Repositories. Inside a project you might find several versions. Such a version is called a Branch. Joomla! has the following branches:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

If you made a mistake or you would like to restore a file, use this command:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/2/ru

2018-05-29T12:03:11Z

Cronolio:

Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]].
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

Working with git and github/ru

2018-05-29T11:55:41Z

Cronolio:

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]]
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
On GitHub you can find projects, so called Repositories. Inside a project you might find several versions. Such a version is called a Branch. Joomla! has the following branches:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

If you made a mistake or you would like to restore a file, use this command:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация своих изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/40/ru

2018-05-29T11:55:41Z

Cronolio:

==Публикация своих изменений на GitHub==

Working with git and github/ru

2018-05-29T11:55:32Z

Cronolio: Created page with "=Делаем свои изменения="

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]]
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
On GitHub you can find projects, so called Repositories. Inside a project you might find several versions. Such a version is called a Branch. Joomla! has the following branches:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Делаем свои изменения=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

If you made a mistake or you would like to restore a file, use this command:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация наших изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/35/ru

2018-05-29T11:55:32Z

Cronolio: Created page with "=Делаем свои изменения="

=Делаем свои изменения=

Working with git and github/ru

2018-05-29T11:55:06Z

Cronolio: Created page with "==Публикация наших изменений на GitHub=="

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]]
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
On GitHub you can find projects, so called Repositories. Inside a project you might find several versions. Such a version is called a Branch. Joomla! has the following branches:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Make Your Changes=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

If you made a mistake or you would like to restore a file, use this command:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Публикация наших изменений на GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>

Translations:Working with git and github/40/ru

2018-05-29T11:55:05Z

Cronolio: Created page with "==Публикация наших изменений на GitHub=="

==Публикация наших изменений на GitHub==

Working with git and github/ru

2018-05-29T11:51:19Z

Cronolio: Created page with "* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи."

<noinclude><languages /></noinclude>

= Вступление =
Этот документ предоставит информацию о том, как сделать вклад в Joomla! CMS с помощью Git и GitHub. Если вы хотите сделать простое изменение (только в одном файле), то это проще сделать с помощью этой документации: [[S:MyLanguage/Using the Github UI to Make Pull Requests|использование пользовательского интерфейса (UI) Github для создания pull request]]
Если вы хотите сделать более комплексные изменения или вам это просто интересно, то продолжайте читать!

== Что такое Git и GitHub? ==

Git это распределенная система контроля версий. Эта система записывает изменения в файл и хранит эти изменения в файле истории. Вы всегда можете взглянуть назад на старые версии вашего кода и восстановить их если требуется. Так как история записывается, Git очень полезен, когда вы работаете вместе с множеством людей над одним проектом.

Here is how GitHub can be used. [https://www.github.com GitHub] is an website that helps manage Git Projects in a visual way. As owner of a project you can change the code and compare different versions. As a user of the project you can contribute by making a Pull Requests. A pull request is a request to the owner to pull some code into the project. You're offering a piece of code (perhaps a solution for a bug) and asking if the Project owner would like to use it. If the owner likes it, he can merge (add) it to his project.

Joomla! использует GitHub и Git для управления кодом. Каждый может вносить вклад в программное обеспечение Joomla! Ссылка проекта Joomla! CMS на GitHub: https://github.com/joomla/joomla-cms

= Начинаем =
== Регистрация на GitHub и установка Git ==
Сперва необходимо зарегистрироваться на [http://www.github.com GitHub]. Это бесплатно и легко сделать. Просто следуйте предоставляемым инструкциям.

После регистрации необходимо установить Git. Последнюю версию Git можно найти здесь http://git-scm.com. Загрузите и откройте установщик. Git — это программа для CLI (Command Line Interface (интерфейс командной строки)). В начале может казаться всё запутанным или может быть немного страшно, но этот документ проведет вас через весь процесс.

Если вы не продвинутый пользователь, тогда просто запустите установщик и нажмите кнопки "next" пока программа не будет установлена. Git не повредит вашу систему. Позже, если захотите, то сможете удалить его как и любую другую программу.

После установки Git, запустите программу под названием "Git Bash". Откроется командная строка. Сообщите Git своё имя (ник) и адрес электронной почты. Git будет использовать эту информацию, когда вы будете вносить вклад в проект.
С помощью следующих команд мы дадим эту информацию Git:

<source>
git config --global user.name "Your name"
git config --global user.email youremail@mail.com
</source>

В предыдущих командах и во всех следующих командах из этой документации каждая новая строка с символами это новая команда. Так что вы вводите первую строку с командой, нажимаете "Enter" и, затем, вводите следующую строку и опять "Еnter".

Теперь вы готовы к использованию Git. Следуйте дальше для настройки тестовой установки.

=Настройка тестовой инсталляции=
Для нашей тестовой установки нужен веб-сервер, который позволит вам установить и запустить Joomla! на вашем компьютере. Существуют множество программ, которые выполняют функции [https://www.mamp.info/ MAMP] и [https://www.apachefriends.org/ XAMPP]. Загрузите и установите одну из них.

After the installation of such a program (I use MAMP in this documentation), we going to install the latest version of Joomla!. In our case, the latest version of Joomla! is not the last stable release. The last version of Joomla! is the staging branch on GitHub.
First, let me explain a little bit more about GitHub.

== Fork and Clone Joomla! ==
On GitHub you can find projects, so called Repositories. Inside a project you might find several versions. Such a version is called a Branch. Joomla! has the following branches:
* '''Staging:''' эта ветка содержит последние исправления ошибок и новые возможности Joomla!
* '''Master:''' эта ветка содержит текущую стабильную версию Joomla!
* '''3.5-dev''' эта ветка содержит файлы Joomla! 3.5, которая не стабильна на момент написания статьи.

On our test location we going to use the '''Staging''' branch but if we should use this branch directly we have problem. We cannot modify this branch because we are not the owner of it.
We are going to make a copy of it. On GitHub this is called a Fork. We are the owner of that copy so we can modify it. After modifying we compare our fork with the original project. Then we can make a Pull Request for the changes we've made. More about that later.
You can Fork a branch by pressing the Fork button on the [https://github.com/joomla/joomla-cms Joomla! CMS Github Repository]. This button is located at the right top of the page.
[[File:Github-fork-button.png|none]]

After forking, we are going to install Joomla! on our local Web server. Go to the folder were you can run files on you Web server. Most of the program use a folder called <tt>htdocs</tt>. Once we are inside that folder, press the right mouse button an click on: "Git Bash Here". The command line will open for this location.

Type the following command to download the files from your Fork of the Joomla! CMS to your computer. Please replace username with the username you are using on GitHub.

<source>
git clone https://github.com/username/joomla-cms.git
</source>

For all commands given in this documentation, you have to open Git via the above described steps. Please remember that for other commands in this documentation.

Once Git is ready, open your browser and go to the installation on your localhost. Usually the URL is something like: <tt>http://localhost/joomla-cms</tt>. You will now see the default Joomla! installation process.

== Установка Joomla! ==
The installation of Joomla! for our local test installation is almost the same as a regular installation. There are a two little differences.

For the database settings, the password and username are default. Most often the username is <tt>root</tt> and the password is also <tt>root</tt> or there is no password. If you still can't connect to the database, look in the manual for your local Web server for the username and password.

The last difference is the final step of the installation. Normally we must delete the installation folder to go further to the back-end or front-end of Joomla!. For a test installation we can skip this part and go directly to the back-end or front-end. Don't remove the installation folder. It can be very useful when we have to install Joomla again.

=Make Your Changes=
Now it is time to made our file changes to Joomla!. All changes we make will be registered and monitored by Git. At any moment you can type the command <tt>git status</tt> to see which files are modified or untracked. Untracked means that the file at that location is new for Git.

If you made a mistake or you would like to restore a file, use this command:

<source>
git checkout path/to/file
</source>

If you like to remove all changes you made, use the following commands:

<source>
git checkout .
git clean -f -d
</source>

The first command resets all files. The second command removes untracked files and folders.

==Publish Our Changes on GitHub==

=Push the Change to the Fork=
After making our changes, we have to upload our changes to our repository on GitHub. After that, we can make a pull request with our changes.

Uploading changes is called <tt>push</tt> in Git terms. Before we can do that, we have to do something very important. We must create a new branch for our changes. (A branch is a version of our project, remember?) If we don't do that and made our change directly to the staging branch, the first time there won't be a problem. But if we made changes for the second time, and the change we made the first time are not merged yet, all these changes will registered too as new changes.

So the first command we are going to run will create a new branch. It will prevent the above described problem.
Replace name-new-branch with the name of the new branch. This name must be short, and can only contain lower case letters and numbers. Do '''NOT''' use spaces. Instead of spaces, use - (minus).

<source>
git checkout -b name-new-branch
</source>

The next command tells git that all made changes are good, and are ready to commit.

<source>
git add --all
</source>

The following command adds our change to the branch. Please replace the message with a short description of your changes. This description will be the title of the pull request we are going to make.

<source>
git commit -m "description"
</source>

The final command will push (upload) the changes to our fork. Please replace name-new-branch with the name of the branch you made a few steps above.

<source>
git push origin name-new-branch
</source>

==Compare Forks and Make a Pull Request==
After pushing our change to GitHub, go to your fork of the Joomla! CMS.

=Дополнительная информация=
Because the staging version of Joomla! can change any moment, it is very useful to have the possibility for keeping our fork up-to-date. We can do that by adding a remote to our forked project:

<source>
git remote add upstream https://github.com/joomla/joomla-cms.git
</source>

We now added a remote called "upstream". With the following command, Git will search for new contribution (commits) in the staging branch we don't have in our fork. If it found some, it will add them to our fork:

<source>
git pull upstream staging
</source>

The changes are now only made on our local fork. To upload them to GitHub use the following command:

<source>
git push
</source>

<noinclude>
[[Category: Bug Squad]]
[[Category: Development]]
[[Category:GitHub]]
</noinclude>