🔑 Доступ к журналу
Вставьте ваш личный ключ доступа (ghp_), чтобы открыть журнал:
Регламент работы с Журналом
💡 Правила заполнения полей ввода
🧱 1. Правило ввода
Учащиеся вносятся в строку строго через запятую.
- Пример:
Фамилия Имя, Фамилия Имя, Фамилия Имя - Пример:
Фамилия Имя, Фамилия Имя /с, Фамилия Имя /э /#
🧱 2. Структура записи
Каждая запись состоит строго из трех позиций в следующем порядке:
[Фамилия Имя] [Ключ] [Тег]
🧱 3. Ключи и Теги
Вводятся по необходимости, обязательными не являются.
🔹 Ключи направления:
- /э или /e — Электронное конструирование (Пример:
Фамилия Имя /э) - /с или /c — Столярное дело (Пример:
Фамилия Имя /с)
🔹 Ключи системные:
- /d — Удаление записи (Пример:
journal Фамилия Имя /d) - /r — Исправление ошибок (Пример:
journal /r) - /m — Модификация времени (Пример:
journal 1200 1500 /m)
🔹 Группы тегов:
- # — Автогенерация хэштега (Пример:
Фамилия Имя /э /#) - @логин — Логин GitHub (Пример:
Фамилия Имя /с @login) - #techlab-familiya-imya — Тег платформы (Пример:
Фамилия Имя /с #techlab-familiya-imya)
📋 Инструкция для преподавателей
Для получения доступа к журналу посещений вам понадобится личный персональный ключ (токен) GitHub. Полный исходный код системы автоматизации Журнала посещенийм доступны в официальном репозитории: techlab-journal-attendance.
Шаг 1. Регистрация аккаунта
- Войдите в свой аккаунт на сайте github.com (или зарегистрируйтесь, если у вас ещё нет аккаунта).
- Сообщите ваш системный логин (username) администратору. Он добавит вас в соавторы репозитория и создаст личное расписание.
- Обязательно подтвердите приглашение в соавторы, которое придёт на вашу электронную почту или появится в уведомлениях вашего профиля GitHub.
Шаг 2. Переход в настройки классических ключей
- В правом верхнем углу экрана нажмите на свою круглую аватарку профиля и в выпадающем меню выберите пункт ⚙️ Settings (Настройки).
- В самом низу левой колонки меню нажмите на последний пункт Developer settings (Настройки разработчика).
- В открывшемся левом меню раскройте раздел 🔑 Personal access tokens и выберите второй подпункт — Tokens (classic).
Шаг 3. Создание и настройка токена
- Вверху справа нажмите кнопку Generate new token и выберите Generate new token (classic).
- В поле Note введите любое название на английском языке (например,
journal-attendance-token). - В строке Expiration (Срок действия) выберите период действия ключа (рекомендуется 90 days).
- В блоке Select scopes (Выбор прав доступа) поставьте галочки напротив следующих двух пунктов:
- [x] repo (полный доступ к репозиториям — необходим для записи файлов посещаемости).
- [x] write:discussion (доступ к обсуждениям — необходим для публикации журнала в Обсуждениях).
- Прокрутите страницу в самый низ и нажмите зелёную кнопку Generate token (Создать токен).
Шаг 4. Вход в журнал
- Обязательно скопируйте появившийся длинный секретный ключ (он начинается на
ghp_...). Важно: GitHub показывает этот ключ только один раз! Если вы закроете страницу, не скопировав его, токен придётся создавать заново. - Вернитесь на страницу журнала, вставьте скопированный ключ в поле ввода на самом верху экрана и нажмите кнопку 🔓 Подключить журнал. Браузер запомнит вас, и при следующих визитах вводить ключ заново не потребуется.
- Обратите внимание: Если в журнале вы нажмёте кнопку ВЫХОД, браузер полностью сотрёт ключ из памяти. Чтобы зайти обратно, вам снова потребуется ввести этот токен. Поэтому нажимайте выход только при реальной необходимости, а сам ключ
ghp_...обязательно сохраните в надёжном месте (в блокноте или в менеджере паролей), чтобы не потерять его!