SlovoKrokНа главную

ИНСТРУКЦИЯ ДЛЯ WINDOWS

Первый запуск.
Шаг за шагом.

Не нужно знать программирование. Ниже — что скачать, какие кнопки нажать и как начать первый урок.

1. Подготовьте компьютер

Нужны Windows, интернет и две бесплатные программы: Python и Node.js. Они помогают SlovoKrok работать; писать команды или код не потребуется. Если они уже установлены в подходящих версиях, переходите к скачиванию курса.

Установите Python

  1. Откройте официальную страницу Python для Windows.
  2. Выберите Python версии 3.12 или новее и скачайте установщик для Windows. Для обычного современного компьютера подходит вариант 64-bit.
  3. Откройте скачанный установщик. Если видите флажок Add python.exe to PATH или Add Python to PATH, включите его. Это позволяет приложению найти Python.
  4. Нажмите Install Now и дождитесь завершения. Названия кнопок могут отличаться в разных версиях установщика.

Установите Node.js

  1. Откройте официальный сайт Node.js.
  2. Скачайте установщик для Windows: версию LTS, не ниже 22. LTS означает версию с длительной поддержкой.
  3. Откройте скачанный файл. Проходите шаги кнопкой Next, затем Install; оставьте обычные настройки.
  4. Дождитесь окончания и нажмите Finish.

Next.js — технология, на которой сделан интерфейс курса. Отдельно скачивать её не нужно: SlovoKrok установит её автоматически.

2. Скачайте и установите SlovoKrok

  1. Нажмите скачать SlovoKrok. В папке «Загрузки» появится ZIP — архив с файлами проекта.
  2. Нажмите на архив правой кнопкой мыши и выберите «Извлечь всё…». Выберите отдельную папку, например C:\SlovoKrok, и нажмите «Извлечь».
  3. Откройте распакованную папку. Иногда внутри будет ещё одна папка SlovoKrok-main — откройте её. Вы должны увидеть файлы install.cmd и start.cmd. Windows может скрывать окончание .cmd, показывая только install и start.
  4. Дважды нажмите install.cmd. Откроется окно с текстом: программа скачивает нужные компоненты. При первом запуске это может занять несколько минут. Оставьте интернет включённым и дождитесь завершения.
  5. После окончания установки дважды нажмите start.cmd. Дождитесь страницы курса в браузере. Если она не открылась, введите в адресную строку http://127.0.0.1:3000/.

3. Начните первый урок

  1. Прочитайте приветственное окно — оно показывает основные возможности курса.
  2. Откройте Настройки → Задания и нажмите «Добавить базовый пакет». Он добавит готовые упражнения, тексты и домашние задания. Повторное добавление пакета не должно создавать дубликаты.
  3. Перейдите в «Обучение», выберите первый модуль и первую тему.
  4. Прочитайте объяснение и выполните задания внутри урока. После завершения темы её материалы станут доступны в разделах практики.
  5. Попробуйте упражнения, чтение или домашнее задание. Если затрудняетесь, сохраните ошибку кнопкой «Записать ошибку», чтобы повторить её позже.

Для начала подключать ИИ не нужно. Уроки и базовый пакет доступны без него. Новые задания от ИИ и смысловая проверка свободных ответов требуют отдельного подключения своего провайдера; оно может быть платным. Офлайн-проверка открытого ответа приблизительная.

4. Где что находится

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

5. Как закрыть курс и сохранить работу

Прогресс хранится на вашем компьютере. Общего аккаунта и автоматической синхронизации между устройствами сейчас нет.

  1. Для остановки курса откройте файл stop.cmd в папке проекта.
  2. В следующий раз откройте start.cmd. Повторять установку не нужно.
  3. Перед обновлением или переносом на другой компьютер сохраните резервную копию в настройках. Скачанный файл храните в своей папке. Профиль «О себе» и обращения в резервную копию курса не входят.

6. Если что-то не работает

Окно сообщает, что Python или Node.js не найдены

Проверьте, что вы завершили их установку. Закройте окно SlovoKrok и запустите install.cmd ещё раз. Если сообщение осталось, перезагрузите компьютер и повторите. Для Python проверьте настройку добавления в PATH в установщике.

Установка прервалась или показала ошибку

Убедитесь, что интернет работает и архив полностью распакован. Запустите doctor.cmd из папки курса. Он проверит установку. Скопируйте текст ошибки или сделайте снимок окна и передайте автору проекта. Не нужно самостоятельно менять системные настройки.

Браузер пишет, что страницу невозможно открыть

Сначала запустите start.cmd и дождитесь запуска. Проверьте адрес: http://127.0.0.1:3000/. Если не помогло, откройте doctor.cmd и сообщите автору результат.

Раздел упражнений пока пустой

Добавьте базовый пакет в настройках и завершите соответствующую тему в «Обучении». Пакет доступен в исходниках и не требует генерации через ИИ.

Как сообщить об ошибке внутри курса

  1. На экране с проблемой нажмите значок сообщения внизу слева.
  2. Напишите, что нажимали, чего ожидали и что получилось.
  3. При необходимости нажмите «Снимок экрана» и выберите окно курса. Проверьте, что в кадр не попала личная информация.
  4. Сохраните обращение и нажмите «Скачать ZIP».
  5. Передайте этот ZIP человеку, который пригласил вас тестировать курс. Приложение само обращения не отправляет. Также можно сообщить о проблеме на GitHub.

7. Как обновить приложение

  1. Сохраните резервную копию курса в настройках.
  2. Остановите приложение через stop.cmd.
  3. Скачайте новый ZIP по ссылке выше и распакуйте его в новую папку. Старую папку пока оставьте.
  4. В новой папке запустите install.cmd, затем start.cmd.
  5. Проверьте, что курс и ваш прогресс открылись. На том же компьютере новая версия использует существующие данные. Для другого компьютера потребуется восстановление из резервной копии.

Готово — можно учиться в своём темпе. Вернуться на сайт SlovoKrok.