Различия

Здесь показаны различия между двумя версиями данной страницы.

--- start [2013/06/16 07:43]
admin
+++ start [2025/10/03 11:43] (текущий)
aleks_versus
@@ Строка 1: / Строка 1: @@
-База знаний по [[QSP]] - платформе для разработки текстовых игр.
+====== Справочная информация о платформе Quest Soft Player ======
-Главная цель этой вики - снабдить авторов игр исчерпывающей информацией для разработки.
+Данный цикл статей - основная версия справки по QSP. Здесь собрано всё необходимое для освоения платформы.
-Список статей:
+Обратная связь принимается на форуме: [[https://qsp.org/index.php?option=com_agora&task=topic&id=647&Itemid=57|Новая справка по QSP]].
-  * [[Создание игр на Quest Navigator]]
-Документация по QSP вне этой вики:
+**Текущая редакция Справки составлялась для плееров с версией библиотеки 5.9.4.**
-  * [[http://qsp.su/index.php?option=com_content&task=view&id=59&Itemid=56|Учебник по созданию игр в редакторе QGen]]
-  * [[http://qsp.su/index.php?option=com_content&view=article&id=57&Itemid=56|Раздел "Разработчикам"]]
+//**Есть желание** приобщиться к текстовым играм, но пока **нет идеи**?//
-  * Справка в формате [[http://qsp.su/attachments/qsp564help.zip|zip]] и [[http://qsp.su/index.php?option=com_wrapper&view=wrapper&Itemid=78|онлайн]]
-  * [[http://qsp.su/index.php?option=com_agora&task=topic&id=316&Itemid=57|FAQ для разработчиков]]
+Скачайте “Набор игрока” с [[https://qsp.org/|главной страницы сайта]] и просто поиграйте, чтобы проникнуться идеей таких игр.
+//**Есть желание** начать писать текстовые игры, даже **есть идея**, но **нет опыта** программирования?//
+Смело открывайте [[https://qsp.org/index.php?option=com_content&task=view&id=59&Itemid=56|учебник]], который специально создан для авторов, не имеющих опыта в программировании. Или заходите на канал [[https://www.youtube.com/c/aleksversus|“Пишем игры на QSP”]] на Ютубе, где можно ознакомиться с полным курсом видеоуроков для новичков.
+**Ну а остальных милости просим в эту справку.**
+  * [[help:qsp|Первая статья: что такое QSP?]]
+  * [[help:glossary|Cловарь терминов]]
+  * [[help:keywords|Список ключевых слов. Указатель]]
+  * [[help:limits|Ограничения QSP]]
+Если вам не хватает информации о какой либо команде, обратитесь к [[help:keywords|Списку ключевых слов]], там вы найдёте ссылки на разделы в справочной форме с более подробными описаниями команд.
+В справке встречаются следующие обозначения:
+  * ''%%[выражение]%%'' - значение выражения, которое может быть как текстового, так и числового типа. Это может быть строка текста, число, значение переменной, результат вычисления математической операции, функции и т.п.
+  * ''%%[$выражение]%%'' - значение выражения, которое может быть только текстового (строкового) типа (но при необходимости движок автоматически переведёт число в строку).
+  * ''%%[%выражение]%%'' - значение выражения, которое может быть только кортежем (возвращать кортеж).
+  * ''%%[#выражение]%%'' - значение выражения, которое может быть только числового типа (если возможно, движок автоматически переведёт строку в число).
+  * ''%%{оператор}%%'' - любая команда или несколько команд, в зависимости от контекста
+**Внимание!** Это просто обозначения, а не настоящий QSP-код! Символ ''%%#%%'' использован в справке только чтобы разделить выражения произвольного и числового типов. К синтаксису QSP данный символ отношения не имеет, его не нужно писать перед названиями числовых переменных.
+Примеры:
+<sxh qsp>
+*pl [выражение]
+</sxh>
+В данном случае вместо ''%%[выражение]%%'' может быть подставлено **любое** значение: строка, число, математическое выражение, значение функции или переменной и т.д.
+<sxh qsp>
+addobj [$название]
+</sxh>
+В этом случае вместо ''%%[$название]%%'' может быть подставлено любое **строковое** значение: просто строка текста, результат строкового типа, возвращаемый функцией, значение строковой переменной и т.д.
+<sxh qsp>
+rand([#число])
+</sxh>
+Здесь вместо ''%%[#число]%%'' может быть подставлено любое **числовое** значение: просто число, результат вычисления математического выражения, значение числовой переменной и т.д.
+<sxh qsp>
+%box = [%кортеж]
+</sxh>
+Здесь вместо ''%%[%кортеж]%%'' может быть подставлен любой **кортеж**, или выражение или функция, возвращающие кортеж.
+<sxh qsp>
+{оператор 1} & {оператор 2} & {оператор 3}
+</sxh>
+Здесь вместо ''%%{оператор 1}%%'', ''%%{оператор 2}%%'' и ''%%{оператор 3}%%'' могут стоять любые команды QSP. Например, операторы вывода текста, математические выражения, присвоение значений переменным и другие.
+===== Оффлайн-версия =====
+Вы можете скачать документацию вики для просмотра в оффлайне: [[https://qsp.org/attachments/qsp592help.zip|qsp592help.zip]].
+===== Документация по QSP вне этой вики =====
+  * [[https://qsp.org/index.php?option=com_content&task=view&id=59&Itemid=56|Учебник по созданию игр в редакторе QGen]]
+  * [[https://www.youtube.com/c/aleksversus|Канал на YouTube, посвящённый написанию игр на QSP]]
+  * [[https://qsp.org/index.php?option=com_content&view=article&id=57&Itemid=56|Раздел “Разработчикам”]]
+  * [[https://qsp.org/index.php?option=com_agora&task=forum&id=1&Itemid=57|Обсуждение и разработка игр на форуме]]
+  * Старая справка в формате [[https://qsp.org/attachments/qsp564help.zip|zip]]. Отличия новой от старой справки:
+    * В новой справке текст переработан для упрощения понимания и соответствия текущему синтаксису.
+    * Отсутствуют статьи “Лицензионное соглашение”, “Системные требования”, “Благодарности”
+    * Не вся информация из статей “Подсказки/советы” и “FAQ” вошла в справку.
+  * [[https://qsp.org/index.php?option=com_agora&task=topic&id=316&Itemid=57|FAQ для разработчиков]]
+  * [[https://aleksversus.github.io/howdo_faq/|Онлайн-справочник по самым часто задаваемым вопросам по QSP]]
+===== Поддержка платформы =====
+**Поддержите развитие платформы** и плееров, пожертвовав небольшую сумму **через следующие сервисы**:
+  * **[[https://buymeacoffee.com/varg|Buy me a coffee]]**
+  * **[[https://brianmacdonald.github.io/Ethonate/address#0x4537B99e27deD6C8459C1eFCdE0E7fa48357e44D|Ethereum / EVM]]**
+  * **[[https://www.paypal.com/donate/?hosted_button_id=RB8B6EQW4FW6N|PayPal]]**
+[[help:qsp|Вперёд: Что такое QSP?]]
-Список полезных ссылок:
-  * [[https://www.dokuwiki.org/ru:tips:good_style|Как писать хорошие вики-статьи]]
-  * [[https://www.dokuwiki.org/ru:wiki:syntax|Вики-синтаксис]]
-  * [[https://www.dokuwiki.org/ru:manual|Руководство пользователя]]
-  * [[playground:playground|Песочница (для любого тестирования)]]

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

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

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

Различия

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

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