Шаблон:Магический предмет: различия между версиями

Текущая версия от 12:24, 2 июня 2025

Документация шаблона: Магический_предмет

Этот шаблон предназначен для отображения информационного блока (инфобокса) о магическом предмете. Основное текстовое описание предмета (магические свойства, история и т.д.) размещается на странице отдельно, после вызова этого шаблона.

Автоматическая категоризация: Этот шаблон автоматически добавляет страницы, на которых он используется, в следующие категории:

(всегда)
Категорию, соответствующую значению параметра `Классификация` (например, ).
Категорию, соответствующую значению параметра `Редкость` (например, , если параметр `Редкость` = "Редкий").
, если параметр `Тип` указан как "Амулет".
, если параметр `Тип` указан как "Артефакт".

Использование

{{Магический_предмет
|Изображение= ВашеИзображение.jpg
|Внешний_вид= Описание внешнего вида.
|Редкость=    Редкий
|Тип=         Артефакт
|Классификация= Артефакты защитные и нейтрализующие
|Владелец=    [[ИмяПерсонажа]]
|Статус=      Не функционирует
}}

== Магические свойства ==
...
== История ==
...

Если вы хотите, чтобы основной текст страницы (например, разделы "Магические свойства", "История") обтекал инфобокс с левой стороны, вы можете использовать специальную CSS-разметку, описанную ниже (см. раздел "CSS и структура страницы для обтекания").

Параметры шаблона

Шаблон для отображения инфобокса о магическом предмете. Автоматически добавляет страницу в категории: 'Магические предметы', категорию согласно Классификации, категорию по Редкости (например, 'Редкие предметы'), а также 'Амулеты' или 'Артефакты' в зависимости от Типа.

Параметры шаблона[Править данные шаблона]
Шаблон использует строчное форматирование параметров.
Параметр		Описание	Тип	Статус
Изображение	`Изображение`	Имя файла изображения предмета (например, Anathema.jpg). Отображается в инфобоксе. Пример Anathema.jpg	Имя файла	предложенный
Внешний вид	`Внешний_вид`	Краткое текстовое описание внешнего вида предмета. Пример Кулон из необработанного гематита на шнурке	Строковый (без форматирования)	необязательный
Редкость	`Редкость`	Редкость предмета. Влияет на цвет отображения в инфобоксе и добавляет соответствующую категорию (например, 'Редкие предметы'). Предлагаемые значения `Обычный` `Необычный` `Редкий` `Эпический` `Легендарный` Пример Редкий	Строковый (без форматирования)	необязательный
Тип	`Тип`	Тип предмета (например, Артефакт, Амулет, Оружие). Используется для категоризации как 'Амулеты' или 'Артефакты'. Пример Артефакт	Однострочный	необязательный
Классификация	`Классификация`	Основная функциональная классификация предмета. Используется для автоматической категоризации. Предлагаемые значения `Артефакты защитные и нейтрализующие` `Артефакты воздействия на сознание и эмоции` `Артефакты манипуляции способностями и жизненной силой` `Артефакты с негативными последствиями и проклятиями` `Артефакты связи, информации и сокрытия` `Артефакты призыва, пленения и контроля существ` `Артефакты утилитарные и специализированные` Пример Артефакты защитные и нейтрализующие	Строковый (без форматирования)	необязательный
Владелец(ы)	`Владелец`	Текущий владелец или владельцы предмета. Используйте вики-ссылки для страниц персонажей (например, [[Фил Морган]], [[Еще Ктото]]). Пример [[Фил Морган]]	Однострочный	необязательный
Статус	`Статус`	Текущий статус предмета. Некоторые значения меняют цвет текста. Предлагаемые значения `В игре` `Не функционирует` `Утрачен` `Разрушен` `Активен` Пример Не функционирует	Строковый (без форматирования)	необязательный

CSS и структура страницы для обтекания

Чтобы текст ("Магические свойства", "История") корректно располагался справа от инфобокса, соответствующие CSS-стили должны быть добавлены на страницу `MediaWiki:Common.css` вашей вики. Сами стили для классов `.item-infobox`, `.item-main-content` и цветовых классов (`.text-green` и т.д.) остаются теми же, что обсуждались ранее.

Примерная структура страницы для достижения такого эффекта:

<div class="item-page-container">
  {{Магический_предмет
  | ... (все параметры) ...
  }}
  <div class="item-main-content">
    == Магические свойства ==
    ...
    == История ==
    ...
  </div>
  <div style="clear:both;"></div>
