Различия

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

--- help:html [2020/05/06 17:34]
aleks_versus
+++ help:html [2024/10/14 12:36] (текущий)
aleks_versus обновление 5.9.0
@@ Строка 1: / Строка 1: @@
-[[help:fonts|Назад: Шрифты]]
+[[help:interface|Назад: Настройки интерфейса]]
-=====HTML=====
-**USEHTML** - если отлична от 0, включает возможность использования HTML в описании локации, в дополнительном описании, в списках действий и предметов, а также в диалоге ввода текста, вызываемого функцией "INPUT". Выводимый текст распознаётся как HTML.<sxh qsp>
+====== HTML ======
-usehtml = 1
+При использовании HTML мы можем более гибко управлять внешним видом нашей игры, встраивать в неё изображения и использовать гиперссылки. Это позволяет разгрузить интерфейс от ненужных текстовых элементов, уменьшить число кнопок, и сделать управление игрой более гибким.
+Иными словами HTML помогает нам сделать игру внешне привлекательной и удобной для игрока.
+===== Включение режима распознавания HTML =====
+Чтобы мы могли использовать HTML в нашей игре, необходимо включить режим раcпознавания HTML. Это делается с помощью системной переменной ''%%USEHTML%%''.
+''%%USEHTML%%'' — если значение данной переменной отлично от 0, включает возможность использования HTML в окне основного описания, в окне дополнительного описания, в списках действий и предметов, а также в диалоговых окнах, вызываемых функцией ''%%$INPUT%%'' и оператором ''%%MSG%%''. Выводимый текст распознаётся как HTML.
+<sxh qsp>
+usehtml = 1 & ! включаем режим распознавания HTML
 </sxh>
