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

Текущая версия от 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: @@
-<noinclude>
+<includeonly><div class="left-infobox">
+  <div class="infobox-caption">О предмете</div>
+  <table class="wikitable infobox-table">
+    {{#if:{{{Изображение|}}}|
+      <tr><td colspan="2" style="text-align:center;">[[File:{{{Изображение}}}|250px|link=]]</td></tr>
+    }}
+    {{#if:{{{Внешний_вид|}}}|
+      <tr>
+        <th>Внешний вид</th>
+        <td>{{{Внешний_вид}}}</td>
+      </tr>
+    }}
+    {{#if:{{{Редкость|}}}|
+      <tr>
+        <th>Редкость</th>
+        <td><span class="{{#switch:{{{Редкость}}}
+          |Необычный=text-green
+          |Редкий=text-blue
+          |Эпический=text-violet
+          |Легендарный=text-orange
+          |Обычный=text-white
+          |#default=
+          }}">{{{Редкость}}}</span>
+        </td>
+      </tr>
+    }}
+    {{#if:{{{Тип|}}}|
+      <tr>
+        <th>Тип</th>
+        <td>{{{Тип}}}</td>
+      </tr>
+    }}
+    {{#if:{{{Классификация|}}}|
+      <tr>
+        <th>Классификация</th>
+        <td>{{{Классификация}}}</td>
+      </tr>
+    }}
+    {{#if:{{{Владелец|}}}|
+      <tr>
+        <th>Владелец(ы)</th>
+        <td>{{{Владелец}}}</td>
+      </tr>
+    }}
+    {{#if:{{{Статус|}}}|
+      <tr>
+        <th>Статус</th>
+        <td><span class="{{#switch:{{{Статус}}}
+          |В игре=text-success
+          |Не функционирует=text-danger
+          |Утрачен=text-danger
+          |Разрушен=text-danger
+          |#default=
+          }}">{{{Статус}}}</span>
+        </td>
+      </tr>
+    }}
+  </table>
+</div>[[Категория:Магические предметы]]
+{{#switch:{{{Классификация|}}}
+  |Артефакты защитные и нейтрализующие=[[Категория:Артефакты защитные и нейтрализующие]]
+  |Артефакты воздействия на сознание и эмоции=[[Категория:Артефакты воздействия на сознание и эмоции]]
+  |Артефакты манипуляции способностями и жизненной силой=[[Категория:Артефакты манипуляции способностями и жизненной силой]]
+  |Артефакты с негативными последствиями и проклятиями=[[Категория:Артефакты с негативными последствиями и проклятиями]]
+  |Артефакты связи, информации и сокрытия=[[Категория:Артефакты связи, информации и сокрытия]]
+  |Артефакты призыва, пленения и контроля существ=[[Категория:Артефакты призыва, пленения и контроля существ]]
+  |Артефакты утилитарные и специализированные=[[Категория:Артефакты утилитарные и специализированные]]
+}}
+{{#switch:{{{Тип|}}}
+  |Амулет=[[Категория:Амулеты]]
+  |Артефакт=[[Категория:Артефакты]]
+}}
+{{#switch:{{{Редкость|}}}
+  |Обычный=[[Категория:Обычные предметы]]
+  |Необычный=[[Категория:Необычные предметы]]
+  |Редкий=[[Категория:Редкие предметы]]
+  |Эпический=[[Категория:Эпические предметы]]
+  |Легендарный=[[Категория:Легендарные предметы]]
+}}</includeonly><noinclude>
+== Документация шаблона: Магический_предмет ==
+Этот шаблон предназначен для отображения информационного блока (инфобокса) о магическом предмете. Основное текстовое описание предмета (магические свойства, история и т.д.) размещается на странице отдельно, после вызова этого шаблона.
+'''Автоматическая категоризация:'''
+Этот шаблон автоматически добавляет страницы, на которых он используется, в следующие категории:
+* [[Категория:Магические предметы]] (всегда)
+* Категорию, соответствующую значению параметра `Классификация` (например, [[Категория:Артефакты защитные и нейтрализующие]]).
+* Категорию, соответствующую значению параметра `Редкость` (например, [[Категория:Редкие предметы]], если параметр `Редкость` = "Редкий").
+* [[Категория:Амулеты]], если параметр `Тип` указан как "Амулет".
+* [[Категория:Артефакты]], если параметр `Тип` указан как "Артефакт".
+=== Использование ===
+<pre>
+{{Магический_предмет
+|Изображение= ВашеИзображение.jpg
+|Внешний_вид= Описание внешнего вида.
+|Редкость=    Редкий
+|Тип=         Артефакт
+|Классификация= Артефакты защитные и нейтрализующие
+|Владелец=    [[ИмяПерсонажа]]
+|Статус=      Не функционирует
+}}
+== Магические свойства ==
+...
+== История ==
+...
+</pre>
+Если вы хотите, чтобы основной текст страницы (например, разделы "Магические свойства", "История") обтекал инфобокс с левой стороны, вы можете использовать специальную CSS-разметку, описанную ниже (см. раздел "CSS и структура страницы для обтекания").
+=== Параметры шаблона ===
 <templatedata>
 {
+	"description": "Шаблон для отображения инфобокса о магическом предмете. Автоматически добавляет страницу в категории: 'Магические предметы', категорию согласно Классификации, категорию по Редкости (например, 'Редкие предметы'), а также 'Амулеты' или 'Артефакты' в зависимости от Типа.",
 	"params": {
 		"Изображение": {
 			"label": "Изображение",
-			"description": "Имя файла изображения предмета (например, MyCoolSword.png).",
+			"description": "Имя файла изображения предмета (например, Anathema.jpg). Отображается в инфобоксе.",
 			"type": "wiki-file-name",
-			"default": "Placeholder.png",
+			"example": "Anathema.jpg",
-			"example": "ShinyOrb.jpg"
+			"suggested": true
 		},
 		"Внешний_вид": {
 			"label": "Внешний вид",
-			"description": "Описание внешнего вида предмета.",
+			"description": "Краткое текстовое описание внешнего вида предмета.",
-			"type": "content",
+			"type": "string",
-			"suggested": true,
+			"example": "Кулон из необработанного гематита на шнурке"
-			"example": "Небольшой гладкий камень, размером обычно не превышающий нескольких сантиметров."
 		},
 		"Редкость": {
 			"label": "Редкость",
-			"description": "Степень редкости предмета.",
+			"description": "Редкость предмета. Влияет на цвет отображения в инфобоксе и добавляет соответствующую категорию (например, 'Редкие предметы').",
-			"type": "line",
+			"type": "string",
-			"default": "Обычный",
-			"suggested": true,
 			"suggestedvalues": [
 				"Обычный",
@@ Строка 30: / Строка 138: @@
 				"Легендарный"
 			],
-			"example": "Эпический"
+			"example": "Редкий"
 		},
 		"Тип": {
 			"label": "Тип",
-			"description": "Тип магического предмета (например, Амулет, Артефакт, Оружие).",
+			"description": "Тип предмета (например, Артефакт, Амулет, Оружие). Используется для категоризации как 'Амулеты' или 'Артефакты'.",
 			"type": "line",
-			"default": "Неизвестно",
-			"suggested": true,
 			"example": "Артефакт"
+		},
+		"Классификация": {
+			"label": "Классификация",
+			"description": "Основная функциональная классификация предмета. Используется для автоматической категоризации.",
+			"type": "string",
+			"suggestedvalues": [
+				"Артефакты защитные и нейтрализующие",
+				"Артефакты воздействия на сознание и эмоции",
+				"Артефакты манипуляции способностями и жизненной силой",
+				"Артефакты с негативными последствиями и проклятиями",
+				"Артефакты связи, информации и сокрытия",
+				"Артефакты призыва, пленения и контроля существ",
+				"Артефакты утилитарные и специализированные"
+			],
+			"example": "Артефакты защитные и нейтрализующие"
 		},
 		"Владелец": {
-			"label": "Владелец 1",
+			"label": "Владелец(ы)",
-			"description": "Текущий или основной владелец предмета (имя страницы).",
+			"description": "Текущий владелец или владельцы предмета. Используйте вики-ссылки для страниц персонажей (например, [[Фил Морган]], [[Еще Ктото]]).",
-			"type": "wiki-page-name"
+			"type": "line",
-		},
+			"example": "[[Фил Морган]]"
-		"Владелец2": {
-			"label": "Владелец 2",
-			"description": "Дополнительный владелец предмета (имя страницы).",
-			"type": "wiki-page-name"
-		},
-		"Владелец3": {
-			"label": "Владелец 3",
-			"description": "Дополнительный владелец предмета (имя страницы).",
-			"type": "wiki-page-name"
-		},
-		"Владелец4": {
-			"label": "Владелец 4",
-			"description": "Дополнительный владелец предмета (имя страницы).",
-			"type": "wiki-page-name"
-		},
-		"Владелец5": {
-			"label": "Владелец 5",
-			"description": "Дополнительный владелец предмета (имя страницы).",
-			"type": "wiki-page-name"
 		},
 		"Статус": {
 			"label": "Статус",
-			"description": "Текущий статус предмета в игровом мире.",
+			"description": "Текущий статус предмета. Некоторые значения меняют цвет текста.",
-			"type": "line",
+			"type": "string",
-			"default": "В запасе",
-			"suggested": true,
 			"suggestedvalues": [
 				"В игре",
-				"В запасе",
+				"Не функционирует",
-				"Уничтожен",
+				"Утрачен",
-				"Потерян"
+				"Разрушен",
+				"Активен"
 			],
-			"example": "В игре"
+			"example": "Не функционирует"
 		}
 	},
-	"description": "Шаблон для вывода информационной карточки о магическом предмете.",
+	"paramOrder": [
-	"format": "block",
+		"Изображение",
-	"sets": [
+		"Внешний_вид",
-		{
+		"Редкость",
-			"label": "Основные характеристики",
+		"Тип",
-			"params": [
+		"Классификация",
-				"Изображение",
+		"Владелец",
-				"Внешний_вид",
+		"Статус"
-				"Редкость",
+	],
-				"Тип",
+	"format": "inline"
-				"Статус"
-			]
-		},
-		{
-			"label": "Владельцы",
-			"params": [
-				"Владелец",
-				"Владелец2",
-				"Владелец3",
-				"Владелец4",
-				"Владелец5"
-			]
-		}
-	]
 }
 </templatedata>
