Таблицы и оглавления
Важно
Для старого редактора панель визуальных инструментов представлена в ограниченном режиме: только самые необходимые функции. Основной инструмент для работы в старом редакторе — это разметка Markdown.
Статическая таблица
Чтобы добавить таблицу, на панели инструментов нажмите
и заполните ячейки. Текст в ячейках таблицы можно форматировать.Чтобы редактировать таблицу, выберите ячейку и используйте динамические кнопки.
Простые таблицы — это статические таблицы, которые оформляются вручную с помощью разметки Wiki или Markdown.
Чтобы разместить таблицу в тексте, используйте разметку:
| Заголовок 1 | Заголовок 2 | Заголовок 3 |
| --- | --- | --- |
| ячейка 11 | ячейка 12 | ячейка 13 |
| ячейка 21 | ячейка 22 | ячейка 23 |
Как выглядит результат
Динамическая таблица
Чтобы добавить на страницу динамическую таблицу, нажмите на панели задач
→ Динамическая таблица.О работе с динамическими таблицами см. в разделе Динамические таблицы.
Динамическая таблица — таблица с возможностью задать тип данных столбца, отсортировать значения или сделать ячейку обязательной для заполнения. Вы можете использовать таблицу напрямую или встроить ее в страницу.
### Как создать и разместить таблицу на странице, созданной в старом редакторе {#section-add-table-button}
Чтобы создать таблицу и разместить ее в тексте страницы:
-
На панели в верхней части страницы нажмите значок . В тексте появится код таблицы:
{{grid page="/users/<имя_пользователя>/<адрес_страницы>/grid-2021-01-24t163048" width="100%"}}
Созданная таблица станет подразделом текущей страницы.
-
Нажмите Сохранить.
Как встроить существующую таблицу
Чтобы встроить динамическую таблицу в страницу:
-
Откройте таблицу и в правом верхнем углу нажмите
Настройки таблицы. -
Выберите </> Копировать код вставки.
-
Настройте параметры для вставки таблицы.
-
Скопируйте код таблицы и вставьте в текст страницы.
Как фильтровать строки и столбцы таблицы
Вы можете вставить динамическую таблицу на страницу, созданную в старом редакторе так, чтобы отображались только заданные столбцы или строки таблицы, которые соответствуют определенным условиям. Для этого:
-
Получите код для вставки таблицы и разместите его в тексте страницы.
-
Чтобы выбрать столбцы таблицы, которые будут отображаться на странице, добавьте к коду таблицы параметр
columns
. Подробнее об использовании этого параметра читайте в разделе Как выбрать столбцы для отображения. -
Чтобы задать условия для отображения строк таблицы в зависимости от значений в заданных ячейках, добавьте к коду таблицы параметр
filters
. Подробнее об использовании этого параметра читайте в разделе Как задать фильтр для отображения строк.
Как перейти к источнику встроенной таблицы
Чтобы открыть оригинал таблицы, встроенной в страницу:
-
Внизу таблицы нажмите значок .
-
Выберите Родительская таблица.
Содержание (оглавление) страницы
Чтобы добавить на страницу содержание этой или любой другой страницы Wiki, которая создана в старом или новом редакторе:
- Нажмите
/
и во всплывающем окне выберите Содержание страницы. - Укажите адрес страницы, содержание которой хотите оформить. Например,
homepage/hello-page
. Если не указать никакого адреса, то будет создано содержание текущей страницы. - В полях От и До укажите максимальный и минимальный уровень заголовков, которые будут включены в содержание. Вы можете оставить значение
—
. В таком случае:
- Для поля От будет взято значение h1.
- Для поля До будет взято значение h8.
- Нажмите Сохранить.
Чтобы изменить уже созданное содержание страницы, в режиме редактирования в правом верхнем углу содержания нажмите
→ Редактировать.Страницы Wiki, созданные в старом редакторе, могут автоматически формировать оглавление на основе заголовков. Для этого используется динамический блок toc
.
Добавить оглавление для страницы
-
Убедитесь, что ваша страница создана в старом редакторе.
-
Убедитесь, что заголовки страницы правильно размечены. Для быстрого просмотра оглавления страницы на панели справа нажмите значок .
Если на странице есть совпадающие заголовки, ссылки в оглавлении могут работать некорректно. -
Создайте оглавление с помощью динамического блока:
{{toc}}
По умолчанию в оглавление будут попадать все заголовки страницы Wiki. Вы можете настроить вывод оглавления с помощью дополнительных параметров.
Пример оглавления, в которое включены заголовки от первого (
h1
) до третьего (h3
) уровня.{{toc from="h1" to="h3"}}
Параметры блока (необязательные)
Параметр | Описание |
---|---|
from |
Самый высокий уровень заголовков, начиная с которого они включаются в оглавление. |
to |
Самый низкий уровень заголовков, заканчивая которым они включаются в оглавление. |
page |
Относительный адрес страницы, по заголовкам которой будет построено оглавление. Например: userName/pageName/ . По умолчанию это адрес страницы, на которую добавлен блок toc . |
Добавить оглавление для группы страниц
Добавить оглавление можно двумя способами:
-
С помощью инструкции.
-
C помощью ссылок:
WikiMarkdown((<ссылка> <название_страницы>))
[<название_страницы>](<ссылка>)
Структура раздела
Чтобы добавить на страницу оглавление любого раздела, который состоит из нескольких вложенных друг в друга страниц Wiki:
- Нажмите
/
и во всплывающем окне выберите Структура раздела. - Укажите адрес страницы, для которой хотите оформить структуру вложенных страниц. Например,
homepage/hello-page
. Если не указать никакого адреса, то будет создано оглавление для вложенных страниц текущей страницы. - В поле Глубина укажите максимальный уровень вложенности, после которого страницы не будут указаны в оглавлении.
- Нажмите Сохранить.
Чтобы изменить уже созданную структуру раздела, в режиме редактирования в правом верхнем углу структуры нажмите
→ Редактировать.Вы можете вставить на страницу списки:
Страницы раздела
Блок содержит список всех страниц заданного раздела.
Вызов блока
{{tree for="адресСтраницы" nomark="0" depth="3" show_redirects="False" show_grids="True" show_files="False" show_owners="False" show_titles="True" show_created_at="False" show_modified_at="False" sort_by="title" sort="asc"}}
Все параметры блока {{tree}}
необязательные, в примере приведены значения параметров по умолчанию.
Параметры блока (необязательные)
Параметр | Описание |
---|---|
for |
Адрес страницы, для которой строится дерево. |
page |
Альтернативное имя (алиас) параметра for . |
depth |
Глубина дерева. Если равна 0 , то глубина не ограничена. |
show_grids |
Отображение динамических таблиц в дереве:true — динамические таблицы включены в дерево;false — динамические таблицы не отображаются в дереве. |
show_files |
Отображение прикрепленных файлов в дереве:true — файлы включены в дерево;false — файлы не отображаются в дереве. |
show_owners |
Отображение авторов страниц:true — авторы отображаются;false — авторы скрыты. |
show_titles |
Отображение заголовков страниц:true — заголовки отображаются;false — заголовки скрыты. |
show_created_at |
Отображение дат создания страниц:true — даты отображаются;false — даты скрыты. |
show_modified_at |
Отображение дат изменения страниц:true — даты отображаются;false — даты скрыты. |
sort_by |
Сортировать страницы:title — по заголовку;cluster — по разделу;created_at — по дате создания;modified_at — по дате изменения. |
sort |
Порядок сортировки:asc — по возрастанию;desc — по убыванию. |
Страницы, ссылающиеся на заданную
Блок содержит список всех страниц, на которых присутствуют ссылки на заданную страницу.
Вызов блока
{{backLinks for="адресСтраницы"}}
Параметры блока (необязательные)
Параметр | Описание |
---|---|
for |
Содержит адрес страницы, для которой строится список. Если параметр не указан, список строится для текущей страницы. |
Страницы, для которых я автор
Блок содержит список страниц, автором которых является пользователь.
Вызов блока
{{mypages}}
Например, чтобы вывести список страниц пользователя
username
и отсортировать их по дате изменения, задайте блок:{{mypages bychange=1 user="username"}}
Все параметры блока {{mypages}}
необязательные. По умолчанию в блоке выводится список страниц того пользователя, который его просматривает. Страницы выводятся в алфавитном порядке.
Параметры блока (необязательные)
Параметр | Описание |
---|---|
user |
Вы можете вывести список страниц любого пользователя, указав в параметре user его логин. |
bydate |
Сортировка по дате создания:1 — включить;0 — отключить. |
bychange |
Сортировка по дате изменения:1 — включить;0 — отключить. |