Title: Making Links to Traction Articles

It is easy to make a link from one article (or comment) to another article, comment, a list of articles or even a view in Traction. This article focuses on how to make a link to an article or comment.

A link will actually create a bi-directional link, so you can see the incoming link in the Referenced By section of the Article to which you linked.

All that is required is to type the Traction ID or the Wiki Page Name of the target article. The Traction ID of an article is composed of the space name and a number (e.g. HR5).

For additional reference on making links, read Making Links with the Link Tool and Embedding Sections in Articles.

Note: With TeamPage Release 5.0, the term 'project' was renamed to 'space'. Some older screenshots may use the original 'project' terminology. The definition of Space as TeamPage's named container for a set of sharable TeamPage Articles did not change - only its name, see Customer2797.

There are 5 easy methods to create direct links to Articles or Comments in Traction.

Method 1: Make a Link with the Link Tool

Traction provides a comprehensive Link Tool in the Article Editor for creating both external and internal links. You can easily create a link to an existing Traction Article, Attachment, Existing or New Wiki Page Name, Share Folder, or View by following the directions in Making Links with the Link Tool.

Method 2: Write the Traction ID in the Article or Comment Text

From the Create New Article, Edit Article, or Comment forms, simply type the Traction ID (space name and article number) of the article to which you want to link (all one word, not separated by blanks, e.g. HR5).

You can see the Traction ID at the top of any single or multi-entry view of an article in Traction, just below the title, or you will find it in the bread crumb at the top of the single entry Traction view.

This also works when you are sending email to a Traction space. Just write the Traction ID in the text of the email message, and it will automatically become a hyperlink when the message is published.

If you want to link directly to a paragraph (or "Item"), then you fully qualify the Traction ID to include the paragraph/item ID. In the case above, typing "HR5.04" could link to paragraph 02 of the article. To determine the item ID of a paragraph, you can hover over the item block and you will see the Item ID at the lower right corner of the grey outline. A new permanent Item ID is attached to each new Item in the article as it is created, and stays attached to the same Item as new Items are added or old items are deleted.

Method 3: Write the Wiki Page Name in Wiki Markup

Making Links with the Link Tool explains how to use a GUI to make 5 different types of links, including a Named Page. Linking to Named Pages goes into more specifics on how to use wiki markup to link to an existing Named Page or to a new page that doesn't yet exist.

Method 4: Drag the Article Title or Traction ID

Note: This method works with TeamPage 6.2.26 or newer, see Customer5509.025: TeamPage 6.2.66

You can drag and drop the title of any article or any link to a single-article view into any compose form or collector window. When you drop, the Traction ID will be inserted at the insertion point.

In the screenshot below, all the highlighted text can be dragged and dropped into the new article or comment forms to create links to the corresponding articles.

Method 5: Choose New List from the Collector

If you have added article references into the Collector (See the The Collector section), you can choose one of the New List options and press GO.

A Compose New Article form will appear with the Traction ID's listed in the article body.

The Links are Resolved when you click Submit

Regardless of the method you chose, the result will be an article or comment with the hyperlink resolved. Each link will include the Traction ID and the title of the article or comment to which you linked. If the target article or comment title is changed in an edit, the link will always display the most current title.

You can click the in-line links to go to the linked articles but you may also click the same link in the References section at the bottom of the article.

You can also click the References (3) link to see the main article followed by all of the articles to which it links on one page.

Back Links

The articles you linked to will include back links to your article in the Referenced By Section. Here is a view of the HR1: 401K Policy with back links in the Referenced By section to the article that was just posted, and to a comment that also linked to this article:

Related Articles
Article: Doc166 (permalink)
Date: March 22, 2008; 4:07:52 PM Eastern Daylight Time

Author Name: Documentation Importer
Author ID: importer