Это старая версия документа!
Содержание
Diagram для «ДокуВики»
Построение схем и генеалогических деревьев, состоящих из блоков и линий соединения. Плагин расширяет синтаксис «Докувики» и позволяет строить диаграммы.
Диаграммы должны использоваться внутри специального тега. Это потому, что их синтаксис похож на синтаксис таблицы. Чтобы вставить диаграмму в код, вы должны написать следующее:
<diagram> Спецификация диаграммы </diagram>
- Релиз: 2021-02-21.
- Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»
Совместимость
- 2009-05-28 «Манеры Фрустерика»
- Не работает: auth_aclquickcheck не может обрабатывать начальные двоеточия в идентификаторах, поэтому я чувствую, что это все еще не работает в «ДокуВики», но, по крайней мере, плагин может правильно учитывать ACL .
Монтаж
Используйте менеджер плагинов для установки или…
- скачать zip-файл
- распаковать его в<dokuwiki>/lib/plugins/
- войдите как администратор и измените плагин в менеджере конфигурации
Применение
Спецификация диаграммы представляет собой многострочное выражение. Каждая строка состоит из управляющих символов, определяющих связи между блоками, и последовательностей букв, определяющих блоки. Эти сущности разделяются специальным символом `|'. Например, следующая спецификация
<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 | y | J | ВЕК | ~ | J | : | : | : | F | ~ | ~ | ~ | ~ | J | : | JLB=Жаклин Ли Бувье (1929–1994) | |||||||||||||||||||||||||||
, | - | - | - | v | - | - | v | - | - | - | . | : | : | : | : | JBK | y | J | |||||||||||||||||||||||||
КОВЧЕГ | ЦБК | 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@aa | J | ВЕК | ~@2 | J | : | : | : | F | ~ | ~ | ~ | ~ | J | : | JLB=Жаклин Ли Бувье (1929–1994) | |||||||||||||||||||||||||||
,@4 | - | - | - | v@4 | - | @a | - | v@4 | - | - | - | .@4 | : | : | : | : | JBK | y@aa | J | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
КОВЧЕГ | ЦБК | 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 и установите новую версию, как указано выше.
Файл для загрузки
Лицензия
- Author: Terence J. Grant
- License: GNU GPL v2
- Donate: Click here.
Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на эту страницу с вашего сайта, если вам нравится этот продукт.