Система управления версиями Git. Система управления версиями git и российский сервис хранения исходного кода gitflic
 Скачать 3.56 Mb.
|
|
3.2.4. Создание заданий Задания существуют в рамках лекций. В одной лекции может быть не- ограниченное количество заданий. Лекции существуют в рамках учебного курса. В рамках учебного курса может быть неограниченное количество лекций. 3.2.4.1. Создание учебного курса Действие выполняет преподаватель. Из левого вертикального меню выбрать пункт «Курсы». Из верхнего меню выбрать пункт «Неопубликованные». Кликнуть мышкой по прямо- угольной кнопке «Новый курс». Появится окно ввода общей информации о курсе. Ввести название и краткое описание курса. Выбрать из выпадающего списка название университета и кафедру. ВНИМАНИЕ! Информация о редакторе курса справочная и, с точки зрения дальнейшей ра- боты с GitFlic, ни на что не влияет. Автор – преподаватель (несколько препода- вателей), который сможет вносить изменения в структуру курса. После окончания ввода всей информации нажать кнопку «Сохра- нить». В случае успешного добавления курса на экране появится титульная страница курса. 3.2.4.2. Добавление на курс преподавателей и студенческих групп Действие выполняет преподаватель. Из левого вертикального меню выбрать пункт «Курсы». Из верхнего меню выбрать пункт «Неопубликованные». Найти создаваемый курс и клик- нуть мышкой по его названию. Появится титульная страница курса. Кликнуть мышкой по кнопке «Перейти к курсу». Появится вкладка, 111 предназначенная для распределения заданий между студентами. Из верх- него горизонтального меню выбрать вкладку «Преподаватели и их группы». Кликнуть по кнопке «Назначить преподавателя и группу». Появится диало- говое окно добавления преподавателя. Выбрать группу, с которой работает преподаватель, выбрать препода- вателя. Если в выпадающем списке отсутствует нужная группа, начать вво- дить её название в поле «Группа». Если нужная группа уже зарегистриро- вана в GitFlic, её название появится в выпадающем списке. После окончания ввода всей информации кликнуть мышкой по кнопке «Добавить». Повторить описанные действия для всех групп, обучающихся на курсе. ВНИМАНИЕ! Студенческие группы должны быть зарегистрированы как указано в п. 3.3.2. 3.2.4.3. Добавление лекций Действие выполняет преподаватель. Из левого вертикального меню выбрать пункт «Курсы». Из верхнего меню выбрать пункт «Неопубликованные». Найти создаваемый курс и клик- нуть мышкой по его названию. Появится титульная страница курса. Кликнуть мышкой по кнопке «Редактировать». Появится информация о курсе с возможностью редактирования содержания. Из верхнего горизон- тального меню выбрать пункт «Структура». Появится список занятий (изначально пустой). Нажать на кнопку «До- бавить занятие» (кнопка расположена в рабочей области). Появится форма ввода данных о занятии. Заполните форму: − выберите тип занятия из выпадающего меню в верхнем поле ввода; − введите название лекции и её краткое содержание. После заполнения формы нажмите кнопку «Сохранить». Произойдёт возврат на вкладку «Структура», в рабочем окне отобразится информация о созданной лекции. Для того чтобы задания, относящиеся к лекции, были доступны, лек- цию необходимо опубликовать. Для публикации лекции кликните мышкой 112 по её названию на вкладке «Структура». Кликните мышкой по кнопке «Опубликовать», расположенной справа от названия лекции. 3.2.4.4. Добавление задания Действие выполняет преподаватель. Из левого вертикального меню выбрать пункт «Курсы». Из верхнего меню выбрать пункт «Неопубликованные». Найти создаваемый курс и клик- нуть мышкой по его названию. Появится титульная страница курса. Кликнуть мышкой по кнопке «Редактировать». Появится информация о курсе с возможностью редактирования содержания. Из верхнего горизон- тального меню выбрать пункт «Структура». Появится список занятий. Найти в списке лекцию, для которой будут добавляться задания. Справа от названия лекции расположены две иконки: «карандаш» и «стрелка». Кликните мышкой по иконке «стрелка». Появится кнопка «Добавить задание». Кликните мышкой по этой кнопке. В появив- шейся форме заполните поле «Название задания» и кликните мышкой по кнопке «Сохранить». Произойдёт возврат на вкладку «Структура», и ниже названия лекции будет отображено название созданного задания (при необ- ходимости кликните мышкой по иконке «стрелка», чтобы раскрыть описа- ние лекции). Кликните мышкой по названию задания. Появится форма для ввода содержательной части задания. Введите содержание задания в текстовое поле «Текст задания». При необходимости прикрепите файлы с материа- лами задания. Для того чтобы сделать задание доступным для отправки сту- дентам, кликните по кнопке «Опубликовать». После окончания редактиро- вания кликните по кнопке «Сохранить». В правой части рабочего окна находится список заданий для текущей лекции. При клике мышкой по названию лекции откроется чистая форма для ввода нового задания. При клике мышкой на названии задания откроется существующее задание для редактирования. После окончания ввода всех заданий кликните по пункту «Структура» в верхнем горизонтальном меню. Произойдёт возврат к списку занятий. 3.2.4.5. Распределение заданий между студентами Действие выполняет преподаватель. Из левого вертикального меню выбрать пункт «Курсы». Из верхнего 113 меню выбрать пункт «Неопубликованные». Найти создаваемый курс и клик- нуть мышкой по его названию. Появится титульная страница курса. Кликнуть мышкой по кнопке «Перейти к курсу». Откроется форма «Управление». Выбрать «Назначение занятий и задач» из верхнего горизон- тального меню. Появится форма со списком занятий и задач. Для выбранного занятия кликните мышкой по иконке «Человечек». В по- явившейся форме выберите группу, которой необходимо назначить задание. ВНИМАНИЕ! Можно выбирать только те группы, которые были добавлены на курс (см. раздел 3.3.4.2). 3.2.4.6. Создание репозитория Действие выполняет студент. Репозиторий (проект) создаётся студентом перед началом выполнения задания. Один и тот же репозиторий можно использовать для выполнения различных заданий, однако рекомендуется создавать репозиторий для каж- дого задания, чтобы сделать распределение решений систематизированным. Для создания репозитория (проекта) кликните мышкой по значку + в правом верхнем углу экрана, рядом с буквой G в зелёном кружке. В выпа- дающем списке кликните мышкой по тексту «Новый проект». Появится вкладка с шаблоном для описания нового проекта. Введите название проекта латинскими буквами. Выберите язык про- граммирования из выпадающего списка. Обратите особое внимание на поле «URL проекта». В нём указан се- тевой адрес, который позволит связать репозиторий GitFlic с локальным ре- позиторием вашего рабочего компьютера. Адрес, указанный в поле «URL команды», нужно изменить. Если ис- ходный адрес: https://gitflic.ru/project/student/my_project, то адрес для связи с репозиторием будет: https://edu.gitflic.ru/project/student/my_project.git (полужирным выделены кодовые слова edu и .git, которые нужно добавить в исходную адресную строку). После ввода всей информации о проекте кликните по кнопке «Создать 114 проект». Существующий проект можно найти на вкладке «Проекты» главной страницы личного кабинета. 3.2.4.7. Отправка задания на проверку Действие выполняет студент. Перейдите на главную страницу личного кабинета GitFlic. Кликните мышкой по пункту «Задания» в левом вертикальном меню. Появится вкладка со списком заданий, назначенных студенту для выполнения. Зада- ния разделены на четыре группы: − новые (не выполненные задания); − на проверке (выполненные задания, находящиеся на проверке у преподавателя); − проверенные (выполненные задания, по которым преподаватель принял положительное решение); − отклонённые (задания, которые преподаватель вернул на дора- ботку). Для просмотра группы её название необходимо выбрать из верхнего горизонтального меню. Найдите в группе «Новые» название задания, которое вы хотите от- править на проверку. Кликните мышкой по кнопке «Отправить решение» справа от названия задания. Откроется вкладка для выбора решения. В поле «Проекты» выберите из выпадающего списка название репо- зитория, в котором хранится выполненное задание. В поле «Путь к файлу» выберите из выпадающего списка название файла, содержащего решение. Если названия файла в выпадающем списке нет, начните вводить название, и оно появится в выпадающем списке. Если необходимо отправить несколько файлов, то они должны быть собраны вместе, в одной директории. Имя этой директории нужно указать в поле «Путь к папке». После заполнения всех полей нажмите кнопку «Сохранить». 115 3.2.4.8. Проверка заданий Действие выполняет преподаватель. Перейдите на главную страницу личного кабинета GitFlic. Кликните мышкой по пункту «Задания» в левом вертикальном меню. Выберите «Па- нель преподавателя» из верхнего горизонтального меню. Выберите пункт «На проверке» из верхнего, горизонтального меню. Отобразится список работ, которые студенты прислали на проверку. Кликните мышкой по названию работы, которую вы хотите прове- рить. Откроется вкладка с описанием работы. Кликните мышкой по пункту «Файлы» в верхнем горизонтальном меню. Откроется текстовый редактор, в котором можно просматривать со- держимое всех файлов, присланных студентом для текущей работы. При наведении курсора мышки на текст слева появится небольшой синий квадратик со значком + внутри. Если кликнуть мышкой по этому квадратику, то откроется поле, в котором можно ввести комментарий. После ввода комментария кликните мышкой по кнопке «Комментировать». Ком- ментарий будет сохранён в том месте файла, где находился курсор мышки при нажатии на синий квадратик. После проверки работы кликните мышкой по кнопке «Выполнено», если решение верное, или по кнопке «Не выполнено», если решение содер- жит ошибки. На панели преподавателя работа переместится во вкладку «Проверен- ные», если решение было верное, или во вкладку «Отклонённые», если ре- шение содержит ошибки. 3.2.4.9. Просмотр результатов проверки Действие выполняет студент. Перейдите на главную страницу личного кабинета GitFlic. Кликните мышкой по пункту «Задания» в левом вертикальном меню. Выберите «Проверенные» или «Отклонённые» из верхнего горизонтального меню. Все задания, находящиеся в группе «Проверенные», приняты преподавате- лем, никаких дополнительных действий выполнять не нужно. Задания, находящиеся в группе «Отклонённые», содержат ошибки. Кликните мышкой по названию задания из этой группы. Откроется вкладка с описанием работы. 116 Выберите пункт «Файлы» из верхнего горизонтального меню. Откро- ется редактор, в котором можно просмотреть текст работы с комментариями преподавателя. После изучения комментариев преподавателя необходимо исправить указанные ошибки, сохранить исправленный файл/файлы в репозитории и отправить работу на повторную проверку. Для отправки работы на повторную проверку необходимо кликнуть мышкой по кнопке «Изменить решение», в появившейся форме заполнить поля (см. п. 3.3.4.7) и кликнуть мышкой по кнопке «Сохранить». 3.3. Репозиторий GitFlic Проект GitFlic включает в себя не только учебный портал, но и репо- зиторий общего назначения. Этим репозиторием могут воспользоваться программисты, разрабатывающие как коммерческое, так и некоммерческое программное обеспечение. Для небольших групп программистов использо- вание GitFlic бесплатно. Крупные программистские коллективы должны со- трудничать с GitFlic на коммерческой основе. 3.3.1. Структура окна сайта GitFlic После входа на сайт GitFlic открывается окно, состоящее из следую- щих четырёх областей: Горизонтальное меню Представляет собой чёрную полосу в верхней части экрана. 117 В левой части горизонтального меню расположена эмблема компании GitFlic – стилизованное изображение головы медведя, рядом с которой рас- положена надпись GitFlic. Щелчок мышкой по эмблеме приводит к пере- ходу на страницу профиля пользователя. В правой части горизонтального меню расположены: − Строка поиска, помогающая найти нужный проект. − Иконка «колокольчик», клик мышкой по которой открывает экран уведомлений. − Знак плюс, позволяющий переключиться на один из диалогов: со- здание нового проекта, создание новой команды разработчиков, создание новой компании. − Иконка с обозначением текущего пользователя. Клик мышкой по ней позволяет выполнить одно из трёх действий: открыть профиль пользо- вателя, открыть экран с настройками или выйти из системы. Вертикальное меню Расположено в левой части экрана и содержит следующие шесть пунктов: − Проекты. Переход к экрану работы с проектами. − Команды. Переход к экрану создания и редактирования команд раз- работчиков. − Компании. Переход к экрану создания и редактирования производ- ственных компаний. − Уведомления. Переход к экрану работы с уведомлениями. − Помощь. Переход к контекстной справке по системе. − Выйти. Выход из системы. Нижнее меню Расположено в нижней части экрана. Позволяет обратиться к юридиче- ским документам, регламентирующим работу с GitFlic, найти контакты разра- ботчиков GitFlic и перейти на страницу, содержащую публичные проекты. Центральная часть экрана Содержимое этой части зависит от того, с какой из страниц интер- фейса в данный момент работает пользователь. Центральная часть экрана имеет собственное меню, назначение пунктов которого будет описано при рассмотрении соответствующей страницы интерфейса. 118 3.3.2. Создание нового репозитория В верхнем меню щёлкните мышкой по знаку плюс и выберите «Новый проект». Заполните форму создания проекта. Обратите внимание на поле URL. Оно состоит из двух частей: фиксированной и редактируемой. Фикси- рованная часть задаёт сетевой путь к папке с проектами пользователя. Ре- дактируемая часть позволяет задать имя вложенной папки, в которой будет храниться создаваемый проект. Запомните полный путь, он пригодится для подключения к проекту локального репозитория. Переключатель «Публичный проект»/«Приватный проект» позволяет вы- брать уровень доступа к создаваемому проекту. Публичный проект будет виден всем посетителям сайта GitFlic, даже не зарегистрированным. Приватный про- ект будет доступен только пользователю, создавшему его (хозяин проекта) и тем пользователям, кому хозяин проекта предоставит доступ. После заполнения полей нажмите кнопку «Создать проект». Откро- ется страница вновь созданного проекта. До добавления файлов в проект на этой странице будет находиться подробная информация, содержащая ко- манды git, позволяющие подключить к проекту локальный репозиторий. На странице приводятся следующие группы команд. Глобальные настройки Git. Эти команды необходимо выполнить один раз, после установки git на компьютер. git config --global user.name "MyName" git config --global user.email MyMail@MyServer.com Клонирование удалённого репозитория (проекта) на локальный компьютер. При клонировании ав- томатически создаётся новая директория, имя которой совпадает с именем проекта. git clone https://gitflic.ru/project/MyName/testovyj-proekt.git cd testovyj-proekt touch README.md git add README.md git commit -m "add README" git push -u origin master Преобразовать существующую директорию в репозиторий git и копирование в неё проекта. cd existing_folder git init git remote add origin https://gitflic.ru/project/abulychev/testovyj-proekt.git git add git commit -m "Initial commit" git push -u origin master Переименовать удалённый репозиторий и скопировать его на локальный компьютер. cd existing_folder 119 git remote rename origin old-origin git remote add origin https://gitflic.ru/project/abulychev/testovyj-proekt.git git push -u origin –all git push -u origin –tags 3.3.3. Управление проектом При выборе проекта открывается обзорная страница, на которой нахо- дятся: − описание проекта; − адрес сайта проекта; − используемый язык программирования; − содержание приложенного README-файла. Для управления состоянием проекта предназначены кнопки «Наблю- дать», «Форк», «Избранное». Кнопка «Наблюдать» используется для управления потоком уведом- лений. При её нажатии появляется выпадающее меню, в котором возможно выбрать режим для получения уведомлений: − получать все уведомления; − получать только уведомления, в которых упоминается пользователь; − не получать уведомления. Кнопка «Форк» позволяет создать новую ветку, используя текущий проект в качестве начальной точки. Кнопка «Избранное» позволяет добавить проект в список избран- ных. Статус «Избранное» учитывается при использовании фильтра «Из- бранное» на странице «Проекты». В верхней части окна проекта расположено дополнительное горизон- тальное меню, включающее пункты: − Файлы – обзор файлов проекта. − Проблемы – создание и управление задачами, возникающими в ходе выполнения проекта. − Запросы на слияние – список запросов на слияние веток проекта и инструменты для управления слияниями. − Коммиты – список выполненных коммитов. − Ветки – список веток проекта. 120 − Теги – список тегов, используемых в проекте. − Релизы – информация о выпущенных релизах. − Статистика – статистические данные о проекте. − Настройки – управление настройками проекта. Ветки проекта выбираются в выпадающем меню над списком файлов (рисунок 3.9). После выбора ветки можно просмотреть загруженные файлы проекта. Рисунок 3.9 – Выбор ветки проекта Копирование кода проекта (рисунок 3.10). Чтобы скопировать код проекта, откройте меню «Код» (расположено на зелёной плашке). Выберите вариант авторизации. Авторизация, при копировании проекта, может про- изводиться по протоколу HTTPS или по протоколу SSH. Рисунок 3.10 – Копирование кода проекта |