Меню Рубрики

Установка math для mediawiki


Release status: stable Implementation Tag Description Allows to render mathematical formulas Author(s)

  • Moritz Schubotz,
  • Tomasz Wegrzanowski,
  • Brion Vibber
  • and others
Latest version continuous updates MediaWiki 1.25+ Database changes Yes Tables math
matho >
mathlatexml License GNU General Public License 2.0 or later Download
  • $wgUseTeX
  • $wgTexvc
  • $wgTexvcBackgroundColor
  • $wgMathCheckFiles
  • $wgMathPath
  • $wgMathDirectory
  • $wgMathFileBackend

The Math extension provides support for rendering mathematical formulae. An overview of what can currently be done with this extension is found at the English Wikipedia’s documentation.

More information about installing and configuring this extension, including for older versions, can be found at Extension:Math/advancedSettings .


Viewing math

The Math extension tries to deliver MathML output, with fallback to images in SVG (converting characters to

s) or PNG (least preferentially). Depending on the capabilities of the device you are using, the sort of output is chosen. Basic math support works for all browsers. However, for optimal rendering specific tuning may be needed:

  • For Firefox or other Gecko browsers, it is required to install the Native MathML extension and math fonts. Accessibility support is provided by NVDA, VoiceOver or Orca. Additionally, NVDA requires the MathPlayer plugin to read mathematics.
  • For Safari or other WebKit browsers, you may also install math fonts and enable native MathML rendering by inserting some CSS rules into the custom style sheet of your browser preference.

Accessibility support is provided by the VoiceOver screen reader but not by Orca yet.

  • For Chrome you must insert some CSS rules into the custom style sheet of your browser preference in order to get accessibility support via ChromeVox or visual rendering via the MathJax plugin.
  • In some versions of Internet Explorer, it is possible to use MathPlayer as an assistive technology.


  • If using Vagrant , install with vagrant roles enable math —provision

