Manual:FAQ/ru

Что такое MediaWiki?
"MediaWiki" -- это вики-движок; иными словами, это программное обеспечение, которое предоставляет веб-сайт, содержащий страницы, редактируемые пользователями. Это программное обеспечение используется преимущественно Wikimedia Foundation для проектов с "открытым контентом", такими как Wikipedia и Wikimedia Commons.

В каком случае следует использовать MediaWiki?
MediaWiki идеально подходит для работы сайтов, назначение которых — дать пользователям возможность совместно редактировать материалы, аналогично перечисленным выше вики. После незначительных изменений MediaWiki может быть использована для решения ряда иных задач, и некоторые пользователи изменяли ее для использования в разных целях.

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

Кто разрабатывает MediaWiki?
Разработка MediaWiki ведется преимущественно добровольцами, работающими на некоммерческую организацию Wikimedia Foundation, в соответствии с их потребностями в вики-движке. Наиболее активные участники:


 * Брайон Виббер (Brion Vibber), ответственный за релизы
 * Тим Старлинг (Tim Starling)
 * Магнус Манске (Magnus Manske)
 * Эвар Арнфьорн Бьярмасон (Ævar Arnfjörð Bjarmason)
 * Роб Черч (Rob Church)
 * Никлас Лакстрем (Niklas Laxström)

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

Где можно скачать MediaWiki?
Последний стабильный релиз MediaWiki можно скачать по адресу download.wikimedia.org или sourceforge.net. Файлы хранятся в формате архива .tar.gz. MediaWiki также можно получить из нашего репозитория подверсий. Также см. раздел Download/ru

Как устанавливать MediaWiki?
Установка MediaWiki занимает от 10 до 30 минут (используя MySQL) и включает в себя загрузку, копирование файлов, создание базы данных и пользователя и запуск программы установки для настройки программного обеспечения.

Полные инструкции находятся в файле INSTALL из установочного архива.

Как установить MediaWiki в виде пакета?
Многие дистрибутивы Linux предоставляют Mediawiki в виде пакета. Команда разработчиков MediaWiki рекомендует обращаться за инструкциями по их установке, настройке и использованию к разработчикам дистрибутивов Linux. Сообщества и компании, которые ведут поддержку таких дистрибутивов, предоставляют эти инструкции.

Можно ли установить более одного вики с движком MediaWiki на один сервер?
Можно установить более одного вики на сервер при условии, что:

ИЛИ
 * Для разных вики используются разные базы данных
 * Для разных вики используется разный префикс базы данных

Информация по этим вариантам находится на страницах $wgDBname и $wgDBprefix.

Информация по установке семейства вики находится на странице Manual:Wiki family.

Как включить закачку?
Закачка файлов является часто используемым средством MediaWiki, но по умолчанию выключено во всех текущих релизных версиях. Чтобы включить ее, сначала установите веб серверу разрешение на запись в каталог закачки (по умолчанию images), например, командой CHMOD 777, а затем установите значение $wgEnableUploads в true в файле LocalSettings.php.

Как удалить кешированную страницу?
Чтобы удалить кешированную страницу, например, при внесении изменений в навигационный блок, добавьте &action=purge в конец ссылки на страницу.

Например, http://www.mediawiki.org/w/index.php?title=Main_Page&action=purge

Как разрешить закачку дополнительных форматов?
MediaWiki требует, чтобы допустимые форматы файлов были указаны в конфигурационной директиве $wgFileExtensions.

Например, чтобы разрешить закачку PDF-файлов, добавьте в LocalSettings.php такую строчку:

«Файл поврежден или имеет недопустимое расширение»
Некоторые пользователи сообщили, что после добавления формата файла в список разрешенных расширений выдается ошибка. Текст этой ошибки выглядит примерно так::


 * Этот файл испорчен или имеет недопустимое расширение. Проверьте файл и закачайте снова.

Возможные решения:

