The content of your wiki is organized in pages.
Since your wiki is ultimately a website, a wiki page is naturally a page in the website that is your wiki. A page therefore has a url, which uniquely identifies it. This url can be shared with others, included in an email, inside a page of another website, etc. You can see the url of the page in your browser's address bar.
The page's url, as any web page url, is composed of 3 parts:
- the protocol: https://. The
sdenotes a secure connection.
- your wiki's hostname (mywiki.polifonic.io, or for this current page: docs.polifonic.io)
- the route to the page, which is the
page idprefixed with a slash [/](e.g. '/my-page, or for this current page: /page:start).
page id uniquely identifies a page within the wiki. To include a link to a page inside another page of the same wiki, you don't need to use the full page's url. You can simply refer to that page using its unique id, enclosed within 2 square brackets, like so:
You can further organize your pages into namespaces. These are logical groupings, entirely at your discretion, intended to organize pages into groups that can be treated together for practical purposes. You can think of namespaces as folders.
Namespaces are useful for several reasons:
- You can assign permissions to a namespace; the namespace permissions will apply to all pages in that namespace, so you don't have to set individual permissions on each page (you can still set permissions on an individual page, in which these individual permissions will override the permissions for the page's namespace).
- You can create a sidebar for this namespace. This namespace sidebar will only be displayed on pages from this namespace.
- You can structure your navigation (in your sidebars or inside the body of your pages) more flexibly by pointing to a namespace rather than a page (actually you will point to the
startpage of that namespace).
A namespace is just a string of characters. All characters are supported, except the following:
<(less than symbol)
>(greater than symbol)
|(vertical bar or pipe)