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

Текущая версия от 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>
+      <tr><td colspan="2" style="text-align:center;">[[File:{{{Изображение}}}|250px|link=]]</td></tr>
      }}
      {{#if:{{{Внешний_вид|}}}|
-    <tr>
+      <tr>
-      <th>Внешний вид</th>
+        <th>Внешний вид</th>
-      <td>{{{Внешний_вид}}}</td>
+        <td>{{{Внешний_вид}}}</td>
-    </tr>
+      </tr>
      }}
      {{#if:{{{Редкость|}}}|
-    <tr>
+      <tr>
-      <th>Редкость</th>
+        <th>Редкость</th>
-      <td><span class="{{#switch:{{{Редкость}}}
+        <td><span class="{{#switch:{{{Редкость}}}
-        |Необычный=text-green
+          |Необычный=text-green
-        |Редкий=text-blue
+          |Редкий=text-blue
-        |Эпический=text-violet
+          |Эпический=text-violet
-        |Легендарный=text-orange
+          |Легендарный=text-orange
-        |Обычный=text-white
+          |Обычный=text-white
-        |#default=
+          |#default=
-        }}">{{{Редкость}}}</span>
+          }}">{{{Редкость}}}</span>
-      </td>
+        </td>
-    </tr>
+      </tr>
      }}
      {{#if:{{{Тип|}}}|
-    <tr>
+      <tr>
-      <th>Тип</th>
+        <th>Тип</th>
-      <td>{{{Тип}}}</td>
+        <td>{{{Тип}}}</td>
-     </tr>
+      </tr>
+    }}
+     {{#if:{{{Классификация|}}}|
+      <tr>
+        <th>Классификация</th>
+        <td>{{{Классификация}}}</td>
+      </tr>
      }}
      {{#if:{{{Владелец|}}}|
-    <tr>
+      <tr>
-      <th>Владелец(ы)</th>
+        <th>Владелец(ы)</th>
-      <td>{{{Владелец}}}</td> </tr>
+        <td>{{{Владелец}}}</td>
+      </tr>
      }}
      {{#if:{{{Статус|}}}|
-    <tr>
+      <tr>
-      <th>Статус</th>
+        <th>Статус</th>
-      <td><span class="{{#switch:{{{Статус}}}
+        <td><span class="{{#switch:{{{Статус}}}
-        |В игре=text-success
+          |В игре=text-success
-        |Не функционирует=text-danger
+          |Не функционирует=text-danger
-        |Утрачен=text-danger
+          |Утрачен=text-danger
-        |Разрушен=text-danger
+          |Разрушен=text-danger
-        |#default=
+          |#default=
-        }}">{{{Статус}}}</span>
+          }}">{{{Статус}}}</span>
-      </td>
+        </td>
-    </tr>
+      </tr>
      }}
    </table>
-</div><noinclude>
+</div>[[Категория:Магические предметы]]
+{{#switch:{{{Классификация|}}}
+  |Артефакты защитные и нейтрализующие=[[Категория:Артефакты защитные и нейтрализующие]]
+  |Артефакты воздействия на сознание и эмоции=[[Категория:Артефакты воздействия на сознание и эмоции]]
+  |Артефакты манипуляции способностями и жизненной силой=[[Категория:Артефакты манипуляции способностями и жизненной силой]]
+  |Артефакты с негативными последствиями и проклятиями=[[Категория:Артефакты с негативными последствиями и проклятиями]]
+  |Артефакты связи, информации и сокрытия=[[Категория:Артефакты связи, информации и сокрытия]]
+  |Артефакты призыва, пленения и контроля существ=[[Категория:Артефакты призыва, пленения и контроля существ]]
+  |Артефакты утилитарные и специализированные=[[Категория:Артефакты утилитарные и специализированные]]
+}}
+{{#switch:{{{Тип|}}}
+  |Амулет=[[Категория:Амулеты]]
+  |Артефакт=[[Категория:Артефакты]]
+}}
+{{#switch:{{{Редкость|}}}
+  |Обычный=[[Категория:Обычные предметы]]
+  |Необычный=[[Категория:Необычные предметы]]
+  |Редкий=[[Категория:Редкие предметы]]
+  |Эпический=[[Категория:Эпические предметы]]
+  |Легендарный=[[Категория:Легендарные предметы]]
+}}</includeonly><noinclude>
 == Документация шаблона: Магический_предмет ==
 Этот шаблон предназначен для отображения информационного блока (инфобокса) о магическом предмете. Основное текстовое описание предмета (магические свойства, история и т.д.) размещается на странице отдельно, после вызова этого шаблона.
