FAQ Часто задаваемые вопросы

Материал из Wiki МИАЦ ВО
Версия от 07:53, 25 октября 2007; 172.16.130.19 (обсуждение) (Новая: == Общие вопросы == === Что такое MediaWiki? === "MediaWiki" -- это вики-движок; иными словами, это программн...)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

Содержание

Общие вопросы

Что такое MediaWiki?

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

В каком случае следует использовать 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

Как устанавливать 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 такую строчку:

$wgFileExtensions[] = 'pdf';

«Файл поврежден или имеет недопустимое расширение»

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

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

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

  • Установите значение $wgMimeDetectorCommand, например, под Unix или Linux это будет
    $wgMimeDetectorCommand = "file -bi";
  • Скомпилируйте/установите расширение PHP fileinfo
    • Fedora — yum install php-pecl-Fileinfo

См. более детальную информацию на странице Manual:Mime type detection.

Как создавать 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; значение по умолчанию:

#p-logo {
    z-index: 3;
    position:absolute; /* требуется для z-index */
    top: 0;
    left: 0;
    height: 155px;
    width: 12em;
    overflow: visible;
}

Как изменить URL-адрес страницы, открывающейся при клике по логотипу в верхнем левом углу

По умолчанию при клике по логотипу вы переходите на Заглавную страницу. Если вы хотите сделать Заглавной страницей, какую-либо другую, отредактируйте страницу MediaWiki:Mainpage. Если вы хотите изменить ссылку логотипа для скина Monobook, отредактируйте файл Monobook.php. Найдите и замените следующий код <?php echo htmlspecialchars($this->data['nav_urls']['mainpage']['href'])?> на выбранный URL, а также замените <?php $this->msg('mainpage') ?> на нужный заголовок для ссылки.

Уменьшение размера логотипа

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

 #p-logo a,
 #p-logo a:hover {
    display: block;
    height: 200px;
    width: 12.2em;
    background-repeat: no-repeat;
    background-position: 35% 50% !important;
    text-decoration: none;
 }

Это простое изменение параметров переопределяет размер всех параметров...

 #p-logo,
 #p-logo a,
 #p-logo a:hover {
    height: 75px;
}

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:

#column-one { padding-top: 160px; }

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:

#column-one { padding-top: 21px; }

You don't have to go edit the css file directly. You can go to <Your Wiki URL>?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.

Как убрать таблицу с кратким содержанием страницы?

Для конкретной страницы

Вставьте волшебное слово __NOTOC__ в содержимое страницы.

Для всех страниц

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

Для конкретного пользователя

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

Как изменить текст в интерфейсе?

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

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

Как изменить язык интерфейса?

  1. Измените значение $wgLanguageCode в файле LocalSettings.php
  2. Запустите скрипт обслуживания rebuildMessages.php для перестройки пространства имен MediaWiki

Например, для систем unix, запустите вот так: "php -f rebuildMessages.php rebuild" в Вашем каталоге обслуживания.

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

Вы можете добится этого, изменив скин. Для скина MonoBook, используемого по умолчанию, найдите строку в файле MonoBook.php:

foreach($this->data['content_actions'] as $key => $tab) {

Вставте после ...as $key => $tab) строку:

if($this->data['loggedin']==1)

