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

Текущая версия от 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` и т.д.) остаются теми же, что обсуждались ранее.
-=== Как использовать: ===
+Примерная структура страницы для достижения такого эффекта:
-Скопируйте, вставьте в начало страницы и подставьте нужные значения после знака "=" или используйте Визуальный редактор / инструмент вставки шаблонов.
+<pre>
-(Если владелец один, то указывать его только во "Владелец", остальные оставить пустыми).
+&lt;div class="item-page-container"&gt;
+   {{Магический_предмет
- <nowiki>{{Магический_предмет
+  | ... (все параметры) ...
-|Изображение=Название.jpg
+  }}
-|Внешний_вид=
+   &lt;div class="item-main-content"&gt;
-|Редкость=
-|Тип=
-|Владелец=
-|Владелец2=
-|Владелец3=
-|Владелец4=
-|Владелец5=
-|Статус=
-}}</nowiki>
-<div class="item-page-container">
-   <div class="item-infobox">
-    <div style="font-weight:bold; font-size:1.2em; margin-bottom:10px; text-align:center;">О предмете</div>
-    <table class="wikitable item-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><span class="{{#switch:{{{статус}}}
-          |В игре=text-success
-          |Утрачен=text-danger |Разрушен=text-danger |#default=
-          }}">{{{статус}}}</span>
-        </td>
-      </tr>
-      }}
-    </table>
-   </div>
-  <div class="item-main-content">
-    {{#if:{{{магические_свойства|}}}|
      == Магические свойства ==
-     {{{магические_свойства}}}
+     ...
-    }}
-    {{#if:{{{история|}}}|
      == История ==
-     {{{история}}}
+     ...
-    }}
+   &lt;/div&gt;
-   </div>
+   &lt;div style="clear:both;"&gt;&lt;/div&gt;
-   <div style="clear:both;"></div>
+&lt;/div&gt;
-</div>
-<noinclude>
-== Документация шаблона ==
-Этот шаблон предназначен для описания предметов.
-=== Использование ===
-<pre>
-{{ОписаниеПредмета
-| изображение         = | внешний_вид         = | редкость            = | тип                 = | владелец            = | статус              = | магические_свойства = | история             = }}
 </pre>
-=== Варианты редкости и их классы ===
-* '''Необычный''': class="text-green"
-* '''Редкий''': class="text-blue"
-* '''Эпический''': class="text-violet"
-* '''Легендарный''': class="text-orange"
-* '''Обычный''': class="text-white"
-=== Варианты статуса и их классы ===
-* '''В игре''': class="text-success"
-* '''Утрачен''' (или '''Разрушен'''): class="text-danger" (можно добавить другие ключевые слова в шаблон)
-* Любой другой текст будет отображен без специального класса.
-CSS для этих классов должен быть добавлен в MediaWiki:Common.css.
 </noinclude>