Руководство пользователя - TestPDF

Веб-приложение для создания, управления и экспорта математических заданий и тестовых вариантов с поддержкой формул LaTeX и PDF-генерации.

Особенности

  • Редактор математических задач с поддержкой формул LaTeX
  • Интерактивный редактор с кнопками для вставки формул
  • Создание вариантов тестов с возможностью настройки
  • Экспорт вариантов в PDF с настраиваемым форматированием
  • Система категорий для организации заданий
  • Управление изображениями для заданий и вариантов
  • Импорт/экспорт данных в JSON формате

Вход в систему

  1. Откройте приложение по адресу http://localhost:8000/
  2. Войдите, используя учетные данные администратора или зарегистрированного пользователя
  3. Если учетной записи нет, воспользуйтесь формой регистрации (/accounts/register/)

Работа с заданиями

Создание нового задания

  1. Перейдите в раздел "Задания"
  2. Нажмите на кнопку "Создать задание"
  3. Заполните форму с необходимыми полями:
    • Название - краткое наименование задания
    • Описание - текст задания с поддержкой формул LaTeX
    • Сложность - числовая оценка сложности задания
    • Максимальный балл - максимальное количество баллов за задание
    • Категории - привязка к категориям для удобной фильтрации
  4. Для добавления формул LaTeX используйте встроенный редактор:
    • Встроенные формулы: $формула$
    • Блочные формулы: $$формула$$
  5. Для добавления изображений воспользуйтесь секцией "Изображения"
  6. Нажмите "Сохранить" для создания задания

Добавление ответов к заданию

  1. Откройте созданное задание
  2. Перейдите во вкладку "Ответы"
  3. Нажмите кнопку "Добавить ответ"
  4. Заполните форму с полями:
    • Вопрос - текст вопроса (опционально)
    • Правильный ответ - эталонный ответ на задание
    • Альтернативные ответы - другие допустимые варианты ответа
    • Объяснение - пояснение к решению (опционально)
  5. Нажмите "Сохранить" для добавления ответа

Работа с вариантами

Создание нового варианта

  1. Перейдите в раздел "Варианты"
  2. Нажмите на кнопку "Создать вариант"
  3. Заполните форму с необходимыми полями:
    • Номер варианта - числовой идентификатор
    • Название - название варианта
    • Категория - привязка к определенной категории
    • Инструкции - инструкции по выполнению (опционально)
    • Приложения - дополнительная информация (опционально)
  4. В секции "Задания" выберите задания для включения в вариант:
    • Используйте фильтр по категориям для удобного поиска
    • Отметьте задания для включения в вариант
    • Настройте порядок заданий, перетаскивая их в нужном порядке
  5. Нажмите "Сохранить" для создания варианта
  6. Опционально можно сразу экспортировать в PDF

Генерация нескольких вариантов

  1. Перейдите в раздел "Варианты" -> "Генерация вариантов"
  2. Укажите параметры генерации:
    • Количество вариантов - сколько вариантов создать
    • Базовый номер - начальный номер для нумерации
    • Категория - категория для новых вариантов
    • Название шаблон - шаблон для названия вариантов
    • Количество заданий - сколько заданий включить в каждый вариант
  3. Настройте параметры выборки заданий:
    • По категориям
    • По сложности
    • По типу заданий
  4. Нажмите "Сгенерировать варианты" для создания

Экспорт в PDF

Экспорт одного варианта

  1. Откройте страницу варианта
  2. Нажмите на кнопку "Экспорт в PDF"
  3. Дождитесь завершения генерации PDF
  4. Файл будет автоматически загружен

Массовый экспорт вариантов

  1. Перейдите в раздел "Варианты"
  2. Отметьте нужные варианты для экспорта
  3. В выпадающем меню выберите "Экспорт в PDF"
  4. Дождитесь генерации архива с PDF-файлами
  5. Загрузите готовый архив

Работа с категориями

  1. Для создания новой категории перейдите в раздел "Категории"
  2. Нажмите "Создать категорию"
  3. Укажите название и описание категории
  4. Сохраните изменения

Импорт и экспорт данных

Экспорт данных

  1. Перейдите в раздел "Инструменты" -> "Экспорт данных"
  2. Выберите типы данных для экспорта:
    • Задания
    • Варианты
    • Категории
    • Ответы
    • Изображения
  3. Нажмите "Экспортировать" для создания JSON-файла
  4. Загрузите файл с данными

Импорт данных

  1. Перейдите в раздел "Инструменты" -> "Импорт данных"
  2. Загрузите ранее экспортированный JSON-файл
  3. Выберите типы данных для импорта
  4. Нажмите "Импортировать" для загрузки данных в систему

Управление изображениями

  1. Для загрузки нового изображения перейдите в раздел "Изображения"
  2. Нажмите "Добавить изображение"
  3. Загрузите файл изображения и укажите название и описание
  4. Сохраните изображение
  5. Теперь изображение можно привязать к заданиям или вариантам

Использование LaTeX-редактора

Система оснащена удобным LaTeX-редактором для работы с математическими формулами:

  1. Для вставки встроенной формулы используйте синтаксис $формула$
  2. Для вставки блочной формулы используйте синтаксис $$формула$$
  3. Для быстрой вставки формул используйте кнопки панели инструментов:
    • Дроби: \frac{a}{b}
    • Корни: \sqrt{x}
    • Индексы: x_{i}
    • Степени: x^{2}
    • Греческие буквы: \alpha, \beta, \gamma
    • Математические операторы: \sum, \int, \prod
  4. При редактировании формулы результат отображается в режиме реального времени
  5. Для создания новой строки используйте двойной перенос строки

Советы по использованию

  1. Организация заданий: Используйте систему категорий для логической группировки заданий.
  2. Оптимизация PDF: Для лучшего качества PDF:
    • Избегайте слишком длинных формул в одну строку
    • Разбивайте большие задания на логические части
    • Используйте блочные формулы для сложных выражений
  3. Импорт/экспорт: Регулярно экспортируйте данные для резервного копирования.
  4. Изображения: Для лучшего отображения в PDF используйте изображения с разрешением 300 dpi.

Версия системы

Текущая версия системы доступна в файле VERSION в корне проекта или через команду: 

from tasks.version import get_version
print(get_version())