См. более детальную информацию на странице Manual:Mime type detection.
 * Установите значение $wgMimeDetectorCommand, например, под Unix или Linux это будет
 * $wgMimeDetectorCommand = "file -bi";
 * Скомпилируйте/установите расширение PHP fileinfo
 * Fedora — yum install php-pecl-Fileinfo

Как создавать Interwiki-ссылки в моей Wiki?
Просто отредактируйте таблицу "interwiki" и добавьте префикс и адрес Wikipedia или требуемого Archive.

Обновление
Общая инструкция по процедуре обновления находится в файле UPGRADE, находящимся в дистрибутиве. Смотрите также Manual:Upgrading.

Как изменить логотип?
Логотип справа вверху на каждой таблице определяется настройкой $wgLogo в файле LocalSettings.php.

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

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

Для справки: Логотип должен быть квадратным, сторона - 135 пикселей.

Как изменить свойства логотипа?
Логотип находится в блоке portlet без секции pBody. Он идентифицируется по id p-logo. Фон указывается переменной wgLogo, определяемой в /includes/DefaultSettings.php; этот путь является относительным веб-сервера, а не системы. Чтобы изменить картинку, ее следует переопределить в /LocalSettings.php. Если ее установить с ошибкой, на странице не будет картинки; проверьте журнал ошибок своего веб-сервера и измените соответствующим образом. Размер p-logo должен быть достаточным для логотипа, иначе логотип придется обрезать. Это устанавливается в таблице стилей, стиль p-logo; значение по умолчанию:

Как изменить URL-адрес страницы, открывающейся при клике по логотипу в верхнем левом углу
По умолчанию при клике по логотипу вы переходите на Заглавную страницу. Если вы хотите сделать Заглавной страницей, какую-либо другую, отредактируйте страницу MediaWiki:Mainpage. Если вы хотите изменить ссылку логотипа для скина Monobook, отредактируйте файл Monobook.php. Найдите и замените следующий код  на выбранный URL, а также замените   на нужный заголовок для ссылки.

Уменьшение размера логотипа
Обратите внимание, что тэг находится вверху логотипа. Поэтому, если Вы пытаетесь уменьшить портлет логотипа, то Вам придется также изменить директивы #p-logo a и #p-logo a:hover. Установки по умолчанию:

Это простое изменение параметров переопределяет размер всех параметров... There is one more rule controlling the amount of space between the logo and first portlet in the side column - the padding on the top of #column-one. By default this is: If you want to remove the logo completely, comment out the wgLogo variable. Then set the column-one padding to a small value, such as 21:

You don't have to go edit the css file directly. You can go to ?title=MediaWiki:Monobook.css. Hit edit and make your changes there. This has preference over the monobook main css.

Как изменить значок в адресной строке браузера (favicon)?

 * Просто замените файл favicon.ico в корневом каталоге вашей wiki на желаемый.
 * В качестве альтернативного решения измените параметр $wgFavicon в файле LocalSettings.php и добавьте параметр $wgFavicon = "/размещение/favicon.ico";

Правило перезаписи ссылок (Rewrite Rule)
Если вы используете правила перезаписи ссылок (например mod_rewrite) для удаления index.php из URL, возможно вам также понадобится добавить исключения для файлов типа .ico. Просто добавьте правило в ваш .htaccess:


 * RewriteRule .*\.ico$ - [L]

Это правило должно располагаться до правила с index.php

Чувствительность к регистру
При закачке файла favicon убедитесь, что файл не начинается с заглавной буквы. (т.е. "favicon.ico", а не "Favicon.ico".) Некоторые браузеры (например, Firefox) не могут найти этот файл, если он начинается с заглавной буквы.

Как я могу настроить блок навигации?
Содержимое блока навигации (Navigation Bar), расположенного по левой стороне каждой страницы (если используется скин Monobook), находится на странице MediaWiki:Sidebar. Дополнительную информацию о его настройке смотрите Руководство:Блок навигации.

