Изменения документа Работа с документацией в xwiki

Редактировал(а) Андрей Ганьков 2025/07/14 13:35

От версии 22.4
отредактировано Андрей Ганьков
на 2025/07/14 11:59
Изменить комментарий: К данной версии нет комментариев
К версии 19.1
отредактировано Андрей Ганьков
на 2021/01/25 15:18
Изменить комментарий: Добавил про создание внутренних ссылок

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -1,14 +5,11 @@
1 -= Общие рекомендации =
2 -
3 -* Оформляйте вики однообразно. Пытайтесь
4 -
5 5  = Использование готовых шаблонов =
6 6  
7 -Для статей с однотипной информацией например, описаний установленной у разных клиентов, имеющих схожую структуру и набор данных рекомендуется использовать шаблон при создании статьи.
3 +Для статей с однотипной информацией, например для описания установленной у разных клиентов, но по сути имеющие одинаковый набор данных, для создания статьи необходимо использовать шаблон.
8 8  
9 9  Для того чтобы использовать установленный шаблон, при создании страницы его надо выбрать из шаблонов (см. снимок).
10 10  
11 -[[image:Создание с использованием шаблона.png||data-xwiki-image-style-alignment="center"]]
7 +(% style="text-align:center" %)
8 +[[image:Создание с использованием шаблона.png]]
12 12  
13 13  (% class="wikigeneratedid" %)
14 14  По нажатии кнопки создать. Можно приступать к заполнению данных, в подготовленной статье. При отсутствии каких то полей не стесняйтесь их добавлять.
... ... @@ -17,12 +17,14 @@
17 17  
18 18  1. Устанавливаем курсор редактирования на то место в статье куда надо вставить изображение
19 19  1. Нажимаем кнопку вставить картинку(((
20 -[[image:Кнопка вставить изображение.png||data-xwiki-image-style-alignment="center"]]
17 +(% style="text-align:center" %)
18 +[[image:Кнопка вставить изображение.png]]
21 21  
22 22  
23 23  )))
24 24  1. Если изображение уже прикреплено к любой статье его можно просто выбрать в пункте "Вложение", если нет переключаемся на вкладку "Загрузка файла"(((
25 -[[image:Вкладка загрузить файл.png||data-xwiki-image-style-alignment="center"]]
23 +(% style="text-align:center" %)
24 +[[image:Вкладка загрузить файл.png]]
26 26  
27 27  
28 28  )))
... ... @@ -29,15 +29,13 @@
29 29  1. Выбираем файл для загрузки кнопка "Обзор"
30 30  1. Обязательно! нажимаем кнопку "Загрузить на сервер"
31 31  1. Перескакиваем на первую вкладку. Здесь можно установить дополнительный параметры, например задать размеры, или расположение по центру.(((
32 -[[image:Параметры изображения.png||data-xwiki-image-style-alignment="center"]]
31 +(% style="text-align:center" %)
32 +[[image:Параметры изображения.png]]
33 33  
34 34  
35 35  )))
36 36  1. "Ок" изображение вставлено в статью.
37 37  
38 -= Работа с заголовками =
39 -
40 -
41 41  = Работа с таблицами =
42 42  
43 43  {{info}}
... ... @@ -69,7 +69,7 @@
69 69  
70 70  == Внутренняя ссылка ==
71 71  
72 -Внутренние ссылки, то есть ссылки на других страницы в вике, надо создавать **не копируя **полностью ссылку **из браузера**, а помощью специального формата. Это позволяет вики при переименовании страниц, корректно заменить все ссылки на новую страницу.
69 +Внутренние ссылки, то есть ссылки на других страницы в вике, надо создавать **не копирую **полностью ссылку **из браузера**, а помощью специального формата. Это позволяет вики при переименовании страниц, так же корректно обрабатывать все внутренние ссылки, и заменять их тоже или устанавливать создавать переадресацию.
73 73  
74 74  === Через редактирования источника ===
75 75  
... ... @@ -86,19 +86,16 @@
86 86  [[Отображаемый текст ссылки>>Название страницы на русском]]
87 87  {{/code}}
88 88  
86 +(% class="wikigeneratedid" %)
89 89  === Из графического редактора ===
90 90  
91 91  Нажимаем кнопку [[image:Значек ссылки.png]] и в появившемся диалоге пишем отображаемый текст, и выбираем из списка нужную страницу.
92 92  
93 -[[image:Диалог редактирования ссылки.png||data-xwiki-image-style-alignment="center"]]
91 +(% style="text-align:center" %)
92 +[[image:Диалог редактирования ссылки.png]]
94 94  
95 95  == Ссылка на заголовок раздела внутри страницы ==
96 96  
97 -(% class="box infomessage" %)
98 -(((
99 -Если цель дать кому-то ссылку на раздел страницы в чате, то ее можно скопировать из правой панели "Содержимое".
100 -)))
101 -
102 102  Вообще ссылка на заголовок делается на той же странице следующим кодом:
103 103  
104 104  {{code language="xwiki"}}
... ... @@ -116,43 +116,20 @@
116 116  Узнать какие же цифры писать в ссылке в Firefox можно следующим образом:
117 117  
118 118  1. В браузере на сохраненой странице выделяем искомый заголовок, в контекстном меню вызываем исследовать элемент (или вызываем инспектор F12 и ищем заголовок в ручную)(((
119 -[[image:Контекстное меню на странице.png||data-xwiki-image-style-alignment="center"]]
113 +(% style="text-align:center" %)
114 +[[image:Контекстное меню на странице.png]]
120 120  
121 121  
122 122  )))
123 123  1. Чуть выше выбранного span с текстом интересующего заголовка будет тег h1(((
124 -[[image:Выделенный span.png||data-xwiki-image-style-alignment="center"]]
119 +(% style="text-align:center" %)
120 +[[image:Выделенный span.png]]
125 125  
126 126  
127 127  )))
128 128  1. Копируем значение его атрибута id через контекстное меню, это и есть наш якорь.(((
129 -[[image:Контекстное меню атрибута.png||data-xwiki-image-style-alignment="center"]]
125 +(% style="text-align:center" %)
126 +[[image:Контекстное меню атрибута.png]]
130 130  
131 131  
132 132  )))
133 -
134 -= Работа с диаграммами =
135 -
136 -Диаграммы из графического редактора вставляются через кнопку + и выбор макроса Chart(График) или напрямую в код страницы. Детальная документация по нем у [[здесь>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Chart Macro]].
137 -
138 -График может как содержать встроенную таблицу с данными так и обращаться к имеющейся таблице. Для того чтобы обратиться к имеющейся таблицы, ей нежно указать id, через меню свойства таблицы или через код:
139 -
140 -{{code language="xwiki"}}
141 -(%id="table_revenue"%)
142 -|=|=X|=Y|=Z
143 -|Q1|1.2|3.4|1.3
144 -{{/code}}
145 -
146 -Теперь создавай диаграмму к ней можно обратится:
147 -
148 -{{code language="xwiki"}}
149 -{{chart type="line" params="document:Цели.2021 год.Компания.WebHome;table:table_revenue;range:B2-B20;series:columns;" width="700"}}{{/chart}}
150 -{{/code}}
151 -
152 - В параметрах необходимо заполнить минимальные настройка:
153 -
154 -* **document** - внутренний адрес страницы, не является обязательным если табличка на той же страницы. Узнать адрес можно через меню страницы "три точки" -> "Информация"
155 -* **table** - id таблицы
156 -* **range** - колонки данных, обратите внимание что **добавляя** **новую** **строку** в таблицу **диапазон** нужно тоже **редактировать**.
157 -
158 -