-Поддерживаемые классическим плеером HTML теги и их атрибуты (для более подробной информации смотрите справочники по HTML):
+По умолчанию в любом плеере **QSP** отключено распознавание HTML, поскольку на старте игры все переменные равны нулю, в т.ч. и ''%%USEHTML%%''. Из-за этого все HTML-теги, выводимые в тексте с помощью соответствующих команд, или в названиях предметов, действий или диалоговых окон ''%%$INPUT%%'' и ''%%MSG%%'', будут отображены на экране, как есть. ((Из этого правила есть исключения. Например, в **qSpider** распознавание HTML включено всегда и не зависит от значения переменной ''%%usehtml%%'')).
-|**тег**|**назначение**|**атрибуты**|
-|A  |[[https://htmlbook.ru/html/a|гиперссылка]] |NAME=[строка] |
+При изменении значения ''%%USEHTML%%'' на число, отличное от нуля, распознавание HTML включится, и сами теги будут скрыты от игрока, а к тексту, выводимому на экран, будет применено форматирование, соответствующее этим тегам.
-|:::|:::|HREF="EXEC:[строка_кода]" |
-|:::|:::| class="plain" |
+===== Код в гиперссылках =====
-|ADDRESS |[[https://htmlbook.ru/html/address|информация об авторе]]| |
-|AREA |[[https://htmlbook.ru/html/area|активные области изображения, которые являются ссылками]]. Используется вместе с тегом MAP| SHAPE=POLY |
+В **QSP** есть возможность запускать код по щелчку на гиперссылке. Для этого мы должны изменить содержимое атрибута **''%%href%%''**.
-|:::|:::| SHAPE=CIRCLE |
-|:::|:::| SHAPE=RECT |
+В этом атрибуте мы прописываем ключевое слово ''%%EXEC%%'', затем без пробелов ставим двоеточие, а после двоеточия в одну строку пишем обычный код **QSP**. Вот пример вставленной в текст гиперссылки, которая ведёт игрока на другую локацию:
-|:::|:::| COORDS=[координаты] |
-|:::|:::| HREF=[ссылка] |
+<sxh qsp>
-|B|[[https://htmlbook.ru/html/b|делает текст жирнее]]| |
+usehtml=1
-|BIG|[[https://htmlbook.ru/html/big|делает текст чуть больше]]| |
-|BLOCKQUOTE |[[https://htmlbook.ru/html/blockquote|цитаты]]| |
+*pl 'В тени сумрачного леса приютился маленький <a href="EXEC: goto ''пряничный_домик'' ">пряничный домик</a>.'
-|BR|[[https://htmlbook.ru/html/br|перевод строки без разрыва абзаца]]| ALIGN=[выравнивание] |
+</sxh>
-|CENTER|[[https://htmlbook.ru/html/center|выравнивание по центру]]| |
-|CITE|[[https://htmlbook.ru/html/cite|цитата или сноска на другой метериал]]| |
+Обратите внимание на используемые в строке кавычки. Поскольку для записи строки мы использовали одинарные кавычки (апострофы), а двойные кавычки использовали для атрибута **href**, пришлось экранировать одинарные кавычки в строке дублированием, чтобы название локации ''%%пряничный_домик%%'' так же было заключено в кавычки. Сравните эту запись со следующей:
-|CODE|[[https://htmlbook.ru/html/code|выделение программного кода]]| |
-|DD|[[http://htmlbook.ru/html/dd|определение]]. Тег используется вместе с тегами DT и DL для создания списка определений| |
+<sxh qsp>
-|DIV|[[https://htmlbook.ru/html/div|выделение блока в документе]]| ALIGN=[выравнивание]|
+*pl "В тени сумрачного леса приютился маленький <a href=""EXEC: goto 'пряничный_домик' "">пряничный домик</a>."
-|DL|[[https://htmlbook.ru/html/dl|список определений]]. Тег используется вместе с тегами DT и DD для создания списка определений| |
+</sxh>
-|DT|[[http://htmlbook.ru/html/dt|термин]]. Тег используется вместе с тегами DD и DL для создания списка определений| |
-|EM|[[https://htmlbook.ru/html/em|акцентирование]]| |
+В гиперссылках нельзя размещать многострочный код, поскольку это нарушает чтение гиперссылок в плеерах, поддерживающих полноценный HTML. Записывайте все команды в одну строку:
-|FONT|[[https://htmlbook.ru/html/font|изменение шрифта]]|COLOR=[цвет]|
-|:::|:::| SIZE=[-2,-1,+0,+1,+2,+3,+4 или 1,2,3,4,5,6,7] |
+<sxh qsp>
-|:::|:::| FACE=[список названий шрифтов] |
+if был_здесь = 0:
-|HR|[[https://htmlbook.ru/html/hr|горизонтальная линия]]|ALIGN=[выравнивание]|
+    яблоки = 10
-|:::|:::|SIZE=[пиксели]|
+    был_здесь = 1
-|:::|:::|WIDTH=[проценты%%|%%пиксели]|
+end
-|:::|:::|NOSHADE|
+*pl "<a href=""EXEC: if яблоки > 0: яблоки-=1 & gt $curloc else: pl 'Яблок больше нет.' "">Яблоки (<<яблоки>> шт.)</a>"
-|H1, H2, H3|[[https://htmlbook.ru/html/h1|заголовки]]| |
+</sxh>
-|H4, H5, H6|:::|:::|
-|I|[[https://htmlbook.ru/html/i|выделение текста курсивом]]| |
+Если нужно выполнить из гиперссылки сложный многострочный код, разместите этот код на отдельной локации, а затем уже вызывайте локацию с помощью ''%%GOSUB%%'' из гиперссылки:
-|IMG|[[https://htmlbook.ru/html/img|вставка изображения]]|SRC=[ссылка]|
-|:::|:::|WIDTH=[пиксели]|
+<sxh qsp>
-|:::|:::|HEIGHT=[пиксели]|
+*pl "<a href=""EXEC: gosub ''взять_яблоко'' "">Яблоки (<<яблоки>> шт.)</a>"
-|:::|:::|ALIGN=TEXTTOP|
+</sxh>
-|:::|:::|ALIGN=CENTER|
-|:::|:::|ALIGN=ABSCENTER|
+Или поместите код в текстовую переменную, а потом выполняйте из гиперссылки с помощью оператора ''%%DYNAMIC%%'':
-|:::|:::|ALIGN=BOTTOM|
-|:::|:::|USEMAP=[ссылка]|
+<sxh qsp>
-|KBD|[[https://htmlbook.ru/html/kbd|текст на клавиатуре]]| |
+$code = {
-|LI|[[https://htmlbook.ru/html/li|элемент маркированного списка]]. Используется совместно с тегами UL или OL| |
+  if яблоки > 0:
-|MAP|[[http://htmlbook.ru/html/map|контейнер для элементов AREA]]|NAME=[строка]|
+    яблоки -= 1
-|OL|[[https://htmlbook.ru/html/ol|нумерованный список]]. Пункты списка устанавливаются тегами LI| |
+    pl 'Вы взяли одно яблоко.'
-|P|[[https://htmlbook.ru/html/p|абзац, параграф]]|ALIGN=[выравнивание]|
+    gt $curloc
-|PRE|[[https://htmlbook.ru/html/pre|предварительно отформатированный текст]]| |
+  else:
-|SAMP|[[https://htmlbook.ru/html/samp|результат вывода программы]]| |
+    pl 'Яблок больше нет.'
-|SMALL|[[https://htmlbook.ru/html/small|немного уменьшает шрифт]]| |
+  end
-|STRIKE|[[http://htmlbook.ru/html/strike|перечёркнутый текст]] (В классическом плеере текст не перечёркивается, а подчёркивается)| |
+}
-|STRONG|[[https://htmlbook.ru/html/strong|акцентирование текста]]. Жирный шрифт| |
+*pl "<a href='EXEC: dynamic $code '>Яблоки (<<яблоки>> шт.)</a>"
-|SUB|[[https://htmlbook.ru/html/sub|нижний индекс]]| |
+</sxh>
-|SUP|[[https://htmlbook.ru/html/sup|верхний индекс]]| |
-|TABLE|[[https://htmlbook.ru/html/table|таблица]]|ALIGN=[выравнивание]|
+===== Особенности работы HTML в разных плеерах =====
-|:::|:::|WIDTH=[проценты%%|%%пиксели]|
-|:::|:::|BORDER=[пиксели]|
+  * Классический плеер поддерживает лишь некоторые HTML-теги. Полный список можно посмотреть на странице [[help:html_classic|HTML-теги поддерживаемые Классическим плеером]].
-|:::|:::|VALIGN=[выравнивание]|
+  * Плеер **qSpider** работает с полноценным браузером, а значит поддерживает все HTML-теги современного стандарта. В том числе и HTML-теги для встраивания видео.
-|:::|:::|BGCOLOR=[цвет]|
+  * Плеер **Quest Navigator** имеет устаревший браузерный движок, который не соответствует современным стандартам, но поддерживает большинство HTML-тегов.
-|:::|:::|CELLSPACING=[пиксели]|
+  * Устаревший плеер **AeroQSP** поддерживает почти все HTML-теги, но поддерживает не все атрибуты, в основном только атрибут **''%%style%%''**.
-|:::|:::|CELLPADDING=[пиксели]|
-|TD|[[https://htmlbook.ru/html/td|ячейка таблицы]]|ALIGN=[выравнивание]|
-|:::|:::|VALIGN=[выравнивание]|
-|:::|:::|BGCOLOR=[цвет]|
-|:::|:::|WIDTH=[проценты%%|%%пиксели]|
-|:::|:::|COLSPAN=[количество]|
-|:::|:::|ROWSPAN=[количество]|
-|:::|:::|NOWRAP|
-|TH|[[https://htmlbook.ru/html/th|заголовок таблицы]]|ALIGN=[выравнивание]|
-|:::|:::|VALIGN=[выравнивание]|
-|:::|:::|BGCOLOR=[цвет]|
-|:::|:::|WIDTH=[проценты%%|%%пиксели]|
-|:::|:::|COLSPAN=[количество]|
-|:::|:::|ROWSPAN=[количество]|
-|TR|[[https://htmlbook.ru/html/tr|строка таблицы]]|ALIGN=[выравнивание]|
-|:::|:::|VALIGN=[выравнивание]|
-|:::|:::|BGCOLOR=[цвет]|
-|TT|[[https://htmlbook.ru/html/tt|моноширинный текст]]| |
-|U|[[https://htmlbook.ru/html/u|подчёркивание текста]]| |
-|UL|[[https://htmlbook.ru/html/ul|маркированный список]]. Пункты списка устанавливаются тегами LI| |
-----
 [[help:inputs|Вперёд: Ввод текста игроком]]

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

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

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

Различия

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

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