Как мне изменить заглавную страницу?
По умолчанию MediaWiki ищет страницу с заголовком Main Page (или Заглавная страница для русской локализации) и обслуживает её как страницу по умолчанию. Такое положение дел может быть изменено заменой содержимого MediaWiki:Mainpage (там можно указать другой заголовок). Это не повлияет на какие-либо ссылки главной навигационной панели (main navigation bar), включая ссылку на Заглавную страницу, помещённую сюда во время установки. Для их изменения отредактируйте MediaWiki:Sidebar.

Как убрать таблицу с кратким содержанием страницы?
Вставьте волшебное слово   в содержимое страницы.
 * Для конкретной страницы

Отредактируйте CSS файлы; найдите стиль, отвечающий за таблицу с кратким содержанием страницы и добавьте display: none; в соответствующую формулировку.
 * Для всех страниц

У пользователей есть возможность при просмотре скрывать таблицу с кратким содержанием страницы. Они могут настроить для себя эту опцию в Special:Preferences.
 * Для конкретного пользователя

Как изменить текст в интерфейсе?
Текст интерфейса меняется при помощи страниц из пространства имён MediaWiki. По-умолчанию заполнено текстом из выбранного языка при установке или обновлении. Чтобы изменить содержание системного сообщения, достаточно исправить соответствующую страницу в пространстве имён MediaWiki.


 * Полный список доступных системных сообщений можно найти на Special:Allmessages
 * Как отключить пространство MediaWiki namespace, смотри в настройках параметра $wgUseDatabaseMessages
 * А чтобы убрать ссылку на Политика конфиденциальности (Privacy policy) или Отказ от ответственности (Disclaimers) внизу каждой страницы, надо соответственно на страницах MediaWiki:Privacy или MediaWiki:Disclaimers поставить символ минуса.

Как изменить язык интерфейса?
Например, для систем unix, запустите вот так: "php -f rebuildMessages.php rebuild" в Вашем каталоге обслуживания.
 * 1) Измените значение $wgLanguageCode в файле LocalSettings.php
 * 2) Запустите скрипт обслуживания rebuildMessages.php</tt> для перестройки пространства имен MediaWiki

Как мне спрятать от анонимных пользователей закладки «править», «обсуждение» и прочие?
Вы можете добиться этого, изменив скин. Для скина MonoBook, используемого по умолчанию, найдите строку в файле MonoBook.php: Вставьте после ...as $key => $tab) строку: Должно получиться что-то вроде: Чтобы спрятать конкретные закладки, измените код для проверки каждого из значений $key в цикле foreach.

Внимание! Редактирование скина только прячет закладки, начиная с версии 1.5 для ограничения доступа используйте $wgGroupPermissions

Как мне удалить ссылку "Представиться системе" ("Create an Account or Login"), расположенную справа вверху страницы?
В Monobook.php измените это выражение: на:

Как мне скрыть ссылки на редактирование от анонимных пользователей?
Отредактируйте скин, например MonoBook.php и добавьте следующее перед тегом :

Если вы хотите скрыть ссылки на редактирование от всех пользователей, включая зарегистрированных и представившихся системе, отредактируйте файл monobook/main.css и добавьте в него

Как изменить нижнюю часть страницы (footer)?
Для того, что бы добавить или удалить элемент из нижней части страницы, вам необходимо отредактировать оболочку (skin). Например, если вы посмотрите файл MonoBook.php, то увидите там следующий код.

В этом коде вы можете просто добавить или удалить из массива те элементы, которые вы хотите (или не хотите) видеть в нижней части страницы; это нужно сделать для всех шаблонов оболочек, и имейте в виду, что может потребоваться время на обновление кэшей MediaWiki.

