MarkupBabel/ru

From Wiki4Intranet
< MarkupBabel
Revision as of 17:21, 29 January 2014 by VitaliyFilippov (Talk | contribs) (Гантт-подобные диаграммы)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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

  • Назначение: {{{description ru}}}
  • Репозиторий: {{{repo}}}
  • Домашняя страница: [{{{url mw}}} MarkupBabel на mediawiki.org]
  • Лицензия: {{{license}}}
  • Состояние доработок: Без изменений


«Вавилон разметок» — включает поддержку 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
На самом деле, данный способ вставки кода является несколько устаревшим и всё его удобство заключается исключительно в том, что блок кода заворачивается
в такой вот блок вида <pre>

Gnuplot

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

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

Гант-подобные диаграммы

Есть поддержка простых диаграмм типа Ганта. Синтаксис:

<gantt [width=ширина height=высота]>
ресурс дата_начала число_дней название задачи
...
</gantt>

Ресурс — без пробелов, дата_начала — в формате YYYY-MM-DD. Примеры:

UMLGraph

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

Тег <umlgraph>.

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

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

UMLet

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

Установка

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

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