+'''Автоматическая категоризация:'''
+Этот шаблон автоматически добавляет страницы, на которых он используется, в следующие категории:
+* [[Категория:Магические предметы]] (всегда)
+* Категорию, соответствующую значению параметра `Классификация` (например, [[Категория:Артефакты защитные и нейтрализующие]]).
+* Категорию, соответствующую значению параметра `Редкость` (например, [[Категория:Редкие предметы]], если параметр `Редкость` = "Редкий").
+* [[Категория:Амулеты]], если параметр `Тип` указан как "Амулет".
+* [[Категория:Артефакты]], если параметр `Тип` указан как "Артефакт".
 === Использование ===
-Чтобы использовать шаблон, вставьте следующий код в начало страницы предмета:
 <pre>
 {{Магический_предмет
 |Изображение= ВашеИзображение.jpg
-|Внешний_вид= Описание внешнего вида предмета.
+|Внешний_вид= Описание внешнего вида.
-|Редкость=    Редкий |Тип=         Артефакт |Владелец=    [[ИмяПерсонажа]] |Статус=      Не функционирует }}
+|Редкость=    Редкий
+|Тип=         Артефакт
+|Классификация= Артефакты защитные и нейтрализующие
+|Владелец=    [[ИмяПерсонажа]]
+|Статус=      Не функционирует
+}}
 == Магические свойства ==
-Здесь подробно описываются магические свойства предмета.
+...
-Этот текст размещается ''после'' вызова шаблона.
 == История ==
-Здесь описывается история происхождения и использования предмета.
+...
-Этот текст также размещается ''после'' вызова шаблона.
 </pre>
-Если вы хотите, чтобы текст обтекал инфобокс, как на исходном изображении, вы можете обернуть шаблон и последующий текст в специальные div-контейнеры (см. раздел CSS и Структура страницы).
+Если вы хотите, чтобы основной текст страницы (например, разделы "Магические свойства", "История") обтекал инфобокс с левой стороны, вы можете использовать специальную CSS-разметку, описанную ниже (см. раздел "CSS и структура страницы для обтекания").
 === Параметры шаблона ===