Должно получиться что-то вроде:

 foreach($this->data['content_actions'] as $key => $tab) if($this->data['loggedin']==1) {

Для того, чтобы спрятать конкретные закладки, измените код для проверки каждого из значений $key в цикле foreach.

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

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

В Monobook.php измените это выражение:

  foreach($this->data['personal_urls'] as $key => $item) {
    ...
   }

на:

  foreach($this->data['personal_urls'] as $key => $item) {
    <b>if ($key != 'login') {</b>
      ...
    <b>}</b>
  }

Как мне скрыть ссылки на редактирование от анонимных пользователей?

Отредактируйте скин, например MonoBook.php и добавьте следующее перед тегом </head>:

<?php if(!$this->data['loggedin']) { ?>
      <style>
        <!--
        .editsection { display: none; }
        -->
      </style>
 <?php } ?>

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

How do I change the footer?

To add or remove items from the footer on your MediaWiki page, you must edit the skin. For example if you go in to MonoBook.php you will find the following code.

 $footerlinks = array(
   'lastmod', 'viewcount', 'numberofwatchingusers', 'credits', 'copyright',
   'privacy', 'about', 'disclaimer', 'tagline',
  );

In the above you can simply add and remove items from the array that you wish to appear in your footer, this must be done for each template though and remember it may take a while to update due to MediaWiki caches.

You can also customize the individual items by modifying certain pages or parameters:

How can I change what the <title> of each page is? Where do I make changes?

Most of the text that you want to change, can be found in the namespace of MediaWiki.

In order to change titles, texts, announcements and the such, go to Special:Allmessages, where you will see the text associated with the pages you wish to change. (As far as I can tell, you need to log in as an administrator (like the one you made when you installed) to edit the protected entries in the MediaWiki namespace.)

If you want to change the title in your browser, you need to edit MediaWiki:Pagetitle. Go there and edit it just like you would any other page in your Wiki.

In recent versions of MediaWiki, MediaWiki:Pagetitle is $1 - {{SITENAME}} by default. If {{SITENAME}} is producing the wrong text for you, you need to set $wgSitename in your LocalSettings.php.

If $wgSitename is correct in LocalSettings.php but {{SITENAME}} is still wrong, it may be that you're using a user-contributed language file which incorrectly sets $wgSitename to a transliteration of "Wikipedia". Edit the language file to correct this. For example, the hebrew language file is at languages/LanguageHe.php in your wiki directory.

Don't forget to clear your browser cache after you fix it.

Как сделать, чтобы внешние ссылки открывались в новом окне броузера?

См. m:Opening external links in a new window.

Основные действия

Как мне отредактировать страницу?

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

Как мне создать новую страницу?

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

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

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

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

Как мне удалить учётную запись?

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

Как я могу удалить старые версии страницы?

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

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

Доступны ли какие-нибудь руководства по редактированию?

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

Как увидеть версию страницы для печати

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

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

Как восстановить пароль How do I reset a password?

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

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

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

 UPDATE user SET user_password=md5(concat(user_id,'-',md5('mynewpassword'))) where user_name ='WikiSysop' ;

user_id это номер пользователя, mynewpassword это новый пароль пользователя, WikiSysop имя администратора.

Customising Further

Как отключить опцию редактирования для незарегистрированных пользователей?

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

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

Почему...?

...в пространстве имён "Помощь" (Help) — пусто ?

We don't currently have a clean, internationalised set of help pages under a free license. A few developers are hoping to make this possible; however, the Help namespace currently ships in a blank state. You are free to add your own help pages, or copy certain of the items from Meta, e.g. the user guide or MediaWiki Handbook, these two collections being free to use under the GNU Free Documentation License.

...are some of my images not showing up after an upgrade?

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 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.

...are all PNG files not being turned into thumbnails?

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.

...is a search for a short keyword giving no hits

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.

...can't I download 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.

...doesn't this work? It works on Wikipedia!

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.

...do I get a 403 Forbidden error after setting permissions on my Fedora system

Fedora Core enables SELinux by default. Instructions for setting SELinux permissions for MediaWiki are available.

Борьба со спамом

Где взять и как установить "чёрный список" спамеров?

Расширение 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:

 $wgSpamRegexLines[] = 'display\s*:\s*none';
 $wgSpamRegexLines[] = 'overflow:\s*\s*auto';
 [...]
 $wgSpamRegex = '/(' . implode( '|', $wgSpamRegexLines ) . ')/i';

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.

Where Now?

Я нашел ошибку или у меня есть запрос о новых возможностях скрипта. Куда мне со всем этим?

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

У меня вопрос, на который здесь нет ответа. Куда мне обратиться?

Если FAQ не помог, попробуйте следующее:

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