Help:Организация контента в MediaWiki
From Wiki4Intranet
Revision as of 19:49, 24 July 2018 by VitaliyFilippov (Talk | contribs)
Кратко об организации контента в 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! Правьте свободно! Вы ничего не сломаете — всё остаётся в истории.Категория:СправкаЕсли вы видите опечатку — возьмите и поправьте.
Если вы видите, что какой-то информации не хватает — возьмите и допишите.
Если вы видите, что какая-то статья сильно устарела и уже никому не нужна — не ругайтесь, что бардак, а возьмите и удалите.
- ↑ На самом деле не любой префикс является неймспейсом, а только один из предопределённых в коде Wiki или расширений. Например, Файл:Тест.jpg — статья в пространстве имён Файл, а НашПроект:Описание — статья в «нулевом» пространстве имён (namespace Main) с названием, включающим двоеточие. Перечень пространств имён можно увидеть, например, в выпадающем списке тут: Служебная:Все страницы