Help:Организация контента в MediaWiki

From Wiki4Intranet
Jump to: navigation, search

Кратко об организации контента в 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) с названием, включающим двоеточие. Перечень пространств имён можно увидеть, например, в выпадающем списке тут: Служебная:Все страницы