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

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