Difference between revisions of "MarkupBabel/ru"

Revision as of 18:57, 24 April 2013

MarkupBabel — расширение MediaWiki.

• Назначение: «Вавилон разметок» — поддержка LaTeX, Graphviz, Gnuplot, UMLGraph и UMLet.
• Репозиторий: https://github.com/mediawiki4intranet/MarkupBabel
• Домашняя страница: http://wiki.4intra.net/MarkupBabel
• Лицензия: GPLv2.0+ 
• Дата создания: 2006-06-29 
• Оценка расширения: Очень полезное (5)

Включение в сборку Mediawiki4Intranet:

• Дата включения: 2008-10-14
• Включённая версия: последняя
• Состояние доработок: Создано в рамках MediaWiki4Intranet

«Вавилон разметок» — включает поддержку LaTeX-формул, Graphviz-графов, Gnuplot-графиков и процентных диаграмм, UML-схем через UMLGraph. Не требует дополнительного скрипта texvc, в отличие от Math. Порождает векторные изображения для LaTeX-вставок.

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

Расширение добавляет следующие теги парсера:

LaTeX

• <m>Код</m>
• <math>Код</math>
• <amsmath>Код</amsmath>

Код — только содержимое документа. В заголовок автоматически подключаются пакеты babel [english, russian], amssymb, amsmath, amscd, color.

При наличии dvisvgm формулы отрисовываются в виде векторных SVG-изображений.

Соответственно, для нормальной работы требуется установленный дистрибутив LaTeX (например texlive), пакеты и dvisvgm. Дополнительной утилиты texvc, которая используется в Википедии — не нужно.

Graphviz

Теги:

graph, neato, circo, fdp, twopi

Аналогично соответствующим раскладкам Graphviz. graph — это обычная раскладка dot.

graph-print, neato-print, circo-print, fdp-print, twopi-print

Включает граф только в растровом виде и только в печатную версию документа.

Код внутри тега — полный код графа, вместе с digraph G { ... }.

Для работы требует, как ни странно, установленный Graphviz.

GeSHi-подсветка синтаксиса

Требует установленного и подключённого geshi (GEneric Syntax HIghlighter). В сборке MediaWiki4Intranet он включён вместе со стандартным расширением SyntaxHighlight_GeSHi.

Все теги вида code-xxx, где xxx - язык. Языки:

• actionscript, ada, apache, asm, asp, bash, c, c_mac, caddcl, cadlisp, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php, php-brief, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml

/* в такой вот блок */

Gnuplot

Для вставки графиков с помощью Gnuplot используйте тег <plot>…</plot>

Минимальную справку по самому Gnuplot можно прочитать здесь: Gnuplot.

UMLGraph

UMLGraph отрисовывает UML-диаграммы по описаниям на Java-подобном языке. Не все считают такой способ описания удобным, поэтому ещё существует расширение PlantUML.

Тег <umlgraph>.

Для работы требуется Java и, собственно, UMLGraph.

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

UMLet

Ещё один способ отрисовки UML-диаграмм. Тег <umlet>. Для работы требуется Java и UMLet.

Установка

Процедура установки — стандартная, через LocalSettings.php:

require_once "$IP/extensions/MarkupBabel/MarkupBabel.php";