Также вы можете настроить свою собственную оболочку, редактируя следующие страницы и параметры:
 * lastmod — правьте MediaWiki:Lastmodified
 * viewcount — правьте MediaWiki:Viewcount
 * numberofwatchingusers — правьте MediaWiki:Number of watching users pageview. Эта опция появится только если вы также добавите код  в LocalSettings.php.
 * copyright — правьте MediaWiki:Copyright. Параметр $1 на этой странице заменяется ссылкой на детали лицензии вашей вики. В файле LocalSettings.php параметр $wgRightsText определяет текст ссылки и установите либо параметр $wgRightsPage либо $wgRightsUrl с положением вики страницы или внешнего URL адреса.
 * privacy — это только ссылка. Редактируйте страницу MediaWiki:Privacy для изменения текста ссылки и MediaWiki:Privacypage для изменения страницы, на которую ссылаетесь.
 * about — это только ссылка. Редактируйте страницу MediaWiki:Aboutsite для изменения текста ссылки и MediaWiki:Aboutpage для изменения страницы на которую ссылаетесь.
 * disclaimer — это только ссылка. Редактируйте страницу MediaWiki:Disclaimers для изменения текста ссылки и MediaWiki:Disclaimerpage для изменения страницы, на которую ссылаетесь.
 * tagline — в настоящий момент не используется.

Как мне изменить заголовок (title) для всех страниц? Что нужно менять?
Большая часть текста, который вы хотите изменить, может быть найдена в пространстве имен MediaWiki.

Для того, что бы изменить заголовки, текст, объявления и тому подобное, откройте страницу Special:Allmessages, где вы увидите текст ассоциированный со страницами, которые вы хотите изменить (Вы можете редактировать эти страницы только в том случае если вы зашли в вики как администратор.)

Если вы хотите изменить заголовок страницы в вашем браузере, то нужно отредактировать страницу MediaWiki:Pagetitle. Правьте её точно также, как любую другую вики-страницу.

В текущей версии MediaWiki, MediaWiki:Pagetitle $1 - по умолчанию – название сайта. Если указывает неправильное название сайта, вам нужно установить параметр $wgSitename в файле LocalSettings.php.

Если параметр $wgSitename в LocalSettings.php указан правильно, но шаблон всё равно выдает ошибку, то это может быть потому, что вы используете языковой файл с некорректно устанавливаемым параметром $wgSitename для транслитерации слова «Википедия». Отредактируйте языковой файл для исправления этой ситуации. Например, языковой файл для русского языка — это файл languages/LanguageRu.php</tt> в директории wiki.

Не забывайте очистить кэш браузера после этих исправлений.

Как сделать, чтобы внешние ссылки открывались в новом окне броузера?
См. Manual:Opening external links in a new window.

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

Как мне создать новую страницу?
Есть несколько способов для создания новой страницы:


 * Сделать внутреннюю ссылку с уже существующей страницы, а потом просто перейти по этой ссылке.
 * Открыть в броузере несуществующую страницу с требуемым названием, например http://www.foowiki.org/index.php/New_page и нажать там на ссылку Править.

На некоторых вики, результат поиска несуществующей страницы будет содержать ссылку на создание такой страницы.

См. также Справка:Создание новой страницы

Как мне удалить учётную запись?
Учетные записи участников не могут быть удалены, но они могут быть заблокированы.

Как я могу удалить старые версии страницы?
Обычные пользователи не могут удалять старые версии страницы. Страницы могут быть только перемещены, а не удалены.

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

Доступны ли какие-нибудь руководства по редактированию?
Доступно несколько руководств по редактированию. В основном на проектах-сёстрах Wikimedia (таких, как Wikipedia). Также, на Meta доступна справка по разметке и прочая документация.


 * Editing содержание помощи на Meta
 * How to edit a page руководство в английской части Wikipedia
 * Как править статьи руководство в русской части Wikipedia

Как увидеть версию страницы для печати
MediaWiki использует стили, которые автоматически оформляют страницу в вид подходящий для печати, и если вы будете печатать страницу через функции "печать" или "Предварительный просмотр" в вашем браузере, то программа автоматически превратит страницу в подходящий для печати вид.

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

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

Для совместимости с более ранними версиями (до 1.1.0) назначьте этому параметру значение false.

