Difference between revisions of "MarkupBabel/ru"
(Split extension page to semantic data and russian description) |
(→Гантт-подобные диаграммы) |
||
(8 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{ExtensionFromInfo|lang=ru|name=MarkupBabel}} | {{ExtensionFromInfo|lang=ru|name=MarkupBabel}} | ||
+ | |||
+ | «Вавилон разметок» — включает поддержку [[LaTeX]]-формул, [[Graphviz]]-графов, [[Gnuplot]]-графиков и процентных диаграмм, UML-схем через UMLGraph. Не требует дополнительного скрипта texvc, в отличие от [[mediawikiwiki:Extension:Math|Math]]. Порождает векторные изображения для LaTeX-вставок. | ||
+ | |||
== Использование == | == Использование == | ||
Line 30: | Line 33: | ||
Требует установленного и подключённого [http://qbnz.com/highlighter/ geshi] (GEneric Syntax HIghlighter). В сборке MediaWiki4Intranet он включён вместе со стандартным расширением <tt>SyntaxHighlight_GeSHi</tt>. | Требует установленного и подключённого [http://qbnz.com/highlighter/ geshi] (GEneric Syntax HIghlighter). В сборке MediaWiki4Intranet он включён вместе со стандартным расширением <tt>SyntaxHighlight_GeSHi</tt>. | ||
− | Все теги вида <tt>code-xxx</tt>, где | + | Все теги вида <tt>code-xxx</tt>, где 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 | * 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> | + | На самом деле, данный способ вставки кода является несколько устаревшим и всё его удобство заключается исключительно в том, что блок кода заворачивается <pre>в такой вот блок вида <pre></pre> |
=== [[Gnuplot]] === | === [[Gnuplot]] === | ||
Line 40: | Line 43: | ||
Минимальную справку по самому Gnuplot можно прочитать здесь: [[Gnuplot]]. | Минимальную справку по самому Gnuplot можно прочитать здесь: [[Gnuplot]]. | ||
+ | |||
+ | === Гант-подобные диаграммы === | ||
+ | |||
+ | Есть поддержка простых диаграмм типа Ганта. Синтаксис: | ||
+ | |||
+ | <pre> | ||
+ | <gantt [width=ширина height=высота]> | ||
+ | ресурс дата_начала число_дней название задачи | ||
+ | ... | ||
+ | </gantt> | ||
+ | </pre> | ||
+ | |||
+ | Ресурс — без пробелов, дата_начала — в формате YYYY-MM-DD. Примеры: | ||
+ | |||
+ | <gantt width="800" height="200"> | ||
+ | Разработка 2014-01-28 2 Баг 1 | ||
+ | Тестирование 2014-01-29 6 Баг 1 | ||
+ | Разработка 2014-02-03 4 Баг 2 | ||
+ | Тестирование 2014-02-06 2 Баг 3 | ||
+ | </gantt> | ||
+ | |||
+ | <gantt width="800" height="200"> | ||
+ | 3.6.3 2014-01-28 14 Разработка | ||
+ | 3.6.3 2014-02-11 7 Тестирование | ||
+ | 3.6.3 2014-02-18 20 Верификация | ||
+ | 3.6.4 2014-02-11 10 Разработка | ||
+ | 3.6.4 2014-02-21 5 Тестирование | ||
+ | 3.6.4 2014-02-26 14 Верификация | ||
+ | </gantt> | ||
=== [http://www.umlgraph.org/ UMLGraph] === | === [http://www.umlgraph.org/ UMLGraph] === | ||
− | + | UMLGraph отрисовывает UML-диаграммы по описаниям на Java-подобном языке. Не все считают такой способ описания удобным, поэтому ещё существует расширение [[PlantUML]]. | |
Тег <umlgraph>. | Тег <umlgraph>. | ||
Line 49: | Line 81: | ||
Для работы требуется Java и, собственно, [http://www.umlgraph.org/ UMLGraph]. | Для работы требуется Java и, собственно, [http://www.umlgraph.org/ UMLGraph]. | ||
− | Подробную справку по использованию можно почитать в статье [[UML]]. | + | Подробную справку по использованию можно почитать в статье [[Help:UML#UMLGraph]]. |
=== [http://www.umlet.com/ UMLet] === | === [http://www.umlet.com/ UMLet] === | ||
Line 57: | Line 89: | ||
== Установка == | == Установка == | ||
− | + | Процедура установки — стандартная, через LocalSettings.php: | |
+ | |||
+ | <code-php> | ||
+ | require_once "$IP/extensions/MarkupBabel/MarkupBabel.php"; | ||
+ | </code-php> |
Latest revision as of 17:21, 29 January 2014
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-вставок.
Contents
Использование
Расширение добавляет следующие теги парсера:
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";