Skip to Content

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

Редактировал(а) Андрей Ганьков 2022/05/04 12:23
От версии 6.1
отредактировано Андрей Ганьков
на 2020/09/23 08:58
Изменить комментарий: Загрузить новое вложение Создание с использованием шаблона.png
К версии 21.1
отредактировано Андрей Ганьков
на 2021/11/15 10:37
Изменить комментарий: Добавил приписку для более простого получения ссылки.

Сводка

Подробности

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