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

Версия от 14:47, 30 мая 2025

О предмете

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

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

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

Чтобы использовать шаблон, вставьте следующий код в начало страницы предмета:

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

== Магические свойства ==
Здесь подробно описываются магические свойства предмета.
Этот текст размещается ''после'' вызова шаблона.

== История ==
Здесь описывается история происхождения и использования предмета.
Этот текст также размещается ''после'' вызова шаблона.

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

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

Ниже приведено описание параметров, которое также используется для TemplateData.

Шаблон для отображения информационного блока (инфобокса) о магическом предмете.

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

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

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

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

<div class="item-page-container">
  {{Магический_предмет
  | Изображение = Anathema.jpg
  | Внешний_вид = Кулон из необработанного гематита на шнурке
  | Редкость = Редкий
  | Тип = Артефакт
  | Владелец = [[Фил Морган]]
  | Статус = Не функционирует
  }}
  <div class="item-main-content">
    == Магические свойства ==
    Артефакт влияет на носителя таким образом...

    == История ==
    Первые подобные артефакты появились...
  </div>
  <div style="clear:both;"></div> <!-- Этот элемент очищает обтекание, чтобы последующий контент не "подлезал" под плавающие блоки -->
</div>

Класс `item-page-container` является оберткой (не всегда обязателен, зависит от общего CSS вики). Класс `item-infobox` (используется внутри шаблона) будет плавающим слева, а `item-main-content` будет содержать основной текст.

@@ Строка 3: / Строка 3: @@
    <table class="wikitable item-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>
+      <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>
@@ Строка 74: / Строка 75: @@
 </pre>
-Если вы хотите, чтобы текст обтекал инфобокс, вы можете обернуть шаблон и последующий текст в специальные div-контейнеры (см. раздел CSS и Структура страницы).
+Если вы хотите, чтобы основной текст страницы (например, разделы "Магические свойства", "История") обтекал инфобокс с левой стороны, вы можете использовать специальную CSS-разметку, описанную ниже (см. раздел "CSS и структура страницы для обтекания").
 === Параметры шаблона ===
-* '''Изображение''' (необязательный): Имя файла изображения (например, `Anathema.jpg`).
+Ниже приведено описание параметров, которое также используется для TemplateData.
-* '''Внешний_вид''' (необязательный): Краткое описание внешнего вида.
-* '''Редкость''' (необязательный): Редкость предмета. Задаёт цвет текста:
+<templatedata>
-** `Обычный` (class="text-white")
+{
-** `Необычный` (class="text-green")
+	"description": "Шаблон для отображения информационного блока (инфобокса) о магическом предмете.",
-** `Редкий` (class="text-blue")
+	"params": {
-** `Эпический` (class="text-violet")
+		"Изображение": {
-** `Легендарный` (class="text-orange")
+			"label": "Изображение",
-* '''Тип''' (необязательный): Тип предмета (например, Артефакт, Амулет).
+			"description": "Имя файла изображения предмета (например, Anathema.jpg). Отображается в инфобоксе.",
-* '''Владелец''' (необязательный): Текущий владелец(ы). Рекомендуется использовать вики-ссылки.
+			"type": "wiki-file-name",
-* '''Статус''' (необязательный): Текущий статус предмета. Задаёт цвет текста для некоторых значений:
+			"example": "Anathema.jpg",
-** `В игре` (class="text-success")
+			"suggested": true
-** `Не функционирует` (class="text-danger")
+		},
-** `Утрачен` (class="text-danger")
+		"Внешний_вид": {
-** `Разрушен` (class="text-danger")
+			"label": "Внешний вид",
-** Другие значения отображаются стандартным цветом.
+			"description": "Краткое текстовое описание внешнего вида предмета.",
+			"type": "string",
+			"example": "Кулон из необработанного гематита на шнурке"
+		},
+		"Редкость": {
+			"label": "Редкость",
+			"description": "Редкость предмета. Влияет на цвет отображения.",
+			"type": "string",
+			"suggestedvalues": [
+				"Обычный",
+				"Необычный",
+				"Редкий",
+				"Эпический",
+				"Легендарный"
+			],
+			"example": "Редкий"
+		},
+		"Тип": {
+			"label": "Тип",
+			"description": "Тип предмета (например, Артефакт, Амулет, Оружие).",
+			"type": "line",
+			"example": "Артефакт"
+		},
+		"Владелец": {
+			"label": "Владелец(ы)",
+			"description": "Текущий владелец или владельцы предмета. Используйте вики-ссылки для страниц персонажей (например, [[Фил Морган]], [[Еще Ктото]]).",
+			"type": "line",
+			"example": "[[Фил Морган]]"
+		},
+		"Статус": {
+			"label": "Статус",
+			"description": "Текущий статус предмета. Некоторые значения меняют цвет текста.",
+			"type": "string",
+			"suggestedvalues": [
+				"В игре",
+				"Не функционирует",
+				"Утрачен",
+				"Разрушен",
+				"Активен"
+			],
+			"example": "Не функционирует"
+		}
+	},
+	"paramOrder": [
+		"Изображение",
+		"Внешний_вид",
+		"Редкость",
+		"Тип",
+		"Владелец",
+		"Статус"
+	],
+	"format": "inline"
+}
+</templatedata>
 === CSS и структура страницы для обтекания ===
-Чтобы текст ("Магические свойства", "История") располагался справа от инфобокса. примерная структура страницы для достижения такого эффекта:
+Чтобы текст ("Магические свойства", "История") корректно располагался справа от инфобокса, соответствующие CSS-стили (см. ниже) должны быть добавлены на страницу `MediaWiki:Common.css` вашей вики. Сами стили для классов `.item-infobox`, `.item-main-content` и цветовых классов (`.text-green` и т.д.) остаются теми же, что обсуждались ранее.
+Примерная структура страницы для достижения такого эффекта:
 <pre>
 &lt;div class="item-page-container"&gt;