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

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

  • Показать исходный текст
  • История страницы
  • Ссылки сюда
  • Оставить на чай
  • Экспорт в PDF
  • Наверх

  • 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 · Последнее изменение: 2023/08/17 15:45 — vladpolskiy