Различия

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

--- help:html [2013/11/07 13:33]
newsash
+++ help:html [2024/10/14 12:36] (текущий)
aleks_versus обновление 5.9.0
@@ Строка 1: / Строка 1: @@
-[[help:fonts|Назад: Шрифты]]
+[[help:interface|Назад: Настройки интерфейса]]
-=====HTML=====
-USEHTML - если отлична от 0, включает возможность использования HTML в описании локации, в дополнительном описании, в списках действий и предметов, а также в диалоге ввода текста, вызываемого функцией "INPUT". Выводимый текст распознаётся как HTML. Список поддерживаемых тегов и их атрибутов смотрите в приложении.
+====== HTML ======
-Поддерживаемые HTML теги и их атрибуты (для более подробной информации смотрите справочники по HTML):
+При использовании HTML мы можем более гибко управлять внешним видом нашей игры, встраивать в неё изображения и использовать гиперссылки. Это позволяет разгрузить интерфейс от ненужных текстовых элементов, уменьшить число кнопок, и сделать управление игрой более гибким.
-|A  | NAME=[строка] |
-|:::| HREF="EXEC:[строка_кода]" |
+Иными словами HTML помогает нам сделать игру внешне привлекательной и удобной для игрока.
-|:::| class="plain" |
-|ADDRESS | |
+===== Включение режима распознавания HTML =====
-|AREA | SHAPE=POLY |
-|:::| SHAPE=CIRCLE |
+Чтобы мы могли использовать HTML в нашей игре, необходимо включить режим раcпознавания HTML. Это делается с помощью системной переменной ''%%USEHTML%%''.
-|:::| SHAPE=RECT |
-|:::| COORDS=[координаты] |
+''%%USEHTML%%'' — если значение данной переменной отлично от 0, включает возможность использования HTML в окне основного описания, в окне дополнительного описания, в списках действий и предметов, а также в диалоговых окнах, вызываемых функцией ''%%$INPUT%%'' и оператором ''%%MSG%%''. Выводимый текст распознаётся как HTML.
-|:::| HREF=[ссылка] |
-|B|
+<sxh qsp>
-|BIG|
+usehtml = 1 & ! включаем режим распознавания HTML
-|BLOCKQUOTE | |
+</sxh>
-|BR| ALIGN=[выравнивание] |
-|CENTER|
+По умолчанию в любом плеере **QSP** отключено распознавание HTML, поскольку на старте игры все переменные равны нулю, в т.ч. и ''%%USEHTML%%''. Из-за этого все HTML-теги, выводимые в тексте с помощью соответствующих команд, или в названиях предметов, действий или диалоговых окон ''%%$INPUT%%'' и ''%%MSG%%'', будут отображены на экране, как есть. ((Из этого правила есть исключения. Например, в **qSpider** распознавание HTML включено всегда и не зависит от значения переменной ''%%usehtml%%'')).
-|CITE|
-|CODE|
+При изменении значения ''%%USEHTML%%'' на число, отличное от нуля, распознавание HTML включится, и сами теги будут скрыты от игрока, а к тексту, выводимому на экран, будет применено форматирование, соответствующее этим тегам.
-|DD|
-|DIV| ALIGN=[выравнивание]|
+===== Код в гиперссылках =====
-|DL|
-|DT|
+В **QSP** есть возможность запускать код по щелчку на гиперссылке. Для этого мы должны изменить содержимое атрибута **''%%href%%''**.
-|EM|
-|FONT| COLOR=[цвет]|
+В этом атрибуте мы прописываем ключевое слово ''%%EXEC%%'', затем без пробелов ставим двоеточие, а после двоеточия в одну строку пишем обычный код **QSP**. Вот пример вставленной в текст гиперссылки, которая ведёт игрока на другую локацию:
-|:::| SIZE=[-2,-1,+0,+1,+2,+3,+4 или 1,2,3,4,5,6,7] |
-|:::| FACE=[список названий шрифтов] |
+<sxh qsp>
-|HR|ALIGN=[выравнивание]|
+usehtml=1
-|:::|SIZE=[пиксели]|
-|:::|WIDTH=[проценты%%|%%пиксели]|
+*pl 'В тени сумрачного леса приютился маленький <a href="EXEC: goto ''пряничный_домик'' ">пряничный домик</a>.'
-|NOSHADE|
+</sxh>
-|H1, H2, H3|
-|H4, H5, H6|
+Обратите внимание на используемые в строке кавычки. Поскольку для записи строки мы использовали одинарные кавычки (апострофы), а двойные кавычки использовали для атрибута **href**, пришлось экранировать одинарные кавычки в строке дублированием, чтобы название локации ''%%пряничный_домик%%'' так же было заключено в кавычки. Сравните эту запись со следующей:
-|I|
-|IMG|SRC=[ссылка]|
+<sxh qsp>
-|:::|WIDTH=[пиксели]|
+*pl "В тени сумрачного леса приютился маленький <a href=""EXEC: goto 'пряничный_домик' "">пряничный домик</a>."
-|:::|HEIGHT=[пиксели]|
+</sxh>
-|:::|ALIGN=TEXTTOP|
-|:::|ALIGN=CENTER|
+В гиперссылках нельзя размещать многострочный код, поскольку это нарушает чтение гиперссылок в плеерах, поддерживающих полноценный HTML. Записывайте все команды в одну строку:
-|:::|ALIGN=ABSCENTER|
-|:::|ALIGN=BOTTOM|
+<sxh qsp>
-|:::|USEMAP=[ссылка]|
+if был_здесь = 0:
-|KBD|
+    яблоки = 10
-|LI|
+    был_здесь = 1
-|MAP|NAME=[строка]|
+end
-|OL|
+*pl "<a href=""EXEC: if яблоки > 0: яблоки-=1 & gt $curloc else: pl 'Яблок больше нет.' "">Яблоки (<<яблоки>> шт.)</a>"
-|P|ALIGN=[выравнивание]|
+</sxh>
-|PRE|
-|SAMP|
+Если нужно выполнить из гиперссылки сложный многострочный код, разместите этот код на отдельной локации, а затем уже вызывайте локацию с помощью ''%%GOSUB%%'' из гиперссылки:
-|SMALL|
-|STRIKE|
+<sxh qsp>
-|STRONG|
+*pl "<a href=""EXEC: gosub ''взять_яблоко'' "">Яблоки (<<яблоки>> шт.)</a>"
-|SUB|
+</sxh>
-|SUP|
-|TABLE|ALIGN=[выравнивание]|
+Или поместите код в текстовую переменную, а потом выполняйте из гиперссылки с помощью оператора ''%%DYNAMIC%%'':
-|:::|WIDTH=[проценты%%|%%пиксели]|
-|:::|BORDER=[пиксели]|
+<sxh qsp>
-|:::|VALIGN=[выравнивание]|
+$code = {
-|:::|BGCOLOR=[цвет]|
+  if яблоки > 0:
-|:::|CELLSPACING=[пиксели]|
+    яблоки -= 1
-|:::|CELLPADDING=[пиксели]|
+    pl 'Вы взяли одно яблоко.'
-|TD|ALIGN=[выравнивание]|
+    gt $curloc
-|:::|VALIGN=[выравнивание]|
+  else:
-|:::|BGCOLOR=[цвет]|
+    pl 'Яблок больше нет.'
-|:::|WIDTH=[проценты%%|%%пиксели]|
+  end
-|:::|COLSPAN=[количество]|
+}
-|:::|ROWSPAN=[количество]|
+*pl "<a href='EXEC: dynamic $code '>Яблоки (<<яблоки>> шт.)</a>"
-|NOWRAP|
+</sxh>
-|TH|ALIGN=[выравнивание]|
-|:::|VALIGN=[выравнивание]|
+===== Особенности работы HTML в разных плеерах =====
-|:::|BGCOLOR=[цвет]|
-|:::|WIDTH=[проценты%%|%%пиксели]|
+  * Классический плеер поддерживает лишь некоторые HTML-теги. Полный список можно посмотреть на странице [[help:html_classic|HTML-теги поддерживаемые Классическим плеером]].
-|:::|COLSPAN=[количество]|
+  * Плеер **qSpider** работает с полноценным браузером, а значит поддерживает все HTML-теги современного стандарта. В том числе и HTML-теги для встраивания видео.
-|:::|ROWSPAN=[количество]|
+  * Плеер **Quest Navigator** имеет устаревший браузерный движок, который не соответствует современным стандартам, но поддерживает большинство HTML-тегов.
-|TR|ALIGN=[выравнивание]|
+  * Устаревший плеер **AeroQSP** поддерживает почти все HTML-теги, но поддерживает не все атрибуты, в основном только атрибут **''%%style%%''**.
-|:::|VALIGN=[выравнивание]|
-|:::|BGCOLOR=[цвет]|
-|TT|
-|U|
-|UL|
-----
 [[help:inputs|Вперёд: Ввод текста игроком]]

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

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

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

Различия

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

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