Manual:FAQ/ru: Difference between revisions
Updating to match new version of source page |
|||
Line 1: | Line 1: | ||
<languages /> |
|||
{{FAQ header/ru}} |
|||
{{ |
{{TNT|FAQ header}} |
||
<br clear="{{dir|{{pagelang}}|left|right}}" /> |
|||
{{TNT|shortcut|FAQ}} |
|||
==The basics== |
|||
== Общие вопросы == |
|||
=== |
===What are the differences between MediaWiki, Wikimedia, Wikipedia and wiki?=== |
||
MediaWiki это [[:ru:Вики-движок|вики-движок]], который разработан и используется для Википедии и других проектов Викимедиа. MediaWiki свободно доступен для использования, и используется всевозможными проектами и организациями по всему миру. |
|||
This is a common question; please see [[Differences between Wikipedia, Wikimedia, MediaWiki, and wiki]] for a detailed answer. |
|||
Этот сайт, mediawiki.org, предназначен для получения информации о MediaWiki и о соответствующем программном обеспечении. |
|||
=== I want to use a MediaWiki instance to (blank). Am I allowed to? === |
|||
=== В каком случае следует использовать MediaWiki? === |
|||
MediaWiki is free software: this means that you may use it for any purpose without legal hindrance. |
|||
MediaWiki идеально подходит для работы сайтов, назначение которых — дать пользователям возможность совместно редактировать материалы, аналогично уже упомянутым [[:ru:вики-проект|вики-проектам]]. После незначительных изменений MediaWiki может быть использована для решения ряда иных задач, и некоторые пользователи изменяли её для использования в разных целях. Но все же можно сделать авторизированный доступ. |
|||
Furthermore, its licensing conditions apply solely to the software itself. |
|||
This means that although many wikis license their content under a permissive license, you are not obliged to license the content submitted to your wiki in any particular way. |
|||
Of course, as a project founded to support sites like Wikipedia, we encourage you to license the texts you write under a free license, but, in short, you are not required to. |
|||
=== Что не может делать MediaWiki? === |
|||
If you wish to alter or amend the software itself, in general, you are permitted to, but there are some restrictions and you should consult [http://www.gnu.org/licenses/old-licenses/gpl-2.0.html the full text of the GNU GPL version 2 for details]. |
|||
Будучи гибкой системой, тем не менее MediaWiki не является общецелевой. В частности, следует помнить, что система создавалась с целью предоставления возможности открытого редактирования, и поэтому в ней нет сложных средств ограничения доступа к страницам. Тем, кому требуется подобная функциональность, рекомендуем обратить внимание на программное обеспечение, созданное специально для таких целей, — в частности, системы документооборота или управления содержимым. |
|||
Because MediaWiki is provided free of charge, there is no warranty, to the extent permitted by applicable law. |
|||
==Installation and configuration== |
|||
=== Кто разрабатывает MediaWiki? === |
|||
Разработка MediaWiki ведется преимущественно добровольцами, работающими на некоммерческую организацию Wikimedia Foundation, в соответствии с их потребностями в вики-движке. Наиболее активные участники: |
|||
===Where do I download MediaWiki?=== |
|||
* Брайон Виббер (Brion Vibber), ответственный за релизы; |
|||
* Тим Старлинг (Tim Starling); |
|||
* Магнус Манске (Magnus Manske); |
|||
* Эвар Арнфьорн Бьярмасон (Ævar Arnfjörð Bjarmason); |
|||
* Роб Чёрч (Rob Church); |
|||
* Никлас Лакстрём (Niklas Laxström). |
|||
[[Download|Click here to download the latest stable release of MediaWiki.]] Files are supplied in a [[:en:Tar (computing)|.tar]][[:en:gzip|.gz]] archive. |
|||
Существует также большое сообщество пользователей, которые отслеживают изменения в программном обеспечении и поддерживают файлы локализации в актуальном состоянии. |
|||
MediaWiki can also be [[download from Git|obtained directly from our Git]] repository. |
|||
===How to install MediaWiki?=== |
|||
== Установка и настройка == |
|||
Installing MediaWiki takes around 10 to 30 minutes, and involves uploading/copying files, and running the installer script to configure the software. |
|||
=== Где можно скачать MediaWiki? === |
|||
See the [[Manual:Installation guide|Installation Guide]], where you will also find the ''minimum system requirements''. |
|||
Последний стабильный релиз MediaWiki можно скачать по адресу [[download:mediawiki/|download.wikimedia.org]] последнюю тестовую версию — {{mwsnapshots-link}}. Файлы хранятся в формате архива [[:en:Tar (file format)|.tar]][[:en:gzip|.gz]]. MediaWiki также можно [[Download from SVN/ru|получить из нашего репозитория подверсий]]. Подробнее см. раздел ''[[Download/ru]]''. |
|||
=== Как устанавливать MediaWiki? === |
|||
===How do I install MediaWiki using a package?=== |
|||
Установка MediaWiki занимает от 10 до 30 минут (используя MySQL) и включает в себя загрузку, копирование файлов, создание базы данных и пользователя и запуск программы установки для настройки программного обеспечения. |
|||
Many Linux distributions provide MediaWiki in a packaged format for that distribution. |
|||
Полные инструкции находятся в файле <tt>'''INSTALL'''</tt> из установочного архива. |
|||
The MediaWiki development team refers you to your Linux distribution for assistance with installing, configuring or using them. |
|||
The individual communities and companies who maintain such packages should provide installation instructions. |
|||
Be warned that third-party distributions may be older versions, so pay close attention to compatibility information for directions and extensions. |
|||
* http://www.chsoftware.net/en/useware/mowesmixer/mowesmixer.htm?step=2&mode=update&flag=update&xflag=help - по этому адресу можно скачать уже настроенный веб сервер с настроенной MediaWiki и другими веб приложениями PHP-GTD, CMS Joomla и ещё более 25. Веб сервер работоспособен с USB флеш диска. |
|||
:''See also: [[Software bundles]]''. |
|||
=== Как установить MediaWiki в виде пакета? === |
|||
===Can I install more than one wiki on a server using MediaWiki?=== |
|||
Многие дистрибутивы Linux предоставляют MediaWiki в виде пакета. Команда разработчиков MediaWiki рекомендует обращаться за инструкциями по их установке, настройке и использованию к разработчикам дистрибутивов Linux. Сообщества и компании, которые ведут поддержку таких дистрибутивов, предоставляют эти инструкции. |
|||
<!-- добавить здесь ссылки на инсталляции? Например : |
|||
It is possible to install more than one wiki on a server provided that: |
|||
Debian: |
|||
apt-get install mediawiki |
|||
Redhat: |
|||
yum install mediawiki |
|||
--> |
|||
*You use a different database for each wiki |
|||
=== Можно ли установить более одного вики-проекта с движком MediaWiki на один сервер? === |
|||
Or |
|||
*You use a different database prefix for each wiki (for Postgres, you can achieve a similar effect by using different schemas and users) |
|||
For information on these options, see '''[[Manual:$wgDBname|$wgDBname]]''' and '''[[Manual:$wgDBprefix|$wgDBprefix]]''' respectively. |
|||
Можно установить более одного вики-проекта на сервер при условии, что для разных вики-проектов используются разные базы данных ИЛИ для разных вики-проектов используется разный префикс базы данных. |
|||
For information on setting up a wiki family, see [[Manual:Wiki family]]. |
|||
Информация по этим вариантам находится на страницах '''[[Manual:$wgDBname|$wgDBname]]''' и '''[[Manual:$wgDBprefix|$wgDBprefix]]'''. |
|||
For information on an alternative way of setting up more than one wiki using the same server, database and source, see [http://www.steverumberg.com/wiki/index.php/WikiHelp Steve Rumberg's] ([http://web.archive.org/web/20070715020649/http://www.steverumberg.com/wiki/index.php/WikiHelp archived version]) excellent exposé and additional comments from users. |
|||
Информация по установке семейства вики находится на странице [[Manual:Wiki family/ru]]. |
|||
===Does MediaWiki work with safe_mode enabled?=== |
|||
=== Как включить загрузку? === |
|||
Yes, but only to a limited degree. |
|||
Загрузка файлов является часто используемым средством MediaWiki, но по умолчанию выключена во всех текущих релизных версиях. Чтобы включить её, сначала установите веб серверу разрешение на запись в каталог закачки (по умолчанию <tt>images</tt>), например, командой CHMOD 777, а затем установите значение '''[[Manual:$wgEnableUploads|$wgEnableUploads]]''' в <tt>true</tt> в файле LocalSettings.php. |
|||
See [[Safe mode]] for information. |
|||
Подробнее на [[Manual:Configuring file uploads]]. |
|||
===Does MediaWiki require shell access?=== |
|||
=== Как включить математические формулы? === |
|||
MediaWiki допускает внедрение математических формул с помощью вспомогательной программы texvc, которая использует язык разметки LaTeX для их написания. Инструкции по установке — на странице [[Manual:Math/ru|Manual:Math]]. |
|||
Shell access ([[w:Secure Shell|SSH]]) is not required for installing MediaWiki, but it is ''highly recommended''. |
|||
=== Как удалить кэшированную страницу? === |
|||
Without shell access, it may even be difficult for you to get a backup of your wiki, or to upgrade to a new version. |
|||
Some maintenance tasks are not possible at all without shell access. |
|||
Many major extensions work best with shell access. |
|||
===How do I install extensions?=== |
|||
Чтобы удалить кэшированную страницу, например, при внесении изменений в навигационный блок, добавьте &action=purge в конец ссылки на страницу. |
|||
See [[Manual:Extensions]] for information about installing and writing extensions. |
|||
Например, http://www.mediawiki.org/w/index.php?title=Main_Page&action=purge |
|||
See the [[:Category:Extensions]] to find existing extensions. |
|||
===How do I add extra namespaces?=== |
|||
=== Как разрешить загрузку дополнительных форматов? === |
|||
See [[Manual:Using_custom_namespaces#Creating_a_custom_namespace | Creating a custom namespace]]. |
|||
MediaWiki требует, чтобы допустимые форматы файлов были указаны в конфигурационной директиве '''[[Manual:$wgFileExtensions|$wgFileExtensions]]'''. |
|||
===How do I enable uploading?=== |
|||
Например, чтобы разрешить загрузку PDF-файлов, добавьте в LocalSettings.php такую строчку: |
|||
File uploads are an often-used feature of MediaWiki, but are disabled by default in all current release versions. |
|||
To enable them, first make the upload directory (default <code>images</code>) writable by the web server (<code>[[wikipedia:chmod|chmod]] -R 777 ./images</code> or allow the Apache user to write to it, etc.) then set '''[[Manual:$wgEnableUploads|$wgEnableUploads]]''' to <code>true</code> in LocalSettings.php ''(i.e. "$wgEnableUploads = true;")''. |
|||
If you get a "failed to mkdir" error when you try to upload, it probably means that there's a permissions problem. |
|||
:''See also: [[Manual:Configuring file uploads]]'' |
|||
===How do I enable embedded math formulas?=== |
|||
MediaWiki allows embedded math formulas. |
|||
See [[Extension:Math]] for complete setup instructions. |
|||
=== How do I set the timezone for my MediaWiki? === |
|||
:''See: [[Manual:Timezone]]'' |
|||
===How do I purge a cached page?=== |
|||
To purge a cached page, such as when making changes to the navigation bar, add <code>&action=purge</code> to the end of the page's dynamic URL. |
|||
E.g. http://www.mediawiki.org/w/index.php?title=Main_Page&action=purge |
|||
Or <code>?action=purge</code> to the end of the page's short form URL: |
|||
E.g. http://www.mediawiki.org/wiki/Main_Page?action=purge |
|||
:''See also: [[Manual:Purge]], [[Manual:Parameters to index.php]]''. |
|||
=== How do I completely disable caching? === |
|||
Add in your LocalSettings.php file the following lines: |
|||
[[Manual:$wgEnableParserCache|$wgEnableParserCache]] = false; |
|||
[[Manual:$wgCachePages|$wgCachePages]] = false; |
|||
===How do I allow uploading of additional formats?=== |
|||
MediaWiki requires that allowed file upload formats are specified using the '''[[Manual:$wgFileExtensions|$wgFileExtensions]]''' configuration directive. |
|||
Usually this directive is situated in LocalSettings.php in the root of your MediaWiki installation. |
|||
For example, to extend uploading to PDF files, add the following to LocalSettings.php: |
|||
<source lang="php"> |
<source lang="php"> |
||
$wgFileExtensions[] = 'pdf'; |
$wgFileExtensions[] = 'pdf'; |
||
</source> |
</source> |
||
To extend uploading to more than one type of file, use the following syntax |
|||
=== «Файл поврежден или имеет недопустимое расширение» === |
|||
<source lang="php"> |
|||
$wgFileExtensions = array_merge($wgFileExtensions, array( 'pdf', 'txt', 'mp3' )); |
|||
</source> |
|||
:''See also: [[Manual:Configuring file uploads]]'' |
|||
Некоторые пользователи сообщили, что после добавления формата файла в список разрешенных расширений выдаётся ошибка. Текст этой ошибки выглядит примерно так: |
|||
==="File is corrupt or has an invalid extension"=== |
|||
: ''Этот файл испорчен или имеет недопустимое расширение. Проверьте файл и закачайте снова.'' |
|||
Some users have reported that after adding a file format to the allowed extensions list, an error is encountered. |
|||
'''Возможные решения:''' |
|||
The text of the error is similar to the following: |
|||
* Попробуйте добавить в файл описания [[MIME]] типов MimeMagic.php строку "application/xml mm" - (пример для файлов типа *.mm - FreeMind) |
|||
* Установите значение '''[[Manual:$wgMimeDetectorCommand|$wgMimeDetectorCommand]]''', например, под Unix или Linux это будет |
|||
*: <tt>$wgMimeDetectorCommand = "file -bi";</tt> |
|||
* Скомпилируйте/установите расширение PHP '''[http://pecl.php.net/package/fileinfo fileinfo]''' |
|||
** Fedora — yum install php-pecl-Fileinfo |
|||
:''The file is corrupt or has an incorrect extension. Please check the file and upload again.'' |
|||
См. более детальную информацию на странице '''[[Manual:Mime type detection]]'''. |
|||
'''Possible solutions:''' |
|||
=== Как создавать интервики-ссылки в моей вики? === |
|||
Просто отредактируйте таблицу 'interwiki' и добавьте префикс и адрес Википедии или требуемого архива. |
|||
Или же можно использовать расширение [[Extension:Interwiki]]. |
|||
*Set the value of '''[[Manual:$wgMimeDetectorCommand|$wgMimeDetectorCommand]]''', e.g. under Unix or Linux, this would be |
|||
== Обновление == |
|||
*:<code>$wgMimeDetectorCommand = "file --brief --mime";</code> |
|||
*Compile/install the '''[http://pecl.php.net/package/fileinfo fileinfo]''' PHP extension |
|||
**Fedora - yum install php-pecl-Fileinfo |
|||
:''See also: [[Manual:Mime type detection]]''.code> |
|||
Общая инструкция по процедуре обновления находится в файле '''<tt>UPGRADE</tt>''', находящимся в дистрибутиве. Смотрите также [[Manual:Upgrading/ru]]. |
|||
===Initial user was not created by installer or it is not an administrator=== |
|||
== Изменение интерфейса == |
|||
{{anchor|Initial user was not created by installer}}<!-- previous title, should remain an alias --> |
|||
=== Как изменить логотип? === |
|||
Sometimes, the installer fails to create the default user, or the user table is lost for some reason. |
|||
Логотип слева вверху на каждой странице определяется настройкой [[Manual:$wgLogo|$wgLogo]] в файле ''LocalSettings.php''. |
|||
There are a couple of options for solving this: |
|||
====maintenance/createAndPromote.php==== |
|||
Чтобы изменить его, просто измените значение $wgLogo на адрес вашего логотипа. Такой файл можно закачать через вики-интерфейс и использовать такой адрес (это позволяет его легко заменять, поэтому, возможно, понадобится защитить эту страницу), или же загрузить на сервер каким-либо другим образом. |
|||
*If your MediaWiki is older than 1.16, make sure <code>[[AdminSettings.php]]</code> is set up (see <code>AdminSettings.sample</code>) |
|||
Обратите внимание: можно просто заместить существующий логотип, который был установлен вместе с MediaWiki по умолчанию, но делать этого не рекомендуется, так как обновление версии может привести к тому, что этот логотип будет замещён, или место его хранения будет изменено. |
|||
*Execute <code>[[Manual:createAndPromote.php|maintenance/createAndPromote.php]] --username <new user name> --password <password for that user></code> from the shell. Append <code>--bureaucrat</code> to command line if you want that user to become a bureaucrat, in addition to becoming an administrator. |
|||
Адрес логотипа по умолчанию: http://Ваша_Вики/skins/common/images/wiki.png |
|||
This will create a new user and promote them to an administrator. |
|||
''Для справки: Логотип должен быть квадратным, сторона — 135 пикселей.'' |
|||
For help, run the script with the parameter <code>--help</code>. |
|||
====Alter the database==== |
|||
=== Как изменить свойства логотипа? === |
|||
Логотип находится в блоке portlet без секции pBody. Он идентифицируется по id «p-logo». Фон указывается переменной '''wgLogo''', определяемой в /includes/DefaultSettings.php; этот путь является относительным веб-сервера, а не системы. Чтобы изменить картинку, её следует переопределить в /[[LocalSettings.php]]. Если её установить с ошибкой, она не будет отображаться на странице; проверьте журнал ошибок своего веб-сервера и измените соответствующим образом. Размер p-logo должен быть достаточным для логотипа, иначе логотип придется обрезать. Это устанавливается в таблице стилей, стиль p-logo; значение по умолчанию: |
|||
*Register a new account using the regular method ([[Special:UserLogin]]). |
|||
*Check the user ID in [[Special:Preferences]]. |
|||
*Execute the following SQL statement against the database: |
|||
**<code>INSERT INTO user_groups ( ug_user, ug_group ) VALUES ( ''<id>'', 'bureaucrat' ), ( ''<id>'', 'sysop' );</code> |
|||
::<code>''<id>''</code> above should be replaced with the appropriate user ID which you can see on the user's preference page. |
|||
::Note: if <code>$wgDBprefix</code> is defined in LocalSettings.php, prepend its value to the table name. For example, if <code>$wgDBprefix</code> is "XYZ", then the table name to use is <code>XYZuser_groups</code>. |
|||
====Temporarily let everyone assign rights to promote your initial user==== |
|||
{{TNT|Warning|You should not let outsiders access your wiki while you do this, if you use this method. This method may leave your wiki temporarily vulnerable to attack while you do the procedure.}} |
|||
This method essentially involves letting all users temporarily modify user permissions in order to promote one user |
|||
*Register a new account using the regular method ([[Special:UserLogin]]). Be logged in using that account. |
|||
*Add the following lines to the bottom of LocalSettings.php |
|||
** <code>$wgAddGroups['user'] = true;</code> |
|||
*Go to [[special:userrights]] and add the user you just created to the ''Administrator'' and ''Bureaucrat'' groups. |
|||
*Remove the <code>$wgAddGroups['user'] = true;</code> line from your LocalSettings.php . This step is '''very important''', as until you remove it anyone can alter permissions, which is bad. |
|||
===How do I reset a user's MediaWiki password?=== |
|||
: ''See [[Manual:Resetting passwords]]'' |
|||
===How can I create interwiki links in my wiki?=== |
|||
: ''See [[Manual:Interwiki]]'' |
|||
===How do I make my base URLs shorter?=== |
|||
<sup>(i.e. /wiki/Article_Name as opposed to /w/index.php?title=Article_Name)</sup> |
|||
:''See [[Manual:Short URL]]'' |
|||
=== How do I organize pages into subdirectories like /wiki/subdir/PageName? === |
|||
:''See [[Manual:$wgNamespacesWithSubpages]], [[Help:Subpages]]'' |
|||
===Is downloading and using all of MediaWiki.org free?=== |
|||
Yes, it is free in the sense of [[:en:Free software|Free software]]. |
|||
See [[Project:Copyrights]] for licensing issues regarding the written content of this site. |
|||
===How do I administrate/manage user rights?=== |
|||
<span id="How_do_I_administrate.2Fmanage_my_users.3F"><!-- compatibility anchor --></span> |
|||
See [[Manual:User rights]] and [[Manual:User rights]] for general information. |
|||
See [[Manual:Preventing access]] for methods and strategies for restricting access. |
|||
====How do I stop anonymous users from editing any page?==== |
|||
The recommended method is by changing the value of the <code>[[Manual:$wgGroupPermissions|$wgGroupPermissions]]</code> configuration option. |
|||
Edit <code>[[LocalSettings.php]]</code> and add the line: |
|||
<source lang="php">$wgGroupPermissions['*']['edit'] = false;</source> |
|||
If you use [[Extension:AbuseFilter]], any admin can also disable IP editing temporarily as needed. |
|||
:''See also: [[Manual:Preventing access#Restrict anonymous editing|Preventing access]], [[Manual:User rights]]''. |
|||
====How do I stop anonymous users from reading any page?==== |
|||
*Add this to the bottom of LocalSettings.php: |
|||
<source lang="php">$wgGroupPermissions['*']['read'] = false;</source> |
|||
See also [[Manual:$wgWhitelistRead]]. |
|||
See [[Manual:Preventing access#Restrict viewing of all pages]] for more information. |
|||
====How do I restrict account creation?==== |
|||
*Add this to the bottom of LocalSettings.php: |
|||
<source lang="php">$wgGroupPermissions['*']['createaccount'] = false;</source> |
|||
See [[Manual:Preventing access#Restrict account creation]] for more information. |
|||
====How do I require an email address be specified at registration?==== |
|||
:''See [[Manual:$wgEmailConfirmToEdit]]'' |
|||
===How do I put MediaWiki into ''Read Only'' mode?=== |
|||
{{MW 1.5|and after}} |
|||
:''See [[Manual:$wgReadOnly]]'' |
|||
=== How do I change default user preferences? === |
|||
{{MW 1.4|and after}} |
|||
The MediaWiki default user preferences are in the language file, i.e. <code>languages/Language.php</code> if you're using English. |
|||
Don't edit that file, just use it for reference, like you do with DefaultSettings.php. |
|||
Say if you want to change the default number of search results on a page. |
|||
Language.php says: |
|||
<source lang=php> |
|||
/* private */ $wgDefaultUserOptionsEn = array( |
|||
... |
|||
'searchlimit' => 20, |
|||
... |
|||
) |
|||
</source> |
|||
To change it to 50, put this in your LocalSettings.php: |
|||
<source lang=php> |
|||
$wgDefaultUserOptions = array( 'searchlimit' => 50 ); |
|||
</source> |
|||
Note that you are setting [[Manual:$wgDefaultUserOptions|$wgDefaultUserOptions]], which contains the site overrides, not $wgDefaultUserOptionsEn, which contains the software defaults. |
|||
Any settings in $wgDefaultUserOptions will override those set in the language file. |
|||
To change the default namespaces to be searched, in any version of MediaWiki, set [[Manual:$wgNamespacesToBeSearchedDefault|$wgNamespacesToBeSearchedDefault]] in LocalSettings.php to an array mapping namespace indexes to boolean values. |
|||
For example, to search the main namespace and the category namespace, use: |
|||
$wgNamespacesToBeSearchedDefault = array( |
|||
NS_MAIN => true, |
|||
NS_CATEGORY => true, |
|||
); |
|||
In some cases, after you change a default user preference, you may also want to change the user preferences of all existing user accounts. |
|||
If so, use the [[Manual:userOptions.php|userOptions.php]] script in the Maintenance directory. |
|||
Use the "--dry" option for the first run, assess the impact and go from there. (--dry does not write the database) |
|||
php userOptions.php --dry --nowarn searchlimit --old 20 --new 50 |
|||
Also, always backup your database before making these kinds of changes (you do not need to do use if you are just using --dry). |
|||
:''See also: [[Manual:$wgDefaultUserOptions]] |
|||
===How can I make Mediawiki run faster?=== |
|||
:''See: [[Manual:Performance tuning]]'' |
|||
===How do I enable a drop-down list of search suggestions?=== |
|||
:''See: [[Manual:Enabling autocomplete in search box]]'' |
|||
==Upgrading== |
|||
:''See: [[Manual:Upgrading]]'' |
|||
<!-- {{#lst:Manual:Upgrading|FAQ}} --> |
|||
==Moving== |
|||
===Is it possible to move my wiki to a different machine?=== |
|||
Yes. |
|||
It should be. |
|||
In essence, you will be backing up your old installation and then "restoring" it onto the new machine. |
|||
Finally, you will have to make additional modifications to update the wiki configuration so that everything points to the new location. |
|||
===How do I move my wiki to a different server?=== |
|||
Follow the instructions at [[Manual:Moving a wiki]]. |
|||
==Changing the interface== |
|||
===How do I change the logo?=== |
|||
The logo that appears in the top left of each page is determined by the [[Manual:$wgLogo|$wgLogo]] configuration line in the ''[[Manual:LocalSettings.php|LocalSettings.php]]'' file. |
|||
There are two ways to change the logo: |
|||
# Upload a picture to your wiki using the normal file uploading interface. This allows the logo to be replaced easily, so you may want to protect the page if you use this method. |
|||
#: Then add the $wgLogo line to ''LocalSettings.php'', for example: |
|||
#: <source lang="php">$wgLogo = "{$wgUploadPath}/6/62/mylogo.png";</source> |
|||
# Upload an image to your server by other means (such as FTP). |
|||
#: Add the $wgLogo line to ''LocalSettings.php'', for example: |
|||
#: <source lang="php">$wgLogo = "{$wgScriptPath}/mylogo.jpg";</source> |
|||
#: (In this example, the image is in the same folder as the LocalSettings.php file.) |
|||
If you want to change the logo in only specific pages, override #p-logo css's background-image property or use third party extension like [[Extension:LogoFunctions]]. |
|||
{{TNT|caution|Do not simply overwrite the default logo installed with MediaWiki (<code>/skins/common/images/wiki.png</code>); this file will be overwritten when you upgrade.}} |
|||
{{TNT|tip| A good logo size is 135x135px or 150x150px. The maximum logo size in Vector is ~160x160px, while MonoBook's is ~155x155px. A logo that is too large will be cut off.}} |
|||
===How do I edit the wiki's CSS?=== |
|||
You shouldn't edit the CSS files (such as main.css) directly, because it will make upgrading harder if you need to apply your customizations each time you upgrade the software. |
|||
Instead you need to edit a wiki page called [[MediaWiki:Common.css]] if you want to apply your CSS changes for all skins, or a wiki page called [[MediaWiki:Monobook.css]] if you want to apply the customizations only for Monobook skin. |
|||
The content of MediaWiki:Common.css and MediaWiki:Monobook.css pages always override the default CSS styles specified in main.css. |
|||
===How do I hide the left vertical navigation toolbar=== |
|||
In other words, how do you make the main content div take up 100% of the display, hiding the logo, toolbox, navigation and search engine? |
|||
To hide it permanently, copy and paste the following into the [[MediaWiki:Common.css]] page: |
|||
<source lang="css"> |
<source lang="css"> |
||
#column-content { margin: 0 0 .6em 0; } |
|||
#p-logo { |
|||
#content { margin: 2.8em 0 0 0; } |
|||
z-index: 3; |
|||
#p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search { display:none; } |
|||
position:absolute; /* требуется для z-index */ |
|||
#p-cactions { left: .1em; } |
|||
top: 0; |
|||
</source> |
|||
left: 0; |
|||
height: 155px; |
|||
To instead hide the toolbar when the user presses F11, enter this in your wiki's [[MediaWiki:Common.js]]: |
|||
width: 12em; |
|||
overflow: visible; |
|||
<source lang="javascript" enclose="div"> |
|||
document.onkeydown = function( e ) { |
|||
if( e == null ) e = event |
|||
if( testKey( e, 122 ) ) { //F11 |
|||
appendCSS('#column-content {margin: 0 0 .6em 0;} #content {margin: 2.8em 0 0 0;} #p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search {display:none;} #p-cactions {left: .1em;} #footer {display:none;}'); |
|||
return false; |
|||
} |
|||
} |
|||
function testKey( e, intKeyCode ) { |
|||
if( window.createPopup ) |
|||
return e.keyCode == intKeyCode |
|||
else |
|||
return e.which == intKeyCode |
|||
} |
} |
||
</source> |
</source> |
||
=== How do I hide the categories at the bottom of each page? === |
|||
=== Как изменить URL-адрес страницы, открывающейся при клике по логотипу в верхнем левом углу === |
|||
You can hide display of the categories on each page by modifying your [[MediaWiki:Common.css]] and adding: |
|||
По умолчанию при клике по логотипу вы переходите на Заглавную страницу. Если вы хотите сделать Заглавной страницей какую-либо другую страницу, отредактируйте системное сообщение [[MediaWiki:Mainpage]]. Если вы хотите изменить ссылку логотипа для скина Monobook, отредактируйте файл Monobook.php. Найдите и замените следующий код <code><?php echo htmlspecialchars($this->data['nav_urls']['mainpage']['href'])?></code> выбранным URL, а также замените <code><?php $this->msg('mainpage') ?></code> нужным заголовком для ссылки. |
|||
<source lang="css">.catlinks { display: none; }</source> |
|||
===Can I customize the logo in the top left corner? If so, how?=== |
|||
Для версии 1.15.1 чтобы изменить заголовок для ссылки, нужно найти код <code><?php echo $skin->tooltipAndAccesskey('p-logo') ?></code> и заменить его строкой <code>title="Ваш_заголовок"</code>. |
|||
The logo is a portlet block without a pBody section. |
|||
===Уменьшение размера логотипа=== |
|||
It is identified by the p-logo id. |
|||
The background image is specified by the [[Manual:$wgLogo|$wgLogo]] variable, which is defined in [[Manual:DefaultSettings.php|DefaultSettings.php]]. |
|||
This location is relative to the web server root and not the system root. |
|||
Redefine this in [[Manual:LocalSettings.php|LocalSettings.php]] to change the image. |
|||
If set wrong there will be no image on the page; check your web server error log and adjust accordingly. |
|||
However the size of the p-logo will need to be big enough for the logo if it is not to be clipped. |
|||
This is set in the stylesheet (main.css in Monobook), under the p-logo style, the default setting is: |
|||
Обратите внимание, что тег находится вверху логотипа. Поэтому, если Вы пытаетесь уменьшить портлет логотипа, то Вам придется также изменить директивы #p-logo a и #p-logo a:hover. Установки по умолчанию: |
|||
<source lang="css"> |
<source lang="css"> |
||
#p-logo { |
|||
z-index: 3; |
|||
position: absolute; /*needed to use z-index */ |
|||
display: block; |
|||
top: 0; |
|||
height: 200px; |
|||
left: 0; |
|||
width: 12.2em; |
|||
height: 155px; |
|||
background-repeat: no-repeat; |
|||
width: 12em; |
|||
background-position: 35% 50% !important; |
|||
overflow: visible; |
|||
text-decoration: none; |
|||
} |
|||
</source> |
</source> |
||
Note, if you are using a different sized logo, and want to change the CSS, please do not modify any of the core MediaWiki stylesheets. |
|||
Это простое изменение параметров переопределяет размер всех параметров… |
|||
Instead add to the on-wiki css page ([[MediaWiki:Monobook.css]] for monobook, [[MediaWiki:Vector.css]] for vector. [[MediaWiki:Common.css]] will also work for all skins) |
|||
<source lang="css"> |
|||
#p-logo, |
|||
===How do I customize the link-URL of the site-logo in the top left corner of all pages that activates when the site-logo is clicked upon?=== |
|||
#p-logo a, |
|||
#p-logo a:hover { |
|||
By default, clicking the site-logo takes you to the main site-page. |
|||
height: 75px; |
|||
If you want to change which internal site-page is the "main" site-page, edit [[MediaWiki:Mainpage]]. |
|||
To make the link of the site-logo link externally to any other arbitrary URL, you can add a hook to your LocalSettings.php to override the mainpage href which is used by the logo. |
|||
<source lang=php> |
|||
/* Change the main page url used in things like the logo to an absolute url */ |
|||
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfChangeMainPageURL'; |
|||
function lfChangeMainPageURL( $sk, &$tpl ) { |
|||
$tpl->data['nav_urls']['mainpage']['href'] = "http://www.your-desired-url.com/"; // Point the main page url to an absolute url |
|||
return true; |
|||
} |
|||
/* Change the main page url used in things like the logo to a url of another page on the wiki */ |
|||
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfChangeMainPageURL'; |
|||
function lfChangeMainPageURL( $sk, &$tpl ) { |
|||
$tpl->data['nav_urls']['mainpage']['href'] = Title::newFromText('ThePage')->getLocalURL(); // Point the main page url to a wiki page's url |
|||
return true; |
|||
} |
} |
||
</source> |
</source> |
||
===Reducing the size of the logo=== |
|||
Есть ещё один параметр, задающий пространство между логотипом и первым портлетом левой колонки: верхний отступ стиля #column-one. |
|||
Значение по умолчанию: |
|||
Note that a tag is on top of the logo so if you are trying to reduce the size of the logo's portlet you will also need to change the #p-logo a and #p-logo a:hover rules. |
|||
The default setting for these is: |
|||
<source lang="css"> |
<source lang="css"> |
||
#p-logo a, |
|||
#column-one { padding-top: 160px; } |
|||
#p-logo a:hover { |
|||
display: block; |
|||
height: 200px; |
|||
width: 12.2em; |
|||
background-repeat: no-repeat; |
|||
background-position: 35% 50% !important; |
|||
text-decoration: none; |
|||
} |
|||
</source> |
</source> |
||
===How do I change the icon in the browser's address line (favicon)?=== |
|||
Если Вы хотите убрать логотип, закомментируйте переменную '''wgLogo''' в [[Manual:LocalSettings.php|LocalSettings.php]]. Не забудьте установить маленькое значение отступа в #column-one, к примеру, 21 пиксель: |
|||
*Simply upload your favicon.ico to the root of your domain/subdomain, make sure file name is in lower case and its name is favicon.ico |
|||
*Alternatively edit the [[Manual:$wgFavicon|$wgFavicon]] setting in ''LocalSettings.php'' and add <code>$wgFavicon = "$wgScriptPath/path/to/your/favicon.ico";</code> |
|||
See [[Manual:$wgFavicon]] for more details. |
|||
''Tip: The favicon image should be either 16 x 16 pixels or 32 x 32 pixels.'' |
|||
====Rewrite Rule==== |
|||
If you are using a rewrite rule in .htaccess to remove "index.php" from the URL, you will also need to add an exception for .ico files. |
|||
Simply add the following rule to your .htaccess: |
|||
:RewriteRule .*\.ico$ - [L] |
|||
This rule must appear ''before'' the index.php rule. |
|||
====Case sensitivity==== |
|||
When uploading the favicon file, be sure the filename is in lowercase. (That is, "favicon.ico", not "Favicon.ico".) |
|||
A lot of servers (e.g., those on UNIX-like operating systems) will not be able to find the file unless its name is in lowercase. |
|||
===How do I customize the navigation bar?=== |
|||
The contents of the navigation bar which appears to the left of each page using the Monobook skin are determined by the '''[[MediaWiki:Sidebar]]''' page there on your wiki. |
|||
For information on customising these, please see [[Manual:Interface/Sidebar]]. |
|||
===How do I put a text message (sitenotice) on every page?=== |
|||
Put a text in the '''[[MediaWiki:Sitenotice]]''' page. It will be displayed on top of every article page. |
|||
You can also add text to '''[[MediaWiki:Anonnotice]]''' to create a message that only displays for logged-out users. |
|||
It is often a good idea to transclude the site notice on the anon notice to make sure that logged-out users still get the information on the site notice, |
|||
===How do I change which page is the main page?=== |
|||
By default, MediaWiki looks for a page with the title ''Main Page'' and serves this as the default page. |
|||
This can be changed by altering the contents of '''[[Creating_a_MediaWiki_page| MediaWiki:Mainpage]]''' to point to a different title. |
|||
If this does not change the 'Main Page' link included on the sidebar at install time, edit '''[[Creating_a_MediaWiki_page| MediaWiki:Sidebar]]'''. |
|||
===How do I change the Main Page title?=== |
|||
Simply click on the "Move" tab, and move the page to the desired page title. |
|||
Usually you also want to [[#How_do_I_change_which_page_is_the_main_page.3F|change which page is the configured as "main page"]]. |
|||
===How do I hide the main page title?=== |
|||
MediaWiki does not have a built-in option to hide the main page title (see {{phabricator|T8129}}), but you can use CSS to hide the title. |
|||
Alternately, you can use the [[Extension:NoTitle|NoTitle extension]]. |
|||
Add the following to {{blue|MediaWiki:Common.css}} on your wiki: |
|||
<source lang="css"> |
<source lang="css"> |
||
body.mainpage.action-view h1.firstHeading, body.mainpage.action-submit h1.firstHeading { display: none; } |
|||
#column-one { padding-top: 21px; } |
|||
</source> |
</source> |
||
Не нужно редактировать файл стилей напрямую. Вместо этого вносите изменения на странице <Ваша Вики>?title=MediaWiki:Monobook.css. Эта страница задаёт основные CSS стиля Monobook. |
|||
If this doesn't work, you may be using a skin that doesn't support this, or you moved your main page without updating [[MediaWiki:Mainpage]], or you have a really old MediaWiki version. |
|||
=== Как изменить значок в адресной строке браузера (favicon)? === |
|||
If the skin uses a different element for the title than a <code>h1</code> element with class <code>firstHeading</code>, you'll need to find the appropriate CSS selector to apply for that skin. |
|||
* Просто замените файл favicon.ico в корневом каталоге вашей wiki желаемым файлом. |
|||
* В качестве альтернативного решения измените параметр [[Manual:$wgFavicon|$wgFavicon]] в файле ''LocalSettings.php'' и добавьте параметр $wgFavicon = "/путь-до-файла/favicon.ico"; |
|||
===How can I hide the table of contents?=== |
|||
==== Правило перезаписи ссылок (''Rewrite Rule'') ==== |
|||
The table of contents ([[TOC]]) is automatically shown once there are four or more headings in the article. |
|||
Если вы используете правила перезаписи ссылок (например mod_rewrite) для удаления index.php из URL, возможно вам также понадобится добавить исключения для файлов типа .ico. Просто добавьте правило в ваш .htaccess (Замечание: Использование файла .htaccess замедляет работу на высоконагруженных серверах, т.к. вебсервер в каждом каталоге должен искать и просматривать этот файл): |
|||
There are multiple ways to hide it. |
|||
; For one page |
|||
<IfModule mod_rewrite.c> |
|||
: Place the magic word <code>'''<nowiki>__NOTOC__</nowiki>'''</code> in the page's wikitext. |
|||
RewriteEngine On |
|||
'''RewriteRule .*\.ico$ - [L]''' |
|||
RewriteRule ^wiki/(.*)$ index.php?title=$1 [L] |
|||
</IfModule> |
|||
; For all pages |
|||
Это правило должно располагаться ''до'' правила с index.php |
|||
:Install [[Extension:NoTOC]] |
|||
:''or'' |
|||
: Add the following rule to [[MediaWiki:Common.css]]: <source lang="css">.toc, #toc { display: none; }</source> |
|||
; Per user |
|||
==== Чувствительность к регистру ==== |
|||
: Users can add the same CSS rule to their [[Special:MyPage/common.css|common.css]] [[Manual:Interface/Stylesheets | personal stylesheet]]. |
|||
{{TNT|MW version|version=1.22 |comment=and before|gerrit change=99430}} |
|||
: There was a user preference to hide the table of contents, it was removed in MediaWiki 1.23 ([[phab:T54813]]). |
|||
===How do I change the interface text?=== |
|||
При закачке файла favicon убедитесь, что файл не начинается с заглавной буквы. (т.е. «favicon.ico», а не «Favicon.ico».) Некоторые браузеры (например, Firefox) не могут найти этот файл, если он начинается с заглавной буквы. |
|||
Interface text is altered using the MediaWiki namespace. |
|||
=== Как я могу настроить блок навигации? === |
|||
For each deviation from the default in the site language there is a page MediaWiki:''Englishmessagename'', and for each deviation from the default in each other language a page MediaWiki:''Englishmessagename''/''languagecode''. |
|||
(Since release 1.9 there are no pages for messages equal to the default.). |
|||
On creation of a page the edit box autofills with the default. |
|||
When creating a page to override the default it is useful to first save the default version, to allow diffs with it. |
|||
See also [[Manual:System message]]. |
|||
*For a list of system messages, see '''[[Special:Allmessages]]''' |
|||
Содержимое блока навигации (''Navigation Bar''), расположенного по левой стороне каждой страницы (если используется скин по умолчанию, Monobook), находится на странице '''[[MediaWiki:Sidebar]]'''. Дополнительную информацию о его настройке смотрите [[Manual:Interface/Sidebar/ru|Руководство:Блок навигации]]. |
|||
*To switch ''off'' the MediaWiki namespace, see the '''[[Manual:$wgUseDatabaseMessages|$wgUseDatabaseMessages]]''' configuration setting |
|||
*To remove the ''Privacy policy'' or ''Disclaimers'' links at the bottom of each page, set the content of pages '''[[MediaWiki:Privacy]]''' or '''[[MediaWiki:Disclaimers]]''' respectively to a single hyphen (<code>-</code>). |
|||
===How do I change the interface language?=== |
|||
=== Как изменить заглавную страницу? === |
|||
To change the default interface language, alter the value of <code>[[Manual:$wgLanguageCode|$wgLanguageCode]]</code> in <code>LocalSettings.php</code>, for example |
|||
По умолчанию посетитель сайта, использующего движок WikiMedia, перенаправляется из корневой директории на страницу с названием ''Main Page'' (или, в русской локализации, ''Заглавная страница''), являющуюся для этого сайта ''страницей по умолчанию''. Туда же он попадает, щёлкая по логотипу в левом верхнем углу или переходя по первой ссылке на главной навигационной панели (main navigation bar). Вы можете переопределить ''страницу по умолчанию'', заменив содержимое <!--This can be changed by altering the contents of-->'''[[MediaWiki:Mainpage]]''' на желаемый заголовок<!--to point to a different title-->. Для того, чтобы изменить также и заголовок ссылки на главной панели, нужно отредактировать либо '''[[MediaWiki:Mainpage-description]]''', либо непосредственно '''[[MediaWiki:Sidebar]]'''. |
|||
<source lang="php">$wgLanguageCode = "fr";</source> |
|||
You may also need to [[w:Wikipedia:Bypass_your_cache|bypass your browser's cache]] to see the changes. |
|||
=== Как убрать таблицу с кратким содержанием страницы? === |
|||
The new default interface language will be applied to all users who haven't ever customised it. |
|||
; Для конкретной страницы |
|||
Вставьте волшебное слово <tt>'''<nowiki>__NOTOC__</nowiki>'''</tt> в содержимое страницы. |
|||
If you want to provide users the possibility to create and choose pages and interface elements in languages other than the default one of the wiki, you need the [[Extension:Translate|Translate extension]], which can make your wiki multilingual. |
|||
; Для всех страниц |
|||
Отредактируйте [[:ru:CSS|CSS]]-файлы; найдите стиль, отвечающий за таблицу с кратким содержанием страницы и добавьте <tt>'''display: none;'''</tt> в соответствующую формулировку. |
|||
{{note|In old versions, the new default will not affect existing users, so if you're logged in, you will need to change your language settings in your [[Help:Preferences|preferences]]. |
|||
; Для конкретного пользователя |
|||
У пользователей есть возможность при просмотре скрывать таблицу с кратким содержанием страницы. Они могут настроить для себя эту опцию на странице '''[[Special:Preferences]]'''. |
|||
If you want to change the language settings for all existing users, use the [[Manual:userOptions.php|userOptions.php]] [[Manual:Maintenance scripts|maintenance script]]. |
|||
=== Как изменить текст в интерфейсе? === |
|||
For instance, to have all users with English set use French instead, run |
|||
<source lang="php">php userOptions.php language --old en --new fr</source> |
|||
Текст интерфейса меняется при помощи страниц из пространства имён MediaWiki. По-умолчанию заполнено текстом из выбранного языка при установке или обновлении. Чтобы изменить содержание ''системного сообщения'', достаточно исправить соответствующую страницу в пространстве имён MediaWiki. |
|||
}} |
|||
===How do I remove the article/edit etc tabs?=== |
|||
* Полный список доступных системных сообщений можно найти на '''[[Special:Allmessages]]'''. |
|||
* Как отключить пространство имён MediaWiki, смотри в настройках параметра '''[[Manual:$wgUseDatabaseMessages/ru|$wgUseDatabaseMessages]]'''. |
|||
* А чтобы убрать ссылку на ''Политика конфиденциальности'' (''Privacy policy'') или ''Отказ от ответственности'' (''Disclaimers'') внизу каждой страницы, надо соответственно на страницах '''[[MediaWiki:Privacy]]''' или '''[[MediaWiki:Disclaimers]]''' поставить символ минуса. |
|||
''For a little more control see: [[User:Subfader/Hide_page_tabs]]'' |
|||
=== Как изменить язык интерфейса? === |
|||
Edit [[MediaWiki:Common.css]] on your wiki, and add this: |
|||
# Измените значение '''[[Manual:$wgLanguageCode|$wgLanguageCode]]''' в файле LocalSettings.php |
|||
# Запустите скрипт обслуживания '''<tt>rebuildMessages.php</tt>''' для перестройки пространства имён MediaWiki. |
|||
<source lang="css">li#ca-edit { display: none; }</source> |
|||
Например, для систем unix, запустите вот так: "php -f rebuildmessages.php rebuild" в Вашем каталоге /maintenance. |
|||
See the page source for the various #ca-* ids used in the content tabs. |
|||
=== Как спрятать от анонимных пользователей закладки «править», «обсуждение» и прочие? === |
|||
Вы можете добиться этого, изменив скин. Для скина MonoBook, используемого по умолчанию, найдите строку в файле ''MonoBook.php'': |
|||
Note: this will only work for Monobook and derived skins such as Modern and Vector (the default skin), and doesn't actually stop people from editing. |
|||
<source lang="php">foreach($this->data['content_actions'] as $key => $tab) {</source> |
|||
To do that, see [[Manual:User rights]]. |
|||
===How do I add/remove tabs throughout my wiki?=== |
|||
Вставьте после ''...as $key => $tab)'' строку: |
|||
Use [[Extension:DynamicTabs]] on older MediaWiki installations or write your own extension (See: [[Manual:Hooks/SkinTemplateNavigation]]): |
|||
<source lang="php">if($this->data['loggedin']==1)</source> |
|||
For example, to remove the talk tab and then add a tab that always goes to the main page you would save this code in <code>extensions/AR-Tabs.php</code>: |
|||
Должно получиться что-то вроде: |
|||
{{MW 1.15|and before}} |
|||
<source lang="php"> |
<source lang="php"> |
||
<?php |
|||
foreach($this->data['content_actions'] as $key => $tab) if($this->data['loggedin']==1) { |
|||
if( !defined( 'MEDIAWIKI' ) ){ |
|||
die( "This is not a valid access point.\n" ); |
|||
} |
|||
$wgHooks['SkinTemplateContentActions'][] = 'replaceTabs'; |
|||
function replaceTabs( $content_actions ) { |
|||
unset( $content_actions['talk'] ); // only this to remove an action |
|||
$maintitle = Title::newFromText( wfMsgForContent( 'mainpage' ) ); |
|||
$main_action['main'] = array( |
|||
'class' => false or 'selected', // if the tab should be highlighted |
|||
'text' => wfMsg( 'sitetitle' ), // what the tab says |
|||
'href' => $maintitle->getFullURL(), // where it links to |
|||
); |
|||
$content_actions = array_merge( $main_action, $content_actions ); // add a new action |
|||
return true; |
|||
} |
|||
</source> |
</source> |
||
{{MW 1.16|and after}} |
|||
<source lang="php"> |
|||
<?php |
|||
if( !defined( 'MEDIAWIKI' ) ){ |
|||
die( "This is not a valid access point.\n" ); |
|||
} |
|||
$wgHooks['SkinTemplateNavigation'][] = 'replaceTabs'; |
|||
Чтобы спрятать конкретные закладки, измените код для проверки каждого из значений $key в цикле foreach. |
|||
function replaceTabs( $skin, &$links) { |
|||
unset( $links['namespaces']['talk'] ); // Remove the talk action |
|||
$maintitle = Title::newFromText( wfMsgForContent( 'mainpage' ) ); |
|||
$links['namespaces']['main'] = array( |
|||
'class' => false or 'selected', // if the tab should be highlighted |
|||
'text' => wfMsg( 'sitetitle' ), // what the tab says |
|||
'href' => $maintitle->getFullURL(), // where it links to |
|||
'context' => 'main', |
|||
); |
|||
return true; |
|||
} |
|||
</source> |
|||
and then add |
|||
<source lang="php">require_once("extensions/AR-Tabs.php");</source> |
|||
to the bottom of LocalSettings.php |
|||
====How do I remove a tab on only one page?==== |
|||
Внимание! Редактирование скина только прячет закладки, начиная с версии 1.5 для ограничения доступа используйте '''[[Manual:$wgGroupPermissions|$wgGroupPermissions]]'''. |
|||
{{MW 1.9|and after}}For example, to remove the Discussion (talk) page tab from the Main Page, on the [[MediaWiki:Common.css]] page add: |
|||
==== Для скина Vector ==== |
|||
<source lang="css"> |
|||
Найдите строку в файле ''Vector.php'': |
|||
body.page-Main_Page li#ca-talk { display: none !important; } |
|||
</source> |
|||
To modify [[MediaWiki:Common.css]] you must have administrative privileges. |
|||
<source lang="php">$this->html( 'headelement' );</source> |
|||
:''See also: [[Manual:Hide page tabs]]'' |
|||
Вставьте после нее следующие строки: |
|||
====How do I remove a tab on all pages==== |
|||
<source lang="php"> |
|||
global $wgUser; if( $wgUser->isAnon() ) { |
|||
{{MW 1.9|and after}}For example, to remove the Discussion (talk) page tab on all wikipages, on the [[MediaWiki:Common.css]] page add: |
|||
?> |
|||
<style type="text/css"> |
|||
<source lang="css"> |
|||
#ca-talk { display: none !important; } |
|||
#ca-talk { display:none!important; } |
|||
</source> |
|||
</style> |
|||
<?php |
|||
Other tabs to remove are '''#ca-history''', '''#ca-viewsource''', '''#ca-view''' (Read tab), '''#ca-nstab-main''' (Page tab), '''#ca-viewsource'''. |
|||
Other drop down menu items you can remove are '''#ca-watch''', '''#ca-move''', '''#ca-delete'''. |
|||
To modify [[MediaWiki:Common.css]] you must have administrative privileges. |
|||
===How do I hide the section edit links for users who are not logged in?=== |
|||
You can change the value of the {{wg|DefaultUserOptions}} configuration option. |
|||
Edit {{manual|LocalSettings.php}} and add the line: |
|||
<source lang="php">$wgDefaultUserOptions ['editsection'] = false;</source> |
|||
:''Also see {{a|How can I prevent editing by anonymous users?}}'' |
|||
===How do I remove the "Talk for this IP" link at the top right when [[Manual:$wgDisableAnonTalk|$wgDisableAnonTalk]] is true?=== |
|||
Set [[Manual:$wgShowIPinHeader|$wgShowIPinHeader]] to false. |
|||
===How do I remove the "Create an Account or Login" link at the top right of the screen?=== |
|||
To remove the login / create account links from the personal_urls you can use this code in your {{manual|LocalSettings.php}} to hook in and remove them: |
|||
<source lang=php> |
|||
$wgHooks['PersonalUrls'][] = 'lfRemoveLoginLink'; |
|||
function lfRemoveLoginLink( &$personal_urls, $title ) { |
|||
unset( $personal_urls['login'] ); |
|||
unset( $personal_urls['anonlogin'] ); |
|||
unset( $personal_urls['createaccount'] ); |
|||
return true; |
|||
} |
} |
||
</source> |
</source> |
||
===How can I suppress actions and special pages?=== |
|||
Чтобы спрятать другие вкладки, добавьте соответствующие идентификаторы (ca-viewsource, ca-edit). |
|||
:'''NOTE''': MediaWiki is not designed for this kind of usage! It should be noted that the following 'answer' is a hack that only 'works' with the Apache webserver. Note also that this system is not foolproof, it's just one step further than hiding the links (see above). |
|||
Подобным образом можно спрятать и другие элементы интерфейса, например «Инструменты» в левом меню (p-tb). |
|||
Suppressing actions and special pages can be useful when you want to create the illusion of a static website via a particular URL or VirtualHost, but also have an 'internal' view that is a true wiki. |
|||
===Как удалить ссылку «Представиться системе» («Create an Account or Login»), расположенную справа вверху страницы?=== |
|||
i.e. if you have an inward facing 'view' of your wiki that users can edit, and an outward facing 'view' that should appear like a static website (no history, no discussion, etc., etc.). |
|||
After hiding all the appropriate links (see above), if you are using the Apache web server, you can disable actions and special pages using the following [http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html rewrite rules]: |
|||
В Monobook.php измените это выражение: |
|||
<pre> |
|||
<source lang="php"> |
|||
# Lock down the site (disable MediaWiki commands) |
|||
foreach($this->data['personal_urls'] as $key => $item) { |
|||
... |
|||
RewriteEngine On |
|||
} |
|||
#RewriteLog /tmp/rewrite.log |
|||
#RewriteLogLevel 9 |
|||
## See http://www.mediawiki.org/wiki/Manual:Parameters_to_index.php#Actions |
|||
RewriteCond %{QUERY_STRING} (.*action=.*) |
|||
RewriteRule .* http://www.my.domain.com? |
|||
RewriteCond %{REQUEST_URI} !^/index.php/Special:Search |
|||
RewriteCond %{REQUEST_URI} ^(.*Special:.*) |
|||
RewriteRule .* http://www.my.domain.com? |
|||
## Catch a trick... |
|||
RewriteCond %{QUERY_STRING} ^(.*Special:.*) |
|||
RewriteRule .* http://www.my.domain.com? |
|||
</pre> |
|||
Above, a request for <code><nowiki>'http://www.my.domain.com/wiki/Page_name?action=edit'</nowiki></code>, for example, will be simply rewritten to <code><nowiki>'http://www.my.domain.com'</nowiki></code>. Similarly any page in the Special namespace (with the exception of Special:Search) will be rewritten to <code><nowiki>'http://www.my.domain.com'</nowiki></code>. '''Remember''', this is only a hack, and isn't intended as a solution for a secure CMS. |
|||
Note that you will need to adjust the above rules to match your specific URL naming schema. |
|||
Other issues to consider when trying to lock down a site like this is the API and POST requests for the wiki content (rather than GET). |
|||
=== How do I edit error messages? === |
|||
[[Special:Allmessages]] contains a complete list of messages (error or otherwise), that can be edited. |
|||
===How do I change the footer?=== |
|||
:''See [[Manual:Footer]] and [[Manual:Configuration settings#Copyright]]'' |
|||
===How can I edit / remove the Powered by MediaWiki image in the footer?=== |
|||
You can hide the Powered by MediaWiki image by adding the following to your wiki's [[MediaWiki:Common.css]]: |
|||
<source lang="css"> |
|||
#f-poweredbyico { display: none; } |
|||
</source> |
</source> |
||
на: |
|||
The Vector skin equivalent is: |
|||
<source lang="php"> |
|||
<source lang="css"> |
|||
foreach($this->data['personal_urls'] as $key => $item) { |
|||
#footer-icon-poweredby { display: none; } |
|||
if ($key != 'login') { |
|||
... |
|||
} |
|||
} |
|||
</source> |
</source> |
||
In MW 1.17 with Vector Skin: |
|||
=== Как скрыть ссылки на редактирование от анонимных пользователей? === |
|||
<source lang="css"> |
|||
#footer-icon-poweredbyico { display: none; } |
|||
</source> |
|||
In MW 1.18 with Vector Skin: |
|||
Отредактируйте скин, например MonoBook.php и добавьте следующее перед тегом </head>: |
|||
<source lang="css"> |
|||
#footer-poweredbyico { display: none; } |
|||
</source> |
|||
If you want to remove it completely in 1.17 you can use {{wg|FooterIcons}} to remove it using this in your {{manual|LocalSettings.php}}: |
|||
<source lang="php"> |
|||
<source lang=php>unset( $wgFooterIcons['poweredby'] );</source> |
|||
<?php if(!$this->data['loggedin']) { ?> |
|||
<style> |
|||
In 1.16 and below you will have to use a hook to remove it: |
|||
<!-- |
|||
<source lang=php> |
|||
.editsection { display: none; } |
|||
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfRemovePoweredBy'; |
|||
--> |
|||
function lfRemovePoweredBy( $sk, &$tpl ) { |
|||
</style> |
|||
unset( $this->data['poweredbyico'] ); |
|||
<?php } ?> |
|||
return true; |
|||
} |
|||
</source> |
</source> |
||
If you wish to change the icon images, urls, alt text, or add new icons please see {{wg|FooterIcons}}' documentation. |
|||
Если вы хотите скрыть ссылки на редактирование от всех пользователей, включая зарегистрированных и представившихся системе, отредактируйте файл monobook/main.css и добавьте в него <code>.editsection { display: none; }</code> |
|||
===How do I add a reply link to default signature tildes (<nowiki>~~~~</nowiki>) template?=== |
|||
===Как изменить нижнюю часть страницы (footer)?=== |
|||
You can customize at: [[MediaWiki:Signature]] / [[MediaWiki:Signature-anon]] |
|||
Для того, что бы добавить или удалить элемент из нижней части страницы, вам необходимо отредактировать оболочку (skin). Например, если вы посмотрите файл MonoBook.php, то увидите там следующий код. |
|||
For example, changing the entries to <code><nowiki>[[{{ns:user}}:$1|$2]] ([[{{ns:user_talk}}:$1|talk]])</nowiki></code> will put a link to users' talk pages and <code><nowiki>[[{{ns:user}}:$1|$2]] ([{{fullurl:{{ns:user_talk}}:$1|action=edit§ion=new}} Reply])</nowiki></code> would give a more direct link. |
|||
<source lang="php"> |
|||
$footerlinks = array( |
|||
'lastmod', 'viewcount', 'numberofwatchingusers', 'credits', 'copyright', |
|||
'privacy', 'about', 'disclaimer', 'tagline', |
|||
); |
|||
</source> |
|||
Users can change it their preferences. |
|||
В этом коде вы можете просто добавить или удалить из массива те элементы, которые вы хотите (или не хотите) видеть в нижней части страницы; это нужно сделать для всех шаблонов оболочек, и имейте в виду, что может потребоваться время на обновление кешей MediaWiki. |
|||
===How can I change what the <title> of each page is? Where do I make changes?=== |
|||
Также вы можете настроить свою собственную оболочку, редактируя следующие страницы и параметры: |
|||
* ''lastmod'' — правьте [[MediaWiki:Lastmodified]]. |
|||
* ''viewcount'' — правьте [[MediaWiki:Viewcount]]. |
|||
* ''numberofwatchingusers'' — правьте [[MediaWiki:Number of watching users pageview]]. Эта опция появится только если вы также добавите код <code>$wgPageShowWatchingUsers = true;</code> в 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'' — в настоящий момент не используется. |
|||
Most of the text that you want to change can be found in the namespace of MediaWiki. |
|||
=== Как изменить заголовок (''title'') для всех страниц? Что нужно менять?=== |
|||
Большая часть текста, который вы хотите изменить, может быть найдена в пространстве имен MediaWiki. |
|||
In order to change titles, texts, announcements, etc., go to [[Special:AllMessages]], where you will see the text associated with the pages you wish to change. |
|||
Для того, что бы изменить заголовки, текст, объявления и тому подобное, откройте страницу [[Special:Allmessages]], где вы увидите текст, связанный со страницами, которые вы хотите изменить (Вы можете редактировать эти страницы только в том случае, если вы являетесь администратором вики-проекта.) |
|||
You need to log in as an administrator 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]]. |
|||
Если вы хотите изменить заголовок страницы в вашем браузере, то нужно отредактировать страницу [[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 <nowiki>$1 - {{SITENAME}}</nowiki> by default. If <nowiki>{{SITENAME}}</nowiki> is producing the wrong text for you, you need to set [[Manual:$wgSitename|$wgSitename]] in your LocalSettings.php. |
|||
If $wgSitename is correct in LocalSettings.php but <nowiki>{{SITENAME}}</nowiki> is still wrong, it may be that you're using a user-contributed language file which incorrectly sets $wgSitename to a transliteration of "Wikipedia". |
|||
Если параметр $wgSitename в LocalSettings.php указан правильно, но шаблон <nowiki>{{SITENAME}}</nowiki> всё равно выдает ошибку, то это может быть потому, что вы используете языковой файл с некорректно устанавливаемым параметром $wgSitename для транслитерации слова «Википедия». Отредактируйте языковой файл для исправления этой ситуации. Например, языковой файл для русского языка — это файл <tt>languages/LanguageRu.php</tt> в директории wiki. |
|||
Edit the language file to correct this. |
|||
For example, the Hebrew language file is at <code>languages/LanguageHe.php</code> in your wiki directory. |
|||
Don't forget to clear your browser cache after you change your settings. |
|||
Не забывайте очистить кеш браузера после этих исправлений. |
|||
===Does MediaWiki automatically capitalize the first letter of $wgSitename?=== |
|||
Если название сайта на русском языке и появляется ошибка с выводом квадратиков или кракозябр, проверьте в какой кодировке вы сохранили файл LocalSettings.php (должно совпадать с кодировкой Wiki). |
|||
Yes. |
|||
=== Как изменить заголовок (''title'') только для "Заглавной страницы"? === |
|||
This can be changed using the <span class="plainlinks">[[Manual:$wgCapitalLinks|$wgCapitalLinks]]</span> configuration setting. |
|||
===How do I make external links open in a new window?=== |
|||
===Как скрыть заголовок на главной странице?=== |
|||
В MediaWiki нет опции позволяющей отключить её, но вы можете использовать CSS для скрытия заголовка или [[Extension:NoTitle|NoTitle extension]]. |
|||
:''See [[Manual:Opening external links in a new window|Opening external links in a new window]]'' |
|||
==== Способ 1 (css) ==== |
|||
Добавьте следущие строки в [[MediaWiki:Monobook.css]]: |
|||
===How can I suppress MediaWiki from formatting URLs, tags, etc?=== |
|||
Put "<nowiki><nowiki></nowiki>" tags around the URL or tag. |
|||
''Example:'' |
|||
<nowiki>svn co <nowiki>http://svn.example.com/myproject/</nowiki></nowiki> |
|||
''Produces:''<br/> |
|||
svn co <nowiki>http://svn.example.com/myproject/</nowiki> |
|||
===How can I force users to preview before they save?=== |
|||
:''See: [[Manual:Force preview]] and [[Extension:ForcePreview]]'' |
|||
===How do I add more buttons on the edit page?=== |
|||
:''See: [[Manual:Custom edit buttons]]'' |
|||
===How can I get more special characters or tags clickable on the edit page?=== |
|||
For adding more selectable special characters, etc., below the edit field, see [[Extension:CharInsert]]. |
|||
=== How can I use Wikipedia's default skin (Vector) on my wiki? === |
|||
{{MW 1.16|and after}}Vector was introduced in MediaWiki version 1.16, and was made the default skin in 1.17. See [[Manual:$wgDefaultSkin]] for more information on configuring your default skin. |
|||
Additional features of the Vector skin are made available using the [[Extension:Vector|Vector extensions]], which you must download and install separately. |
|||
=== How do I disable external links from showing in the printable version of a page? === |
|||
Edit the page [[MediaWiki:Print.css]] on your wiki and add the following code there: |
|||
<source lang="css"> |
<source lang="css"> |
||
#content a.external.text:after, |
|||
body.page-Main_Page h1.firstHeading { display:none; } |
|||
#content a.external.autonumber:after { |
|||
content: none; |
|||
} |
|||
</source> |
</source> |
||
This will override the styles defined in skins/common/commonPrint.css in MediaWiki source code. |
|||
====Способ 2 (display title)==== |
|||
For more information, see [[Manual:CSS]]. |
|||
Добавьте следущие строки на страницу в которой вы хотите скрыть заголовок ('''требует чтобы опция [[Manual:$wgRestrictDisplayTitle|$wgRestrictDisplayTitle]] была отключена'''): |
|||
<pre> |
|||
{{DISPLAYTITLE:<span style="display:none">{{FULLPAGENAME}}</span>}} |
|||
</pre> |
|||
===Как сделать, чтобы внешние ссылки открывались в новом окне браузера?=== |
|||
Для настройки на открытие внешних ссылок в новом окне или вкладке браузера, необходимо в файл '''LocalSettings.php''' добавить строку. |
|||
If instead you want to have the external links ''underlined'' in the printable version, then also add the following code: |
|||
$wgExternalLinkTarget = '_blank'; |
|||
<source lang="css"> |
|||
См. [[Manual:Opening external links in a new window]]. |
|||
#content a.external { |
|||
text-decoration: underline !important; |
|||
} |
|||
</source> |
|||
===How do I change the text of the article (page name) tab of my wiki's main page?=== |
|||
==Основные действия== |
|||
{{anchor|How do I change the text of the tab of my wikis main page?}} |
|||
===Как отредактировать страницу?=== |
|||
To change the text of the tab, as one example used in Wikipedia, you first open the page "<code>MediaWiki:Mainpage-nstab</code>". |
|||
After you've done that, click Edit and type in the edit box the text you want to be seen later on the main page - that's it. |
|||
Чтобы отредактировать страницу, просто щелкните по ссылке «'''править'''», которая появляется на каждой странице. При использовании оформления Моно-книга (по умолчанию), это находится на вкладке вверху формы текущей страницы. Появится форма для редактирования содержания. После внесенных вами изменений, нажмите кнопку «'''Записать страницу'''» и внесённые вами изменения будут сохранены. |
|||
Don't forget to save the page as well. |
|||
==Basic usage== |
|||
===Как создать новую страницу?=== |
|||
===How do I edit a page?=== |
|||
Есть несколько способов для создания новой страницы: |
|||
To edit a page, simply click the '''edit''' link that appears on each page. |
|||
* Сделать внутреннюю ссылку с уже существующей страницы, а потом просто перейти по этой ссылке. |
|||
Using the default Vector skin, this is in the form of a tab at the top of the page. |
|||
* Открыть в браузере несуществующую страницу с требуемым названием, например <code><nowiki>http://www.example.com/index.php?title=New_page</nowiki></code> и нажать там на ссылку «'''править'''», «'''создать'''» или , «'''создать как исходный текст'''». |
|||
A form will appear, containing the existing markup. |
|||
When you have finished making modifications, click the '''Save''' button to commit your changes. |
|||
:''See also: [[Help:Editing pages]]'' |
|||
В некоторых вики, можно вписать название нужной, но ещё не существующей страницы в строку поиска, — результат будет содержать ссылку на создание такой страницы. |
|||
===How do I create a new page?=== |
|||
* ''См. также [[Help:Starting a new page/ru|Справка:Создание новой страницы]].'' |
|||
There are several ways to create a new page: |
|||
===Как удалить учётную запись?=== |
|||
*Create a link to the page on another page, then click on the red link which appears |
|||
Учётные записи участников не могут быть удалены, но они могут быть заблокированы.. |
|||
*Browse to the intended location of the page, e.g. <code><nowiki>http://www.example.com/index.php?title=New_page</nowiki></code> and click on the "'''Edit'''", "'''Create'''" or "'''Create source'''" link. |
|||
On some wikis, a failed search for a page will contain a link which allows you to edit that page. |
|||
:''See also: [[Help:Starting a new page]]'' |
|||
===Как я могу удалить старые версии страницы?=== |
|||
Обычные пользователи не могут удалять старые версии страницы. Страницы могут быть только перемещены, а не удалены. |
|||
===How do I delete an old version of a page?=== |
|||
Администраторы могут удалять версии, делая их невидимыми для обычных пользователей. Они будут по-прежнему находиться в базе данных, но могут быть удалены запуском [[Extension:SpecialDeleteOldRevisions|SpecialDeleteOldRevisions]]. |
|||
Old versions of page data are retained in the database and can be accessed via the page history features. |
|||
===Доступны ли какие-нибудь руководства по редактированию?=== |
|||
This is useful for reviewing changes and correcting or reverting undesirable ones, but in some cases, administrators might want to make this information unavailable, for legal reasons, or to reduce the size of the database. |
|||
*Administrators can delete an old revision of a page by deleting the page, and then selectively undeleting revisions to be kept |
|||
Доступно несколько руководств по редактированию. В основном на проектах-сёстрах Wikimedia (таких, как Википедия). Также, на ''[[:m:|Meta]]'' доступна справка по разметке и прочая документация. |
|||
*The [[Extension:Oversight|Oversight]] extension (also known as ''HideRevision'') can be used to move harmful revisions out of page histories on older versions of MediaWiki (<1.16). |
|||
*For newer MediaWikis (1.14+), you can enable the core [[RevisionDelete]] feature that allows privileged users to remove single revisions from page histories. |
|||
*The <code>maintenance/deleteOldRevisions.php</code> [[Manual:Maintenance scripts|maintenance script]] can mass-delete all old revisions of pages and their associated text records. |
|||
:''See also: [[Manual:Removing embarrassment]]'' |
|||
* «[[m:Help:Editing|Editing]]» — содержание помощи на ''Meta''. |
|||
* «''[[:en:Wikipedia:How to edit a page|How to edit a page]]''» — руководство в английской части Википедии. |
|||
* «''[[:ru:Википедия:Как править статьи|Как править статьи]]''» — руководство в русской части Википедии. |
|||
===How do I use oversight/delete revisions in the page history?=== |
|||
===Как увидеть версию страницы для печати=== |
|||
:''See: [[RevisionDelete]]'' |
|||
MediaWiki использует стили, которые автоматически оформляют страницу в вид подходящий для печати, и если вы будете печатать страницу через функции «печать» или «Предварительный просмотр» в вашем браузере, то программа автоматически превратит страницу в нужный вид. |
|||
You can also delete a page, and then restore only the revisions you want. |
|||
Кроме того, вы можете воспользоваться ссылкой " Версия для печати" на панели инструментов. |
|||
===Are there any editing tutorials available?=== |
|||
===Как восстановить пароль=== |
|||
There are several editing tutorials available, mostly on Wikimedia sister projects, such as Wikipedia. |
|||
Для безопасности хеши паролей участников в базе данных содержат мусор, из-за чего злоумышленнику будет сложнее их все сломать. |
|||
There are also markup references, etc. available on ''Meta''. |
|||
*The page [[Help:Editing pages]] on this site |
|||
Для совместимости с более ранними версиями (до 1.1.0) назначьте параметру [[Manual:$wgPasswordSalt|$wgPasswordSalt]] значение false. |
|||
*[[m:Help:Editing|Editing]] help content on ''Meta'' |
|||
*The ''[[:en:Wikipedia:How to edit a page|How to edit a page]]'' guide on the English Wikipedia |
|||
===How do I view the printable form of a page?=== |
|||
Чтобы назначить пароль пользователей (когда эта опция выключена), используйте следующий SQL-запрос: |
|||
<source lang="sql"> |
|||
UPDATE user SET user_password = MD5(CONCAT(user_id,'-', MD5('somepass'))) where user_name = 'someuser'; |
|||
</source> |
|||
user_id — идентификатор пользователя, somepass — новый пароль пользователя, someuser — имя пользователя. |
|||
MediaWiki includes stylesheets which automatically style a page appropriately when it is printed; using the print or print preview function within your browser ought to render the page in a printable form. |
|||
<b>В новых версиях изменен алгоритм формирования пароля.</b> |
|||
You can also view this printable form using the ''printable version'' link in the sidebar under ''Toolbox'' or ''Print/export'' if using the [[Extension:Collection|Collection extension]]. |
|||
Если установлен флаг $wgPasswordSalt, то алгоритм: |
|||
<source lang="sql"> |
|||
=== How do I use templates? === |
|||
UPDATE user SET user_password = CONCAT(':B:', salt, ':', MD5(CONCAT(salt, '-', MD5('somepass')))) where user_name = 'someuser'; |
|||
</source> |
|||
:''See [[Help:Templates]]'' |
|||
если нет, то: |
|||
<source lang="sql"> |
|||
===Can I use media (images, video, audio, etc.) from [[m:Wikimedia Commons|Wikimedia Commons]] in my installed version of MediaWiki?=== |
|||
UPDATE user SET user_password = CONCAT(':A:', MD5('somepass')) where user_name = 'someuser'; |
|||
</source> |
|||
Yes, this is encouraged through the use of [[Manual:$wgUseInstantCommons]]. |
|||
salt - соль, строка из 8 символов (цифр или латинских букв, например: 9632ef27). |
|||
:''See also: [[InstantCommons]]'' |
|||
===How do I use a template as a signature?=== |
|||
When you look at your preferences, you see a check box for "raw signature." |
|||
But the field will only take a certain number of characters. |
|||
What if you want more? |
|||
You will need to create two pages, possibly in your userspace. |
|||
#Create the first page (FIRST PAGE) |
|||
# Go to your preferences, check "raw signature" and put <nowiki>{{FIRST PAGE}}</nowiki> in the signature. Save |
|||
#Create a second page (SECOND PAGE) (possibly a sub-page of the first) |
|||
#Go back to the first page (FIRST PAGE) and do <nowiki>{{SECOND PAGE}}</nowiki> |
|||
#Go to the second page (SECOND PAGE) and place the code you wish to have for your signature. |
|||
If you don't have this structure, you will still be inserting all your signature code into the raw code wherever your signature is used, because the software will insert "SUBST" in your preferences. |
|||
You may not mind this, in which case you only need one page. |
|||
If you want the raw code to only display <nowiki>{{FIRST PAGE}}</nowiki>, which looks a lot cleaner, then you need to use the two-page structure. |
|||
=== How do I add the sandbox functionality to my installation of the wiki? === |
|||
In wiki terms, a ''sandbox'' is simply a "play pen"; a page which users can mess about in. |
|||
This is an ordinary page created in the normal manner, and can be located wherever you like. |
|||
There is no special sandbox functionality built into MediaWiki. |
|||
Users often inquire about the Wikipedia sandboxes, which seem to be self-emptying. |
|||
This is not quite correct; there are a number of volunteers who run [[Manual:Bots|bots]] to clean these up and return them to a certain state at regular time intervals. |
|||
=== How do I add a "Sandbox" link to personal tools (top right)? === |
|||
You need to add the [[Extension:Gadgets|Gadget extension]] and add the [[w:MediaWiki:Gadget-mySandbox.js|Sandbox gadget]]. |
|||
You will probably also want to make it a default gadget. |
|||
=== How do I make my wiki serve all languages? === |
|||
To make your wiki multilingual and a tool for translation, allowing translation of pages and of the custom interface (like the sidebar), use the [[Extension:Translate|Translate extension]]; there's [[Help:Extension:Translate|extensive documentation]]. |
|||
==Wiki Importing== |
|||
===Importing from MediaWiki XML dumps=== |
|||
:''See [[Manual:Importing XML dumps]]'' |
|||
== Импорт в wiki == |
|||
=== |
===Importing from other types of wiki software=== |
||
'''Note:''' The following is directly copied from [[m:MediaWiki FAQ|old meta FAQ]]. |
|||
'''Заметка:''' Текст этого подраздела просто скопирован из [http://meta.wikimedia.org/w/index.php?title=MediaWiki_FAQ старого FAQ] и требует исправления. |
|||
It might need to be corrected. |
|||
There is some documentation about importing in the UPGRADE file distributed with MediaWiki. |
|||
Немного сведений об импорте содержится в файле UPGRADE, который есть в дистрибутиве MediaWiki. |
|||
To follow on from those, this is how at least one individual imported pages from usemod to 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 <nowiki> [[ ]] </nowiki> to all your links. You can do this with the following: |
Because MediaWiki does not automatically link to [[w:CamelCase|CamelCase]] style links, you will need to add brackets <nowiki> [[ ]] </nowiki> 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 |
Second, do |
||
<pre> |
<pre> |
||
Line 459: | Line 971: | ||
'''This doesn't''' work so well for SubPage links - someone care to fix? |
'''This doesn't''' work so well for SubPage links - someone care to fix? |
||
Then, |
|||
Затем, |
|||
<pre> |
<pre> |
||
Line 466: | Line 978: | ||
</pre> |
</pre> |
||
This fixes your upload links. Change the replace text so it fills in your url such as <nowiki>http://www.yourwiki.org/uploads/filename</nowiki> |
This fixes your upload links. |
||
Change the replace text so it fills in your url such as <nowiki>http://www.yourwiki.org/uploads/filename</nowiki> |
|||
You are now ready to import ImportStage3.txt into your database with a command such as |
|||
Теперь вы готовы импортировать файл ImportStage3.txt в свою базу данных при помощи такой команды как |
|||
<pre> |
<pre> |
||
mysql -u< |
mysql -u<mysqluser> -p<yourpass> <db name> < ImportStage3.txt |
||
</pre> |
</pre> |
||
''' |
'''Note:''' If your <code>importUseModWiki.php</code> outputs an XML file instead of SQL statements, this probably means you have a rather new version of MediaWiki. |
||
In such a case, you can 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=== |
|||
=== Импортирование других типов файлов === |
|||
Если файл можно открыть в OpenOffice, то делаем экспорт: |
|||
There are a variety of tools available to help convert content from HTML (and other formats) to MediaWiki markup. |
|||
Файл - Экспорт - Формат файла: MediaWiki(.txt) |
|||
; Developer and SysAdmin tools |
|||
Затем содержимое этого файла вставляем в редактор MediaWiki. |
|||
* [http://search.cpan.org/dist/HTML-WikiConverter-MediaWiki HTML::WikiConverter::MediaWiki] - a Perl module for converting from HTML to MediaWiki markup. |
|||
* [[meta:Wikificator|Wikificator]] - a Javascript MediaWiki extension that converts XHTML to MediaWiki markup. |
|||
* The [[Manual:Edit.php|Edit.php]], [[Manual:importImages.php|importImages.php]] and [[Manual:ImportTextFile.php|ImportTextFile.php]] [[Manual:Maintenance scripts|maintenance scripts]] can be used to import text and images into MediaWiki. |
|||
; End-user tools |
|||
* [http://labs.seapine.com/htmltowiki.cgi HTML to Wiki Converter] - an online HTML to MediaWiki markup conversion service. (Based on [http://search.cpan.org/dist/HTML-WikiConverter-MediaWiki HTML::WikiConverter::MediaWiki]) |
|||
* [[w:User:Cacycle/wikEd|wikEd]] - a text editor for MediaWiki that can import HTML (including Microsoft Word-generated HTML.) |
|||
;Instructions |
|||
Тут немного информации об импортировании файлов других форматов: |
|||
*[http://xpt.sourceforge.net/techdocs/language/wiki/wikimedia/wkm07-MediaWikiImport/ar01s04.html Brief notes on converting from Microsoft .chm help files to MediaWiki] |
|||
*[http://openwetware.org/wiki/Converting_documents_to_mediawiki_markup#Word_Documents Notes on converting from Microsoft Office formats to MediaWiki] |
|||
===MediaWiki auto importing script=== |
|||
* [http://xpt.sourceforge.net/techdocs/language/wiki/wikimedia/wkm07-MediaWikiImport/index.html#How_to_migrate_lot_of_text_files Импорт множества текстовых файлов] |
|||
* [http://xpt.sourceforge.net/techdocs/language/wiki/wikimedia/wkm07-MediaWikiImport/index.html#mass_image_upload_zip_ Загрузка множества графических файлов] |
|||
* [http://xpt.sourceforge.net/techdocs/language/wiki/wikimedia/wkm07-MediaWikiImport/ar01s02.html Инструменты для конвертирования из HTML в MediaWiki], [http://xpt.sourceforge.net/techdocs/language/wiki/wikimedia/wkm07-MediaWikiImport/ar01s03.html и это]. |
|||
* [http://xpt.sourceforge.net/techdocs/language/wiki/wikimedia/wkm07-MediaWikiImport/ar01s04.html Инструменты для конвертирования из файлов помощи Microsoft .chm в MediaWiki] |
|||
Taken from [http://xpt.sourceforge.net/tools/wiki_import/ wiki_import - MediaWiki auto import script]: |
|||
=== Cкрипт автоматического импорта Mediawiki === |
|||
====Description==== |
|||
Взято с [http://xpt.sourceforge.net/tools/wiki_import/ wiki_import - скрипт автоматического импорта в mediawiki]: |
|||
The script is designed to import a whole folder of files into MediaWiki, with the folder directory tree mapped as wiki category hierarchy. |
|||
==== Описание ==== |
|||
====Features==== |
|||
Скрипт разработан для импортирования целого каталога файлов в MediaWiki с деревом папок каталога, размеченным как вики-иерархия категории <!-- with the folder directory tree mapped as wiki category hierarchy.--> |
|||
*economic, build wiki site from existing knowledge base collection without "double-entry" |
|||
==== Features ==== |
|||
*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==== |
|||
* 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 |
|||
wiki_import.sh $ $Revision: 1.1 $ |
|||
==== Быстрая помощь ==== |
|||
(Подсказка программы — содержится в файле <tt>wiki_import.sh.hlp</tt>.) |
|||
<pre> |
|||
wiki_import.sh $ $Revision: 0 $ |
|||
mediawiki automatic file import script |
mediawiki automatic file import script |
||
Line 540: | Line 1,056: | ||
Examples: |
Examples: |
||
echo ./path/to/file.ext | wiki_import.sh - |
echo ./path/to/file.ext | wiki_import.sh -1 -l -f -s 'Customer Support' -R |
||
</pre> |
|||
For the rest of details, check out [http://xpt.sourceforge.net/tools/wiki_import/ wiki_import]. |
|||
=== Templates imported from other wikis (such as Wikipedia) don't work for me === |
|||
==Дальнейшая настройка== |
|||
You probably need to install some extensions used on the source wiki, such as [[Extension:ParserFunctions|ParserFunctions]] or sometimes [[Extension:Cite|Cite]]. |
|||
===Как отключить опцию редактирования для незарегистрированных пользователей?=== |
|||
Also, make sure that you copied all [[Manual:Interface/Stylesheets|site CSS]] and [[Manual:Interface/JavaScript|JavaScript]] required by the template. |
|||
==Customising further== |
|||
Начиная с версии MediaWiki 1.5, были сделаны существенные улучшения для настройки прав пользователей, что сделало ограничение доступа к определенным функциям более гибким и легким. За этот параметр отвечает переменная '''[[Manual:$wgGroupPermissions|$wgGroupPermissions]]'''. |
|||
===I want to have multiple wikis, but only require registration once=== |
|||
Инструкция по использованию этой опции доступна на странице ''[[Manual:Preventing access]]''. |
|||
*If you're starting from scratch or you're switching from one wiki to multiple, you can use [[Manual:$wgSharedDB|$wgSharedDB]] and [[Manual:$wgSharedTables|$wgSharedTables]] to have all wikis share the user table of the "main" wiki. You can share other tables as well, as long as they don't contain any data dependent on non-shared tables or data specific to one wiki. See [[Manual:Shared database]] for examples and more information. |
|||
==Почему...?== |
|||
*If your wikis are already established and you want to switch to a single sign-on, you can use the [[Extension:CentralAuth|CentralAuth extension]]. It has a few more features than a shared user table, but it's more difficult to configure and it's tailored toward a Wikimedia-style setup. However, it is easier than attempting to completely merge multiple user tables into one. |
|||
===How can I allow use of HTML tags?=== |
|||
===...в пространстве имён «Справка» (Help) — пусто ?=== |
|||
See [[Manual:$wgRawHtml]] as well as [[Manual:$wgGroupPermissions]] and [[Manual:Preventing access]]. |
|||
На данный момент у нас нет готовой, мультиязычной справки под свободной лицензией. Несколько разработчиков надеются сделать это, однако пока пространство имен "Справка" страниц не содержит. Вы можете добавить свои собственные страницы помощи или скопировать нужную часть с "Меты", из руководства пользователя или [[m:Help:Contents|справочника по MediaWiki]], эти два сборника могут быть свободно использованы на условиях публичной лицензии [[:en:GNU Free Documentation License|GNU Free Documentation License]]. |
|||
{{TNT|caution|This can be easily abused to attack users}} |
|||
===...некоторые из моих изображений не показываются после обновления (апгрейда?)?=== |
|||
See [[Extension:SecureHTML]] and [[Extension:HTMLets]] for ways to make this safer. |
|||
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 <tt>unknown / unknown</tt> and, in some cases, a warning about potentially dangerous files. |
|||
===How do I fix problems or add features to MediaWiki?=== |
|||
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. |
|||
The basic steps to improving MediaWiki (that is, [[How to become a MediaWiki hacker|becoming a MediaWiki developer]]) are: |
|||
===... все PNG не преобразуются в миниатюры?=== |
|||
* Install [[Special:MyLanguage/Gerrit|Git]] |
|||
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 <i>mime_content_type png</i> for information on fixing this bug at the PHP level, possibly by editing your magic.mime file. |
|||
* Download the Git "clone" of the MediaWiki source code |
|||
* Get a server, a database, and PHP running on your computer (this can be annoying, so please ask for help if something isn't working) |
|||
* Get MediaWiki running on your computer off that Git checkout (can be annoying as well, so, ditto) |
|||
* Fix the problem or add the feature you were thinking of, or if you don't have one in mind, look at one of the "[[annoying little bug]]"s |
|||
* Edit the source code of the relevant file(s) to fix the problem |
|||
* Follow [[Gerrit/Tutorial]] |
|||
=== How do I run a bot? === |
|||
'''См. [[Help:FAQ#Corrupt or Incorrect Extension|здесь]] для получения большей информации.''' |
|||
:''See [[Manual:Bots]]'' |
|||
===...поиск по коротким словам не дает результата?=== |
|||
You might want to use the [[Manual:Pywikibot|Pywikibot]] framework. |
|||
=== How do I change noindex nofollow === |
|||
Настройки по умолчанию для MySQL требуют, чтобы минимальная длина слова, проиндексированного для полнотекстового поиска, была 4 символа. Это станет проблемой, если вы хотите искать на странице более короткие слова. Чтобы изменить это, вам нужно изменить настройки MySQL, как написано [http://dev.mysql.com/doc/refman/4.1/en/fulltext-fine-tuning.html в документации MySQL]. Заметьте, что индексы дожны быть перестроены после изменения настроек по умолчанию. |
|||
Set <code>[[Manual:$wgNoFollowLinks|$wgNoFollowLinks]] = false;</code> in [[Manual:LocalSettings.php|LocalSettings.php]] |
|||
===...я не могу загрузить MediaWiki 1.8?=== |
|||
=== How do I create a small [[w:en:Wiki_farm|wiki farm]]? === |
|||
В настоящее время, MediaWiki 1.8 в стадии разработки и не включена в общий релиз. Исходный код, при желании, может быть [[Download from SVN/ru|скачан с SVN]]. |
|||
:''See: [[Manual:Wiki family]]'' |
|||
===...это не работает? В Википедии эта фича есть!=== |
|||
=== How do I add [[w:Meta element|meta tags]]? === |
|||
Сайты Википедии работают на текущей альфа-версии MediaWiki 1.8. See above for caveats and information on obtaining this. |
|||
The OutputPage class includes an addMeta methods which can be used to add meta tags. |
|||
Также, они работают с некоторыми расширениями, такими как "Makesysop" и "Renameuser" (полный список доступен на [[Special:Version|странице версий]] одного из их проектов). |
|||
The [[RequestContext]] can be used to get the relevant OutputPage object. |
|||
To add further Meta tags just add further lines as last lines of the function addMetaTags() like: |
|||
===...я получаю ошибку '''403 Forbidden''' после установки разрешений в моей ОС Fedora=== |
|||
Дистрибутив Fedora Core включает [[:en:SELinux|SELinux]] по умолчанию. Инструкции по настройке разрешений MediaWiki для SELinux [[SELinux|доступны здесь]]. |
|||
$out->addMeta ( 'description', 'This is a meta description.' ); |
|||
== Борьба со спамом == |
|||
==Why...?== |
|||
=== Где взять и как установить «чёрный список» спамеров? === |
|||
===…is the Help namespace empty?=== |
|||
Расширение [[Extension:Spam blacklist|spam blacklist]] можно найти здесь [[Download from SVN/ru|Subversion]]. За инструкциями по установке обращайтесь к файлу [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/SpamBlacklist/README?view=markup README]. |
|||
The Help namespace currently ships in a blank state. |
|||
=== Как убрать домены из черного списка спамеров? === |
|||
It's up to you how much or how little help you give to your site visitors and whether this relates to other aspects of your site. |
|||
Obviously you can easily link your visitors to help resources elsewhere. |
|||
We don't currently have a clean, internationalised set of help pages under a free license. |
|||
Вы можете внести в "белый" список домены, которые желаете, на вашей локальной <nowiki> [[Mediawiki:Spam-whitelist]]</nowiki>-странице. |
|||
However, if you want to copy in some help information onto your site, about how to use a wiki (a MediaWiki powered wiki) you are free to copy the [[Help:Contents]] from this wiki. |
|||
This set of pages have been deliberately created for this purpose, with wiki-neutral information, and no license restrictions. |
|||
See [[Project:PD help]]. More help is available at the Meta-Wiki [[m:Help:Contents|MediaWiki Handbook]]. |
|||
===…are some of my images not showing up after an upgrade?=== |
|||
Чтобы узнать формат, который вы должны использовать, возьмите за образец "белый" список англоязычной Википедии; [[wikimedia:w:en:MediaWiki:Spam-whitelist]] |
|||
Several users have reported that, following an upgrade or a moving of their wiki, several images fail to be shown inline. |
|||
=== Как использовать параметр $wgSpamRegex для блокировки нескольких адресов? === |
|||
The files exist, and the image description pages show a MIME type of <code>unknowncode>/unknown</code> and, in some cases, a warning about potentially dangerous files. |
|||
To fix this, run the <code>maintenance/rebuildImages.php</code> script from the command line. |
|||
'''$wgSpamRegex''' это мощный фильтр для содержимого страницы. Однако добавление нескольких элементов в регулярные выражения может быть неудобным. Рассмотрим этот фрагмент: |
|||
This will set MIME information for each file in the database. |
|||
===…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 <i>mime_content_type png</i> for information on fixing this bug at the PHP level, possibly by editing your magic.mime file. |
|||
See [[Manual:FAQ#"File is corrupt or has an invalid extension"|here]] for more info. |
|||
===…is a search for a short keyword giving no hits?=== |
|||
By default, MediaWiki uses MyISAM's fulltext matching functionality to allow searching page content. |
|||
The default settings for this mean that words of less than four characters won't be indexed, so will be ignored in searches with older versions of MediaWiki. |
|||
MediaWiki 1.13 and earlier are unable to work around this; you must either [http://dev.mysql.com/doc/refman/4.1/en/fulltext-fine-tuning.html change MySQL's configuration] to index shorter words, or [[download|upgrade]] to a more recent version of MediaWiki. |
|||
Note that some particular words may still not be indexed if they are in MySQL's default stopword list. |
|||
===…can't I download MediaWiki {{padright:{{#expr:{{MW stable branch number}}+.01}}|4}}?=== |
|||
MediaWiki {{padright:{{#expr:{{MW stable branch number}}+.01}}|4}} is in a development state at present, and has not been packaged into a general release. |
|||
The code can be [[download from Git|downloaded from Git]] if desired. |
|||
Or, if you want the latest development version packaged as an archive, get it at {{mwsnapshots-link}}. |
|||
===…doesn't this work? It works on Wikipedia!=== |
|||
Wikipedia and other Wikimedia web sites use the current version of the code in development; at present, this is MediaWiki {{CURRENTVERSION}}, pulled from the current development branch. |
|||
Coupled with the use of several extensions, this means that functionality between these wikis and your particular setup may differ. |
|||
*To obtain the current development code, read [[Download from Git]] |
|||
*To check what version a Wikimedia wiki is running, as well as what extensions are installed, visit the [[Special:Version]] page for that wiki |
|||
===…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 [[SELinux|are available]]. |
|||
===…do I get logged out constantly?=== |
|||
This is probably related to cookies or session data, for example a problem with PHP's session.save_path [http://php.net/manual/en/ref.session.php#ini.session.save-path] setting. See [[m:Help:Logging in#Log in problems|Log in problems]] for information. |
|||
===…doesn't my wiki work on Sourceforge? === |
|||
:''See [[Manual:Installing MediaWiki on SourceForge.net]].'' |
|||
===…is it a good idea to keep user accounts?=== |
|||
At many times you just want to remove a user account out of the wiki either because it belonged to a spammer account or you just feel like it. |
|||
The appropriate choice is to block the account or rename it if needed. |
|||
Here is why: |
|||
''Do I just remove his row from the [[User table]]?'' |
|||
[[mailarchive:wikitech-l/2007-June/031579.html|Rob Church posted the following]] regarding this issue on the mediawiki-l mailing list: |
|||
"If the user has made edits, then removing rows from the user table |
|||
cause theoretical loss of referential integrity. Now, to be honest |
|||
with you, I can't think of any conditions where this would cause an |
|||
actual problem; "undefined behaviour" is the phrase we use. |
|||
What I'd suggest doing, to be on the safe side, is running a couple of |
|||
quick updates against the database: |
|||
:<source lang="sql">UPDATE revision SET rev_user = 0 WHERE rev_user = <current_user_id></source> |
|||
:<source lang="sql">UPDATE archive SET ar_user = 0 WHERE ar_user = <current_user_id></source> |
|||
What this will do is cause MediaWiki to treat the revisions as having |
|||
been made anonymously when generating things like page histories, |
|||
which should eliminate any problems caused by these routines |
|||
attempting to check user details from other tables. |
|||
If the user has caused log entries, i.e. rows in the logging table, or |
|||
uploaded images, then the situation becomes trickier, as you'll have |
|||
to start mopping up all the rows everywhere and it could become a bit |
|||
of a mess, so if the user's done anything other than edit, I would |
|||
strongly recommend just blocking them indefinitely. |
|||
If the username is offensive or undesirable, then you could consider |
|||
renaming it using the [[Extension:Renameuser|RenameUser]] extension." |
|||
Another option is to give Admins the [[Manual:User_rights|'hideuser']] right, and indefinitely block the user with the ''Hide username from edits and lists'' option selected. |
|||
[[Extension:UserMerge]] is also useful. |
|||
==Anti-spam== |
|||
===Where do I get the spam blacklist from and how do I install it?=== |
|||
The [[m:Spam blacklist|spam blacklist]] extension can be found in [[Download from Git|Git]], just like all other officially supported extensions. |
|||
For installation and configuration instructions, consult the {{git file|project=mediawiki/extensions/SpamBlacklist|file=README|branch=HEAD|text=README}} file and [[Extension:SpamBlacklist|extension page]] over here. |
|||
===How do I use $wgSpamRegex to block more than one string?=== |
|||
'''$wgSpamRegex''' (see [[Manual:$wgSpamRegex|Manual]]) is a powerful filter for page content. |
|||
Adding multiple items to the regex, however, can be awkward. |
|||
Consider this snippet: |
|||
<source lang="php"> |
<source lang="php"> |
||
$wgSpamRegexLines[] = 'display\s*:\s*none'; |
|||
$wgSpamRegexLines[] = 'overflow\s*:\s*auto'; |
|||
[...] |
|||
$wgSpamRegex = '/(' . implode( '|', $wgSpamRegexLines ) . ')/i'; |
|||
</source> |
</source> |
||
Код в этом примере позволяет удобно добавлять элементы в регулярное выражение без того, чтобы заниматься ерундой каждый раз. Он также демонстрирует два популярных фильтра, которые блокируют некоторые распространённые спам-атаки. |
|||
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. |
|||
:''See also:'' [[Extension:SpamRegex]] |
|||
===Are there additional ways to fight spam?=== |
|||
See '''[[Manual:Combating spam]]''' for an overview of anti-spam measures such as Captcha, content filtering and restricting edition. |
|||
==Anti-vandalism== |
|||
See '''[[Manual:Combating vandalism]]''' for hints and suggestions on how to deal with wiki vandalism. |
|||
==Where now?== |
|||
===I've found a bug or have a feature request. Where do I post it?=== |
|||
Bugs and feature requests should be posted on [[Phabricator]]. |
|||
See [[Special:MyLanguage/How to report a bug|How to report a bug]]. |
|||
===I'm getting a strange error. What now?=== |
|||
*See if it is covered by ''[[Manual:Errors and Symptoms]]'' |
|||
*Try to find out more about the problem, see ''[[How to debug MediaWiki]]'' |
|||
*See the [[#Still no luck. Where can I ask for help?|section below]] for information on how to contact [[developers]] and other knowledgabe users. |
|||
=== I tried that but it didn't work === |
|||
:''I had a problem, I came to this page and it told me how to fix it. But it didn't work, the problem is still there!!!!'' |
|||
Nine times out of ten this is because you didn't [[#How do I purge a cached page?|clear your cache]]. |
|||
The simple test for this is to request a page that hasn't been requested before. |
|||
Select the part of the URL in the address bar that contains the page title (e.g. Main_Page). |
|||
Twiddle your fingers on the keyboard for a while, hit enter. |
|||
Check if the problem is on that page too. |
|||
MediaWiki uses both a server-side cache and a client-side cache, so clearing your browser cache is often not enough. |
|||
See the [[#How do I purge a cached page?|relevant entry below]] for more details. |
|||
Here are some other things to check: |
|||
* Were you editing the right file? Try inserting some garbage into the file you edited, does it break anything? |
|||
** A great debugging tool in this case is to create a file called phpinfo.php, containing only <code><?php phpinfo() ?></code>. Upload it into your web directory and invoke it with your browser. Check the document root and the path to php.ini. |
|||
* Were you editing the right part of the file? Did you create a duplicate entry in php.ini? Add new settings to the end of LocalSettings.php, not to the beginning. |
|||
* If you created a .htaccess, are you sure AllowOverrides is on? Ask your hosting provider. |
|||
===I have a question not answered here. Where do I go next?=== |
|||
===Есть ли еще дополнительные методы борьбы со спамом?=== |
|||
Смотрите '''[[Manual:Combating spam]] (англ)''' [[Инструкция:Борьба со спамом]] (русск.) для ознакомления с дополнительными методами борьбы со спамом, такими как капча, фильтрация контента и ограничение редактирования. |
|||
If you've exhausted the FAQ above, please try the following: |
|||
==Что дальше?== |
|||
*Check the [[Project:Help|other sources of help]] on this site |
|||
===Я нашел ошибку или у меня есть запрос о новых возможностях скрипта. Куда мне со всем этим?=== |
|||
*[[Special:Search|Search]] the rest of this site |
|||
*Search older documentation archived on [[m:Main Page|Meta]]; Useful developer documentation remains on Meta.wikimedia.org in the category [[m:Category:Pages to be exported to MediaWiki.org|Pages to be exported to MediaWiki.org]] until the [[m:Meta:MetaProject to transfer content to MediaWiki.org]] completes |
|||
*Search the web |
|||
*[[How to become a MediaWiki hacker|Dig into the source]] |
|||
*See the [[#Still no luck. Where can I ask for help?|section below]] for information on how to contact developers and other knowledgeable users. |
|||
===Still no luck. Where can I ask for help?=== |
|||
Сообщения об ошибках и запросы на новые возможности публикуются в рамках [[MediaZilla:|MediaZilla]], нашей реализации [[:en:Bugzilla|Bugzilla]]. Пожалуйста, предварительно воспользуйтесь поиском, чтобы избежать повторных запросов. |
|||
*Post a message at [[Project:Support desk]] |
|||
===У меня вопрос, на который здесь нет ответа. Куда мне обратиться?=== |
|||
*Email the [[mail:mediawiki-l|mediawiki-l mailing list]] (try and [http://dir.gmane.org/gmane.org.wikimedia.mediawiki search the archive] first). |
|||
*Ask the [[developers]] in our [[MediaWiki on IRC|IRC channel]]. |
|||
===Recommended reading=== |
|||
Если FAQ не помог, попробуйте следующее: |
|||
*[http://www.catb.org/~esr/faqs/smart-questions.html Asking smart questions] |
|||
*[[Project:Help|Почитать другие статьи в разделе «Помощь»]] на этом сайте |
|||
*[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html Effective bug reporting] |
|||
*[[Special:Search|Воспользоваться поиском]] по сайту |
|||
*[http://workaround.org/getting-help-on-irc Getting help on IRC] |
|||
*Поискать в нашем архиве документации на [[m:Main Page|Meta]] |
|||
*[[Books about MediaWiki]] |
|||
*Поискать информацию в сети |
|||
*Опубликовать запрос о помощи в [[Project:Support desk]] |
|||
*Написать в [[mail:mediawiki-l|лист рассылки mediawiki-l]] |
|||
*Спросить совета у разработчиков в нашем IRC канале ([[:en:Freenode|сеть Freenode]], канал '''[irc://irc.freenode.net/mediawiki #mediawiki]'''). |
|||
=== References === |
|||
=== Рекомендуется к прочтению === |
|||
<references /> |
|||
* [http://ln.com.ua/~openxs/articles/smart-questions-ru.html Как правильно задавать вопросы] |
|||
* [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html Эффективная сдача багов] |
|||
{{Languages}} |
|||
[[Category:Manual{{translation}}]] |
[[Category:Manual{{translation}}]] |
Revision as of 21:24, 27 December 2015
![](http://upload.wikimedia.org/wikipedia/commons/thumb/4/40/OOjs_UI_icon_speechBubbles-ltr.svg/45px-OOjs_UI_icon_speechBubbles-ltr.svg.png)
- mediawiki-l, почтовая рассылка MediaWiki.
- #mediawiki подключиться — IRC-канал.
- Центр помощи
Часто задаваемые вопросы (ЧЗВ) об использовании MediaWiki. Если на ваш вопрос нет ответа ни здесь, ни в технической документации MediaWiki или пользовательской документации MediaWiki, тогда задайте его на форуме помощи. | ![]() |
The basics
What are the differences between MediaWiki, Wikimedia, Wikipedia and wiki?
This is a common question; please see Differences between Wikipedia, Wikimedia, MediaWiki, and wiki for a detailed answer.
I want to use a MediaWiki instance to (blank). Am I allowed to?
MediaWiki is free software: this means that you may use it for any purpose without legal hindrance. Furthermore, its licensing conditions apply solely to the software itself. This means that although many wikis license their content under a permissive license, you are not obliged to license the content submitted to your wiki in any particular way. Of course, as a project founded to support sites like Wikipedia, we encourage you to license the texts you write under a free license, but, in short, you are not required to.
If you wish to alter or amend the software itself, in general, you are permitted to, but there are some restrictions and you should consult the full text of the GNU GPL version 2 for details.
Because MediaWiki is provided free of charge, there is no warranty, to the extent permitted by applicable law.
Installation and configuration
Where do I download MediaWiki?
Click here to download the latest stable release of MediaWiki. Files are supplied in a .tar.gz archive. MediaWiki can also be obtained directly from our Git repository.
How to install MediaWiki?
Installing MediaWiki takes around 10 to 30 minutes, and involves uploading/copying files, and running the installer script to configure the software. See the Installation Guide, where you will also find the minimum system requirements.
How do I install MediaWiki using a package?
Many Linux distributions provide MediaWiki in a packaged format for that distribution. The MediaWiki development team refers you to your Linux distribution for assistance with installing, configuring or using them. The individual communities and companies who maintain such packages should provide installation instructions.
Be warned that third-party distributions may be older versions, so pay close attention to compatibility information for directions and extensions.
- See also: Software bundles.
Can I install more than one wiki on a server using MediaWiki?
It is possible to install more than one wiki on a server provided that:
- You use a different database for each wiki
Or
- You use a different database prefix for each wiki (for Postgres, you can achieve a similar effect by using different schemas and users)
For information on these options, see $wgDBname and $wgDBprefix respectively.
For information on setting up a wiki family, see Manual:Wiki family.
For information on an alternative way of setting up more than one wiki using the same server, database and source, see Steve Rumberg's (archived version) excellent exposé and additional comments from users.
Does MediaWiki work with safe_mode enabled?
Yes, but only to a limited degree. See Safe mode for information.
Does MediaWiki require shell access?
Shell access (SSH) is not required for installing MediaWiki, but it is highly recommended. Without shell access, it may even be difficult for you to get a backup of your wiki, or to upgrade to a new version. Some maintenance tasks are not possible at all without shell access. Many major extensions work best with shell access.
How do I install extensions?
See Manual:Extensions for information about installing and writing extensions. See the Category:Extensions to find existing extensions.
How do I add extra namespaces?
See Creating a custom namespace.
How do I enable uploading?
File uploads are an often-used feature of MediaWiki, but are disabled by default in all current release versions.
To enable them, first make the upload directory (default images
) writable by the web server (chmod -R 777 ./images
or allow the Apache user to write to it, etc.) then set $wgEnableUploads to true
in LocalSettings.php (i.e. "$wgEnableUploads = true;").
If you get a "failed to mkdir" error when you try to upload, it probably means that there's a permissions problem.
- See also: Manual:Configuring file uploads
How do I enable embedded math formulas?
MediaWiki allows embedded math formulas. See Extension:Math for complete setup instructions.
How do I set the timezone for my MediaWiki?
- See: Manual:Timezone
How do I purge a cached page?
To purge a cached page, such as when making changes to the navigation bar, add &action=purge
to the end of the page's dynamic URL.
E.g. http://www.mediawiki.org/w/index.php?title=Main_Page&action=purge
Or ?action=purge
to the end of the page's short form URL:
E.g. http://www.mediawiki.org/wiki/Main_Page?action=purge
- See also: Manual:Purge, Manual:Parameters to index.php.
How do I completely disable caching?
Add in your LocalSettings.php file the following lines:
$wgEnableParserCache = false; $wgCachePages = false;
How do I allow uploading of additional formats?
MediaWiki requires that allowed file upload formats are specified using the $wgFileExtensions configuration directive. Usually this directive is situated in LocalSettings.php in the root of your MediaWiki installation.
For example, to extend uploading to PDF files, add the following to LocalSettings.php:
$wgFileExtensions[] = 'pdf';
To extend uploading to more than one type of file, use the following syntax
$wgFileExtensions = array_merge($wgFileExtensions, array( 'pdf', 'txt', 'mp3' ));
- See also: Manual:Configuring file uploads
"File is corrupt or has an invalid extension"
Some users have reported that after adding a file format to the allowed extensions list, an error is encountered. The text of the error is similar to the following:
- The file is corrupt or has an incorrect extension. Please check the file and upload again.
Possible solutions:
- Set the value of $wgMimeDetectorCommand, e.g. under Unix or Linux, this would be
$wgMimeDetectorCommand = "file --brief --mime";
- Compile/install the fileinfo PHP extension
- Fedora - yum install php-pecl-Fileinfo
- See also: Manual:Mime type detection.code>
Initial user was not created by installer or it is not an administrator
Sometimes, the installer fails to create the default user, or the user table is lost for some reason. There are a couple of options for solving this:
maintenance/createAndPromote.php
- If your MediaWiki is older than 1.16, make sure
AdminSettings.php
is set up (seeAdminSettings.sample
) - Execute
maintenance/createAndPromote.php --username <new user name> --password <password for that user>
from the shell. Append--bureaucrat
to command line if you want that user to become a bureaucrat, in addition to becoming an administrator.
This will create a new user and promote them to an administrator.
For help, run the script with the parameter --help
.
Alter the database
- Register a new account using the regular method (Special:UserLogin).
- Check the user ID in Special:Preferences.
- Execute the following SQL statement against the database:
INSERT INTO user_groups ( ug_user, ug_group ) VALUES ( <id>, 'bureaucrat' ), ( <id>, 'sysop' );
<id>
above should be replaced with the appropriate user ID which you can see on the user's preference page.- Note: if
$wgDBprefix
is defined in LocalSettings.php, prepend its value to the table name. For example, if$wgDBprefix
is "XYZ", then the table name to use isXYZuser_groups
.
Temporarily let everyone assign rights to promote your initial user
This method essentially involves letting all users temporarily modify user permissions in order to promote one user
- Register a new account using the regular method (Special:UserLogin). Be logged in using that account.
- Add the following lines to the bottom of LocalSettings.php
$wgAddGroups['user'] = true;
- Go to special:userrights and add the user you just created to the Administrator and Bureaucrat groups.
- Remove the
$wgAddGroups['user'] = true;
line from your LocalSettings.php . This step is very important, as until you remove it anyone can alter permissions, which is bad.
How do I reset a user's MediaWiki password?
How can I create interwiki links in my wiki?
- See Manual:Interwiki
How do I make my base URLs shorter?
(i.e. /wiki/Article_Name as opposed to /w/index.php?title=Article_Name)
- See Manual:Short URL
How do I organize pages into subdirectories like /wiki/subdir/PageName?
Is downloading and using all of MediaWiki.org free?
Yes, it is free in the sense of Free software. See Project:Copyrights for licensing issues regarding the written content of this site.
How do I administrate/manage user rights?
See Manual:User rights and Manual:User rights for general information. See Manual:Preventing access for methods and strategies for restricting access.
How do I stop anonymous users from editing any page?
The recommended method is by changing the value of the $wgGroupPermissions
configuration option.
Edit LocalSettings.php
and add the line:
$wgGroupPermissions['*']['edit'] = false;
If you use Extension:AbuseFilter, any admin can also disable IP editing temporarily as needed.
- See also: Preventing access, Manual:User rights.
How do I stop anonymous users from reading any page?
- Add this to the bottom of LocalSettings.php:
$wgGroupPermissions['*']['read'] = false;
See also Manual:$wgWhitelistRead. See Manual:Preventing access#Restrict viewing of all pages for more information.
How do I restrict account creation?
- Add this to the bottom of LocalSettings.php:
$wgGroupPermissions['*']['createaccount'] = false;
See Manual:Preventing access#Restrict account creation for more information.
How do I require an email address be specified at registration?
How do I put MediaWiki into Read Only mode?
Версия MediaWiki: | ≥ 1.5 |
How do I change default user preferences?
Версия MediaWiki: | ≥ 1.4 |
The MediaWiki default user preferences are in the language file, i.e. languages/Language.php
if you're using English.
Don't edit that file, just use it for reference, like you do with DefaultSettings.php.
Say if you want to change the default number of search results on a page. Language.php says:
/* private */ $wgDefaultUserOptionsEn = array(
...
'searchlimit' => 20,
...
)
To change it to 50, put this in your LocalSettings.php:
$wgDefaultUserOptions = array( 'searchlimit' => 50 );
Note that you are setting $wgDefaultUserOptions, which contains the site overrides, not $wgDefaultUserOptionsEn, which contains the software defaults. Any settings in $wgDefaultUserOptions will override those set in the language file.
To change the default namespaces to be searched, in any version of MediaWiki, set $wgNamespacesToBeSearchedDefault in LocalSettings.php to an array mapping namespace indexes to boolean values. For example, to search the main namespace and the category namespace, use:
$wgNamespacesToBeSearchedDefault = array( NS_MAIN => true, NS_CATEGORY => true, );
In some cases, after you change a default user preference, you may also want to change the user preferences of all existing user accounts.
If so, use the userOptions.php script in the Maintenance directory. Use the "--dry" option for the first run, assess the impact and go from there. (--dry does not write the database)
php userOptions.php --dry --nowarn searchlimit --old 20 --new 50
Also, always backup your database before making these kinds of changes (you do not need to do use if you are just using --dry).
- See also: Manual:$wgDefaultUserOptions
How can I make Mediawiki run faster?
How do I enable a drop-down list of search suggestions?
Upgrading
- See: Manual:Upgrading
Moving
Is it possible to move my wiki to a different machine?
Yes. It should be. In essence, you will be backing up your old installation and then "restoring" it onto the new machine. Finally, you will have to make additional modifications to update the wiki configuration so that everything points to the new location.
How do I move my wiki to a different server?
Follow the instructions at Manual:Moving a wiki.
Changing the interface
How do I change the logo?
The logo that appears in the top left of each page is determined by the $wgLogo configuration line in the LocalSettings.php file.
There are two ways to change the logo:
- Upload a picture to your wiki using the normal file uploading interface. This allows the logo to be replaced easily, so you may want to protect the page if you use this method.
- Then add the $wgLogo line to LocalSettings.php, for example:
$wgLogo = "{$wgUploadPath}/6/62/mylogo.png";
- Upload an image to your server by other means (such as FTP).
- Add the $wgLogo line to LocalSettings.php, for example:
$wgLogo = "{$wgScriptPath}/mylogo.jpg";
- (In this example, the image is in the same folder as the LocalSettings.php file.)
If you want to change the logo in only specific pages, override #p-logo css's background-image property or use third party extension like Extension:LogoFunctions.
![]() | Do not simply overwrite the default logo installed with MediaWiki (/skins/common/images/wiki.png ); this file will be overwritten when you upgrade. |
How do I edit the wiki's CSS?
You shouldn't edit the CSS files (such as main.css) directly, because it will make upgrading harder if you need to apply your customizations each time you upgrade the software. Instead you need to edit a wiki page called MediaWiki:Common.css if you want to apply your CSS changes for all skins, or a wiki page called MediaWiki:Monobook.css if you want to apply the customizations only for Monobook skin.
The content of MediaWiki:Common.css and MediaWiki:Monobook.css pages always override the default CSS styles specified in main.css.
How do I hide the left vertical navigation toolbar
In other words, how do you make the main content div take up 100% of the display, hiding the logo, toolbox, navigation and search engine?
To hide it permanently, copy and paste the following into the MediaWiki:Common.css page:
#column-content { margin: 0 0 .6em 0; }
#content { margin: 2.8em 0 0 0; }
#p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search { display:none; }
#p-cactions { left: .1em; }
To instead hide the toolbar when the user presses F11, enter this in your wiki's MediaWiki:Common.js:
document.onkeydown = function( e ) {
if( e == null ) e = event
if( testKey( e, 122 ) ) { //F11
appendCSS('#column-content {margin: 0 0 .6em 0;} #content {margin: 2.8em 0 0 0;} #p-logo, .generated-sidebar, #p-lang, #p-tb, #p-search {display:none;} #p-cactions {left: .1em;} #footer {display:none;}');
return false;
}
}
function testKey( e, intKeyCode ) {
if( window.createPopup )
return e.keyCode == intKeyCode
else
return e.which == intKeyCode
}
How do I hide the categories at the bottom of each page?
You can hide display of the categories on each page by modifying your MediaWiki:Common.css and adding:
.catlinks { display: none; }
Can I customize the logo in the top left corner? If so, how?
The logo is a portlet block without a pBody section. It is identified by the p-logo id. The background image is specified by the $wgLogo variable, which is defined in DefaultSettings.php. This location is relative to the web server root and not the system root. Redefine this in LocalSettings.php to change the image. If set wrong there will be no image on the page; check your web server error log and adjust accordingly. However the size of the p-logo will need to be big enough for the logo if it is not to be clipped. This is set in the stylesheet (main.css in Monobook), under the p-logo style, the default setting is:
#p-logo {
z-index: 3;
position: absolute; /*needed to use z-index */
top: 0;
left: 0;
height: 155px;
width: 12em;
overflow: visible;
}
Note, if you are using a different sized logo, and want to change the CSS, please do not modify any of the core MediaWiki stylesheets. Instead add to the on-wiki css page (MediaWiki:Monobook.css for monobook, MediaWiki:Vector.css for vector. MediaWiki:Common.css will also work for all skins)
How do I customize the link-URL of the site-logo in the top left corner of all pages that activates when the site-logo is clicked upon?
By default, clicking the site-logo takes you to the main site-page. If you want to change which internal site-page is the "main" site-page, edit MediaWiki:Mainpage.
To make the link of the site-logo link externally to any other arbitrary URL, you can add a hook to your LocalSettings.php to override the mainpage href which is used by the logo.
/* Change the main page url used in things like the logo to an absolute url */
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfChangeMainPageURL';
function lfChangeMainPageURL( $sk, &$tpl ) {
$tpl->data['nav_urls']['mainpage']['href'] = "http://www.your-desired-url.com/"; // Point the main page url to an absolute url
return true;
}
/* Change the main page url used in things like the logo to a url of another page on the wiki */
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfChangeMainPageURL';
function lfChangeMainPageURL( $sk, &$tpl ) {
$tpl->data['nav_urls']['mainpage']['href'] = Title::newFromText('ThePage')->getLocalURL(); // Point the main page url to a wiki page's url
return true;
}
Reducing the size of the logo
Note that a tag is on top of the logo so if you are trying to reduce the size of the logo's portlet you will also need to change the #p-logo a and #p-logo a:hover rules. The default setting for these is:
#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;
}
How do I change the icon in the browser's address line (favicon)?
- Simply upload your favicon.ico to the root of your domain/subdomain, make sure file name is in lower case and its name is favicon.ico
- Alternatively edit the $wgFavicon setting in LocalSettings.php and add
$wgFavicon = "$wgScriptPath/path/to/your/favicon.ico";
See Manual:$wgFavicon for more details.
Tip: The favicon image should be either 16 x 16 pixels or 32 x 32 pixels.
Rewrite Rule
If you are using a rewrite rule in .htaccess to remove "index.php" from the URL, you will also need to add an exception for .ico files. Simply add the following rule to your .htaccess:
- RewriteRule .*\.ico$ - [L]
This rule must appear before the index.php rule.
Case sensitivity
When uploading the favicon file, be sure the filename is in lowercase. (That is, "favicon.ico", not "Favicon.ico".) A lot of servers (e.g., those on UNIX-like operating systems) will not be able to find the file unless its name is in lowercase.
How do I customize the navigation bar?
The contents of the navigation bar which appears to the left of each page using the Monobook skin are determined by the MediaWiki:Sidebar page there on your wiki. For information on customising these, please see Manual:Interface/Sidebar.
How do I put a text message (sitenotice) on every page?
Put a text in the MediaWiki:Sitenotice page. It will be displayed on top of every article page.
You can also add text to MediaWiki:Anonnotice to create a message that only displays for logged-out users. It is often a good idea to transclude the site notice on the anon notice to make sure that logged-out users still get the information on the site notice,
How do I change which page is the main page?
By default, MediaWiki looks for a page with the title Main Page and serves this as the default page. This can be changed by altering the contents of MediaWiki:Mainpage to point to a different title. If this does not change the 'Main Page' link included on the sidebar at install time, edit MediaWiki:Sidebar.
How do I change the Main Page title?
Simply click on the "Move" tab, and move the page to the desired page title.
Usually you also want to change which page is the configured as "main page".
How do I hide the main page title?
MediaWiki does not have a built-in option to hide the main page title (see задача T8129), but you can use CSS to hide the title. Alternately, you can use the NoTitle extension.
Add the following to MediaWiki:Common.css on your wiki:
body.mainpage.action-view h1.firstHeading, body.mainpage.action-submit h1.firstHeading { display: none; }
If this doesn't work, you may be using a skin that doesn't support this, or you moved your main page without updating MediaWiki:Mainpage, or you have a really old MediaWiki version.
If the skin uses a different element for the title than a h1
element with class firstHeading
, you'll need to find the appropriate CSS selector to apply for that skin.
How can I hide the table of contents?
The table of contents (TOC) is automatically shown once there are four or more headings in the article. There are multiple ways to hide it.
- For one page
- Place the magic word
__NOTOC__
in the page's wikitext.
- For all pages
- Install Extension:NoTOC
- or
- Add the following rule to MediaWiki:Common.css:
.toc, #toc { display: none; }
- Per user
- Users can add the same CSS rule to their common.css personal stylesheet.
Версия MediaWiki: | ≤ 1.22 Gerrit change 99430 |
- There was a user preference to hide the table of contents, it was removed in MediaWiki 1.23 (phab:T54813).
How do I change the interface text?
Interface text is altered using the MediaWiki namespace. For each deviation from the default in the site language there is a page MediaWiki:Englishmessagename, and for each deviation from the default in each other language a page MediaWiki:Englishmessagename/languagecode. (Since release 1.9 there are no pages for messages equal to the default.). On creation of a page the edit box autofills with the default. When creating a page to override the default it is useful to first save the default version, to allow diffs with it. See also Manual:System message.
- For a list of system messages, see Special:Allmessages
- To switch off the MediaWiki namespace, see the $wgUseDatabaseMessages configuration setting
- To remove the Privacy policy or Disclaimers links at the bottom of each page, set the content of pages MediaWiki:Privacy or MediaWiki:Disclaimers respectively to a single hyphen (
-
).
How do I change the interface language?
To change the default interface language, alter the value of $wgLanguageCode
in LocalSettings.php
, for example
$wgLanguageCode = "fr";
You may also need to bypass your browser's cache to see the changes.
The new default interface language will be applied to all users who haven't ever customised it.
If you want to provide users the possibility to create and choose pages and interface elements in languages other than the default one of the wiki, you need the Translate extension, which can make your wiki multilingual.
If you want to change the language settings for all existing users, use the userOptions.php maintenance script. For instance, to have all users with English set use French instead, run
php userOptions.php language --old en --new fr
How do I remove the article/edit etc tabs?
For a little more control see: User:Subfader/Hide_page_tabs
Edit MediaWiki:Common.css on your wiki, and add this:
li#ca-edit { display: none; }
See the page source for the various #ca-* ids used in the content tabs.
Note: this will only work for Monobook and derived skins such as Modern and Vector (the default skin), and doesn't actually stop people from editing. To do that, see Manual:User rights.
How do I add/remove tabs throughout my wiki?
Use Extension:DynamicTabs on older MediaWiki installations or write your own extension (See: Manual:Hooks/SkinTemplateNavigation):
For example, to remove the talk tab and then add a tab that always goes to the main page you would save this code in extensions/AR-Tabs.php
:
Версия MediaWiki: | ≤ 1.15 |
<?php
if( !defined( 'MEDIAWIKI' ) ){
die( "This is not a valid access point.\n" );
}
$wgHooks['SkinTemplateContentActions'][] = 'replaceTabs';
function replaceTabs( $content_actions ) {
unset( $content_actions['talk'] ); // only this to remove an action
$maintitle = Title::newFromText( wfMsgForContent( 'mainpage' ) );
$main_action['main'] = array(
'class' => false or 'selected', // if the tab should be highlighted
'text' => wfMsg( 'sitetitle' ), // what the tab says
'href' => $maintitle->getFullURL(), // where it links to
);
$content_actions = array_merge( $main_action, $content_actions ); // add a new action
return true;
}
Версия MediaWiki: | ≥ 1.16 |
<?php
if( !defined( 'MEDIAWIKI' ) ){
die( "This is not a valid access point.\n" );
}
$wgHooks['SkinTemplateNavigation'][] = 'replaceTabs';
function replaceTabs( $skin, &$links) {
unset( $links['namespaces']['talk'] ); // Remove the talk action
$maintitle = Title::newFromText( wfMsgForContent( 'mainpage' ) );
$links['namespaces']['main'] = array(
'class' => false or 'selected', // if the tab should be highlighted
'text' => wfMsg( 'sitetitle' ), // what the tab says
'href' => $maintitle->getFullURL(), // where it links to
'context' => 'main',
);
return true;
}
and then add
require_once("extensions/AR-Tabs.php");
to the bottom of LocalSettings.php
How do I remove a tab on only one page?
Версия MediaWiki: | ≥ 1.9 |
For example, to remove the Discussion (talk) page tab from the Main Page, on the MediaWiki:Common.css page add:
body.page-Main_Page li#ca-talk { display: none !important; }
To modify MediaWiki:Common.css you must have administrative privileges.
- See also: Manual:Hide page tabs
How do I remove a tab on all pages
Версия MediaWiki: | ≥ 1.9 |
For example, to remove the Discussion (talk) page tab on all wikipages, on the MediaWiki:Common.css page add:
#ca-talk { display:none!important; }
Other tabs to remove are #ca-history, #ca-viewsource, #ca-view (Read tab), #ca-nstab-main (Page tab), #ca-viewsource.
Other drop down menu items you can remove are #ca-watch, #ca-move, #ca-delete.
To modify MediaWiki:Common.css you must have administrative privileges.
How do I hide the section edit links for users who are not logged in?
You can change the value of the $wgDefaultUserOptions
configuration option.
Edit LocalSettings.php and add the line:
$wgDefaultUserOptions ['editsection'] = false;
How do I remove the "Talk for this IP" link at the top right when $wgDisableAnonTalk is true?
Set $wgShowIPinHeader to false.
How do I remove the "Create an Account or Login" link at the top right of the screen?
To remove the login / create account links from the personal_urls you can use this code in your LocalSettings.php to hook in and remove them:
$wgHooks['PersonalUrls'][] = 'lfRemoveLoginLink';
function lfRemoveLoginLink( &$personal_urls, $title ) {
unset( $personal_urls['login'] );
unset( $personal_urls['anonlogin'] );
unset( $personal_urls['createaccount'] );
return true;
}
How can I suppress actions and special pages?
- NOTE: MediaWiki is not designed for this kind of usage! It should be noted that the following 'answer' is a hack that only 'works' with the Apache webserver. Note also that this system is not foolproof, it's just one step further than hiding the links (see above).
Suppressing actions and special pages can be useful when you want to create the illusion of a static website via a particular URL or VirtualHost, but also have an 'internal' view that is a true wiki. i.e. if you have an inward facing 'view' of your wiki that users can edit, and an outward facing 'view' that should appear like a static website (no history, no discussion, etc., etc.).
After hiding all the appropriate links (see above), if you are using the Apache web server, you can disable actions and special pages using the following rewrite rules:
# Lock down the site (disable MediaWiki commands) RewriteEngine On #RewriteLog /tmp/rewrite.log #RewriteLogLevel 9 ## See http://www.mediawiki.org/wiki/Manual:Parameters_to_index.php#Actions RewriteCond %{QUERY_STRING} (.*action=.*) RewriteRule .* http://www.my.domain.com? RewriteCond %{REQUEST_URI} !^/index.php/Special:Search RewriteCond %{REQUEST_URI} ^(.*Special:.*) RewriteRule .* http://www.my.domain.com? ## Catch a trick... RewriteCond %{QUERY_STRING} ^(.*Special:.*) RewriteRule .* http://www.my.domain.com?
Above, a request for 'http://www.my.domain.com/wiki/Page_name?action=edit'
, for example, will be simply rewritten to 'http://www.my.domain.com'
. Similarly any page in the Special namespace (with the exception of Special:Search) will be rewritten to 'http://www.my.domain.com'
. Remember, this is only a hack, and isn't intended as a solution for a secure CMS.
Note that you will need to adjust the above rules to match your specific URL naming schema.
Other issues to consider when trying to lock down a site like this is the API and POST requests for the wiki content (rather than GET).
How do I edit error messages?
Special:Allmessages contains a complete list of messages (error or otherwise), that can be edited.
How do I change the footer?
How can I edit / remove the Powered by MediaWiki image in the footer?
You can hide the Powered by MediaWiki image by adding the following to your wiki's MediaWiki:Common.css:
#f-poweredbyico { display: none; }
The Vector skin equivalent is:
#footer-icon-poweredby { display: none; }
In MW 1.17 with Vector Skin:
#footer-icon-poweredbyico { display: none; }
In MW 1.18 with Vector Skin:
#footer-poweredbyico { display: none; }
If you want to remove it completely in 1.17 you can use $wgFooterIcons
to remove it using this in your LocalSettings.php:
unset( $wgFooterIcons['poweredby'] );
In 1.16 and below you will have to use a hook to remove it:
$wgHooks['SkinTemplateOutputPageBeforeExec'][] = 'lfRemovePoweredBy';
function lfRemovePoweredBy( $sk, &$tpl ) {
unset( $this->data['poweredbyico'] );
return true;
}
If you wish to change the icon images, urls, alt text, or add new icons please see $wgFooterIcons
' documentation.
How do I add a reply link to default signature tildes (~~~~) template?
You can customize at: MediaWiki:Signature / MediaWiki:Signature-anon
For example, changing the entries to [[{{ns:user}}:$1|$2]] ([[{{ns:user_talk}}:$1|talk]])
will put a link to users' talk pages and [[{{ns:user}}:$1|$2]] ([{{fullurl:{{ns:user_talk}}:$1|action=edit§ion=new}} Reply])
would give a more direct link.
Users can change it their preferences.
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, etc., go to Special:AllMessages, where you will see the text associated with the pages you wish to change. You need to log in as an administrator 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 change your settings.
Does MediaWiki automatically capitalize the first letter of $wgSitename?
Yes. This can be changed using the $wgCapitalLinks configuration setting.
How do I make external links open in a new window?
How can I suppress MediaWiki from formatting URLs, tags, etc?
Put "<nowiki>" tags around the URL or tag.
Example:
svn co <nowiki>http://svn.example.com/myproject/</nowiki>
Produces:
svn co http://svn.example.com/myproject/
How can I force users to preview before they save?
How do I add more buttons on the edit page?
How can I get more special characters or tags clickable on the edit page?
For adding more selectable special characters, etc., below the edit field, see Extension:CharInsert.
How can I use Wikipedia's default skin (Vector) on my wiki?
Версия MediaWiki: | ≥ 1.16 |
Vector was introduced in MediaWiki version 1.16, and was made the default skin in 1.17. See Manual:$wgDefaultSkin for more information on configuring your default skin.
Additional features of the Vector skin are made available using the Vector extensions, which you must download and install separately.
How do I disable external links from showing in the printable version of a page?
Edit the page MediaWiki:Print.css on your wiki and add the following code there:
#content a.external.text:after,
#content a.external.autonumber:after {
content: none;
}
This will override the styles defined in skins/common/commonPrint.css in MediaWiki source code. For more information, see Manual:CSS.
If instead you want to have the external links underlined in the printable version, then also add the following code:
#content a.external {
text-decoration: underline !important;
}
How do I change the text of the article (page name) tab of my wiki's main page?
To change the text of the tab, as one example used in Wikipedia, you first open the page "MediaWiki:Mainpage-nstab
".
After you've done that, click Edit and type in the edit box the text you want to be seen later on the main page - that's it. Don't forget to save the page as well.
Basic usage
How do I edit a page?
To edit a page, simply click the edit link that appears on each page. Using the default Vector skin, this is in the form of a tab at the top of the page. A form will appear, containing the existing markup. When you have finished making modifications, click the Save button to commit your changes.
- See also: Help:Editing pages
How do I create a new page?
There are several ways to create a new page:
- Create a link to the page on another page, then click on the red link which appears
- Browse to the intended location of the page, e.g.
http://www.example.com/index.php?title=New_page
and click on the "Edit", "Create" or "Create source" link.
On some wikis, a failed search for a page will contain a link which allows you to edit that page.
- See also: Help:Starting a new page
How do I delete an old version of a page?
Old versions of page data are retained in the database and can be accessed via the page history features. This is useful for reviewing changes and correcting or reverting undesirable ones, but in some cases, administrators might want to make this information unavailable, for legal reasons, or to reduce the size of the database.
- Administrators can delete an old revision of a page by deleting the page, and then selectively undeleting revisions to be kept
- The Oversight extension (also known as HideRevision) can be used to move harmful revisions out of page histories on older versions of MediaWiki (<1.16).
- For newer MediaWikis (1.14+), you can enable the core RevisionDelete feature that allows privileged users to remove single revisions from page histories.
- The
maintenance/deleteOldRevisions.php
maintenance script can mass-delete all old revisions of pages and their associated text records.
- See also: Manual:Removing embarrassment
How do I use oversight/delete revisions in the page history?
- See: RevisionDelete
You can also delete a page, and then restore only the revisions you want.
Are there any editing tutorials available?
There are several editing tutorials available, mostly on Wikimedia sister projects, such as Wikipedia. There are also markup references, etc. available on Meta.
- The page Help:Editing pages on this site
- Editing help content on Meta
- The How to edit a page guide on the English Wikipedia
How do I view the printable form of a page?
MediaWiki includes stylesheets which automatically style a page appropriately when it is printed; using the print or print preview function within your browser ought to render the page in a printable form.
You can also view this printable form using the printable version link in the sidebar under Toolbox or Print/export if using the Collection extension.
How do I use templates?
- See Help:Templates
Can I use media (images, video, audio, etc.) from Wikimedia Commons in my installed version of MediaWiki?
Yes, this is encouraged through the use of Manual:$wgUseInstantCommons.
- See also: InstantCommons
How do I use a template as a signature?
When you look at your preferences, you see a check box for "raw signature." But the field will only take a certain number of characters. What if you want more?
You will need to create two pages, possibly in your userspace.
- Create the first page (FIRST PAGE)
- Go to your preferences, check "raw signature" and put {{FIRST PAGE}} in the signature. Save
- Create a second page (SECOND PAGE) (possibly a sub-page of the first)
- Go back to the first page (FIRST PAGE) and do {{SECOND PAGE}}
- Go to the second page (SECOND PAGE) and place the code you wish to have for your signature.
If you don't have this structure, you will still be inserting all your signature code into the raw code wherever your signature is used, because the software will insert "SUBST" in your preferences. You may not mind this, in which case you only need one page. If you want the raw code to only display {{FIRST PAGE}}, which looks a lot cleaner, then you need to use the two-page structure.
How do I add the sandbox functionality to my installation of the wiki?
In wiki terms, a sandbox is simply a "play pen"; a page which users can mess about in. This is an ordinary page created in the normal manner, and can be located wherever you like. There is no special sandbox functionality built into MediaWiki.
Users often inquire about the Wikipedia sandboxes, which seem to be self-emptying. This is not quite correct; there are a number of volunteers who run bots to clean these up and return them to a certain state at regular time intervals.
How do I add a "Sandbox" link to personal tools (top right)?
You need to add the Gadget extension and add the Sandbox gadget. You will probably also want to make it a default gadget.
How do I make my wiki serve all languages?
To make your wiki multilingual and a tool for translation, allowing translation of pages and of the custom interface (like the sidebar), use the Translate extension; there's extensive documentation.
Wiki Importing
Importing from MediaWiki XML dumps
Importing from other types of wiki software
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<mysqluser> -p<yourpass> <db name> < ImportStage3.txt
Note: If your importUseModWiki.php
outputs an XML file instead of SQL statements, this probably means you have a rather new version of MediaWiki.
In such a case, you can 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
There are a variety of tools available to help convert content from HTML (and other formats) to MediaWiki markup.
- Developer and SysAdmin tools
- HTML::WikiConverter::MediaWiki - a Perl module for converting from HTML to MediaWiki markup.
- Wikificator - a Javascript MediaWiki extension that converts XHTML to MediaWiki markup.
- The Edit.php, importImages.php and ImportTextFile.php maintenance scripts can be used to import text and images into MediaWiki.
- End-user tools
- HTML to Wiki Converter - an online HTML to MediaWiki markup conversion service. (Based on HTML::WikiConverter::MediaWiki)
- wikEd - a text editor for MediaWiki that can import HTML (including Microsoft Word-generated HTML.)
- Instructions
- Brief notes on converting from Microsoft .chm help files to MediaWiki
- Notes on converting from Microsoft Office formats 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 '{{<Res Param|Root Category> Restricted}}' (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
For the rest of details, check out wiki_import.
Templates imported from other wikis (such as Wikipedia) don't work for me
You probably need to install some extensions used on the source wiki, such as ParserFunctions or sometimes Cite. Also, make sure that you copied all site CSS and JavaScript required by the template.
Customising further
I want to have multiple wikis, but only require registration once
- If you're starting from scratch or you're switching from one wiki to multiple, you can use $wgSharedDB and $wgSharedTables to have all wikis share the user table of the "main" wiki. You can share other tables as well, as long as they don't contain any data dependent on non-shared tables or data specific to one wiki. See Manual:Shared database for examples and more information.
- If your wikis are already established and you want to switch to a single sign-on, you can use the CentralAuth extension. It has a few more features than a shared user table, but it's more difficult to configure and it's tailored toward a Wikimedia-style setup. However, it is easier than attempting to completely merge multiple user tables into one.
How can I allow use of HTML tags?
See Manual:$wgRawHtml as well as Manual:$wgGroupPermissions and Manual:Preventing access.
![]() | This can be easily abused to attack users |
See Extension:SecureHTML and Extension:HTMLets for ways to make this safer.
How do I fix problems or add features to MediaWiki?
The basic steps to improving MediaWiki (that is, becoming a MediaWiki developer) are:
- Install Git
- Download the Git "clone" of the MediaWiki source code
- Get a server, a database, and PHP running on your computer (this can be annoying, so please ask for help if something isn't working)
- Get MediaWiki running on your computer off that Git checkout (can be annoying as well, so, ditto)
- Fix the problem or add the feature you were thinking of, or if you don't have one in mind, look at one of the "annoying little bug"s
- Edit the source code of the relevant file(s) to fix the problem
- Follow Gerrit/Tutorial
How do I run a bot?
- See Manual:Bots
You might want to use the Pywikibot framework.
How do I change noindex nofollow
Set $wgNoFollowLinks = false;
in LocalSettings.php
How do I create a small wiki farm?
- See: Manual:Wiki family
How do I add meta tags?
The OutputPage class includes an addMeta methods which can be used to add meta tags. The RequestContext can be used to get the relevant OutputPage object.
To add further Meta tags just add further lines as last lines of the function addMetaTags() like:
$out->addMeta ( 'description', 'This is a meta description.' );
Why...?
…is the Help namespace empty?
The Help namespace currently ships in a blank state. It's up to you how much or how little help you give to your site visitors and whether this relates to other aspects of your site. Obviously you can easily link your visitors to help resources elsewhere.
We don't currently have a clean, internationalised set of help pages under a free license. However, if you want to copy in some help information onto your site, about how to use a wiki (a MediaWiki powered wiki) you are free to copy the Help:Contents from this wiki. This set of pages have been deliberately created for this purpose, with wiki-neutral information, and no license restrictions. See Project:PD help. More help is available at the Meta-Wiki MediaWiki Handbook.
…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 unknowncode>/unknown
and, in some cases, a warning about potentially dangerous files.
To fix this, run the maintenance/rebuildImages.php
script from the command line.
This will set MIME information for each file in the database.
…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?
By default, MediaWiki uses MyISAM's fulltext matching functionality to allow searching page content. The default settings for this mean that words of less than four characters won't be indexed, so will be ignored in searches with older versions of MediaWiki.
MediaWiki 1.13 and earlier are unable to work around this; you must either change MySQL's configuration to index shorter words, or upgrade to a more recent version of MediaWiki.
Note that some particular words may still not be indexed if they are in MySQL's default stopword list.
…can't I download MediaWiki 1.43?
MediaWiki 1.43 is in a development state at present, and has not been packaged into a general release. The code can be downloaded from Git if desired. Or, if you want the latest development version packaged as an archive, get it at Template:Mwsnapshots-link.
…doesn't this work? It works on Wikipedia!
Wikipedia and other Wikimedia web sites use the current version of the code in development; at present, this is MediaWiki 1.43.0-wmf.19 (a8c8877), pulled from the current development branch. Coupled with the use of several extensions, this means that functionality between these wikis and your particular setup may differ.
- To obtain the current development code, read Download from Git
- To check what version a Wikimedia wiki is running, as well as what extensions are installed, visit the Special:Version page for that wiki
…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.
…do I get logged out constantly?
This is probably related to cookies or session data, for example a problem with PHP's session.save_path [1] setting. See Log in problems for information.
…doesn't my wiki work on Sourceforge?
…is it a good idea to keep user accounts?
At many times you just want to remove a user account out of the wiki either because it belonged to a spammer account or you just feel like it. The appropriate choice is to block the account or rename it if needed. Here is why:
Do I just remove his row from the User table?
Rob Church posted the following regarding this issue on the mediawiki-l mailing list:
"If the user has made edits, then removing rows from the user table cause theoretical loss of referential integrity. Now, to be honest with you, I can't think of any conditions where this would cause an actual problem; "undefined behaviour" is the phrase we use.
What I'd suggest doing, to be on the safe side, is running a couple of quick updates against the database:
UPDATE revision SET rev_user = 0 WHERE rev_user = <current_user_id>
UPDATE archive SET ar_user = 0 WHERE ar_user = <current_user_id>
What this will do is cause MediaWiki to treat the revisions as having been made anonymously when generating things like page histories, which should eliminate any problems caused by these routines attempting to check user details from other tables.
If the user has caused log entries, i.e. rows in the logging table, or uploaded images, then the situation becomes trickier, as you'll have to start mopping up all the rows everywhere and it could become a bit of a mess, so if the user's done anything other than edit, I would strongly recommend just blocking them indefinitely.
If the username is offensive or undesirable, then you could consider renaming it using the RenameUser extension."
Another option is to give Admins the 'hideuser' right, and indefinitely block the user with the Hide username from edits and lists option selected.
Extension:UserMerge is also useful.
Anti-spam
Where do I get the spam blacklist from and how do I install it?
The spam blacklist extension can be found in Git, just like all other officially supported extensions. For installation and configuration instructions, consult the README file and extension page over here.
How do I use $wgSpamRegex to block more than one string?
$wgSpamRegex (see Manual) 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.
- See also: Extension:SpamRegex
Are there additional ways to fight spam?
See Manual:Combating spam for an overview of anti-spam measures such as Captcha, content filtering and restricting edition.
Anti-vandalism
See Manual:Combating vandalism for hints and suggestions on how to deal with wiki vandalism.
Where now?
I've found a bug or have a feature request. Where do I post it?
Bugs and feature requests should be posted on Phabricator. See How to report a bug.
I'm getting a strange error. What now?
- See if it is covered by Manual:Errors and Symptoms
- Try to find out more about the problem, see How to debug MediaWiki
- See the section below for information on how to contact developers and other knowledgabe users.
I tried that but it didn't work
- I had a problem, I came to this page and it told me how to fix it. But it didn't work, the problem is still there!!!!
Nine times out of ten this is because you didn't clear your cache. The simple test for this is to request a page that hasn't been requested before. Select the part of the URL in the address bar that contains the page title (e.g. Main_Page). Twiddle your fingers on the keyboard for a while, hit enter. Check if the problem is on that page too.
MediaWiki uses both a server-side cache and a client-side cache, so clearing your browser cache is often not enough. See the relevant entry below for more details.
Here are some other things to check:
- Were you editing the right file? Try inserting some garbage into the file you edited, does it break anything?
- A great debugging tool in this case is to create a file called phpinfo.php, containing only
<?php phpinfo() ?>
. Upload it into your web directory and invoke it with your browser. Check the document root and the path to php.ini.
- A great debugging tool in this case is to create a file called phpinfo.php, containing only
- Were you editing the right part of the file? Did you create a duplicate entry in php.ini? Add new settings to the end of LocalSettings.php, not to the beginning.
- If you created a .htaccess, are you sure AllowOverrides is on? Ask your hosting provider.
I have a question not answered here. Where do I go next?
If you've exhausted the FAQ above, please try the following:
- Check the other sources of help on this site
- Search the rest of this site
- Search older documentation archived on Meta; Useful developer documentation remains on Meta.wikimedia.org in the category Pages to be exported to MediaWiki.org until the m:Meta:MetaProject to transfer content to MediaWiki.org completes
- Search the web
- Dig into the source
- See the section below for information on how to contact developers and other knowledgeable users.
Still no luck. Where can I ask for help?
- Post a message at Project:Support desk
- Email the mediawiki-l mailing list (try and search the archive first).
- Ask the developers in our IRC channel.
Recommended reading
References
[[Category:ManualTemplate:Translation]] [[Category:ConfigureTemplate:Translation]]