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

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

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

----


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

Предлагаемая структура статей((названия пока какие приходят в голову, потом можно будет придумать получше)):

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


====Всякие нюансы, которые должны быть упомянуты, и памятка для себя====
  * Операция сложения пытается привести строку к числу (($test = '1' & $test += 1)). Возможно другие тоже.
  * Отдельно упомянуть отличие операторов и системных переменных (("SHOWACTS 1", но "USEHTML **=** 1"))
  * Дополнительное окно описания и окно пользователя - одно и то же, нечеткость терминологии.
  * Проверить IIF на запись выражений через &.
  * OR и AND побитовые, проверить
  * Фигурные скобки = третий вид кавычек?
  * Вставить про опасность совместного использования числовых и текстовых индексов массива.
  * Возможно статью "Известные баги"
  * Впихнуть куда-нибудь статью со стандартными приставками к названию локаций и прочим "хорошим тоном удобного программирования"
  * Упомянуть, что if ($строка) не работает, ошибка типов данных
  * ADDQST не работает в Aero
  * Модули olegus'a:
    * http://forum.ifiction.ru/viewtopic.php?id=1613 - экран
    * http://forum.ifiction.ru/viewtopic.php?id=1522 - таблицы данных
    * http://forum.ifiction.ru/viewtopic.php?id=1527 - меню
    * http://forum.ifiction.ru/viewtopic.php?id=1540 - форматирование текста
    * http://forum.ifiction.ru/viewtopic.php?id=1873 - таймер
Документация QSPСайтФорум

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

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

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

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