Перейти к содержимому

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

Редактировал(а) Андрей Ганьков 2025/07/14 13:35
От версии 14.1
отредактировано Андрей Ганьков
на 2020/09/24 19:13
Изменить комментарий: Загрузить новое вложение Параметры изображения.png
К версии 22.5
отредактировано Андрей Ганьков
на 2025/07/14 13:06
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Инструкции.Для сисадмина.WebHome
1 +Для пользователя.WebHome
Содержимое
... ... @@ -1,26 +1,43 @@
1 += Общие рекомендации =
2 +
3 +* Оформляйте вики однообразно. Пытаемся в месте выработать единый стиль, поэтому смотрите больше как оформлены аналогичные вещи. Если что-то не нравится в оформлении других, давайте обс
4 +
1 1  = Использование готовых шаблонов =
2 2  
3 -Для статей с однотипной информацией, например для описания 1С установленной у разных клиентов, но по сути имеющие одинаковый набор данных, для создания статьи необходимо использовать шаблон.
7 +Для статей с однотипной информацией — например, описаний установленной 1С у разных клиентов, имеющих схожую структуру и набор данных — рекомендуется использовать шаблон при создании статьи.
4 4  
5 5  Для того чтобы использовать установленный шаблон, при создании страницы его надо выбрать из шаблонов (см. снимок).
6 6  
7 -(% style="text-align:center" %)
8 -[[image:Создание с использованием шаблона.png]]
11 +[[image:Создание с использованием шаблона.png||data-xwiki-image-style-alignment="center"]]
9 9  
10 10  (% class="wikigeneratedid" %)
11 11  По нажатии кнопки создать. Можно приступать к заполнению данных, в подготовленной статье. При отсутствии каких то полей не стесняйтесь их добавлять.
12 12  
13 -(% class="wikigeneratedid" %)
14 14  = Вставить изображение в статью =
15 15  
16 16  1. Устанавливаем курсор редактирования на то место в статье куда надо вставить изображение
17 -1. Нажимаем кнопку вставить картинку
18 -1. Если изображение уже прикреплено к любой статье его можно просто выбрать в пункте "Вложение", если нет переключаемся на вкладку "Загрузить файл"
19 +1. Нажимаем кнопку вставить картинку(((
20 +[[image:Кнопка вставить изображение.png||data-xwiki-image-style-alignment="center"]]
21 +
22 +
23 +)))
24 +1. Если изображение уже прикреплено к любой статье его можно просто выбрать в пункте "Вложение", если нет переключаемся на вкладку "Загрузка файла"(((
25 +[[image:Вкладка загрузить файл.png||data-xwiki-image-style-alignment="center"]]
26 +
27 +
28 +)))
19 19  1. Выбираем файл для загрузки кнопка "Обзор"
20 -1. Обязательно! нажимаем кнопку "Загрузить файл"
21 -1. Перескакиваем на первую вкладку. Здесь можно установить дополнительный параметры, например задать размеры, или расположение по центру.
30 +1. Обязательно! нажимаем кнопку "Загрузить на сервер"
31 +1. Перескакиваем на первую вкладку. Здесь можно установить дополнительный параметры, например задать размеры, или расположение по центру.(((
32 +[[image:Параметры изображения.png||data-xwiki-image-style-alignment="center"]]
33 +
34 +
35 +)))
22 22  1. "Ок" изображение вставлено в статью.
23 23  
38 += Работа с заголовками =
39 +
40 +
24 24  = Работа с таблицами =
25 25  
26 26  {{info}}
... ... @@ -42,8 +42,46 @@
42 42  (% class="wikigeneratedid" %)
43 43  Добавлять и удалять строки и колонки можно через меню правой кнопкой мыши.
44 44  
45 -= Дать ссылку на заголовок раздела внутри страницы =
62 +== Очистка любого форматирования таблиц ==
46 46  
64 +Часто бывает так что случайными движением мыши вставляются размеры в каждую строку таблицы или при копировании данных из Excel. Таблица вся завалена тегами форматирования, что практически убивает возможность ее удобного редактирования в виде исходника. Очистить форматирование можно, открыв исходник страницы, скопировав текст любой сервис замены по Regexp например [[этот>>https://www.freeformatter.com/regex-tester.html]]. Вставляем наш текст. Далее указываем шаблон поиска {{code language="regexp"}}\(\%.*?\%\){{/code}}. Обязательно проставляем параметр /g для тех сервисов в которых можно это указать галочкой, или добавляем его в конец выражения если галки нет. Выполняем замену на пустое место. И получаем очищенный от форматирования вариант таблицы.
65 +
66 += Работа со ссылками =
67 +
68 +[[Официальная документация ~>~>>>https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/?syntax=2.1&section=Links]]
69 +
70 +== Внутренняя ссылка ==
71 +
72 +Внутренние ссылки, то есть ссылки на других страницы в вике, надо создавать **не копируя **полностью ссылку **из браузера**, а помощью специального формата. Это позволяет вики при переименовании страниц, корректно заменить все ссылки на новую страницу.
73 +
74 +=== Через редактирования источника ===
75 +
76 +Следующий вариант сделает ссылку на страницу в виде ее названия.
77 +
78 +{{code language="XWiki"}}
79 +[[Название страницы на русском]]
80 +{{/code}}
81 +
82 +(% class="wikigeneratedid" %)
83 +Дать ссылку с другим текстом можно следующим образом.
84 +
85 +{{code language="Xwiki"}}
86 +[[Отображаемый текст ссылки>>Название страницы на русском]]
87 +{{/code}}
88 +
89 +=== Из графического редактора ===
90 +
91 +Нажимаем кнопку [[image:Значек ссылки.png]] и в появившемся диалоге пишем отображаемый текст, и выбираем из списка нужную страницу.
92 +
93 +[[image:Диалог редактирования ссылки.png||data-xwiki-image-style-alignment="center"]]
94 +
95 +== Ссылка на заголовок раздела внутри страницы ==
96 +
97 +(% class="box infomessage" %)
98 +(((
99 +Если цель дать кому-то ссылку на раздел страницы в чате, то ее можно скопировать из правой панели "Содержимое".
100 +)))
101 +
47 47  Вообще ссылка на заголовок делается на той же странице следующим кодом:
48 48  
49 49  {{code language="xwiki"}}
... ... @@ -61,20 +61,43 @@
61 61  Узнать какие же цифры писать в ссылке в Firefox можно следующим образом:
62 62  
63 63  1. В браузере на сохраненой странице выделяем искомый заголовок, в контекстном меню вызываем исследовать элемент (или вызываем инспектор F12 и ищем заголовок в ручную)(((
64 -(% style="text-align:center" %)
65 -[[image:Контекстное меню на странице.png]]
119 +[[image:Контекстное меню на странице.png||data-xwiki-image-style-alignment="center"]]
66 66  
67 67  
68 68  )))
69 69  1. Чуть выше выбранного span с текстом интересующего заголовка будет тег h1(((
70 -(% style="text-align:center" %)
71 -[[image:Выделенный span.png]]
124 +[[image:Выделенный span.png||data-xwiki-image-style-alignment="center"]]
72 72  
73 73  
74 74  )))
75 75  1. Копируем значение его атрибута id через контекстное меню, это и есть наш якорь.(((
76 -(% style="text-align:center" %)
77 -[[image:Контекстное меню атрибута.png]]
129 +[[image:Контекстное меню атрибута.png||data-xwiki-image-style-alignment="center"]]
78 78  
79 79  
80 80  )))
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 +
Диалог редактирования ссылки.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.gav
Размер
... ... @@ -1,0 +1,1 @@
1 +63.2 KB
Содержимое
Значек ссылки.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.gav
Размер
... ... @@ -1,0 +1,1 @@
1 +7.5 KB
Содержимое