Документация QSP

СайтФорум

• Должна быть статья, которая отсылает ошибшихся адресом по адресу
  • Логично разместить нечто подобное в стартовую статью Вики
  • Сейчас это "Введение"
    • А куда девать ссылку про обратную связь на форум?
      • На данном этапе развития справки её (ссылку) должны видеть все, кто заходят в справку
      • И она должна бросаться в глаза, чтобы человек знал "Ага, обратная связь от меня нужна и может помочь"

• Регулярные выражения
• Нет ссылок на оглавление
• Куда писать про подвыражения?
  • Разбить строковые константы и строковые функции на две статьи
  • Строки сразу после переменных
  • Подвыражения в выражениях
• Возможно программирование стоит перенести ниже в оглавлении
• Концепция "блоков кода"
• Концепция переменных с двумя значениями
• Вынести базовые функции из программного кода?
• KILLVAR, KILLALL
• CLA
• В какой момент обрабатываются подвыражения?
• Пересортировать статьи в Вики

• Отдельно упомянуть отличие операторов и системных переменных ¹⁾
• Дополнительное окно описания и окно пользователя - одно и то же, нечеткость терминологии.
• Проверить IIF на запись выражений через &.
• Фигурные скобки = третий вид кавычек?
• Возможно статью "Известные баги"
• Упомянуть, что if ($строка) не работает, ошибка типов данных
• ADDQST не работает в Aero, в Aero работает ADDLIB
• Из справки по QSP 5.6.4 не использованы (не распиханы по статьям) благодарности, минимальные требования, FAQ

Оглавление

• introduction
• Что такое QSP? - статья со скрином QSP (классики) и описанием что есть что. Возможно несколько скринов в разных конфигурациях окна.
• Словарь
• Список ключевых слов
• Локации
• Программирование (подумать над названием ещё раз, когда будут написаны статьи)
  • Переменные
  • Выражения
  • Программный код - возможно перенести CURLOC.
  • Массивы
  • Строки
    • Регулярные выражения
  • Условия
  • Пользовательские функции и процедуры
  • Переходы внутри локации
  • Порядок работы интерпретатора
  • Служебные локации ²⁾
    • На каждый аспект отдельная статья, кроссылки с соответствующими аспектам ³⁾
  • Динамический код
• Вывод текста
  • Основное окно описания
  • Дополнительное окно описания
  • Диалоговое окно
• Действия
• Предметы (инвентарь)
• Меню
• Оформление
  • Звук
  • Графика
  • Шрифты
  • HTML
• Расширенные возможности
  • Ввод текста игроком
  • Работа с файлами, использование модулей
  • Готовые модули
  • Реальное время
  • Нюансы написания игр под разные плееры
    • Quest Soft Player
      • Лицензия
    • AeroQSP
      • Справка по AeroQSP ⁴⁾
    • Quest Navigator
      • Список файлов игры
      • Файл настроек игры
      • Файл шаблона и файл стилей ^{5) 6)}
        • Шрифты
      • Файл JS ⁷⁾
      • Нюансы переноса с предыдущих плееров, отличия.
      • Гайд по кроссплатформенности ⁸⁾
  • Утилиты или средства разработки - позже выберу название, которое будет лучше содержанию подходить
    • TXT2GAM
    • QGen - пока оставлю тут, потом подумаю, нужна ли статья
• Фишки ⁹⁾
• Игровые задачи (как сделать)
• Само * Структуру самоучителя буду прорабатывать после всего остального. Сначала нормальная документация, потом обучение.учитель - пошаговое написание первой игры.