Просмотр кода страницы Шаблон:Relation diagram usage

Создание диаграммы отношений классов реализуется набором шаблонов:

# {{tl|relation_diagram|diagram{{=}}&lt;имя диаграммы&gt;|graph{{=}}&lt;имя графа&gt;|type{{=}}&lt;опциональный тип изображения графа&gt;|border{{=}}&lt;опциональный тип границы изображения графа&gt;|format{{=}}&lt;опциональный формат файла изображения&gt;|size{{=}}&lt;опциональный размер изображения графа на странице&gt;|location{{=}}&lt;опциональная позиция изображения на странице&gt;|alignment{{=}}&lt;опциональное выравнивание изображения на странице&gt;|link{{=}}&lt;опциональная альтернативная ссылка на файл изображения&gt;|alt{{=}}&lt;опциональный текст, замещающий граф в случае неуспешности загрузки изображения&gt;|content{{=}}&lt;описание классов и отношений&gt;}} - объявление диаграммы отношений с именами диаграммы отношений (diagram) и графа (graph), а также обязательным наполнением, задаваемым нижеследующими шаблонами. '''Имя графа нигде не отображается и используется при генерации имени файла изображения. Файл будет уникален только если имя графа задано латинскими символами, цифрами и знаком "_".'''
# {{tl|relation_diagram addref|class{{=}}&lt;имя класса&gt;|ref{{=}}&lt;ссылка в [[mw:Help:Links|синтаксисе вики]]&gt;}} - опциональная ассоциация узла графа (т.е. класса диаграммы отношений) с внутренним или внешним ресурсом с помощью механизма [http://www.w3schools.com/tags/tag_map.asp HTML map].
# {{tl|relation_diagram add|&lt;тип отношения&gt;|&lt;имя класса, инициирующего отношение&gt;|&lt;имя класса, принимающего отношение&gt;|headlabel{{=}}&lt;Опциональная подпись у узла, принимающего отношение&gt;|taillabel{{=}}&lt;Опциональная одпись у узла задающего отношение&gt;|label{{=}}&lt;Опциональная подпись отношения&gt;}} - добавление двух классов и отношения между ними. Если класс с указанным именем уже существует на диаграмме, то новый узел не создается; тип отношения задается одним из ключевых слов:
## <tt>implementation</tt> - реализация интерфейса;
## <tt>inheritance</tt> - наследование;
## <tt>aggregation</tt> - агрегирование;
## <tt>composition</tt> - композиция;
## <tt>association</tt> - ассоциация.

Диаграмма, описанная в данном синтаксисе интерпретируется в синтаксис [http://www.graphviz.org/Documentation/dotguide.pdf dot], который подается через расширение [[mw:Extension:GraphViz|GraphViz]] на вход интерпретатора [http://www.graphviz.org/ GraphViz]. Загружаемый на вики файл имеет имя, заданное именем статьи. Поэтому при использовании шаблона {{tl|relation_diagram}} внутри другого шаблона может возникать [[mw:Extension_talk:GraphViz#Polynomial_explosion_when_used_in_templates|проблема, связанная с большим количеством одинаковых диаграмм]].

Использование дополнительных атрибутов и связанные с этим ограничения (например, на размеры) изображения графа <tt>type</tt>, <tt>border</tt>, <tt>size</tt>, <tt>format</tt>, <tt>location</tt>, <tt>alignment</tt>, <tt>link</tt> и <tt>alt</tt>: [[Wikipedia:Wikipedia:Extended_image_syntax]].

Поддерживаемые параметры атрибута <tt>format</tt>: png, gif, jpg, jpeg, svg.

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

<pre>
{{relation_diagram|diagram=Опциональное имя диаграммы|graph=OptionalGraphName|type=frame|content=
{{relation_diagram addref|class=Interface1|ref=[[ImplementationClass interwiki reference]]}}
{{relation_diagram addref|class=DerivedClass|ref=https://www.google.com}}
{{relation_diagram add|implementation|ImplementationClass|Interface1}}
{{relation_diagram add|implementation|ImplementationClass|Interface2}}
{{relation_diagram add|inheritance|DerivedClass|BaseClass}}
{{relation_diagram add|aggregation|Aggregate|Aggregatee|headlabel=*|taillabel=1|label=<<связь>>}}
{{relation_diagram add|composition|Composition|Element|headlabel=1|taillabel=1}}
{{relation_diagram add|association|Association1|Association2}}
}}
</pre>

<includeonly>По описанной выше причине, результат см. в [[Шаблон:Relation diagram usage|отдельном описании]].</includeonly>
<noinclude>
Результат:

{{relation_diagram|diagram=Опциональное имя диаграммы|graph=OptionalGraphName|type=frame|content=
{{relation_diagram addref|class=Interface1|ref=[[ImplementationClass interwiki reference]]}}
{{relation_diagram addref|class=DerivedClass|ref=https://www.google.com}}
{{relation_diagram add|implementation|ImplementationClass|Interface1}}
{{relation_diagram add|implementation|ImplementationClass|Interface2}}
{{relation_diagram add|inheritance|DerivedClass|BaseClass}}
{{relation_diagram add|aggregation|Aggregate|Aggregatee|headlabel=*|taillabel=1|label=<<связь>>}}
{{relation_diagram add|composition|Composition|Element|headlabel=1|taillabel=1}}
{{relation_diagram add|association|Association1|Association2}}
}}
</noinclude>