-* '''Изображение''' (необязательный): Имя файла изображения (например, `Anathema.jpg`).
+<templatedata>
-* '''Внешний_вид''' (необязательный): Краткое описание внешнего вида.
+{
-* '''Редкость''' (необязательный): Редкость предмета. Задаёт цвет текста:
+	"description": "Шаблон для отображения инфобокса о магическом предмете. Автоматически добавляет страницу в категории: 'Магические предметы', категорию согласно Классификации, категорию по Редкости (например, 'Редкие предметы'), а также 'Амулеты' или 'Артефакты' в зависимости от Типа.",
-** `Обычный` (class="text-white")
+	"params": {
-** `Необычный` (class="text-green")
+		"Изображение": {
-** `Редкий` (class="text-blue")
+			"label": "Изображение",
-** `Эпический` (class="text-violet")
+			"description": "Имя файла изображения предмета (например, Anathema.jpg). Отображается в инфобоксе.",
-** `Легендарный` (class="text-orange")
+			"type": "wiki-file-name",
-* '''Тип''' (необязательный): Тип предмета (например, Артефакт, Амулет).
+			"example": "Anathema.jpg",
-* '''Владелец''' (необязательный): Текущий владелец(ы). Рекомендуется использовать вики-ссылки.
+			"suggested": true
-* '''Статус''' (необязательный): Текущий статус предмета. Задаёт цвет текста для некоторых значений:
+		},
-** `В игре` (class="text-success")
+		"Внешний_вид": {
-** `Не функционирует` (class="text-danger")
+			"label": "Внешний вид",
-** `Утрачен` (class="text-danger")
+			"description": "Краткое текстовое описание внешнего вида предмета.",
-** `Разрушен` (class="text-danger")
+			"type": "string",
-** Другие значения отображаются стандартным цветом.
+			"example": "Кулон из необработанного гематита на шнурке"
+		},
+		"Редкость": {
+			"label": "Редкость",
+			"description": "Редкость предмета. Влияет на цвет отображения в инфобоксе и добавляет соответствующую категорию (например, 'Редкие предметы').",
+			"type": "string",
+			"suggestedvalues": [
+				"Обычный",
+				"Необычный",
+				"Редкий",
+				"Эпический",
+				"Легендарный"
+			],
+			"example": "Редкий"
+		},
+		"Тип": {
+			"label": "Тип",
+			"description": "Тип предмета (например, Артефакт, Амулет, Оружие). Используется для категоризации как 'Амулеты' или 'Артефакты'.",
+			"type": "line",
+			"example": "Артефакт"
+		},
+		"Классификация": {
+			"label": "Классификация",
+			"description": "Основная функциональная классификация предмета. Используется для автоматической категоризации.",
+			"type": "string",
+			"suggestedvalues": [
+				"Артефакты защитные и нейтрализующие",
+				"Артефакты воздействия на сознание и эмоции",
+				"Артефакты манипуляции способностями и жизненной силой",
+				"Артефакты с негативными последствиями и проклятиями",
+				"Артефакты связи, информации и сокрытия",
+				"Артефакты призыва, пленения и контроля существ",
+				"Артефакты утилитарные и специализированные"
+			],
+			"example": "Артефакты защитные и нейтрализующие"
+		},
+		"Владелец": {
+			"label": "Владелец(ы)",
+			"description": "Текущий владелец или владельцы предмета. Используйте вики-ссылки для страниц персонажей (например, [[Фил Морган]], [[Еще Ктото]]).",
+			"type": "line",
+			"example": "[[Фил Морган]]"
+		},
+		"Статус": {
+			"label": "Статус",
+			"description": "Текущий статус предмета. Некоторые значения меняют цвет текста.",
+			"type": "string",
+			"suggestedvalues": [
+				"В игре",
+				"Не функционирует",
+				"Утрачен",
+				"Разрушен",
+				"Активен"
+			],
+			"example": "Не функционирует"
+		}
+	},
+	"paramOrder": [
+		"Изображение",
+		"Внешний_вид",
+		"Редкость",
+		"Тип",
+		"Классификация",
+		"Владелец",
+		"Статус"
+	],
+	"format": "inline"
+}
+</templatedata>
 === CSS и структура страницы для обтекания ===
-Чтобы текст ("Магические свойства", "История") располагался справа от инфобокса, как в вашем примере, CSS должен быть добавлен на страницу `MediaWiki:Common.css` вашей вики (см. ниже).
+Чтобы текст ("Магические свойства", "История") корректно располагался справа от инфобокса, соответствующие CSS-стили должны быть добавлены на страницу `MediaWiki:Common.css` вашей вики. Сами стили для классов `.item-infobox`, `.item-main-content` и цветовых классов (`.text-green` и т.д.) остаются теми же, что обсуждались ранее.
 Примерная структура страницы для достижения такого эффекта:
@@ Строка 98: / Строка 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>