Tables and tables of contents
Warning
For the old editor, the visual toolbar is limited to feature only the essential functions. The main tool for working in the old editor is Markdown.
Static table
To add a table, click
on the toolbar and fill in table cells. You can format text in the table cells.To edit a table, select a cell and use the dynamic buttons.
Simple tables are static tables that are created manually using Wiki markup elements or Markdown formatting.
To place a table in the text, use the markup:
| Heading 1 | Heading 2 | Heading 3 |
| --- | --- | --- |
| cell 11 | cell 12 | cell 13 |
| cell 21 | cell 22 | cell 23 |
See the result
Dynamic table
To add a dynamic table to your page, on the task panel, click
→ Dynamic table.To learn about working with dynamic tables, see Dynamic tables.
Dynamic tables are tables where you can specify column data type, sort values, or make cells required for filling in. You can use a table directly or embed it in a page.
How to create and place a table on a page created in the old editor
To create a table and embed it in the text of a page:
-
In the panel at the top of the page, click . The table code will appear in the text:
{{grid page="/users/userName/pageName/grid-2021-01-24t163048" width="100%"}}
The created table will become a subcluster of the current page.
-
Click Save.
Embedding an existing table
To embed a dynamic table in a page:
-
Open the table you need and click
Table settings in the top-right corner. -
Select </> Copy embed code.
-
Configure the parameters for inserting the table.
-
Copy the table code and paste it into the page text.
Filtering rows and columns
You can filter dynamic tables you embed in a page created in the old editor so that only specific rows and columns are displayed. To do this:
-
Get the table embed code and insert it into the text of the page.
-
To choose columns for display, add the
columns
parameter to your table's code. For more information about using this parameter, see Choosing columns to display. -
To filter table rows based on values set in specific cells, add the
filters
parameter to your table code. For more information about using this parameter, see Setting filters for displaying rows.
Jumping to the parent table
To open the original table embedded in the page:
-
Click at the bottom of the table.
-
Select Parent table.
Page table of contents
To add to your page a table of contents for the current or any other Wiki page created using the old or new editor:
- Press
/
and select Page table of contents in the pop-up window. - Specify the address of the page to add a table of contents to. For example,
homepage/hello-page
. If you do not specify any address, the table of contents will be created for the current page. - In the From and To fields, specify the maximum and minimum heading levels to include in the table of contents. You can keep the
—
value. In this case:
- The From field will get the h1 value.
- The To field will get the h8 value.
- Click Save.
To change the previously created page table of contents, in edit mode, click
→ Edit in its top-right corner.Wiki pages created in the old editor may automatically generate a table of contents based on headings. This is done using a dynamic block named toc
.
Adding a table of contents for a page
-
Make sure your page is created in the old editor.
-
Make sure the page headings are marked up properly. To quickly view the table of contents for a page, click in the right-hand panel.
If there are matching headings on the page, the links in the table of contents may not work correctly. -
Create a table of contents using a dynamic block:
{{toc}}
By default, all headings of the current Wiki page are added to the table of contents. You can configure the additional TOC settings using the advanced parameters.
Here is an example of a table of contents that includes first (
h1
) to third (h3
) level headings:{{toc from="h1" to="h3"}}
Block parameters (optional)
Parameter | Description |
---|---|
from |
Highest level of headings to include first in the table of contents |
to |
Lowest level of headings to include last in the table of contents |
page |
Relative address of the table of contents source page, e.g., userName/pageName/ ; default address of the page where the toc block is added |
Adding a table of contents for a page group
There are two ways to add a table of contents:
-
Following this guide.
-
Using links:
WikiMarkdown((<link> <page_name>))
[<page_name>](<link>)
Cluster structure
To add to your page a table of contents for any cluster consisting of several Wiki subpages:
- Press
/
and select Cluster structure in the pop-up window. - Specify the page address for which you want to format the structure of subpages. For example,
homepage/hello-page
. If you do not specify any address, a table of contents will be created for subpages of the current page. - In the Depth field, specify the maximum level of nesting beyond which the pages will not be listed in the table of contents.
- Click Save.
To change the previously created cluster structure, in edit mode, click
→ Edit in its top-right corner.You can add lists to your page:
Cluster pages
This block contains a list of all pages for the selected cluster.
Using the block
{{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"}}
All parameters of the {{tree}}
block are optional. The example below shows the default parameter values.
Block parameters (optional)
Parameter | Description |
---|---|
for |
Address of the page the tree is intended for |
page |
Alternative name (alias) for the for parameter |
depth |
Depth of the tree. Setting this to 0 makes the depth unlimited. |
show_grids |
Displaying dynamic tables in the tree:true : Dynamic tables are included in the tree.false : Dynamic tables are not displayed in the tree. |
show_files |
Displaying attached files in the tree:true : Files are included in the tree.false : Files are not displayed in the tree. |
show_owners |
Displaying page authors:true : Authors are displayed.false : Authors are hidden. |
show_titles |
Displaying page titles:true : Page titles are displayed.false : Page titles are hidden. |
show_created_at |
Displaying page creation dates:true : Dates are displayed.false : Dates are hidden. |
show_modified_at |
Displaying the dates of page changes:true : Dates are displayed.false : Dates are hidden. |
sort_by |
Sort pages:title : By title.cluster : By cluster.created_at : By date created.modified_at : By date last modified. |
sort |
Sorting order:asc : Ascending.desc : Descending. |
List of pages linking to a specified page
The block contains a list of all pages that link to the specified page.
Using the block
{{backLinks for="адресСтраницы"}}
Block parameters (optional)
Parameter | Description |
---|---|
for |
Contains the address of the page that the list is being built for. If this parameter is omitted, the list is built for the current page. |
Pages created by me
The block contains a list of pages that the user authored.
Using the block
{{mypages}}
For example, if you want to display a list of pages created by
username
and sort them by the date of their last update, set this block:{{mypages bychange=1 user="username"}}
All parameters of the {{mypages}}
block are optional. By default, the block displays the current user's list of pages. The pages are displayed in alphabetical order.
Block parameters (optional)
Parameter | Description |
---|---|
user |
You can display the list of pages created by any user. To do this, specify that user's login in the user parameter. |
bydate |
Sorting by creation date:1 : Enable.0 : Disable. |
bychange |
Sorting by date of change:1 : Enable.0 : Disable. |