In wiki-style projects, a Traction article is normally linked to using a unique page name assigned to that article, rather than its Traction ID. This article provides more detail on the process of linking to Named Pages than is covered in Making Links to Traction Articles and Making Links with the Link Tool.
Once an article has been assigned one or more page names as discribed in Page Name Management and Name History, a link can be established using any of those names. Remember that assigned page names can be either Global or specific to a particular project. When linking to a Named Page, you will need to specify either the project it was assigned in or that it is Global.
You can link with the GUI driven Link Tool or by using wiki syntax. This article covers both cases.
Linking with the Link Tool
The most straightforward method to create a link from the body of another article is to use the Link Tool accessed by clicking the Insert/Edit Link icon in the Article Editor toolbar.
Depending on what you want to appear as the link text, you should do one of the following:
1) If you want the "Wiki Page Name" to be the link text, you should place your cursor where you want the link to be inserted, then
Click the Insert/Edit Link icon.
Select Link to a Named Page and then make sure that the Project Selector is showing either the project that the target page is located in or Global, as appropriate.
When you type any text string into the "Wiki Name" box, Traction will suggest all Page Names that contain that string.
You can select from the list or write a new page name.
Make sure the Use name as link text checkbox is checked and click the Insert button.
The link will be inserted at the cursor point.
2) If you want the link text to be different from the "Wiki Name,"
Follow the steps in 1) above, being sure the Use name as link text checkbox is unchecked.
Write the text for the link in the "Text to Display" dialog at the top of the form before submitting.
or
In the article editor, type the text you want to display as the link
Highlight the link text
Follow the steps in 1) above, being sure the Use name as link text checkbox is unchecked.
Write the text for the link in the "Text to Display" dialog at the top of the form.
Linking with Wiki Syntax
Experienced wiki users often prefer the convenience of using wiki markup rather than the Link Tool.
Linking to a Named Page in the Same Project
Most of the time, you will link to a named page in the same project as the article or comment you are working on. If you want to link to an article with the page name Revenue Recognition, simply surround the page name in double square brackets:
"[[Revenue Recognition]]"
Linking to a Named Page in a Different Project
You may want to link to a named page that is in a different project. The approach is the same but you have to qualify which project, Accounting, you are linking to:
"[[Accounting:Revenue Recognition]]"
Linking to a Global Page Name
Traction's naming model (see Page Name Management and Name History) includes the capability to assign page names from a Global name space. To link to a page name alias in the global name space, use a * instead of a project name:
"[[*:Revenue Recognition]]"
Links to New Page Names
One of the advantages of using Page Name is that you can link to a page that doesn't exist yet.
Links to new pages in redwith a dotted underline. When users with author permissions click on the link, Traction will display a page asking if they wish to create the article with the requested page name. For context, the page will show what articles are requesting it.
Editing links with the Link Tool
When you click to edit an article in which you've made links with the link tool, links will show in red (for links to pages that don't exist) or blue (for all other links).
Place your cursor anywhere on an existing link and click on the Insert/Edit Link icon in the toolbar. The Link Tool with the existing settings loaded. You can make changes as desired then save them clicking the Insert button.
When you click to edit an article in which you've made links with wiki markup, the actual syntax you used will appear (rather than a red or blue link). If the targeted page name had been changed, Traction will actually render the changed (not the original) text.
