Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
e3ece33
Переписал курс для Positron и Quarto
yoursdearboy Aug 26, 2026
be7f58e
Вернул исходный текст курса для Positron
yoursdearboy Aug 26, 2026
8670aee
Поправил 01
yoursdearboy Aug 26, 2026
5c589fc
Переписал 02-01
yoursdearboy Aug 26, 2026
b44919a
Переписал 02-02
yoursdearboy Aug 27, 2026
1438f30
Переписал 02-03
yoursdearboy Aug 27, 2026
be9bea4
Переписал 02-04
yoursdearboy Aug 28, 2026
f3108ba
Обновил служебные файлы
yoursdearboy Aug 28, 2026
646f0c9
Исправил пунктуацию
yoursdearboy Aug 28, 2026
b632f9c
Переписал 03-01
yoursdearboy Aug 28, 2026
add99c6
Засинкал 03 и 04 с переписанными 01-02
yoursdearboy Aug 28, 2026
32b9283
Переписал 03-01
yoursdearboy Aug 28, 2026
766c962
Переписал 03-02
yoursdearboy Aug 28, 2026
7f6944c
Переписал 03-03
yoursdearboy Aug 29, 2026
d4e11b6
Обновил AGENTS.md
yoursdearboy Aug 29, 2026
856a525
Вернул создание репозитория через GitHub
yoursdearboy Aug 29, 2026
2f30b44
Переписал 04-02
yoursdearboy Aug 29, 2026
47ced90
Переписал 04-03
yoursdearboy Aug 30, 2026
b0ea82f
Поправил 04-04
yoursdearboy Aug 30, 2026
20e03f6
Обновил docs
yoursdearboy Aug 30, 2026
57b5a6c
Вернул скриншоты 05-03
yoursdearboy Aug 30, 2026
80c195a
Поправил ссылку на penguins.csv
yoursdearboy Sep 1, 2026
c34ed4b
Build
yoursdearboy Sep 1, 2026
c604a24
Rebuild
yoursdearboy Sep 1, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@
.Rhistory
.RData
.Ruserdata
__pycache__/
2 changes: 1 addition & 1 deletion 01-01-about.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Git автоматически отслеживает изменения во в
![](./img/notFinal.gif){width=400px style="border: 1px solid #ddd"}
:::

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

