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

Содержание

Diagram для «ДокуВики»
Обсуждение

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

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

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

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

Релиз: 2021-02-21.
Репозиторий:http://nikita.melnichenko.name/projects/dokuwiki-diagram/?lang=en
Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

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

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

Монтаж

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

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

Применение

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

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

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

AAA

BBB

CCC

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

<diagram>
| root |-| 1-st branch |
| |:| | | | | |
| |L|~|~| 2-nd branch |
</diagram>

root

1-st branch

2-nd branch

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

<diagram>
| AAA |-| BBB |AAA=root|BBB=1<sup>st</sup> branch (see [[wp>Branch]])
| |:| | | | | |
| |L|~|~| CCC |CCC=2<sup>nd</sup> branch\\ **(very important branch)**
</diagram>

root

1^st branch (see Branch)

2^nd branch
(very important branch)

С помощью таких диаграмм можно описать генеалогическое древо.

<diagram>
| | | Dad |y| Mom | | |Dad=Daddy|Mom=Mommy
| |,|-|-|-|+|-|-|-|.| |
| Sys | |  Me | | Bro |Sys=Syster|Bro=Brother
</diagram>

Daddy

Mommy

Syster

Me

Brother

Все типы соединений показаны в следующей таблице:

,	.	`	'			v	(	)	-	!	+

F	7	L	J	A	V	C	D	~	:	%

y	h	}	{	p	b	]	[	*	#

We'll refer to these elements as connection tiles. Мы будем называть эти элементы тайлами соединения.

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

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

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

ААА ВВВ ДДД ССС с

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

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

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

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

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

Визуализированное дерево

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

Визуализированное дерево

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

c@0

c@1

c@2

c@3

c@4

c@5

c@6

c@7

c@8

c@9

c@a

c@b

c@c

c@d

c@e

c@f

c@00

c@10

c@20

c@30

c@40

c@50

c@60

c@70

c@80

c@90

c@a0

c@b0

c@c0

c@d0

c@e0

c@f0

c@01

c@11

c@21

c@31

c@41

c@51

c@61

c@71

c@81

c@91

c@a1

c@b1

c@c1

c@d1

c@e1

c@f1

c@02

c@12

c@22

c@32

c@42

c@52

c@62

c@72

c@82

c@92

c@a2

c@b2

c@c2

c@d2

c@e2

c@f2

c@03

c@13

c@23

c@33

c@43

c@53

c@63

c@73

c@83

c@93

c@a3

c@b3

c@c3

c@d3

c@e3

c@f3

c@04

c@14

c@24

c@34

c@44

c@54

c@64

c@74

c@84

c@94

c@a4

c@b4

c@c4

c@d4

c@e4

c@f4

c@05

c@15

c@25

c@35

c@45

c@55

c@65

c@75

c@85

c@95

c@a5

c@b5

c@c5

c@d5

c@e5

c@f5

c@06

c@16

c@26

c@36

c@46

c@56

c@66

c@76

c@86

c@96

c@a6

c@b6

c@c6

c@d6

c@e6

c@f6

c@07

c@17

c@27

c@37

c@47

c@57

c@67

c@77

c@87

c@97

c@a7

c@b7

c@c7

c@d7

c@e7

c@f7

c@08

c@18

c@28

c@38

c@48

c@58

c@68

c@78

c@88

c@98

c@a8

c@b8

c@c8

c@d8

c@e8

c@f8

c@09

c@19

c@29

c@39

c@49

c@59

c@69

c@79

c@89

c@99

c@a9

c@b9

c@c9

c@d9

c@e9

c@f9

c@0a

c@1a

c@2a

c@3a

c@4a

c@5a

c@6a

c@7a

c@8a

c@9a

c@aa

c@ba

c@ca

c@da

c@ea

c@fa

c@0b

c@1b

c@2b

c@3b

c@4b

c@5b

c@6b

c@7b

c@8b

c@9b

c@ab

c@bb

c@cb

c@db

c@eb

c@fb

c@0c

c@1c

c@2c

c@3c

c@4c

c@5c

c@6c

c@7c

c@8c

c@9c

c@ac

c@bc

c@cc

c@dc

c@ec

c@fc

c@0d

c@1d

c@2d

c@3d

c@4d

c@5d

c@6d

c@7d

c@8d

c@9d

c@ad

c@bd

c@cd

c@dd

c@ed

c@fd

c@0e

c@1e

c@2e

c@3e

c@4e

c@5e

c@6e

c@7e

c@8e

c@9e

c@ae

c@be

c@ce

c@de

c@ee

c@fe

c@0f

c@1f

c@2f

c@3f

c@4f

c@5f

c@6f

c@7f

c@8f

c@9f

c@af

c@bf

c@cf

c@df

c@ef

c@ff

Обновление

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

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

citations.zip

Лицензия

Author: Terence J. Grant
License: GNU GPL v2
Donate: Click here.

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

Только авторизованные участники могут оставлять комментарии.