</div>

@@ Строка 1: / Строка 1: @@
-<div class="item-infobox">
+<includeonly><div class="left-infobox">
-   <div style="font-weight:bold; font-size:1.2em; margin-bottom:10px; text-align:center;">О предмете</div>
+   <div class="infobox-caption">О предмете</div>
-   <table class="wikitable item-infobox-table">
+   <table class="wikitable infobox-table">
      {{#if:{{{Изображение|}}}|
        <tr><td colspan="2" style="text-align:center;">[[File:{{{Изображение}}}|250px|link=]]</td></tr>
@@ Строка 29: / Строка 29: @@
          <th>Тип</th>
          <td>{{{Тип}}}</td>
+      </tr>
+    }}
+    {{#if:{{{Классификация|}}}|
+      <tr>
+        <th>Классификация</th>
+        <td>{{{Классификация}}}</td>
        </tr>
      }}
@@ Строка 51: / Строка 57: @@
      }}
    </table>
-</div><noinclude>
+</div>[[Категория:Магические предметы]]
+{{#switch:{{{Классификация|}}}
+  |Артефакты защитные и нейтрализующие=[[Категория:Артефакты защитные и нейтрализующие]]
+  |Артефакты воздействия на сознание и эмоции=[[Категория:Артефакты воздействия на сознание и эмоции]]
+  |Артефакты манипуляции способностями и жизненной силой=[[Категория:Артефакты манипуляции способностями и жизненной силой]]
+  |Артефакты с негативными последствиями и проклятиями=[[Категория:Артефакты с негативными последствиями и проклятиями]]
+  |Артефакты связи, информации и сокрытия=[[Категория:Артефакты связи, информации и сокрытия]]
+  |Артефакты призыва, пленения и контроля существ=[[Категория:Артефакты призыва, пленения и контроля существ]]
+  |Артефакты утилитарные и специализированные=[[Категория:Артефакты утилитарные и специализированные]]
+}}
+{{#switch:{{{Тип|}}}
+  |Амулет=[[Категория:Амулеты]]
+  |Артефакт=[[Категория:Артефакты]]
+}}
+{{#switch:{{{Редкость|}}}
+  |Обычный=[[Категория:Обычные предметы]]
+  |Необычный=[[Категория:Необычные предметы]]
+  |Редкий=[[Категория:Редкие предметы]]
+  |Эпический=[[Категория:Эпические предметы]]
+  |Легендарный=[[Категория:Легендарные предметы]]
+}}</includeonly><noinclude>
 == Документация шаблона: Магический_предмет ==
 Этот шаблон предназначен для отображения информационного блока (инфобокса) о магическом предмете. Основное текстовое описание предмета (магические свойства, история и т.д.) размещается на странице отдельно, после вызова этого шаблона.
+'''Автоматическая категоризация:'''
+Этот шаблон автоматически добавляет страницы, на которых он используется, в следующие категории:
+* [[Категория:Магические предметы]] (всегда)
+* Категорию, соответствующую значению параметра `Классификация` (например, [[Категория:Артефакты защитные и нейтрализующие]]).
+* Категорию, соответствующую значению параметра `Редкость` (например, [[Категория:Редкие предметы]], если параметр `Редкость` = "Редкий").
+* [[Категория:Амулеты]], если параметр `Тип` указан как "Амулет".
+* [[Категория:Артефакты]], если параметр `Тип` указан как "Артефакт".
 === Использование ===
-Чтобы использовать шаблон, вставьте следующий код в начало страницы предмета:
 <pre>
 {{Магический_предмет
 |Изображение= ВашеИзображение.jpg
-|Внешний_вид= Описание внешнего вида предмета.
+|Внешний_вид= Описание внешнего вида.
 |Редкость=    Редкий
 |Тип=         Артефакт
-|Владелец=    [[ИмяПерсонажа]]
+|Классификация= Артефакты защитные и нейтрализующие
-|Статус=      Не функционирует }}
+|Владелец=    [[ИмяПерсонажа]]
+|Статус=      Не функционирует
+}}
 == Магические свойства ==
-Здесь подробно описываются магические свойства предмета.
+...
-Этот текст размещается ''после'' вызова шаблона.
 == История ==
-Здесь описывается история происхождения и использования предмета.
+...
-Этот текст также размещается ''после'' вызова шаблона.
 </pre>
