Здесь показаны различия между двумя версиями данной страницы.
help:qspider_themes [2024/03/13 09:43] aleks_versus создано |
help:qspider_themes [2024/10/14 13:38] (текущий) aleks_versus обновление 5.9.0 |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Темы оформления ====== | ====== Темы оформления ====== | ||
- | qSpider позволяет вам писать собственные темы оформления, которые затем можно переключать прямо из кода игры. Таким образом вы можете написать несколько тем для различных нужд, и включать их по мере необходимости. | + | **qSpider** позволяет вам писать собственные темы оформления, которые затем можно переключать прямо из кода игры. Таким образом вы можете написать несколько тем для различных нужд, и включать их по мере необходимости. |
Например, у вас могут быть различные темы для локаций-помещений и локаций-пустошей. У вас могут быть отдельные темы для локаций-страниц, где вы представляете информацию об игре. Можно оформить темы для визуализации чтения книг, взаимодействия с хранилищами и так далее. | Например, у вас могут быть различные темы для локаций-помещений и локаций-пустошей. У вас могут быть отдельные темы для локаций-страниц, где вы представляете информацию об игре. Можно оформить темы для визуализации чтения книг, взаимодействия с хранилищами и так далее. | ||
Строка 12: | Строка 12: | ||
Свою тему вы можете создать, модифицируя шаблон одной из встроенных тем: | Свою тему вы можете создать, модифицируя шаблон одной из встроенных тем: | ||
- | * [[https://github.com/QSPFoundation/qspider/blob/master/public/themes/classic.html|Классическая]] | + | |
- | * [[https://github.com/QSPFoundation/qspider/blob/master/public/themes/aero.html|Aero]] | + | * [[https://github.com/QSPFoundation/qspider/blob/master/public/themes/classic.html|Классическая]] |
+ | * [[https://github.com/QSPFoundation/qspider/blob/master/public/themes/aero.html|Aero]] | ||
Если вы когда-нибудь стилизовали HTML-разметку с помощью CSS, отредактировать тему для вас не составит труда. | Если вы когда-нибудь стилизовали HTML-разметку с помощью CSS, отредактировать тему для вас не составит труда. | ||
Строка 21: | Строка 22: | ||
<sxh html> | <sxh html> | ||
<qspider-theme name="qspider:classic"> | <qspider-theme name="qspider:classic"> | ||
- | <css-link src="qspider:themes/common.css"></css-link> | + | <css-link src="qspider:themes/common.css"></css-link> |
- | <css-link src="qspider:themes/classic.css"></css-link> | + | <css-link src="qspider:themes/classic.css"></css-link> |
</sxh> | </sxh> | ||
- | В теге ''qspider-theme'' в атрибуте ''name'' указывается название темы. Именно это название в дальнейшем будет использоваться для указания темы по умолчанию и при переключении тем. | + | В теге ''qspider-theme'' в атрибуте ''%%name%%'' указывается название темы. Именно это название в дальнейшем будет использоваться для указания темы по умолчанию и при переключении тем. |
- | Префикс ''qspider:'' в этом атрибуте указывает на то, что тема встроена в плеер, а значит qSpider будет искать эту тему в своих внутренних ресурсах. Названия созданных вами тем должны указываться без префикса ''qspider:''. | + | Префикс ''qspider:'' в этом атрибуте указывает на то, что тема встроена в плеер, а значит **qSpider** будет искать эту тему в своих внутренних ресурсах. Названия созданных вами тем должны указываться без префикса ''qspider:''. |
- | Теги ''css-link'' содержат ссылки на CSS-файлы со стилями для темы. Точно так же: обратите внимание на атрибут ''src''. Префикс ''qspider:'' указывает, что CSS будет браться из внутренних ресурсов плеера. Вам нужно указывать пути без префикса ''qspider:'' для реально существующих в игре файлов. Пути к CSS файлам указываются в темах **относительно конфигурационного файла игры**, в котором эти темы подключаются. | + | Теги ''%%css-link%%'' содержат ссылки на CSS-файлы со стилями для темы. Точно так же: обратите внимание на атрибут ''%%src%%''. Префикс ''qspider:'' указывает, что CSS будет браться из внутренних ресурсов плеера. Вам нужно указывать пути без префикса ''qspider:'' для реально существующих в игре файлов. Пути к CSS файлам указываются в темах **относительно конфигурационного файла игры** (''%%game.cfg%%''), в котором эти темы подключаются. |
===== Подключение тем ===== | ===== Подключение тем ===== | ||
Строка 35: | Строка 36: | ||
Для подключения своих тем к игре, пропишите в файле конфигурации параметры **themes** и **defaultTheme**: | Для подключения своих тем к игре, пропишите в файле конфигурации параметры **themes** и **defaultTheme**: | ||
- | <sxh qsp> | + | <sxh> |
[[game]] | [[game]] | ||
id = "test-asset-qspider" | id = "test-asset-qspider" | ||
Строка 46: | Строка 47: | ||
В параметре **themes** размещается список путей к темам относительно файла конфигурации. | В параметре **themes** размещается список путей к темам относительно файла конфигурации. | ||
- | В параметре **defaultTheme** указывается название темы, которая будет использоваться по умолчанию (атрибут ''name'' тега ''qspider-theme''). | + | В параметре **defaultTheme** указывается название темы, которая будет использоваться по умолчанию (атрибут ''%%name%%'' тега ''qspider-theme''). |
===== Переключение тем ===== | ===== Переключение тем ===== | ||
- | Переключение темы можно производить непосредственно из кода игры, используя [[help:qspider_inclib|встроенную библиотеку]] "''qspider''"". | + | Переключение темы можно производить непосредственно из кода игры, используя [[help:qspider_inclib|встроенную библиотеку]] "''qspider''": |
<sxh qsp> | <sxh qsp> | ||
Строка 56: | Строка 57: | ||
@qspider_change_theme('game-main') | @qspider_change_theme('game-main') | ||
</sxh> | </sxh> | ||
+ | |||
+ | ===== Другие статьи по qSpider ===== | ||
+ | |||
+ | * [[help:qspider|qSpider — общая информация]] | ||
+ | * [[help:qspider_gamecfg|Конфигурационный файл]] | ||
+ | * [[help:qspider_aeroqsp|Особенности запуска и работы игр AeroQSP на qSpider]] | ||
+ | * [[help:qspider_interface|Взаимодействие с интерфейсом]] | ||
+ | * [[help:qspider_spectags|Специальные теги]] | ||
+ | * [[help:qspider_inclib|Встроенная библиотека]] | ||
+ | * [[help:qspider_standalone|Стандалон-сборка игры на qSpider]] | ||
+ |