init

map-editor/INDEX.md

@@ -0,0 +1,119 @@
+# 📑 Индекс файлов редактора карт
+
+## 📚 Документация
+
+| Файл | Описание |
+|------|----------|
+| **README.md** | Полная документация с инструкциями |
+| **QUICKSTART.md** | Быстрый старт за 2 минуты |
+| **FEATURES.md** | Подробное описание всех возможностей |
+| **INDEX.md** | Этот файл - навигация по проекту |
+
+## 🎯 Основные файлы
+
+| Файл | Тип | Описание |
+|------|-----|----------|
+| **index.html** | HTML | Главная страница редактора |
+| **editor.js** | JS | Логика редактора и визуализации |
+| **open-editor.sh** | Shell | Скрипт для быстрого запуска |
+
+## 🗺️ Примеры карт
+
+| Файл | Размер | Описание |
+|------|--------|----------|
+| **simple-track.json** | 10×10 | Простая трасса для начинающих |
+| **demo-with-start.json** | 15×15 | Демонстрационная карта с препятствиями |
+| **example-maps.json** | Разные | Коллекция из 5 различных карт |
+
+### Содержимое example-maps.json:
+1. Simple Track (10×10) - простая трасса
+2. Ice Circuit (10×10) - карта с ледяными участками
+3. Obstacle Course (15×15) - сложная карта с препятствиями
+4. Minimal (5×5) - минимальная карта для тестирования
+5. Empty Large (20×20) - пустая карта для создания
+
+## 🎬 Примеры решений
+
+| Файл | Шагов | Сложность | Рекомендуется для |
+|------|-------|-----------|-------------------|
+| **example-solution.json** | 10 | Простая | simple-track.json |
+| **complex-solution.json** | 20 | Сложная | Любой карты |
+| **demo-solution.json** | 15 | Средняя | demo-with-start.json |
+
+## 🚀 Быстрый старт
+
+### Вариант 1: Просмотр примера
+1. Откройте `index.html`
+2. Импортируйте `demo-with-start.json`
+3. Загрузите решение `demo-solution.json`
+4. Нажмите ▶ Play
+
+### Вариант 2: Создание своей карты
+1. Откройте `index.html`
+2. Создайте карту с помощью инструментов
+3. Экспортируйте в JSON
+4. Используйте в игре
+
+## 📖 Рекомендуемый порядок чтения
+
+Для новичков:
+1. 📄 **QUICKSTART.md** - начните здесь
+2. 🎮 Поэкспериментируйте с редактором
+3. 📚 **README.md** - полная документация
+4. 🎯 **FEATURES.md** - подробности
+
+Для опытных:
+1. 📚 **README.md** - вся информация сразу
+2. 🎯 **FEATURES.md** - технические детали
+
+## 🎨 Типы ячеек
+
+| Код | Тип | Цвет | Маркер |
+|-----|-----|------|--------|
+| 0 | Дорога | Светло-серый | - |
+| 1 | Камень | Тёмно-серый | - |
+| 2 | Снег | Голубой | - |
+| 3 | Лёд | Светло-голубой | - |
+| 4 | Чекпоинт | Жёлтый | C |
+| 5 | Старт | Зелёный | S |
+
+## 📦 Форматы файлов
+
+### Карта (map)
+```json
+{
+  "map": [[0, 1, 2], [3, 4, 5]]
+}
+```
+
+### Решение (solution)
+```json
+{
+  "solution": [[1, 0], [0, 1], [-1, 0]]
+}
+```
+
+## 🔗 Полезные ссылки
+
+- [Основной README проекта](../README.md)
+- [Документация BFS алгоритма](../README.md)
+- [Документация A* алгоритма](../ASTAR-README.md)
+
+## 💡 Быстрые команды
+
+```bash
+# Открыть редактор
+./open-editor.sh
+
+# Или напрямую в браузере
+firefox index.html
+chrome index.html
+```
+
+---
+
+**Создано**: 2025-10-19  
+**Версия**: 2.0 (с визуализацией решений)  
+**Технологии**: HTML5, CSS3, JavaScript ES6+, Canvas API
+
+