```{r, include=FALSE}
# Особенность звучит так себе, но ветки это реально основная фича Git.
Expand Down
6 changes: 3 additions & 3 deletions 01-02-install.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
## Проверьте наличие Git {#terminal}

В комплекте с дистрибутивом Git устанавливается программа для терминала.
Чтобы её запустить, откройте Rstudio и в верхнем меню выберите **Tools → Terminal New Terminal**.
Чтобы открыть терминал в Positron, вызовите поиск команд комбинацией клавиш Ctrl + Shift + P, найдите и выберите **Terminal: Create New Terminal**.
В появившемся окне терминала введите команду `git` и нажмите клавишу Enter.

Если вы видите результат как на скриншоте ниже, то Git установлен.
Иначе нужно его установить --- см. инструкцию для вашей операционной системы ниже.
После установки перезапустите RStudio и повторите проверку.
После установки перезапустите Positron и повторите проверку.

![](./img/git.png){width="100%"}
![](./img/SCR-20260826-ofub.png){width="100%"}

## Windows

Expand Down
9 changes: 5 additions & 4 deletions 01-03-shell.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,14 @@
Команды для терминала вы встретите в документации и в интернете, ими легко поделиться и использовать в скриптах.
Кроме терминала есть много других способов и их даже можно использовать одновременно.

Графические интерфейсы --- все они имеют ограничения и реализуют только часть возможностей Git, но достаточны для решения большинства задач. Это может быть интерфейс, встроенный в другие программы (например [RStudio](https://docs.posit.co/ide/user/ide/guide/tools/version-control.html), [Pycharm](https://www.jetbrains.com/help/pycharm/using-git-integration.html), [VS Code](https://code.visualstudio.com/docs/sourcecontrol/overview)) или самостоятельная программа (например [GitHub Desktop](https://github.com/apps/desktop), [GitKraken](https://www.gitkraken.com) [и многие другие](https://git-scm.com/downloads/guis));
Графические интерфейсы --- все они имеют ограничения и реализуют только часть возможностей Git, но достаточны для решения большинства задач. Это может быть интерфейс, встроенный в другие программы (например [Positron](https://positron.posit.co/git.html), [Pycharm](https://www.jetbrains.com/help/pycharm/using-git-integration.html), [VS Code](https://code.visualstudio.com/docs/sourcecontrol/overview), [RStudio](https://docs.posit.co/ide/user/ide/guide/tools/version-control.html)) или самостоятельная программа (например [GitHub Desktop](https://github.com/apps/desktop), [GitKraken](https://www.gitkraken.com) [и многие другие](https://git-scm.com/downloads/guis));

Веб-интерфейсы --- прямо на сайте GitHub можно редактировать отдельные файлы, а также выполнять некоторые команды.

В этом курсе мы будем работать с Git одновременно в интерфейсе RStudio и в терминале, как это делает большинство пользователей R каждый день, а также через GitHub.
Поэтому запомните, как запустить терминал в RStudio ---
в верхнем меню выберите **Tools → Terminal → New Terminal** ([см. скриншот в предыдущей главе](#terminal)).
В этом курсе мы будем работать с Git одновременно в интерфейсе Positron и в терминале, как это делает большинство пользователей каждый день, а также через GitHub.
К терминалу можно вернуться в любой момент, переключаясь между вкладками **(1) CONSOLE** и **(2) TERMINAL** на нижней панели Positron.

![](./img/SCR-20260826-ofub-2.png){width="100%"}

Перед началом работы необходимо сделать несколько настроек.
Укажите свое имя и адрес электронной почты, чтобы Git верно записывал информацию об авторе изменений.
Expand Down
72 changes: 33 additions & 39 deletions 02-01-init.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -7,66 +7,60 @@ Git может отслеживать изменения в любой папк
**Репозиторий** --- это скрытая подпапка `.git`, в которой хранятся версии проекта и информация об изменениях.
Всё необходимое для работы Git содержится непосредственно в ней.

Самый простой способ создать репозиторий --- вместе с проектом RStudio.
В верхнем меню выберите [File → New Project]{.figtext}.
В появившемся окне выберите [New directory]{.figtext}, а затем [New Project]{.figtext}.
На последнем шаге в поле [Directory name]{.figtext} введите название папки для проекта: [penguins]{.figtext}.
Она будет создана на вашем компьютере по адресу, указанному в поле [Create project as subdirectory of]{.figtext}.
‼️ Не забудьте поставить галочку напротив опции [<input type="checkbox" checked disabled /> Create a git repository]{.figtext}, иначе проект будет создан без Git репозитория.
После нажатия кнопки [Create Project]{.figtext} окно RStudio перезагрузится с открытым проектом.

<table class="table table-borderless">
<tr>
<td>![](./img/02-01-01-new-project.png){width="320px"}</td>
<td>![](./img/02-01-02-new-project.png){width="320px"}</td>
</tr>
<tr>
<td>![](./img/02-01-03-new-project.png){width="320px"}</td>
<td>![](./img/02-01-04-new-project.png){width="320px"}</td>
</tr>
</table>

При следующем запуске RStudio откроет последний проект.
Если этого не произойдет, чтобы открыть проект в верхнем меню выберите [File → Open Project]{.figtext} или [File → Recent Projects]{.figtext}.

Убедитесь в том, что проект загружен, для этого обратите внимание на следующие элементы интерфейса:
В правом верхнем углу указано название проекта [(A)]{.figref}.
На панели файлов (по умолчанию она в нижнем правом углу) открыта папка с файлами проекта [(B)]{.figref}.

![](./img/02-01-05-window.png){width="680px"}

Когда в RStudio открыт проект, R и Git ищут файлы в папке проекта --- это так называемая **рабочая папка или рабочая область**.
Мы продолжим проект из курса «Введение в автоматизацию обработки данных на R». Откройте его в Positron по [инструкции из курса](https://stepik.org/lesson/2482459/step/5?unit=2520221): нажмите [Open]{.figtext} на верхней панели, выберите Open Folder… и найдите нужную папку.

Если проекта нет, создайте его, как показано [в курсе](https://stepik.org/lesson/2482459/step/2?unit=2520221). Затем создайте папку `data`, скачайте файл [`penguins.csv`](https://stepik.org/media/attachments/lesson/2482459/penguins.csv) и поместите его туда.

Убедитесь, что папка открыта: в панели [(1) Explorer]{.figtext} должны быть видны файлы, в том числе папка `data`.
Откройте пункт [(2) Source Control]{.figtext} на панели слева и нажмите [Initialize Repository]{.figtext}.
Positron создаст репозиторий в папке проекта. На панели в разделе [Changes]{.figtext} появится список файлов.

Если у вас нет кнопки [Initialize Repository]{.figtext}, [проверьте установку Git](#install).

![](./img/SCR-20260826-rxxf.png){width=100%}

Когда в Positron открыт проект, R и Git ищут файлы в ней --- это так называемая **рабочая папка или рабочая область**.

<details><summary>Подробнее про поиск и адреса файлов.</summary>
На разных компьютерах, например у разных участников, проект может находиться в разных местах.
У пользователя с именем `mjordan` это может быть `/Users/mjordan/penguins`,
а у пользователя `scruz` допустим
`C:\Users\scruz\penguins`.

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

```r
read_csv("/Users/mjordan/penguins/data/sample.csv")
read.csv("/Users/mjordan/r-course/data/penguins.csv")
```

то он будет работать только у пользователя `mjordan`.
У других полный адрес будет отличаться, и код «сломается».
Чтобы он работал у всех, нужно указывать адрес файла относительно рабочей папки.

```r
read_csv("data/sample.csv")
read.csv("data/penguins.csv")
```
</details>

Рассмотрим созданные RStudio файлы:
Внутри папки проекта создана папка репозитория `.git`. Открывать или изменять её содержимое не нужно, поэтому она скрыта. Для работы с репозиторием используют панель [Source Control]{.figtext} и команды в терминале.

- `hello-git.Rproj` --- содержит настройки проекта
- `.gitignore` --- содержит список файлов, которые Git не будет отслеживать; о том, зачем это нужно и как настроить [смотри в отдельном разделе](#gitignore)
- `.git` --- репозиторий; это скрытая папка, чтобы ее увидеть, в меню на панели файлов выберите [More → Show Hidden Files]{.figtext}
<details><summary>Как увидеть скрытую папку.</summary>
Positron не показывает некоторые служебные папки на панели Explorer.
Чтобы увидеть их, откройте терминал и выполните команду:

Если файл `.gitignore` отсутствует, значит, вы не отметили галочку [<input type="checkbox" checked disabled /> Create a git repository]{.figtext} при создании проекта или не установили Git.
[Проверьте наличие Git](#install) и создайте проект заново.
```shell
ls -la
```

В Windows может потребоваться другая команда:

```powershell
Get-ChildItem -Force
```

Появится список файлов проекта, в том числе папка `.git`.
</details>

Итак, у нас есть проект RStudio --- папка, в которой мы будем работать, и
Итак, у нас есть проект --- папка, в которой мы будем работать, и
внутри нее Git репозиторий --- скрытая папка, в которой будут храниться версии проекта.
Приступим к созданию первой версии.
47 changes: 15 additions & 32 deletions 02-02-commit.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -5,43 +5,26 @@ Git отслеживает изменения в файлах, находящи
а при помощи версий --- или, в терминах Git, **коммитов (commit)**.
Коммиты нужно создавать вручную, выбирая, какие файлы вы хотите зафиксировать, добавив в версию.

Откройте в RStudio панель с названием [Git]{.figtext} (по умолчанию она в верхнем правом углу).
В отличие от списка файлов, на ней выводятся только те файлы, которые были изменены по сравнению с последней версией (коммитом).
Так как мы еще не создали ни одной версии, то в списке выводятся оба файла, созданных с проектом: `.gitignore` и `penguins.Rproj`


![](./img/02-02-01-window.png){width=680px}

<details><summary>Нет панели Git?</summary>
Значит, вы не отметили галочку [Create a git repository]{.figtext} при создании проекта или не установили Git.
[Проверьте наличие Git](#install) и [создайте проект заново](#git-init).
</details>

Чтобы создать коммит (версию), отметьте файлы галочкой в столбце [Staged]{.figtext}.
Галочка напротив файла означает, что он добавлен в **индекс (staging)** ---
промежуточную область для выбора файлов, которые будут зафиксированы.
Неотмеченные файлы останутся в рабочей папке, но в коммит не попадут.
Вы можете добавить их в следующую версию позже или отменить изменения.
Нажмите кнопку [Commit]{.figtext}.

![](./img/02-02-02-staging.png){width=400px}

В открывшемся окне можно подробнее посмотреть, что изменилось в файлах.
Просмотрите изменения и введите краткое описание в поле [Commit message]{.figtext}.
В нашем примере был создан проект, это и будет подходящим описанием.
Откройте в Positron панель [Source Control]{.figtext}.
В отличие от панели с файлами [Explorer]{.figtext}, на ней выводятся только те файлы, которые были изменены по сравнению с последней версией (коммитом).
Так как мы еще не создали ни одной версии, то в списке выводятся все файлы проекта.

Чтобы создать коммит (версию), наведите на заголовок [Changes]{.figtext} и нажмите `+`.
После этого файлы окажутся в разделе [Staged Changes]{.figtext} --- **индексе (staging)**,
промежуточной области для выбора файлов, которые войдут в новую версию (коммит).
Можно добавлять файлы и по одному, нажимая `+` только напротив нужных.
Файлы, не добавленные в индекс, останутся в рабочей папке, но не войдут в коммит.
Вы можете добавить их в следующую версию позже или отменить изменения, нажав `↶`.

Введите краткое описание в поле [Message]{.figtext}.
В нашем примере мы закончили курс R, это и будет подходящим описанием: `Добавил файлы курса по R`.
Нажмите кнопку [Commit]{.figtext} под текстовым полем.

![](./img/02-02-03-commit.png){width=600px}

В открывшемся окне не должно быть ошибок, но должно быть сообщение как на изображении ниже.

![](./img/02-02-04-message.png){width=600px}
![](./img/SCR-20260827-dsdg.png){width=100%}

Закройте окно с сообщением и окно создания коммита, вернитесь к RStudio.
Обратите внимание, теперь панель [Git]{.figtext} со списком измененных файлов пуста ---
Обратите внимание, теперь панель [Source Control]{.figtext} со списком измененных файлов пуста ---
это значит, что изменений по сравнению с последней версией, которую мы только что создали, нет.

![](./img/02-02-05-git-pane.png){width=400px}

Теперь у нас есть версия проекта, к которой можно вернуться в любой момент и начать работу с этого места.

Expand Down
Loading
Loading