Чтобы назначить пароль пользователей (когда эта опция выключена) используйте следующий запрос: user_id это номер пользователя, mynewpassword это новый пароль пользователя, WikiSysop имя администратора.

Importing from other types of wiki
Note: The following is directly copied from old meta FAQ. It might need to be corrected.

There is some documentation about importing in the UPGRADE file distributed with MediaWiki.

To follow on from those, this is how at least one individual imported pages from usemod to MediaWiki:

Because MediaWiki does not automatically link to CamelCase style links, you will need to add brackets  to all your links. You can do this with the following:

First, obtain ImportStage1.txt (or whatever you want to call it) from the importUseModWiki.php script ( use > to pipe the output to a file )

Second, do

sed '/Importing/!s/\ [A-Z]\w*[a-z]\w*[A-Z]\w*[a-zA-Z]/\ \[\[&\]\] /g' ImportStage1.txt > ImportStage2.txt

This should create proper links in place of your CamelCase links.

This doesn't work so well for SubPage links - someone care to fix?

Then,

sed 's/upload\:\w*\.\w*/http\:\/\/aberwiki\.org\/uploads\/& /g' ImportStage2.txt > ImportStage3.txt

This fixes your upload links. Change the replace text so it fills in your url such as http://www.yourwiki.org/uploads/filename

You are now ready to import ImportStage3.txt into your database with a command such as

mysql -u -p < ImportStage3.txt

Note: If your  outputs an XML file instead of SQL statements, this probably means you have a rather new version of MediaWiki. In such a case, you case import the XML file -- see Importing a Wikipedia database dump into MediaWiki, towards the bottom of the page ('Import XML'). Don't forget to rebuild all the tables -- that page also explains how to do that.

Importing from other types of files
Here are some info on importing from other types of files:


 * Massive text files importing
 * Massive image files uploading
 * Tools to converter from html to MediaWiki, and this.
 * Tools to converter from Microsoft .chm help files to MediaWiki

Mediawiki auto importing script
Taken from wiki_import - mediawiki auto import script:

Description
The script is designed to import a whole folder of files into mediawiki, with the folder directory tree mapped as wiki category hierarchy.

Features

 * economic, build wiki site from existing knowledge base collection without "double-entry"
 * persistent, map folder directory tree as wiki category hierarchy
 * sophisticated, import/handle all well-known file types automatically
 * complete, cover every applicable scenario, even the case when you need to control access to individual wiki pages
 * versatile, highly customizable

Quick Help
 wiki_import.sh $ $Revision: 1.1 $

mediawiki automatic file import script

Usage: wiki_import.sh [OPTIONS]...

The script is designed to import a whole folder of files into mediawiki, with the folder directory tree mapped as wiki category hierarchy.

The specification of the file-to-import is passed from standard input.

