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

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

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

----

Благодарности:
  * Nex
  * Ajenta
  * MasterSet
  * olegus


Можно ли использовать слово "команда", как общее название для строки кода?

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

Предлагаемая структура статей((названия пока какие приходят в голову, потом можно будет придумать получше)):
[[help:contents|Оглавление]]
  * **[[help:introduction|Введение]]**
  * [[help:wtf_qsp|Что такое QSP?]] - статья со скрином QSP (классики) и описанием что есть что. Возможно несколько скринов в разных конфигурациях окна. 
  * [[help:glossary|Словарь]]
  * [[help:keywords|Список ключевых слов]]
  * **[[help:locations|Локации]]** - добавить ссылки на статью про обработчики
  * Программирование (подумать над названием ещё раз, когда будут написаны статьи)
    * **[[help:variables|Переменные]]**
    * [[help:expressions|Выражения]]
    * [[help:dummy|Мусорка]] - скорее всего большинство операторов и функций расползётся по другим статьям - останется что-то типа !комментариев
    * [[help:arrays|Массивы]]
    * [[help:stroki|Строки]],,,[[help:strings|Строки основная статья]]
      * //[[help:reguljarnye_vyrazhenija|Регулярные выражения]]//
    * [[help:conditional|Условные выражения]]
    * [[help:transitions|Переходы]]
    * [[help:loops|Циклы]]
    * [[help:principle|Порядок работы плеера QSP]] ((ака принцип работы))
    * [[help:sluzhebnye_lokacii|Служебные локации]] ((и переменные, задающие обработчики))
      * На каждый аспект отдельная статья, кроссылки с соответствующими аспектам ((инвентарь, переходы и т.п.))
  * Вывод текста
    * [[help:osnovnoe_okno|Основное окно описания]]
    * [[help:dopolnitelnoe_okno|Дополнительное окно описания]]
    * [[help:dialog_window|Диалоговое окно]]
  * [[help:dejstvija|Действия]]
  * [[help:predmety_inventar|Предметы (инвентарь)]]
  * [[help:menju|Меню]]
  * Оформление
    * [[help:sound|Звук]]
    * [[help:graphics|Графика]]
    * [[help:fonts|Шрифты]]
    * [[help:html|HTML]]
  * Расширенные возможности
    * [[help:inputs|Ввод текста игроком]]
    * [[help:files_modules|Работа с файлами, использование модулей]]
    * //Готовые модули//
    * [[help:realtime|Реальное время]]
    * //Нюансы написания игр под разные плееры//
      * //Quest Soft Player//
        * [[help:qsp_license|Лицензия]]
      * //AeroQSP//
        * //Справка по AeroQSP// ((Придется собирать по всему сайту и форумам информацию. Хотя можно тупо ссылки, всё равно плеер устарел))
      * //Quest Navigator//
        * //Список файлов игры//
        * //Файл настроек игры//
        * //Файл шаблона и файл стилей// ((Похоже будет лучше объединить эти две статьи, не могу придумать, как будет  хорошо в разделенном виде)) ((Список id, классов и кусочков body. Разные варианты для разных целей. Возможно ссылки на самоучители))
          * //Шрифты//
        * //Файл JS// ((Список колбэков и переменных. Возможно ссылки на самоучители типа https://learn.javascript.ru/ . Возможно примеры кода для разных целей.))
        * //Нюансы переноса с предыдущих плееров, отличия.//
        * //Гайд по кроссплатформенности// ((я не возмусь писать, но статья нужная для тех, кто будет шаблоны править))
    * //Утилиты или средства разработки// - позже выберу название, которое будет лучше содержанию подходить
      * //[[help:txt2gam|TXT2GAM]]//
      * //[[help:qgen|QGen]] - пока оставлю тут, потом подумаю, нужна ли статья//
  * Фишки ((Фигурные скобки, двумерные массивы и прочие фишки, которые я сейчас не помню или не знаю ака тёмная сторона силы))
  * //Игровые задачи (как сделать)//
  * //Само
    * Структуру самоучителя буду прорабатывать после всего остального. Сначала нормальная документация, потом обучение.учитель - пошаговое написание первой игры.//


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

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

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

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

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