Инструменты пользователя

Инструменты сайта


wiki:plugin:diagram

Это старая версия документа!


Diagram для «ДокуВики»

Построение схем и генеалогических деревьев, состоящих из блоков и линий соединения. Плагин расширяет синтаксис «Докувики» и позволяет строить диаграммы.

Диаграммы должны использоваться внутри специального тега. Это потому, что их синтаксис похож на синтаксис таблицы. Чтобы вставить диаграмму в код, вы должны написать следующее:

<diagram> 
Спецификация диаграммы 
</diagram>

Совместимость

  • 2009-05-28 «Манеры Фрустерика»
    • Не работает: auth_aclquickcheck не может обрабатывать начальные двоеточия в идентификаторах, поэтому я чувствую, что это все еще не работает в «ДокуВики», но, по крайней мере, плагин может правильно учитывать ACL .

Монтаж

Используйте менеджер плагинов для установки или…

  1. скачать zip-файл
  2. распаковать его в<dokuwiki>/lib/plugins/
  3. войдите как администратор и измените плагин в менеджере конфигурации

Применение

Спецификация диаграммы представляет собой многострочное выражение. Каждая строка состоит из управляющих символов, определяющих связи между блоками, и последовательностей букв, определяющих блоки. Эти сущности разделяются специальным символом `|'. Например, следующая спецификация

<diagram>
| AAA |-| BBB |
| |:| | | | | |
| |L|~|~| CCC |
</diagram>

определяет эту диаграмму:

AAA BBB
CCC

Вы можете написать любой текст вместо последовательности букв для описания блока, за исключением случая использования специальных символов.

root 1-st branch
2-nd branch

К сожалению, этот метод ломает текстовое представление диаграммы (для больших диаграмм это приводит к сложности изменения вики-кода), а также не позволяет использовать вики-синтаксис внутри блока. Чтобы преодолеть это, вы должны рассматривать последовательности букв, цифр и подчеркивания как аббревиатуры и расшифровывать их в конце строки, используя знак равенства и `|' символ в качестве разделителя. Например:

<диаграмма>

ААА - BBB AAA=root
:
Л~~ CCC

</diagram> корень 1 -е отделение (см. Отделение ) 2 -я ветвь (очень важная ветвь) С помощью таких диаграмм можно описать генеалогическое древо.

<диаграмма>

Папа у Мама Папа=Папа
,---+---.
Сис я Братан Sys=Систер

</diagram> Папочка мама Систер Мне Брат Все типы соединений показаны в следующей таблице:

