Рабочее пространство для лабораторной работы

При выполнении лабораторной работы следует придерживаться структуры рабочего пространства.

1 Основные идеи

• Стандартные соглашения об именах
• Стандартное соглашение для путей к файлам
• Стандартная настройка курса внутри шаблона курса

2 Общие правила

• Рабочее пространство по предмету располагается в следующей иерархии:

  1~/work/study/
  2└── <учебный год>/
  3    └── <название предмета>/
  4        └── <код предмета>/
  

• Например, для 2023–2024 учебного года и предмета «Операционные системы» (код предмета os-intro) структура каталогов примет следующий вид:

  1~/work/study/
  2└── 2023-2024/
  3    └── Операционные системы/
  4        └── os-intro/
  

• Название проекта на хостинге git имеет вид:

  1study_<учебный год>_<код предмета>
  

• Например, для 2023–2024 учебного года и предмета «Операционные системы» (код предмета os-intro) название проекта примет следующий вид:

  1study_2023-2024_os-intro
  

• Каталог для лабораторных работ имеет вид labs.

• Каталоги для лабораторных работ имеют вид lab<номер>, например: lab01, lab02 и т.д.

• Каталог для групповых проектов имеет вид group-project.

• Каталог для персональных проектов имеет вид personal-project.

• Если проектов несколько, то они нумеруются подобно лабораторным работам.

• Этапы проекта обозначаются как stage<номер>.

3 Шаблон для рабочего пространства

• Репозиторий: https://github.com/yamadharma/course-directory-student-template.

3.1 Сознание репозитория курса на основе шаблона

• Репозиторий на основе шаблона можно создать либо вручную, через web-интерфейс, либо с помощью утилит gh (см. github: утилиты командной строки).

3.1.1 Создание с помощью утилит

• Создание выглядит следующим образом:

  1gh repo create <new-repo-name> --template="<owner/template-repo>"
  

• Например, для 2023–2024 учебного года и предмета «Операционные системы» (аббревиатура предмета — os-intro) создание репозитория примет следующий вид:

  1mkdir -p ~/work/study/2023-2024/"Операционные системы"
  2cd ~/work/study/2023-2024/"Операционные системы"
  3gh repo create study_2023-2024_os-intro --template=yamadharma/course-directory-student-template --public
  4git clone --recursive git@github.com:<owner>/study_2023-2024_os-intro.git os-intro
  

3.1.2 Создание вручную

• Сделать свой репозиторий на основе шаблона можно и вручную: https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template.

3.2 Структура шаблона

• Посмотреть доступные цели make:

  1make help
  

• Посмотреть список доступных курсов:

  1make list
  

• При создании структуры название курса берётся из следующих мест:
  • название курса находится в файле COURSE;
  • каталог курса называется как аббревиатура курса.

3.3 Настройка каталога курса

• Перейдите в каталог курса:

  1cd ~/work/study/2023-2024/"Операционные системы"/os-intro
  

• Удалите лишние файлы:

  1rm package.json
  

• Создайте необходимые каталоги:

  1echo os-intro > COURSE
  2make prepare
  

• Отправьте файлы на сервер:

  1git add .
  2git commit -am 'feat(main): make course structure'
  3git push