Skip to Content

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

Версия 15.1 от Андрей Ганьков на 2020/09/24 19:14

Использование готовых шаблонов

Для статей с однотипной информацией, например для описания 1С установленной у разных клиентов, но по сути имеющие одинаковый набор данных, для создания статьи необходимо использовать шаблон.

Для того чтобы использовать установленный шаблон, при создании страницы его надо выбрать из шаблонов (см. снимок).

Создание с использованием шаблона.png

По нажатии кнопки создать. Можно приступать к заполнению данных, в подготовленной статье. При отсутствии каких то полей не стесняйтесь их добавлять.

Вставить изображение в статью

  1. Устанавливаем курсор редактирования на то место в статье куда надо вставить изображение
  2. Нажимаем кнопку вставить картинку

    Кнопка вставить изображение.png

     

  3. Если изображение уже прикреплено к любой статье его можно просто выбрать в пункте "Вложение", если нет переключаемся на вкладку "Загрузка файла"

    Вкладка загрузить файл.png

     

  4. Выбираем файл для загрузки кнопка "Обзор"
  5. Обязательно! нажимаем кнопку "Загрузить на сервер"
  6. Перескакиваем на первую вкладку. Здесь можно установить дополнительный параметры, например задать размеры, или расположение по центру.

    Параметры изображения.png

     

  7. "Ок" изображение вставлено в статью.

Работа с таблицами

Information

Пожалуйста без надобности не меняйте размеры колонок вручную, табличка сама подстроит размеры колонок под содержимое и экран пользователя. Установив фиксированные размеры под свой экран, не даст возможность отображать адекватно таблицу на мобильных устройствах. Так же установка размеров пропишет в каждой ячейки атрибут (% style="width:180px" %) что значительно усложняет читаемость и редактирование таблицы в вики разметке.

В вики разметке таблица выглядит так:

|= Заголовок колонки 1 |= Заголовок колонки 2 |= Заголовок колонки 3
|Строка 1 ячека 1| Строка 1 ячека 2| Строка 1 ячека 3
|Строка 2 ячека 1| Строка 2 ячека 2| Строка 2 ячека 3

Достаточно просто, поэтому иногда удобнее работать с табличками в вики разметке. Чтобы переключится в момент редактирования на вики разметку, нужно нажать кнопку "Источник" на панели редактирования.

Добавлять и удалять строки и колонки можно через меню правой кнопкой мыши.

Дать ссылку на заголовок раздела внутри страницы

Вообще ссылка на заголовок делается на той же странице следующим кодом:

[[разделе по смене пароля>>||anchor="HTitle"]]

Где Title название самого заголовка.

Но это работает только для английских заголовков. Для русских Title выглядит иначе. Например так "H42143C43543D43043F43044043E43B44F" для заголовка "Смена пароля".

[[разделе по смене пароля>>||anchor="H42143C43543D43043F43044043E43B44F"]]

Узнать какие же цифры писать в ссылке в Firefox можно следующим образом:

  1. В браузере на сохраненой странице выделяем искомый заголовок, в контекстном меню вызываем исследовать элемент (или вызываем инспектор F12 и ищем заголовок в ручную)

    Контекстное меню на странице.png

     

  2. Чуть выше выбранного span с текстом интересующего заголовка будет тег h1

    Выделенный span.png

     

  3. Копируем значение его атрибута id через контекстное меню, это и есть наш якорь.

    Контекстное меню атрибута.png