@@ Строка 78: / Строка 110: @@
 === Параметры шаблона ===
-Ниже приведено описание параметров, которое также используется для TemplateData.
 <templatedata>
 {
-	"description": "Шаблон для отображения информационного блока (инфобокса) о магическом предмете.",
+	"description": "Шаблон для отображения инфобокса о магическом предмете. Автоматически добавляет страницу в категории: 'Магические предметы', категорию согласно Классификации, категорию по Редкости (например, 'Редкие предметы'), а также 'Амулеты' или 'Артефакты' в зависимости от Типа.",
 	"params": {
 		"Изображение": {
@@ Строка 99: / Строка 129: @@
 		"Редкость": {
 			"label": "Редкость",
-			"description": "Редкость предмета. Влияет на цвет отображения.",
+			"description": "Редкость предмета. Влияет на цвет отображения в инфобоксе и добавляет соответствующую категорию (например, 'Редкие предметы').",
 			"type": "string",
 			"suggestedvalues": [
@@ Строка 112: / Строка 142: @@
 		"Тип": {
 			"label": "Тип",
-			"description": "Тип предмета (например, Артефакт, Амулет, Оружие).",
+			"description": "Тип предмета (например, Артефакт, Амулет, Оружие). Используется для категоризации как 'Амулеты' или 'Артефакты'.",
 			"type": "line",
 			"example": "Артефакт"
+		},
+		"Классификация": {
+			"label": "Классификация",
+			"description": "Основная функциональная классификация предмета. Используется для автоматической категоризации.",
+			"type": "string",
+			"suggestedvalues": [
+				"Артефакты защитные и нейтрализующие",
+				"Артефакты воздействия на сознание и эмоции",
+				"Артефакты манипуляции способностями и жизненной силой",
+				"Артефакты с негативными последствиями и проклятиями",
+				"Артефакты связи, информации и сокрытия",
+				"Артефакты призыва, пленения и контроля существ",
+				"Артефакты утилитарные и специализированные"
+			],
+			"example": "Артефакты защитные и нейтрализующие"
 		},
 		"Владелец": {
@@ Строка 141: / Строка 186: @@
 		"Редкость",
 		"Тип",
+		"Классификация",
 		"Владелец",
 		"Статус"
@@ Строка 149: / Строка 195: @@
 === CSS и структура страницы для обтекания ===
-Чтобы текст ("Магические свойства", "История") корректно располагался справа от инфобокса, соответствующие CSS-стили (см. ниже) должны быть добавлены на страницу `MediaWiki:Common.css` вашей вики. Сами стили для классов `.item-infobox`, `.item-main-content` и цветовых классов (`.text-green` и т.д.) остаются теми же, что обсуждались ранее.
+Чтобы текст ("Магические свойства", "История") корректно располагался справа от инфобокса, соответствующие CSS-стили должны быть добавлены на страницу `MediaWiki:Common.css` вашей вики. Сами стили для классов `.item-infobox`, `.item-main-content` и цветовых классов (`.text-green` и т.д.) остаются теми же, что обсуждались ранее.
 Примерная структура страницы для достижения такого эффекта:
@@ Строка 155: / Строка 201: @@
 &lt;div class="item-page-container"&gt;
    {{Магический_предмет
-   | Изображение = Anathema.jpg
+   | ... (все параметры) ...
-  | Внешний_вид = Кулон из необработанного гематита на шнурке
-  | Редкость = Редкий
-  | Тип = Артефакт
-  | Владелец = [[Фил Морган]]
-  | Статус = Не функционирует
    }}
    &lt;div class="item-main-content"&gt;
      == Магические свойства ==
-     Артефакт влияет на носителя таким образом...
+     ...
      == История ==
-     Первые подобные артефакты появились...
+     ...
    &lt;/div&gt;
-   &lt;div style="clear:both;"&gt;&lt;/div&gt; &lt;!-- Этот элемент очищает обтекание, чтобы последующий контент не "подлезал" под плавающие блоки --&gt;
+   &lt;div style="clear:both;"&gt;&lt;/div&gt;
 &lt;/div&gt;
 </pre>
-Класс `item-page-container` является оберткой (не всегда обязателен, зависит от общего CSS вики). Класс `item-infobox` (используется внутри шаблона) будет плавающим слева, а `item-main-content` будет содержать основной текст.
 </noinclude>