-=== Назначение: ===
+=== CSS и структура страницы для обтекания ===
-Шаблон для описания характеристик магического предмета. Использует `<templatedata>` для удобного заполнения через Визуальный редактор.
+Чтобы текст ("Магические свойства", "История") корректно располагался справа от инфобокса, соответствующие CSS-стили должны быть добавлены на страницу `MediaWiki:Common.css` вашей вики. Сами стили для классов `.item-infobox`, `.item-main-content` и цветовых классов (`.text-green` и т.д.) остаются теми же, что обсуждались ранее.
-=== Как использовать: ===
-Скопируйте, вставьте в начало страницы и подставьте нужные значения после знака "=" или используйте Визуальный редактор / инструмент вставки шаблонов.
-(Если владелец один, то указывать его только во "Владелец", остальные оставить пустыми).
- <nowiki>{{Магический_предмет
-|Изображение=Название.jpg
-|Внешний_вид=
-|Редкость=
-|Тип=
-|Владелец=
-|Владелец2=
-|Владелец3=
-|Владелец4=
-|Владелец5=
-|Статус=
-}}</nowiki>
-=== Внешний вид (предпросмотр) ===
+Примерная структура страницы для достижения такого эффекта:
-<div style="clear:both; overflow:auto; border:1px dashed grey; padding: 1em; margin-bottom:1em;"> {{Магический_предмет
+<pre>
-|Изображение=Example.jpg
+&lt;div class="item-page-container"&gt;
-|Внешний_вид=Небольшой гладкий камень, размером обычно не превышающий нескольких сантиметров. Его можно спутать с обычным камнем, если бы не легкое свечение, исходящее изнутри.
+  {{Магический_предмет
-|Редкость=Эпический
+  | ... (все параметры) ...
-|Тип=Артефакт
+  }}
-|Владелец=Главный Герой
+  &lt;div class="item-main-content"&gt;
-|Владелец2=Помощник Героя
+    == Магические свойства ==
-|Статус=В игре
+    ...
-}}
+    == История ==
-<div style="clear:both;"></div>
+    ...
-{{Магический_предмет |Изображение=Placeholder.png |Внешний_вид= |Редкость=Обычный |Тип= |Владелец= |Статус=В запасе }}
+  &lt;/div&gt;
-<div style="clear:both;"></div>
+  &lt;div style="clear:both;"&gt;&lt;/div&gt;
-</div>
+&lt;/div&gt;
-</noinclude><div class="magic-item-infobox">
+</pre>
-    <div class="magic-item-header">
-        О предмете
-    </div>
-    <div class="magic-item-image">
-        [[Файл:{{{Изображение|Placeholder.png}}}|250px|link=|center]]
-    </div>
-    <table class="magic-item-details">
-        <tbody>
-            <tr>
-                <td class="magic-item-label">Внешний вид:</td>
-                <td class="magic-item-value">{{{Внешний_вид|Н/Д}}}</td>
-            </tr>
-            <tr>
-                <td class="magic-item-label">Редкость:</td>
-                <td class="magic-item-value {{#switch: {{{Редкость|Обычный}}}
-                    | Обычный = rarity-common
-                    | Необычный = rarity-uncommon
-                    | Редкий = rarity-rare
-                    | Эпический = rarity-epic
-                    | Легендарный = rarity-legendary
-                    | #default = rarity-unknown
-                    }}">{{{Редкость|Обычный}}}</td>
-            </tr>
-            <tr>
-                <td class="magic-item-label">Тип:</td>
-                <td class="magic-item-value">[[{{{Тип|Неизвестно}}}]]</td>
-            </tr>
-            <tr>
-                <td class="magic-item-label">Владелец:</td>
-                <td class="magic-item-value">
-                    {{#if: {{{Владелец|}}} | [[{{{Владелец}}}]] | Н/Д}}{{#if: {{{Владелец2|}}} | , [[{{{Владелец2}}}]] | }}{{#if: {{{Владелец3|}}} | , [[{{{Владелец3}}}]] | }}{{#if: {{{Владелец4|}}} | , [[{{{Владелец4}}}]] | }}{{#if: {{{Владелец5|}}} | , [[{{{Владелец5}}}]] | }}
-                </td>
-            </tr>
-            <tr>
-                <td class="magic-item-label">Статус:</td>
-                <td class="magic-item-value {{#switch: {{{Статус|В запасе}}}
-                    | В игре = status-in-game
-                    | Уничтожен = status-destroyed
-                    | Потерян = status-lost
-                    | В запасе = status-in-stock
-                    | #default = status-unknown
-                    }}">{{{Статус|В запасе}}}</td>
-            </tr>
-        </tbody>
-    </table>
-</div><includeonly>{{#ifeq: {{NAMESPACE}} | {{ns:0}} |
-[[Категория:Магические_предметы]]
-{{#switch: {{{Тип|}}}
- | Амулет = [[Категория:Амулеты]]
- | Артефакт = [[Категория:Артефакты]]
- | #default = }}
-{{#switch: {{{Редкость|}}}
- | Необычный = [[Категория:Необычные_предметы]]
- | Редкий = [[Категория:Редкие_предметы]]
- | Эпический = [[Категория:Эпические_предметы]]
- | Легендарный = [[Категория:Легендарные_предметы]]
- | Обычный = [[Категория:Обычные_предметы]]
- | #default = }}
-}}</includeonly><noinclude>
-[[Категория:Шаблоны|{{PAGENAME}}]]
 </noinclude>