Difference between revisions of "Help:Организация контента в MediaWiki"

Latest revision as of 19:49, 24 July 2018

Кратко об организации контента в MediaWiki. Основные понятия:

• Страницы и файлы:
  • Весь текст лежит в статьях (page). Они же страницы.
  • Статья = название + текст.
  • Текст пишется в собственном языке разметки MediaWiki.
  • Кроме статей есть файлы — картинки и т. п. У каждого файла есть парная страница с названием Файл:Название_Файла.jpg.
  • Пространство имён (namespace) — часть названия статьи до ":"^[1]. Например, «Файл». Пространства имён служат для технических целей (например, чтобы отличать статьи от категорий).
• Для группировки статей служат категории:
  • Категория — это тоже статья, но в пространстве имён «Категория». Всё, название чего начинается с "Категория:" — категория. :-)
  • Категория — это НЕ папка, а «тег» (метка). То есть, каждая статья может включаться в любое число категорий.
  • Чтобы включить статью в категорию, в текст статьи надо добавить строчку «[[Категория:Название Вашей Категории]]».
  • Так как категория — это тоже статья, категория тоже может включаться в другие категории (или даже сама в себя — правда, непонятно, зачем).
  • Категория, включённая в другую — называется её подкатегорией.
• Все пространства имён «плоские», иерархии нет. То есть, пара (Пространство имён, Название статьи) — это уникальный идентификатор статьи.
  • Это означает, что нельзя создать две статьи с одинаковыми названиями, даже в разных категориях.
  • А ещё это означает, что название статьи должно быть полностью детализированным.
  • То есть, если в вики вы не одни — то правильное название не «Инструкция по развёртыванию стенда», а «Инструкция по развёртыванию стенда Проекта СуперТелефон», не «Описание версии», а «Описание версии SuperTelefon 2.1.2».
• Частично иерархия эмулируется символом /. Подстраница — это страница с именем вида A/B/C/D. Однако:
  • Суммарная длина названия со всеми A/B/C/D всё равно не должна превышать 255 символов
  • В пространстве имён Файл иерархия запрещена
  • MediaWiki в целом не рассчитана на работу с иерархиями, поэтому удобных интерфейсов для этого нет
• Спецстраницы / Служебные страницы:
  • Это страницы, которые не содержат текста, а дают доступ к какой-то функции кода системы MediaWiki.
  • Они имеют имена вида Служебная:XXX. То есть, находятся в namespace Служебная (Special). Например: Служебная:Версия.
  • Список доступных служебных страниц можно увидеть, нажав на ссылку «Спецстраницы» в левой панели интерфейса.
• Шаблоны:
  • Статьи можно включать друг в друга, при этом доступна возможность подстановки параметров. Ещё есть функции парсера, теги расширений, Semantic и прочая ерунда и на этом даже можно кое-как программировать. Но лучше не нужно.
  • Статьи, предназначенные только для включения в другие, принято размещать в namespace Шаблон (Template). Например Шаблон:Bug.

И наконец…

Wiki — это Wiki! Правьте свободно! Вы ничего не сломаете — всё остаётся в истории.

Если вы видите опечатку — возьмите и поправьте.

Если вы видите, что какой-то информации не хватает — возьмите и допишите.

Если вы видите, что какая-то статья сильно устарела и уже никому не нужна — не ругайтесь, что бардак, а возьмите и удалите.

1. ↑ На самом деле не любой префикс является неймспейсом, а только один из предопределённых в коде Wiki или расширений. Например, Файл:Тест.jpg — статья в пространстве имён Файл, а НашПроект:Описание — статья в «нулевом» пространстве имён (namespace Main) с названием, включающим двоеточие. Перечень пространств имён можно увидеть, например, в выпадающем списке тут: Служебная:Все страницы