Сведения о документе

MediaWiki

Что такое MediaWiki

MediaWiki — это программный механизм для веб-сайтов, работающих по технологии «вики». Это один из самых мощных и распоcтранённых вики-движков. Он встречается и на совсем маленьких сайтах, а на огромных порталах, таких как Википедия (http://www.wikipedia.org/), для работы которой MediaWiki и создавалась.

Основной сайт проекта — http://www.mediawiki.org/.

Системные требования

MediaWiki является web-ориентированной средой. Для его работы требуется:

Настройка MediaWiki в среде Школьный Сервер

Mediawiki устанавливается при установке дистрибутива Школьный Сервер автоматически и сразу готова к использованию. Так как MediaWiki использует для своей работы Web-сервер Apache2 и базу MySQL, надо убедиться, что соответствующие этим серверам службы запущены. Сделать это можно в модуле «Системные службы» Центра управления системой. Необходимо проконтролировать состояние и при необходимости запустить службы httpd2 и mysqld.

Поcле запуска Apache2 и MySQL можно обращаться на стартовую страничку MediaWiki, расположенную по адресу http://ip-адрес/mediawiki/.

Например, если ip-адрес вашего сервера 192.168.0.1, то адрес, по которому будет доступен Mediawiki такой: http://192.168.0.1/mediawiki/.

Естественно, при использовании в вашей сети DNS-сервера, ip-адрес может быть заменён на имя, например http://www.school-server.localnet/mediawiki/.

Первоначальная настройка Wiki

Движок MediaWiki представляет из себя очень гибкую систему. Для очень большого числа специфических задач можно использовать специально написанные модули расширения Wiki, например модуль работы с сервером авторизации LDAP, модуль выгрузки страниц в формат PDF и многие другие.

Мы рассмотрим настройку Wiki на примере стандартных задач, таких как управление пользователями, изменение логотипа, настройка боковой панели и решение некоторых попутно возникающих проблем.

Примечание: Для выполнения операций, требующих модификации файлов и не предусмотренных web-ориентированными средствами настройки, может потребоваться доступ к консоли настраиваемой системы: локальный или удалённый (например по SSH).

Управление пользователями

Управление пользователями осуществляется от имени любого пользователя, обладающего привилегиями администратора системы Wiki. При установке системы создаётся учётная запись административного пользователя, используя которую, можно выполнить первичный вход в систему для осуществления её настроек. В частности, для создания пользователей.

Создание и удаление пользователей

Для создания пользователей необходимо зайти в систему от имени пользователя, обладающего всем набором привилегий в системе. Предположим, что нам нужно создать пользователей — учителей школы — чтобы каждый из них мог независимо работать в системе посредством локальной вычислительной сети с различных рабочих мест. В случае вывода Wiki в Интернет, например при использовании Wiki в качестве сайта школы, есть возможность работы в системе из любого уголка Земли, где есть доступ к Интернету, например из дома школьников и учителей. В качестве обыкновенного пользователя, не обладающего администраторскими привилегиями, может зарегистрироваться любой желающий. Для этого необходимо перейти на страницу авторизации щёлкнув мышью на ссылке представиться системе.

Теперь можно представляться системе под этим именем и создавать материал.

По умолчанию в Wiki существуют 4 основных статуса:

Пользователь

самостоятельно зарегистрировавшийся пользователь, который автоматически получает право создавать, редактировать и защищать свои статьи.

Администратор

участник, наделённый правами и обязанностями выполнять работы по обслуживанию, к которым относятся:

Администраторы не имеют каких-либо привилегий в управлении проектом и не имеют права использовать свои возможности для навязывания другим участникам своей точки зрения.

Статусом администратора могут наделять Бюрократы.

Бюрократ

специальный администратор, в ведении которого находятся имена участников, статусы ботов, присвоение статуса администратора и контроль за легитимностью выборов в Арбитражный комитет. Бюрократами становятся опытные администраторы, наделённые доверием сообщества.

Бот (англ. bot, от англ. robot — робот)

программа, выполняющая автоматически и/или по заданному расписанию какие-либо действия и имеющая в этом некое сходство с человеком.

Изменение логотипа

Для изменения логотипа на Главной Станице Wiki нам потребуется:

Логотип нужно скопировать в каталог с файлами MediaWiki. В нашем случае это /var/www/webapps/mediawiki/.

Если файл с логотипом называется MY_LOGO.png, то для указания его в качестве логотипа MediaWiki в файле LocalSettings.php, который находится в каталоге на сервере /var/www/webapps/mediawiki/ нужно найти параметр $wgLogo и присвоить ему значение $wgScriptPath/MY_LOGO.png.

Примечание: Переменная $wgScriptPath подставляет путь до wiki (/var/www/webapps/mediawiki/).

Настройка основного меню (боковая панель)

Основное меню в Wiki позволяет организовать доступ к основным разделам базы знаний самым удобным и быстрым образом.

Для организации меню нам потребуется перейти на специальную страницу Wiki MediaWiki:Sidebar.

Для этого откроем браузер, например Firefox, и введём в адресную строку путь к странице настроек основного меню: http://ip-адрес/?title=MediaWiki:Sidebar.

Между содержимым страницы и структурой основного меню просматривается соответствие. Нажав Править можно изменить структуру меню, добавляя либо удаляя ссылки на определённые страницы.

Как мы видим, названия разделов написаны на странице 2 раза через вертикальную черту. Если указать имя раздела один раз, в основном меню вместо короткой ссылки вы увидите полный путь до страницы. Это важный момент!

Настройка типов файлов, поддерживаемых Wiki для загрузки

Типы файлов, разрешённых для загрузки в Wiki можно указать в файле конфигурации MediaWiki-системы — LocalSettings.php, который находится на сервере в каталоге /var/www/webapps/mediawiki/.

В нём параметры за типы файлов, разреёшенных для загрузки в базу знаний, отвечают параметры $wgFileExtensions[]. Количество параметров соответствует количеству разрешённых для загрузки типов файлов. Например:

$wgFileExtensions[] = 'zip';
$wgFileExtensions[] = 'pps';
$wgFileExtensions[] = 'odt';
$wgFileExtensions[] = 'ods';
$wgFileExtensions[] = 'odp';
$wgFileExtensions[] = 'pdf';
$wgFileExtensions[] = 'png';

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

Чтоб понять область применения MediaWiki необходимо разобраться с самой технологией Wiki.

Что такое Wiki

Wiki(Вики) — это гипертекстовая среда (обычно веб-сайт) для сбора и структурирования письменных сведений. Характеризуется следующими признаками:

Для создания вики-среды необходимо особое программное обеспечение — движок вики. Это частный вид системы управления сайтом (CMS), довольно простой в своём устройстве и функциональности, поскольку почти все действия по структуризации и обработке сведений производятся пользователями вручную.

Подчеркнём точность данного в начале определения: именно для сбора и структурирования сведений. Гипертекст в вики — не более чем техническая основа, среда. Те, кто активно создают и иизменяют основной контент сайта, образуют вики-сообщество.

Почему MediaWiki?

Есть несколько причин, обуславливающих использование Wiki-среды для деятельности, связанной с образованием:

Принимая во внимание вышеописанные преимущества, можно формировать локальные электронные энциклопедии конкретного учебного заведения: школы, колледжа, техникума, института, — воспитанники которых получат возможность пользоваться электронными лекциями преподавателей и учителей, имея доступ к ним прямо с домашнего компьютера посредством Интертета. Такой доступ достаточно легко организовать, создав в школе сервер с сайтом школы, которым может являться Wiki.

Работа в MediaWiki

После установки и настройки базы знаний можно незамедлительно приступать к работе над учебным материалом.

Моя первая страница

При создании своей первой страницы средствами Wiki многие начинающие пользователи очень долго ищут в системе кнопку Создать. Не будем попросту тратить на это время, потому что такой кнопки здесь нет.

Для того чтобы создать страницу с нужным нам называнием, достаточно в форме поиска написать название, которое подходит для описания нашей страницы, и нажать кнопку перейти, на что система выдаст нам страницу с таким называнием, а если таковой нет, то предложит её создать.

Примем предложение системы и перейдём по ссылке Создать страницу. Итак, мы попали в поле редактирования страницы. Давайте напишем здесь предложение:

У нас получилось создать страницу! Теперь задача минимум - изучить основную
Wiki-разметку, чтобы красиво оформлять свои знания и заинтересовать учеников.

и нажмём расположенную внизу кнопку записать страницу. И опять маленькая победа — страница создана. Самая простенькая, но зато своими силами!

Азбука Wiki-разметки

В предыдущем подразделе у нас получилось создать простую страницу и даже разместить в ней некоторый текст. Но, согласитесь, просто размещать текст без форматирования можно и в простом текстовом редакторе. Нас категорически не устраивает размещать статьи в стиле "печатной машинки", следовательно, нужно научиться форматировать текст. Это проще простого:

Форматирование "мышкой"

Под форматированием "мышкой" следует понимать набор действий над текстом, которые можно выполнять, как будто мы находимся в текстовом редакторе стандартного офисного пакета, например OpenOffice.org. Принцип прост:

  1. Выделяем слово или словосочетание.

  2. Щёлкаем на кнопке из палитры кнопок для соответствующего типа форматирования.

После выбора соответствующего форматирования выделенный текст будет обрамлён с обеих сторон специальными символами, благодаря которым после сохранения страницы примет желаемый вид. Приведём примеры:

Полужирное начертание '''Пингвин'''
Курсивное начертание ''Пингвин''
Внутренняя ссылка [[Пингвин]]

Содержание. Заголовки и подзаголовки

Документы, созданные в текстовом процессоре, включают систему уровней заголовков, по которым впоследствии, как правило, после оформления документа, можно автоматически построить содержание, используя ряд хитрых функций офисного пакета. В случае с Wiki можно забыть про понятие "Содержание", так как оно действительно строится автоматически, исходя из созданных заголовков и подзаголовков:

=Заголовок1=
==Подзаголовок1==
===Подподзаголовок1===
====И так далее1====
=Заголовок2=
==Подзаголовок2==
===Подподзаголовок2===
====И так далее2====
=Заголовок3=
==Подзаголовок3==
===Подподзаголовок3===
====И так далее3====
=Заголовок4=
==Подзаголовок4==
===Подподзаголовок4===
====И так далее4====
=Заголовок5=
==Подзаголовок5==
===Подподзаголовок5===
====И так далее5====

Каждый из элементов содержания является ссылкой на ту часть страницы, названием которой является. Таким образом, можно быстро и легко "путешествовать" по готовому документу, щёлкая мышкой на заголовке нужного раздела.

Вставка изображений на страницу

Загрузить изображения на страницу очень просто. Достаточно щёлкнуть на кнопке вставки изображения на панели форматирования.

После этого система автоматически создаст тег [[Изображение:Example.jpg]]. Здесь Example.jpg — целевое имя файла. Например, есть необходимость в размещении на вики некого изображения, которое называется medved.png. Следовательно, целевое имя файла должно быть medved.png вместо Example.jpg После записи страницы содержание тега [[Изображение:medved.png]] превратится в ссылку вида Изображение:Medved.рng, щёлкнув по которой, автоматически попадаем в форму загрузки файла.

Нажав кнопку Обзор, выбираем заготовленный файл и нажимаем Загрузить файл. После загрузки перейдём на страницу и увидим на ней загруженную картинку. Также рисунок можно снабдить надписью, изменить его размер и положение (посередине, слева или справа).

Примечание: Если в вики-разметке после вставки тега с рисунком продолжать писать текст, то после сохранения страницы он будет располагаться слева или справа от рисунка в зависимости от расположения последнего. Это не всегда удобно. Иногда требуется расположить текст ниже рисунка. Для этого можно использовать тег <br clear="all">.

Создание внутренних и внешних ссылок

Как это выглядит Что надо набрать

В Лондоне хороший общественный транспорт.

  • Первая буква точки назначения автоматически делается большой.
  • Внутренние пробелы автоматически представляются как подчёркивания (набор подчёркивания имеет тот же эффект, что и набор пробела, но не рекомендуется).

Таким образом, приведённая выше ссылка ведёт на http://127.0.0.1/wiki/Общественный_транспорт, которая является статьёй с названием «Общественный транспорт».


Внимание: если падеж ссылающегося слова или словосочетания не совпадает с именительным, то следует в двойных квадратных скобках ставить вертикальную черту и слева от неё писать именительный падеж, а справа — соответствующий грамматике предложения, в которое вставлена ссылка.

Пример: Лондон располагает хорошим общественным транспортом.

В Лондоне хороший [[общественный транспорт]].

Лондон располагает хорошим [[общественный транспорт|
общественным транспортом]].
Та же ссылка, но с другим именем: справочная информация.
Та же ссылка, но с другим именем: 
[[Википедия:Справка|справочная информация]]
Окончания сливаются со ссылкой: тестирование,

гены

Окончания сливаются со ссылкой: [[тест]]ирование, [[ген]]ы

Автоматически скрывается заключённое в круглых скобках: царство.

Автоматически скрывается пространство имён: Портал сообщества.

Сервер заполняет часть после | в момент сохранения страницы.

Автоматически скрывается заключённое в круглых скобках:
[[царство (биология)|]].
Автоматически скрывается пространство имён: 
[[Википедия:Портал сообщества|]].
Можно ссылаться на подраздел в самой статье, указав его после «решётки»: Ссылайтесь.
Можно ссылаться на подраздел в самой статье,
указав его после «решётки»:
[[Википедия:Правила и указания#Ссылайтесь|Ссылайтесь]].

Если вы хотите просто создать ссылку на категорию, не добавляя в неё текущую страницу, используйте ссылки следующего вида: Категория:Википедия:Проекты. Не забывайте добавлять : в начало ссылки.

Если вы хотите просто создать ссылку на категорию,
не добавляя в неё текущую страницу,
используйте ссылки следующего вида:
[[:Категория:Википедия:Проекты]].
При добавлении комментариев к странице обсуждения следует их подписать. Это можно сделать, добавив три тильды для получения имени пользователя:
Мария Ивановна

или четыре для получения имени пользователя плюс дата/время:

Мария Ивановна 08:10 Oct 5, 2002 (UTC)
При добавлении комментариев к странице обсуждения,
следует их подписать. Это можно сделать, добавив
три тильды для получения имени пользователя:
: ~~~
или четыре для получения имени пользователя плюс
дата/время:
: ~~~~
Именно вариант с датой и временем является предпочтительным.
Медведи на улицах Москвы — это страница,

которая ещё не создана.

Вы можете создать её, кликнув на ссылке.

[[Медведи на улицах Москвы]] — это 
страница, которая ещё не создана.
Внешняя ссылка: Nupedia,

для ссылок не на русском языке желательно указывать язык: NupediaШаблон:Ref-en

Внешняя ссылка: [http://www.nupedia.com Nupedia],
для ссылок не на русском языке желательно
указывать язык: [http://www.nupedia.com Nupedia]{{ref-en}}
Или просто укажите URL: http://www.nupedia.com.
  • В URL все символы должны находиться в диапазонах: A-Z a-z 0-9 ._\/~%-+&#?!=()@ \x80-\xFF. Если URL содержит другие символы, их следует преобразовать: например, ^ следует записывать как %5E (чтобы можно было просматривать в ASCII).
Или просто укажите URL: 
http://www.nupedia.com.
Указать e-mail можно так:

name@example.com

  • Этот адрес приведён для примера, не используйте его.
Указать e-mail можно так:
[mailto:name@example.com name@example.com]

Создание таблиц

Таблицы являются удобной формой для отображения информации. Но таблицы выполняют свою цель лишь тогда, когда между строками и столбцами имеется смысловая связь, то есть информацию в них можно рассортировать неким образом, например по дате или алфавиту.

С другой стороны, таблицы сложнее обычного текста. Так что применять их имеет смысл лишь в тех случаях, когда они действительно улучшают восприятие материала. Поэтому предварительно обдумайте: не лучше ли использовать обычный список.

Простейшая таблица

Любая таблица в wiki-стиле начинается с фигурной скобки { с последующей вертикальной чертой | и заканчивается вертикальной чертой | с закрывающей фигурной скобкой }. Каждая ячейка строки начинается с вертикальной черты |, после которой пишется её содержание.

Пример

Исходный код таблицы с одной строкой
{|
|Ячейка 1
|Ячейка 2
|Ячейка 3
|}
Будет выглядеть так
  Ячейка 1 Ячейка 2 Ячейка 3

Для введения следующей строки после вертикальной черты ставится штрих «-». Таким образом можно вводить любое количество строк.

Пример

Исходный код таблицы в две строки
{|
 |Ячейка 1*1
 |Ячейка 2*1
 |Ячейка 3*1
 |-
 |Ячейка 1*2
 |Ячейка 2*2
 |Ячейка 3*2
 |}
Будет выглядеть так
  Ячейка 1*1 Ячейка 2*1 Ячейка 3*1
  Ячейка 1*2 Ячейка 2*2 Ячейка 3*2

Пример

Таблица в три строки пишется так
{|
 |Ячейка 1*1
 |Ячейка 2*1
 |Ячейка 3*1
 |-
 |Ячейка 1*2
 |Ячейка 2*2
 |Ячейка 3*2
 |-
 |Ячейка 1*3
 |Ячейка 2*3
 |Ячейка 3*3
 |}
Будет выглядеть так
  Ячейка 1*1 Ячейка 2*1 Ячейка 3*1
  Ячейка 1*2 Ячейка 2*2 Ячейка 3*2
  Ячейка 1*3 Ячейка 2*3 Ячейка 3*3
Табличные рамки

Вид рамки описывается в первой строке, сразу после {|. Не забудьте, что между ними и атрибутом должен быть пробел.

Толщина линий рамки задаётся атрибутом border=n, где «n» — толщина линии:

Пример

Исходный код таблицы
{| border=1
 |Ячейка 1*1
 |Ячейка 2*1
 |Ячейка 3*1
 |-
 |Ячейка 1*2
 |Ячейка 2*2
 |Ячейка 3*2
 |-
 |Ячейка 1*3
 |Ячейка 2*3
 |Ячейка 3*3
 |}
Будет выглядеть так
Ячейка 1*1Ячейка 2*1Ячейка 3*1
Ячейка 1*2Ячейка 2*2Ячейка 3*2
Ячейка 1*3Ячейка 2*3Ячейка 3*3

Изменять оформление рамки таблицы также можно с помощью атрибута class.

Заголовки

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

Пример

Для последней таблицы код может быть таким
{| border=1
 !Первый столбец
 !Второй столбец
 !Третий столбец
 |-
 !Первая строка
 |Ячейка 2*1
 |Ячейка 3*1
 |-
 !Вторая строка
 |Ячейка 2*2
 |Ячейка 3*2
 |-
 !Третья строка
 |Ячейка 2*3
 |Ячейка 3*3
 |}
Таблица будет выглядеть так
Первый столбецВторой столбецТретий столбец
Первая строкаЯчейка 2*1Ячейка 3*1
Вторая строкаЯчейка 2*2Ячейка 3*2
Третья строкаЯчейка 2*3Ячейка 3*3
Запись в одну строку

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

Пример

Для последней таблицы код может быть таким
{| border=1
 !Первый столбец||Второй столбец||Третий столбец
 |-
 |Ячейка 1*1||Ячейка 2*1||Ячейка 3*1
 |-
 |Ячейка 1*2||Ячейка 2*2||Ячейка 3*2
 |-
 |Ячейка 1*3||Ячейка 2*3||Ячейка 3*3
 |}
Таблица будет выглядеть так
Первый столбецВторой столбецТретий столбец
Ячейка 1*1Ячейка 2*1Ячейка 3*1
Ячейка 1*2Ячейка 2*2Ячейка 3*2
Ячейка 1*3Ячейка 2*3Ячейка 3*3
Объединение ячеек

В wiki-стиле, как и в HTML, имеется возможность объединять несколько ячеек как по вертикали, так и по горизонтали. Для объединения по вертикали применяется атрибут rowspan=n, где «n» — число ячеек, которые должна объединить данная ячейка. Этот атрибут вписывается перед содержанием объединяющей ячейки.

Пример
Вертикальное объединение двух ячеек пишется так:

{| border=1
 |Ячейка 1
 |rowspan=2 |Ячейка 2, объединяет два ряда таблицы
 |Ячейка 3
 |-
 |Ячейка 4
 |Ячейка 5
 |}
Выглядеть это будет так
Ячейка 1 Ячейка 2, объединяет два ряда таблицы Ячейка 3
Ячейка 4 Ячейка 5

Для объединения по горизонтали используется атрибут colspan=n.

Пример

Объединение по горизонтали
{| border=1
 |Ячейка 1
 |colspan=2 |Ячейка 2, объединяет два столбца
 |-
 |Ячейка 3
 |Ячейка 4
 |Ячейка 5
 |}
Выглядит это так
Ячейка 1 Ячейка 2, объединяет два столбца
Ячейка 3 Ячейка 4 Ячейка 5

Wiki-разметка

Wiki-разметка позволяет создавать и цветные и вложенные таблицы а также таблицы с названием и фиксировнной шириной. Помимо таблиц поддерживается масса возможностей. Обзор тегов вики-разметки можно найти по ссылке: http://ru.wikipedia.org/wiki/Википедия:Как_править_статьи.

Защита от вандализма

Вандализм — явно вредительское добавление, удаление или изменение содержания, совершённое умышленно в целях скомпрометировать достоверность и авторитетность энциклопедии. В основном вандализм проявляется в замене содержимого качественных статей на ругательства, граффити или другое содержание, абсолютно не имеющее отношения к теме статьи. Внесение неверных изменений по причине искреннего заблуждения вандализмом не является.

Вандализм, несмотря на распространённое мнение, на самом деле не представляет большой проблемы для вики, так как все изменения статей хранятся в специальной базе данных, — таким образом, злоумышленники не могут уничтожить информацию полностью. Участник, заметивший, что статья была испорчена, должен откатить повреждённую версию — сделать это совсем несложно. Чтобы вынести предупреждение вандалу, необходимо на его странице обсуждения добавить Шаблон:Вандализм.

Поскольку количество людей, желающих заниматься вандализмом, приблизительно равно количеству людей, желающих восстановить истину, то создание условий, в которых второе сделать легче, чем первое, «автоматически» делает материалы вики всё более и более соответствующими истине.

Большинство последствий вандализма в вики нейтрализуются в считанные минуты.

Если вы заметили, что содержание страницы искажено или уничтожено в результате вандализма, пожалуйста, верните её к последней достоверной версии. Это может сделать любой посетитель вики.

В первую очередь перейдите к истории правок страницы и, используя для сравнения версий ссылки «пред.», определите, какие именно правки были вандальными.

Использование ссылки «отменить»

Если вандальная правка одна, то просто щёлкните на ссылке (отменить) рядом с ней.

(текущ.) (пред.) о о 13:35, 10 мая 2008 Вандал (обсуждение | вклад) (102 байта) (отменить)
(текущ.) (пред.) о о 13:32, 10 мая 2008 Участник (обсуждение | вклад) (5024 байта) (отменить)

Если есть несколько вандальных правок, то отметьте в левом столбце переключателей последнюю хорошую версию, в правом — последнюю испорченную, и нажмите кнопку «Сравнить выбранные версии».

После этого вы попадёте на страницу сравнения версий, где нужно щёлкнуть на ссылке (отменить) в правом верхнем углу таблицы.

В обоих случаях после нажатия (отменить) вы перейдёте к редактированию страницы.

Однако если вы отменяете правку или правки, не являющиеся последними в истории правок, то может получиться так, что система MediaWiki не сможет удалить их из содержания страницы, и тогда вы увидите сообщение:

Правка не может быть отменена из-за несовместимости промежуточных изменений.

В этом случае придётся делать «возврат к ранней версии».

Возврат к ранней версии

Перейдите к последней хорошей версии. Затем на её странице нажмите ссылку «править». На появившейся странице редактирования сверху будет показано предупреждение о том, что вы редактируете старую версию страницы. Вручную добавьте полезные изменения, сделанные после вандальных правок, и запишите страницу.

Описание правки

Система MediaWiki предлагает автоматическое описание правки «Отмена правки nnn участника xxx» (к которому можно добавить свой краткий комментарий) только при отмене одной правки.

Во всех остальных случаях автоматическое описание отсутствует, и желательно добавить в поле «описания изменений» понятный комментарий, например:

Отмена 5 вандальных правок [[Участник:xxx]], возврат к версии 13:05,
14 сентября 2007 от участника yyy
Сведения о документе