, . ` ' ^ в ( ) - ! +

Ф 7 л Дж А В С Д ~ : %

у час } { п б ] [ * #

Мы будем называть эти элементы тайлами соединения.

Стиль элементов диаграммы Вы можете изменить цвет границы и цвет фона блока. Это делается путем указания параметров блока в описании аббревиатуры непосредственно перед знаком равенства и в фигурных скобках. Параметры должны быть отформатированы как ключ:значение и разделены точкой с запятой. В текущей версии плагина поддерживаются два ключа: border-colorдля цвета рамки и background-colorдля цвета фона. Значения цвета должны быть указаны в формате CSS2 , включая ключевые слова цвета SVG .

<диаграмма>

ААА Ф~~~7
! ССС DDD CCC{border-color:#a9c}=Граница #a9c,
фон прозрачный
ВВВ

</diagram> Рамка синяя, фон светло-зеленый Граница #a9c, фон прозрачный Рамка серебряная, фон серебряный Граница зеленая, фон #abcdef Также можно настроить выравнивание текста и внутренний отступ с помощью text-alignи paddingсвойств:

<диаграмма>

Слева
!
`--Центр
!
`--Right

</diagram> Текст выровнен по левому краю По умолчанию текст выравнивается по центру Выровнять текст по правому краю и настроить отступы Здесь можно заметить, что разрешено пропускать пустые секции в конце строки, как в последнем примере. Но следует помнить о некоторых сложностях при дальнейшем редактировании схемы и влиянии на ширину блока. Кроме того, вы можете изменить расстояние между блоками, добавив больше столбцов и строк (это работает из-за минимальной высоты и ширины каждого пустого блока). Сравнивать

<диаграмма>

ААА - ВВВ
: ДДД
Л~~ ССС

</диаграмма> ААА ВВВ ДДД ССС с

<диаграмма>

ААА --- ВВВ
:
: ДДД
:
Л~~~~ ССС

</диаграмма> ААА ВВВ ДДД ССС Стрелки Вы можете использовать стрелки на диаграммах. Например,

<диаграмма>

ААА -@2 ВВВ -@а ЭЭЭ
:@1 !@4 }@72-- ГГГ
ДДД ~@8 ССС ФФФ

</диаграмма> ААА ВВВ ЭЭЭ ГГГ ДДД ССС ФФФ Для вставки стрелки необходимо после управляющего символа поставить «@» и один или два символа настройки направления. Первый символ устанавливает стрелки, направленные из центра соединительной плитки. Это шестнадцатеричное число, имеющее по 4 бита для каждого из 4 направлений: вверх, вправо, вниз, влево. Каждый бит устанавливает наличие стрелки в соответствующем направлении. Если вы не знакомы с шестнадцатеричным представлением, используйте следующий алгоритм. Рассчитайте сумму чисел направления, используя эту таблицу:

Вверх Верно Вниз Левый 1 2 4 8 Если вы получили число, которое больше девяти, то замените его на букву согласно таблице:

10 11 12 13 14 15 а б с д е ф Второй символ не нужен, если вам нужно, чтобы все стрелки смотрели наружу. В противном случае укажите те, которые должны смотреть внутрь, используя ту же схему направления для второго символа.

Пример: генеалогическое древо Кеннеди. Основной синтаксис для диаграмм был заимствован из Википедии. Сравните генеалогическое древо Кеннеди с генеалогическим древом ниже.

<диаграмма>

ЯК у МАК JAK=Джеймс Кеннеди
(ок. 1770 - ок. 1840)
!
ПАК у БМК PAK=Патрик Кеннеди
(ок. 1823–1858)
,---v---+---v---.
МЛК JLK ДЖОК ММК ПДК у МАХ MLK=Мэри Л. Кеннеди
(1851–1926)
JLK=Джоанна Л. Кеннеди
(1852–1926)
JOK=Джон Кеннеди
(1854–1855)
MMK=Маргарет М. Кеннеди
( 1855–1929)
PJK=Патрик Джозеф Кеннеди
(1858–1929)
!
JPK y РФК JPK=Джозеф П. Кеннеди-старший
(1888–1969)
,---v---v---v---+---v---v ---v---.
JPK Кеннеди 7 РК КАК 7 ЭМК Ф ПАК Ф РФК Ф ЯК Ф ЕДК JPK=Джозеф Патрик Кеннеди-младший
(1915–1944)
JFK=Джон Фицджеральд Кеннеди
(1917–1963)
ROK=KAK=[[wp>Кэтлин Кавендиш, маркиза Хартингтон
(1920 - 1948)
EMK=Юнис Кеннеди Шрайвер
(р. 1921)
PAK=Патриция Кеннеди Лоуфорд
(1924–2006)
RFK=Роберт Фрэнсис Кеннеди
(1925–1968)
JAK=Джин Кеннеди Смит\ \ (р. 1928)
: : : : Ф~Дж : :
JLB yJ ВЕК ~J : : :F~~~~J : JLB=Жаклин Ли Бувье
(1929–1994)
,---v--v---. : : :: JBK yJ
КОВЧЕГ ЦБК JKJ ПБК : : :: ,---v--. ARK=Арабелла Кеннеди
(1956 - 1956)
CBK=Кэролайн Кеннеди
(р. 1957)
JKJ=Джон Ф. Кеннеди-младший
(1960 - 1999)
: : :: КАК ЭМК ПЖК KAK=Кара Энн Кеннеди
(1960 г.р.)
EMK=Эдвард Кеннеди-младший
(1961 г.р.)
SAS у~~~~~~~~~J : ::
,---v---v--v---. Ф~~J :L~~~~y СЭС
RSS МОС ТПС МКС АПС : Ф~~J ! RSS=Роберт Сарджент Шрайвер III
(р. 1954)
MOS=Мария Шрайвер
(р. 1955)
TPS=Тимоти Перри Шрайвер
(р. 1959)
MKS=Марк Кеннеди Шрайвер
(р. 1964)
: : ,---v--v---.
PEL у~~~~~~~J : СЭЖ ВКС АМС КМС PEL=Питер Лоуфорд
(1923–1984)
SEJ=Стивен Эдвард Смит-младший
(р. 1957)
WKS=Уильям Кеннеди Смит
(b , 1960)
AMS=Аманда Мэри Смит
(1967 г.р.)
,---v--v---. :
ЦКЛ СМЛ ВФЛ РЕЛ Лу ЭТС CKL=Кристофер Лоуфорд
(1955 г.р.)
SML=Сидней Малея Лоуфорд
(1956 г.р.)
VFL=Виктория Фрэнсис Лоуфорд
(1958 г.р.)
REL=Робин Элизабет Лоуфорд
(р. 1961)
,---v---v---v---v---v--v ---v---v---v---.
ХК JPK РФК ДАК МСК МЛК МКК ЦГК ММК ДХК REK KHK=Кэтлин Кеннеди Таунсенд
(р. 1951)
JPK=Джозеф Патрик Кеннеди II
(р. 1952)
RFK=Роберт Ф. Кеннеди-младший
(р. 1954)
DAK=Дэвид Кеннеди
(1955–1984)
MCK=Кортни Кеннеди Хилл
(р. 1956)
MLK=Майкл ЛеМойн Кеннеди
(1958–1997)
MKK=Керри Кеннеди
(р. 1959)
CGK=Кристофер Джордж Кеннеди\ \ б. 1963)MMK=Мэттью Максвелл Тейлор Кеннеди
(р. 1965)
DHK=Дуглас Гарриман Кеннеди
(р. 1967)

</диаграмма> Визуализированное дерево

Пример: Генеалогическое древо Кеннеди со стрелками Теперь добавим стрелки. Здесь они немного избыточны, но это для большего разнообразия.

<диаграмма>

ЯК y@aa МАК JAK=Джеймс Кеннеди
(ок. 1770 - ок. 1840)
!@4
ПАК у@аа БМК PAK=Патрик Кеннеди
(ок. 1823–1858)
,@4--- v@4- - - +@e - - - v@4- -- .@4
МЛК JLK ДЖОК ММК PJK y@aa МАХ MLK=Мэри Л. Кеннеди
(1851–1926)
JLK=Джоанна Л. Кеннеди
(1852–1926)
JOK=Джон Кеннеди
(1854–1855)
MMK=Маргарет М. Кеннеди
( 1855–1929)
PJK=Патрик Джозеф Кеннеди
(1858–1929)
!@4
JPK y@aa РФК JPK=Джозеф П. Кеннеди-старший
(1888–1969)
,@4- - - v@4 - - - v@4- -- v@4- - -+@e -- - v@4- - -v@4-- -v@4- - -.@4
JPK Кеннеди 7@88 РК КАК 7@88 ЭМК F@22 ПАК Ф@22 РФК F@22 ЯК F@22 ЕДК JPK=Джозеф Патрик Кеннеди-младший
(1915–1944)
JFK=Джон Фицджеральд Кеннеди
(1917–1963)
ROK=KAK=[[wp>Кэтлин Кавендиш, маркиза Хартингтон
(1920 - 1948)
EMK=Юнис Кеннеди Шрайвер
(р. 1921)
PAK=Патриция Кеннеди Лоуфорд
(1924–2006)
RFK=Роберт Фрэнсис Кеннеди
(1925–1968)
JAK=Джин Кеннеди Смит\ \ (р. 1928)
: : :@4 : Ф ~ Дж : :
JLB y@aaJ ВЕК ~@2J : : : F ~ ~~ ~J : JLB=Жаклин Ли Бувье
(1929–1994)
,@4- - - v@4- @a - v@4 - - -.@4 : : : : JBK y@aaJ
КОВЧЕГ ЦБК JKJ ПБК : : : : ,@4-- -v@4@a - -.@4 ARK=Арабелла Кеннеди
(1956 - 1956)
CBK=Кэролайн Кеннеди
(р. 1957)
JKJ=Джон Ф. Кеннеди-младший
(1960 - 1999)
:@4 :@4 :@4:@4 КАК ЭМК ПЖК KAK=Кара Энн Кеннеди
(1960 г.р.)
EMK=Эдвард Кеннеди-младший
(1961 г.р.)
SAS y@aa~ ~ ~ ~~ ~ ~ ~ ~J : : :
,@4--- v@4- - - v@4 - @a - v@4- -- .@4 F~ ~J : L ~ ~~ ~y@aa СЭС
RSS МОС ТПС МКС АПС : F~ ~J ! RSS=Роберт Сарджент Шрайвер III
(р. 1954)
MOS=Мария Шрайвер
(р. 1955)
TPS=Тимоти Перри Шрайвер
(р. 1959)
MKS=Марк Кеннеди Шрайвер
(р. 1964)
: : ,@4- - -v@4-@a -v@4- - -.@4
PEL y@aa~ ~ ~~ ~ ~ ~ J : СЭЖ ВКС АМС КМС PEL=Питер Лоуфорд
(1923–1984)
SEJ=Стивен Эдвард Смит-младший
(р. 1957)
WKS=Уильям Кеннеди Смит
(b , 1960)
AMS=Аманда Мэри Смит
(1967 г.р.)
,@4- - - v@4 - @a - v@4-- - .@4 :
ЦКЛ СМЛ ВФЛ РЕЛ Лу@аа ЭТС CKL=Кристофер Лоуфорд
(1955 г.р.)
SML=Сидней Малея Лоуфорд
(1956 г.р.)
VFL=Виктория Фрэнсис Лоуфорд
(1958 г.р.)
REL=Робин Элизабет Лоуфорд
(р. 1961)
,@4--- v@4- - - v@4 - - - v@4- -- v@4- - - v@4 -@a -v@4- - -v@4-- -v@4- - -v@4-- -.@4
ХК JPK РФК ДАК МСК МЛК МКК ЦГК ММК ДХК REK KHK=Кэтлин Кеннеди Таунсенд
(р. 1951)
JPK=Джозеф Патрик Кеннеди II
(р. 1952)
RFK=Роберт Ф. Кеннеди-младший
(р. 1954)
DAK=Дэвид Кеннеди
(1955–1984)
MCK=Кортни Кеннеди Хилл
(р. 1956)
MLK=Майкл ЛеМойн Кеннеди
(1958–1997)
MKK=Керри Кеннеди
(р. 1959)
CGK=Кристофер Джордж Кеннеди\ \ б. 1963)MMK=Мэттью Максвелл Тейлор Кеннеди
(р. 1965)
DHK=Дуглас Гарриман Кеннеди
(р. 1967)

</диаграмма> Визуализированное дерево

Дополнительные тесты Использование всех типов подключения:

<диаграмма>

в В
,!. Ф:7 у р
)-+-(D~%~C } {] [ * # `!'
:J h b
A

диаграмма> Использование всех типов стрелок: на отдельной странице .

Обновление

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

Файл для загрузки

Лицензия

Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на эту страницу с вашего сайта, если вам нравится этот продукт.

Только авторизованные участники могут оставлять комментарии.
wiki/plugin/diagram.1692276327.txt.gz · Последнее изменение: vladpolskiy