Manual installation

  • Download and place the file(s) in a directory called Math in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:

    You should additionally go to the page Special:MathStatus to see whether all of the components of the Math extension now work. For any problems you see, the best option is to create a task on https://phabricator.wikimedia.org

    Unfortunately, there is no well tested gu > and RESTBase to work with the Math extension, but there is at least a working draft. Extension:Math/Restbase please contribute.

    Math output modes

    The setting $wgMathValidModes holds an array with the names of output modes that can be used for rendering. If multiple modes are enabled, logged-in users can set a personal preference in the appearance pane of their user preferences page.

    You can also use the $wgDefaultUserOptions setting to set which of these modes should be the default, e.g.:


    Mode: ‘mathml’ (pre-July 2015: MW_MATH_MATHML)

    For MW 1.23 and higher, you can use a Mathoid server that uses MathJax to convert texvc input on the server side to MathML+SVG rendering. This is the most recommended option; Mathoid is the rendering mode that will be used on Wikipedia in the future.

    Mathoid as a service

    To use Mathoid as a service, resulting in performance benefits, the following settings are recommended:

    Mathoid’s CLI interface

    To use Mathoid’s CLI interface, which is possibly easier to set up and resulting in less permanent memory consumption, while degrading performance, the following settings are recommended:

    If you run MediaWiki under system containing SELinux and you get Mathoid cli ‘/path/to/mathoid/cli.js’ is not executable message from the error log, you can run

    to make sure the Apache server allow to change system limits.


    Mode: ‘png’ (pre-July 2015: MW_MATH_PNG)

    Since MediaWiki 1.32, this mode will also require a Mathoid server to work. In older versions, it requires installing texvc and texvccheck, which may require the most setup work.


    Mode: ‘latexml’ (pre-July 2015: MW_MATH_LATEXML)

    Uses the LaTeXML utility. The rendering is done via an online service (set with $wgLaTeXMLUrl, which has a default value).

    No rendering

    Mode: ‘source’, (pre-July 2015: MW_MATH_SOURCE)

    This mode will forward the Latex input without rendering, presenting it in a element, surrounded by $ :formula $.

    Make sure to set $wgMathDisableTexFilter to ‘always’ (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.


    Warning: The client-s > for an alternative.

    List of significant configuration settings

    Setting name Default value Description
    $wgMathVal > array( ‘png’, ‘source’, ‘mathml’ ) Defines the mode allowed on the server.
    $wgMathDisableTexFilter ‘never’ Option to disable the tex filter. If set to true any LaTeX expression is parsed this can be a potential security risk. If set to false only a subset of the TeX commands is allowed. See the wikipedia page Help:Math for details. Use «always» to disable this feature.
    $wgMathFullRestbaseURL false The math extension gets the default config from the Visual Editor, if available. Details.

    Tips and tricks

    • You can use the Firefox MathML copy addon to copy formulae to other applications such as Microsoft Word (video), or Google docs with the g(Math) plugin (video)
    • You can override the user preferred and default rendermode by adding the forcemathmode attirbute to the element. eg.. to force an image being rendered . .

    Error reporting

    If something is wrong with the math extension you can report that at Phabricator. In addition you should check how your problem relates to the automated unit tests that are generated from the page CoverageTest.

    Further reading

    See Extension:Math/advancedSettings for old versions and further information.


    Сайт ARNY.RU

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

    Выбор платформы

    Тут ничего сложного — виртуальная машина Ubuntu 16.04.1, почему VM говорил уже много раз: виртуалку удобно таскать туда-сюда между серверами, она не привязана к железу, один раз настроив VM получаем шаблон для множественного использования. Почему Ubuntu — на мой субъективный взгляд, сегодня это самый стремительно развивающийся проект. Для серьёзного многопользовательского продакшена не подойдёт, но когда для себя что-то запилить и ещё для пары админов — очень комфортно делать на Ubuntu.

    Гипервизор — мой любимый Hyper-V, встроенный сегодня во все современные версии настольных и серверных ОС от MS. И это очень упрощает работу с VMs.

    К своему вящему позору до сих пор не знал, что начиная с версии 14.04 Ubuntu поддерживает VM 2 поколения. Много всяких интересных штук добавили.

    Подготовка машины 2 поколения

    Процесс установки ничем не отличается, за исключением того, что в конце инсталлятор спрашивает точно ли мы хотим загружаться как UEFI.

    Логинимся рутом, киляем пользователя, заведенного при установке:

    Разрешаем вход рута по SSH:

    Проверяем/изменяем настройки сети:

    Переходим на putty, накатываем обновления:

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

    Выбор дистрибутива Wiki
    • Полностью бесплатное ПО;
    • Это должна быть именно чистая вики, а не вики плюс форум или вики плюс трекер-заявок;
    • Внешний вид, простота установки.

    Поискав в интернете, понял, что выбора-то и нет, только MediaWiki.

    Установка Wiki
    Apache, PHP 7.0

    Будет предложено ввести пароль root для mysql, поскольку у меня внутренняя вики, без доступа из интернет, помятуя прошлые проколы, ввожу короткий пароль.

    Установка MediaWiki

    Следует помнить, что команда вводится в одну строчку, wget (как и некоторые команды выше) не поместилась здесь, лучше сначала скопировать её в блокнот и проверить этот момент.

    Настройка MediaWiki
    Настройка PHP

    Чтобы не прокручивать длинный конфиг, удобно пользоваться поиском vi: сначала нажать /, затем набрать upload_max_filesize и Enter.

    Конфигурирование MediaWiki

    Если ничего не грузится, нужно попробовать открыть дефолтную страницу apache:

    Страница открылась — разбираемся с mediawiki, нет — разбираемся с apache.

    Итак, конфигурационная страница загрузилась, предлагаю не наступать на те же грабли, что и я и сразу выбрать язык для MediaWiki — en. На мой взгляд названия страниц в строке адреса на русском — нелепо и неудобно, но если вы не считаете это минусом — оставляйте русский.

    Предупреждения и их устранение

    Затем производится проверка и будут выданы предупреждения:

    • GD для PHP.Не удалось найти встроенную библиотеку GD или ImageMagick.Возможность использования миниатюр изображений будет отключена.

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

    • PECL для PHP.Внимание!: расширение intl из PECL недоступно для нормализации Юникода, будет использоваться медленная реализация на чистом PHP.

    Будет использовано расширение «intl» для PECL для нормализации Юникода.

    • Кеширование.Внимание: Не найдены APCu, XCache или WinCache.

    Для PHP 7.0 нет таких механизмов кеширования, мне они и не нужны, поскольку это личная, закрытая вики, максимум на 2-3 человека.

    Но можно установить специально созданный для PHP 7.0 opcache:

    И настроить — раскомментировать строки в конфигурационном файле, поменять значения:

    Предупреждаю, сами эти настройки не выверены, работа opcache мне не понравилась и закомментировал всё обратно.

    В результате получилось следующее:

    Устанавливаем, предлагаю чётко выбрать ваш тип Вики — открытая/закрытая, это важный момент. После установки будет сгенерирован файл LocalSettings.php, который нужно закинуть в /var/lib/mediawiki, пользуемся программой WinSCP:

    Ссылка для входа в wiki будет предоставлена при генерации. Надо сказать, что большая часть глобальных настроек Вики идет именно через файл LocalSettings.php.

    Смена картинки

    Для стандартной шкуры Vector картинку-лого можно поменять закинув свою с названием mediawiki.png и размером 135×135 в папку /var/lib/mediawiki/resources/assets.

    Смена шкуры

    Встроенные шкуры мне не понравились, есть очень красивые, но платные — отпадает, есть альтернативные — мне они показались неинтересными. Остановился на Apex:

    Самое то для Вики небольших размеров, какая-то легкость присутствует. Установка там простая и подробно расписана, в LocalSettings.php:

    Полезно сделать Apex шкурой по умолчанию для новых пользователей:

    Картинка-лого для шкуры Apex лежит /var/lib/mediawiki/skins/apex/images/logos.

    Настройка подвала

    Убрать «Отказ от ответственности»: перейти по адресу http://vm_ip/mediawiki/index.php/MediaWiki:Disclaimers,
    отредактировать страницу, заменив текст на — (знак минуса).
    Убрать «Условия конфиденциальности»: ../MediaWiki:Privacy, тоже самое.


    Генерируем, кладем в корень, добавляем в LocalSettings.php:

    Остальные настройки MediaWiki

    Это некоторая особенность, настройки Вики производятся не из меню Администратора, а со специальной страницы:

    Группы пользователей и права

    Можно посмотреть на странице:

    Меня интересуют только Анонимные (они же Все) и Пользователи. Первые обозначаются *, поскольку у меня закрытая Вики, то доступ предоставляется только авторизованным — user. Чтобы отнять или предоставить дополнительные права у группы user, нужно в файле LocalSettings.php создать специальную секцию, пример моей:

    Более тонко права настраиваются в LocalSettings.php через расширение Lockdown:

    Права задаются для группы, эта группа и всё группы с более высокими правами будут иметь доступ, все остальные группы — нет:

    Sysop — группа Администраторов. При такой настройке Пользователи не будут иметь право открыть страницу редактирования и страницу с историей изменения для данной страницы.


    Есть очень хороший FAQ для MediaWiki. В частности там описано как поступить, если не создался пользователь с правами Администратора, так получилось у меня:

    • Добавить последней строчкой LocalSettings.php:
    • Перейти на страницу:
    • Выбрать своего пользователя и добавить ему прав.
    Перенос в продакшен

    Экспортируем VM средствами Hyper-V на диск и тащим его по месту назначения. Импортируем, меняем IP-адрес. Тут важно поменять его в трех местах:

    1. В файле /etc/network/interfaces;
    2. В файле /etc/hosts;
    3. В файле LocalSettings.php.
    Дополнение от 27.04.2017

    В описании на сайте MediaWiki говорится, что с PHP 7.1 пока совместимо не до конца.

    Однако у меня после обновления до PHP 7.1 MediaWiki вообще перестала работать. Apache при этом свою дефолтную страницу открывает, а вот MediaWiki index.php грузит как html, там код страницы и закомментированное предупреждение, смысл которого — у вас не настроено php.

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

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


    Manual:Руководство по установке

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


    Руководство по обновлению

    Если вы уже используете MediaWiki, смотрите руководство по обновлению.

    Ручная установка

    Краткое описание

    Внимание: MediaWiki несовместим с версиями PHP от 7.4.0 до 7.4.2 включительно из-за ошибки в самих этих версиях PHP. Обратитесь к phab:T246594 для более подробной информации.

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

    1. Убедитесь, что ваша система удовлетворяет минимальным требованиям. (Для подробностей обратитесь к статье Требования для установки. Не забудьте также проверить требования, указанные в примечаниях к выпуску (файле RELEASE-NOTES), поставляемых вместе с MediaWiki.) Вам потребуется:
      • MediaWiki (текущая стабильная версия — 1.34.1)
      • Веб-сервер, например Apache или IIS
      • Локальный доступ или доступ с помощью командной строки, необходимый для запуска скриптов обслуживания
      • PHP версии 7.2.9 или выше
        • с расширением Perl Compatible Regular Expressions
        • со стандартной библиотекой PHP
        • с поддержкой JSON
      • Сервер базы данных, один из следующих:
        • MySQL 5.5.8+
        • MariaDB
        • PostgreSQL 9.2+
        • SQLite 3.8+

      Для поддержки создания миниатюр изображений и TeX требуются дополнительные программы. У Parsoid (требуется для VisualEditor) и других служб есть свои требования.

    2. Скачайте MediaWiki(прямая ссылка на последнюю версию) и распакуйте архив на своём компьютере в каталог, к которому имеется веб-доступ.
    3. Перейдите с помощью браузера в директорию, куда была распакована MediaWiki и следуйте указаниям установщика. Путь будет иметь вид http://domain/directory/mw-config/index.php . Замените directory путём, куда вы распаковали папку с MediaWiki. Если установка производится на локальном сервере, замените domain на localhost . Если установка производится на локальном сервере, и позже нужно будет получить доступ к вашей вики с домена domain , вам потребуется заменить в LocalSettings.php localhost на domain. Если установка происходит на удалённом сервере, замените domain на домен вашего сервера (например: www.myserver.com).
    4. Следуйте указаниям установщика, чтобы завершить процесс.

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

    Основное руководство по установке

    • Прежде чем устанавливать MediaWiki, прочитайте следующие статьи:
      • Что такое MediaWiki
      • Список возможностей MediaWiki
      • Требования для установки(Важно: проверьте их выполнение, прежде чем продолжать!)
    • Установка MediaWiki
    • Настройка MediaWiki:
      • Первоначальная настройка (используя скрипт конфигурирования)
      • Подробная настройка
      • Установка расширений

    Альтернативы ручной установке

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

    Вы можете избежать ручной установки, использовав подготовленную программную систему с MediaWiki или услуги хостинга с установкой в один клик, т. н. «вики-фермы».

    Если вы устанавливаете MediaWiki только для разработки или тестирования, можете использовать mediawiki-vagrant — набор скриптов настройки Vagrant для автоматического создания и обновления виртуальной машины с работающей MediaWiki и выбранным вами набором расширений и сервисов.

    Официальные docker-изображения публикуются на Docker Hub.

    Вы также можете использовать ресурсы сообщества на основе таких платформ, как Docker. Эти ресурсы управляются Jenkins и будут некоторое время поддерживаться в актуальном состоянии.

    Это ресурсы сообщества, и к ним всегда следует относиться с некоторой осторожностью. Используйте на свой риск.

    Внимание: Предоставляемые веб-хостерами программы для автоматической установки приложений, таких как MediaWiki, могут (и нередко так и получается) выполнить процесс установки неправильно, что приводит к ошибкам и неудачной установке. Если у вас возникнет такая проблема, это не значит, что установить MediaWiki у вас не получится; всё, что это значит, это то, что вам следует произвести ручную установку, следуя приведённому здесь алгоритму. У ручной установки есть преимущества, например: больший контроль над тем, в какой каталог на сервере будет проведена установка; возможность задействовать совместно используемую базу данных; или возможность настроить бо́льшую часть функциональности вики в процессе установки.

    Семейство вики-сайтов

    Семейство вики-сайтов (wiki family) — это совокупность из двух и более вики, установленных на один компьютер.

    Установка нескольких экземпляров MediaWiki

    Одним из подходов к организации семейства вики является установка нескольких экземпляров MediaWiki (например с использованием комплекта программ, как пример, Bitnami MediaWiki Stack) в разных каталогах — один каталог на вики. Например, возможен случай, что вы хотите организовать одновременно деловую вики и личную вики, и вы хотите сделать их полностью раздельными.

    Несколько вики с одним экземпляром MediaWiki

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

    1. Вы можете использовать для каждой вики свою базу данных. Смотрите $wgDBname .
    2. Вы можете использовать для каждой вики свой префикс базы данных. Смотрите $wgDBprefix .

    Установка существующей вики

    Некоторым пользователям нужно установить MediaWiki с содержимым Википедии, Викисловаря или какой-либо другой вики. Такая установка позволяет читать вики без соединения с Интернетом, может использоваться для проведения экспериментов, или для создания зеркал или форков.

    Основной (но не обязательно самый простой) способ создания такой вики — установить MediaWiki и произвести импорт страниц. Смотрите Руководство:FAQ#Импортирование вики.

    (Вероятно, решения, сторонние для MediaWiki, будут лучшими вариантами. Такие решения, например Xowa или Kiwix, могут быть найдены на странице w:Wikipedia:Database download.)


    Расширенное использование

    На следующих страницах приводится информация об установке и настройке MediaWiki в специфических условиях.

    Расширенная настройка

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

    Помощь в установке

    Установка на конкретные ОС

    На следующих страницах приведены более подробные инструкции по установке, предназначенные для конкретных систем. Однако, по большому счету страница Установка MediaWiki является более актуальной, и лучше написана, чем документация для конкретных ОС, и рекомендуется сначала проконсультироваться на странице Основные инструкции по установке перед просмотром системных установочных документов.


Читайте также:  Установка snap для blackberry z30

Добавить комментарий