Difference between revisions of "MarkupBabel/ru"

From Wiki4Intranet
Jump to: navigation, search
(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>, где xxx - язык. Языки:
+
Все теги вида <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
  
На самом деле, данный способ вставки кода является несколько устаревшим и всё его удобство заключается исключительно в том, что блок кода заворачивается в блок вида &lt;pre&gt;: <pre>/* в такой вот блок */</pre>
+
На самом деле, данный способ вставки кода является несколько устаревшим и всё его удобство заключается исключительно в том, что блок кода заворачивается <pre>в такой вот блок вида &lt;pre&gt;</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 отрисовывает UML-диаграммы по описаниям на Java-подобном языке. Не все считают такой способ описания удобным, поэтому ещё существует расширение [[PlantUML]].
  
 
Тег &lt;umlgraph&gt;.
 
Тег &lt;umlgraph&gt;.
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.

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