Options: -s, --sect=n    the root category section of the wiki of the imported article (mandatory) -1, --header    include standard header (category hierarchy path & notice) -l, --link      link to actual file on the web site -f, --footer    include standard footer (article category) -R, --res[=p]   add restricted tag in the footer as '' (default=`$_opt_sect')

Configuration Options: -p, --php=fn    mediawiki import php script specification -r, --root=n    the root category name for the whole wiki site -m, --max=n     max_allowed_packet for mysqld to import -u, --user=n    wiki user used for the import -a, --arch=p    the root url that linked-to archive files based on

Examples:

echo ./path/to/file.ext | wiki_import.sh -1 -l -f -s 'Customer Support' -R </tt>

For the rest of details, check out wiki_import.

Как отключить опцию редактирования для незарегистрированных пользователей?
Начиная с версии MediaWiki 1.5, были сделаны существенные улучшения для настройки прав пользователей, что сделало ограничение доступа к определенным функциям более гибким и легким. За этот параметр отвечает переменная $wgGroupPermissions.

Инструкция по использованию этой опции доступна на странице Manual:Preventing access.

...в пространстве имён "Справка" (Help) — пусто ?
На данный момент у нас нет готовой, мультиязычной справки под свободной лицензией. Несколько разработчиков надеются сделать это, однако пока пространство имен "Справка" страниц не содержит. Вы можете добавить свои собственные страницы помощи или скопировать нужную часть с "Меты", из руководства пользователя или справочника по MediaWiki, эти два сборника могут быть свободно использованы на условиях публичной лицензии GNU Free Documentation License.

...некоторые из моих изображений не показываются после обновления (апгрейда?)?
Several users have reported that, following an upgrade or a moving of their wiki, several images fail to be shown inline. The files exist, and the image description pages show a MIME type of unknown / unknown</tt> and, in some cases, a warning about potentially dangerous files.

The cure for this is to run the rebuildImages maintenance script from the command line. This sets the MIME types for all files in the database, and should restore things back to normal.

... все PNG не преобразуются в миниатюры?
After upgrading to a more recent version of PHP, it is possible a different MimeMagic.php function is being used to detect file MIME types, particularly the built-in PHP function mime_content_type, which fails to detect PNG files. Search the web for mime_content_type png for information on fixing this bug at the PHP level, possibly by editing your magic.mime file.

See here for more info.

...поиск по коротким словам не дает результата?
The default settings for MySQL demands that the minimum length of a word to be indexed for fulltext search is 4 characters. This can be a problem if you want to search for shorter words as substrings in pages. To change this, you need to reconfigure your mysql, as described in the MySQL documentation note that indexes must be rebuilt after resetting the mysql default settings.

...я не могу загрузить MediaWiki 1.8?
MediaWiki 1.8 is in a development state at present, and has not been packaged into a general release. The code can be downloaded from Subversion if desired.

...это не работает? В Википедии это фича есть!
Wikimedia web sites run the current alpha code, MediaWiki 1.8. See above for caveats and information on obtaining this.

Also, they work with several extensions, such as "Makesysop" and "Renameuser" (the complete list exists in a version page of one of their projects.

...я получаю ошибку 403 Forbidden после установки разрешений в моей ОС Fedora
Дистрибутив Fedora Core включает SELinux по умолчанию. Инструкции по настройке разрешений MediaWiki для SELinux доступны здесь.

Где взять и как установить "чёрный список" спамеров?
Расширение spam blacklist можно найти здесь Subversion. За инструкциями по установке обращайтесь к файлу README.

Как мне убрать домены из черного списка спамеров?
Вы можете внести в "белый" список домены, которые желаете, на вашей локальной Mediawiki:Spam-whitelist -странице.

Чтобы узнать формат, который вы должны использовать, возьмите за образец "белый" список англоязычной Википедии; wikimedia:w:en:MediaWiki:Spam-whitelist

Как использовать параметр $wgSpamRegex для блокировки нескольких адресов?
$wgSpamRegex is a powerful filter for page content. Adding multiple items to the regex, however, can be awkward. Consider this snippet: This example code allows convenient addition of additional items to the regex without fiddling about each time. It also demonstrates two popular filters, which block some of the most common spam attacks.

Я нашел ошибку или у меня есть запрос о новых возможностях скрипта. Куда мне со всем этим?
Сообщения об ошибках и запросы на новые возможности публикуются в рамках MediaZilla, нашей реализации Bugzilla. Пожалуйста, предварительно воспользуйтесь поиском, чтобы избежать повторных запросов.

У меня вопрос, на который здесь нет ответа. Куда мне обратиться?
Если FAQ не помог, попробуйте следующее:


 * Почитать другие статьи в разделе "Помощь" на этом сайте
 * Воспользоваться поиском по сайту
 * Поискать в нашем архиве документации на Meta
 * Поискать информацию в сети
 * Опубликовать запрос о помощи в Project:Support desk
 * Написать в лист рассылки mediawiki-l
 * Спросить совета у разработчиков в нашем IRC канале (сеть Freenode, канал #mediawiki).

Рекомендуется к прочтению

 * Как правильно задавать вопросы
 * Эффективная сдача багов