Linking
Scroll uses the links in the wiki pages to generate links in the exported document. You can link to pages in the same space, or outside Confluence.
Linking to a Confluence Page
In Wiki Markup, links are denoted by square brackets. Whenever you place text between square brackets, Confluence recognizes it as a link.
You can display your own text instead of the page name: Inside the square brackets, insert the required text followed by a vertical bar and then the page name. The second example below shows this.
| What you need to type | What you will get |
|---|---|
| [User Guide] | User Guide |
| [User Guide Home|User Guide] | User Guide Home |
In the above examples, 'User Guide' is the name of the page you want to link to.
 | Links to Pages which are not exported If the page you are linking to, is not part of the exported document, Scroll will convert the absolute link to the Confluence server, where the export was created. This is also true, if you link to pages from another space. |
Linking to Anchors
Anchors allow you to link to specific places within a page. Anchor links can be especially useful when navigating between sections of a long page or when you want to link to a segment of a page and not to the page as a whole.
Anchors are made up of two parts:
- The link
- The content to which you are linking.
In Confluence, you can place an anchor in a page using the anchor macro. This creates an anchor called "here", but you can substitute this with whatever name you like.
{anchor:here}
Once an anchor is in the page, you can link to it by putting #here (or whatever anchor name you choose) at the end of a link pointing to that page.
For example, there are two anchors in this page called "top" and "bottom", which you can link to like so:
[#top] [#bottom]
These links come out like this: top bottom.
More examples:
- Linking to an anchor in another page
[nameofpage#anchorname]
- Linking to headings: Confluence treats all headings as anchors. So you don't have to place an anchor but simply link to it like this:
[#textofheading]
Linking a Web Page
To link to a web page outside Confluence,
| What you need to type | What you will get |
|---|---|
| [http://www.atlassian.com/software/confluence] | http://www.atlassian.com/software/confluence |
| [go to Atlassian|http://www.atlassian.com/software/confluence] | go to Atlassian |
- Internal links will be used for links within the document. Scroll supports, links to pages, links to headings and to anchors.
- If an internal link goes to a page, which is not part of the exported document, Scroll will generate an absolute link to the page in the Wiki.
- Links to attachments will be converted to absolute links.
- All links starting with http:// or https:// will be rendered as external links in the exported document.
DocBook Support
Docbook will generate xref and link elements.
More information about linking in DocBook can be found here:
Add Comment