Документация QSP
Сайт Форум

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
__**Эта страница создана newsash, чтобы продумать и обсудить, что нужно сделать по документации**__

__**Да-да, это служебная страница**__

----


====Структура статей====

Предлагаемая структура статей((названия пока какие приходят в голову, потом можно будет придумать получше)):
  * Плееры
    * Quest Soft Player ((Я так понимаю сюда из базовой справки пойдут лицензия, системные требования и благодарности?))
    * AeroQSP
      * Справка по AeroQSP ((Придется собирать по всему сайту и форумам информацию.))
    * Quest Navigator
      * Список файлов игры
      * Файл настроек игры
      * Файл шаблона и файл стилей ((Похоже будет лучше объединить эти две статьи, не могу придумать, как будет  хорошо в разделенном виде)) ((Список id, классов и кусочков body. Разные варианты для разных целей. Возможно ссылки на самоучители))
        * Шрифты
      * Файл JS ((Список колбэков и переменных. Возможно ссылки на самоучители типа http://learn.javascript.ru/ . Возможно примеры кода для разных целей.))
      * Нюансы переноса с предыдущих плееров, отличия.
      * Гайд по кроссплатформенности ((я не возмусь писать, но статья нужная для тех, кто будет шаблоны править))
  * Редакторы
    * QGen ((Возможно справка по QGen))
    * TXT2GAM
  * Синтаксис QSP ((Хочу изменить разделение справки по функциям, операторам и т.п. Это неудобно. Пусть будет смысловое разделение))
    * Статья со скрином QSP (классики) и описанием что есть что. Возможно несколько скринов в разных конфигурациях окна. 
    * Базовый синтаксис
      * Переменные, выражения, базовые операторы и функции ((большинство раскидаю по другим статьям - всякие P,PL,CLR и т.п.))
      * Массивы ((Использование массивов, функции))
      * Работа со строками
        * Регулярные выражения
      * Условные выражения и переходы
        * Ссылка на многострочные IF/ACT
        * Циклы
    * Порядок работы QSP ((ака принцип работы))
    * Работа с основным и дополнительным окном
    * Работа с действиями
      * Ссылка на многострочные IF/ACT
    * Работа с инвентарём
    * Ввод текста пользователем ((Строка и диалог))
    * Мультимедиа и оформление ((звук, VIEW, цвет текста и т.п.))
    * Работа с файлами, использование модулей
    * Служебные локации ((и переменные, задающие обработчики))
    * Меню для предметов
    * HTML ((для каждого из плееров))
    * Фишки ((Фигурные скобки, двумерные массивы и прочие фишки, которые я сейчас не помню или не знаю))
  * Готовые модули
    * всякие там
  * Самоучитель
    * Структуру самоучителя буду прорабатывать после всего остального. Сначала нормальная документация, потом обучение.


====Всякие нюансы, которые должны быть упомянуты, и памятка для себя====
  * Операция сложения пытается привести строку к числу (($test = '1' & $test += 1)). Возможно другие тоже.
  * Отдельно упомянуть отличие операторов и системных переменных (("SHOWACTS 1", но "USEHTML **=** 1"))
  * Дополнительное окно описания и окно пользователя - одно и то же, нечеткость терминологии.
  * Проверить IIF на запись выражений через &.
  * OR и AND побитовые, проверить
  * Фигурные скобки = третий вид кавычек?
  * Вставить про опасность совместного использования числовых и текстовых индексов массива.
  * Возможно статью "Известные баги"
  * Впихнуть куда-нибудь статью со стандартными приставками к названию локаций и прочим "хорошим тоном удобного программирования"
  * Упомянуть, что if ($строка) не работает, ошибка типов данных
Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Инструменты страницы

Документация QSP
Сайт Форум
