Attaching objects and links to wiki pages

Introduction

While editing a Mingle wiki page, you can:

attach links to websites, cards and other wiki pages
insert graphics (to display within the card or as just an attachment)
attach other documents (e.g. Microsoft Word documents)

All editing features available on wiki pages are now available on cards too. So if you want to insert a graphic on a card just follow the steps for the wiki page below after clicking the edit link on a card view.

How to attach links, graphics and documents

Sign in to Mingle and navigate to the project with the wiki pages you want to edit (if you're not already working within the project).
Locate the wiki page you want to edit.

Click the Project admin tab > Wiki pages link to view a list of all wiki pages within the project.

You may also find wiki pages attached to cards or other wiki pages, or from Mingle's search.
Click the wiki page name link to open the wiki page.

Mingle displays the contents of the wiki page.
Click the Edit link.

Mingle opens the wiki page for editing.
If you want to:
- create a link to another wiki page, type the exact name of the wiki page between double brackets, e.g.
```
[[wiki_page]]
```
  .
- create a link to a card within the project, type a card keyword (as set up under Project admin tab > Card keywords link) followed by the card number, e.g.
```
#123
```
  (where # is a card keyword).
- create a link to an external website, type the text to link between double quotes, followed directly by a colon and the full website address, e.g.
```
"The ThoughtWorks Website":http://www.thoughtworks.com
```
  .
- embed a graphic that exists on an external website, type the graphic's full URL between two exclamation marks, e.g.
```
!http://studios.thoughtworks.com/mingle/images/Mingle_Logo.png!
```
If you want to attach a graphic or other file, click the Browse... button at the bottom of the page and locate the graphic on your PC.

To add multiple attachments click the "add another file" link and this will allow you to add another file. By clicking multiple times many different attachments can be added at once.
Click the Save link.

Mingle updates the wiki page with the changes you made, and will attach any files you indicated.
If you attached a graphic file and you now want to embed this graphic within the wiki page, click the Edit link.
Type the exact file name of the attachment (as it displays at the bottom of the page) between exclamation marks, e.g.
```
!pic43585.jpg!
```
.
If you would like to check to see how this would appear in Mingle, click the Preview link. If you typed the attached graphic's name correctly, Mingle displays the graphic in the Preview window.
Click the Save link.

Mingle saves the changes you made to the wiki page.

Attaching links to websites, cards and other wiki pages

From within a wiki page, you can create links to external websites, cards and other wiki pages. See the below for the markup to apply.

Link to cards

The actual prefix you use in front of card numbers depends on the card keywords you set up. A '#' is used as an example here.

See the following related cards, #231, #533, #74

Preview

See the following related cards, 231, 533, 74

Link to external URL

See "The ThoughtWorks Website":http://www.thoughtworks.com for details

Preview

See The ThoughtWorks Website for details

Footnote link

This is covered elsewhere[1]

Preview

Footnote location

fn1. Down here, in fact

Preview

Link to a wiki page within the project

You must type the page reference exactly as it appears in Mingle with the same capitalization.

See [[Mingle_Markup]] for details

Preview

See Mingle Markup for details

Link to a wiki page within the project - but with different link text

See [[this link here|Mingle_Markup]] for details

Preview

See this link here for details

See the Formatting help section for details about other types of formatting you can apply to Mingle cards and wiki pages.

Inserting graphics

You can insert graphics as a simple attachment in a wiki page, or you can also make the graphic display on the wiki page.

When you attach images or documents, Mingle may change the file name. If the original file name contains spaces, e.g. file name.jpg, Mingle replaces the spaces with underscores, e.g. file_name.jpg. Before trying to display a graphic within a wiki page, double-check the exact file name at the bottom of the wiki page after saving.

Link to an image

!Mingle_Logo.png!

Preview

Link to an image on an external website

!http://studios.thoughtworks.com/mingle/images/Mingle_Logo.png!

Preview

See the Formatting help section for details about other types of formatting you can apply to Mingle cards and wiki pages.

Removing graphics

If you have simply attached a graphic to a wiki page (without making it display in the wiki page), removing a graphic is the same as removing any other attachment - simply click the X next to the attachment at the bottom of the wiki page.

If you have also made the graphic display on the wiki page, you should also click the Edit link and remove the wiki markup relating to this graphic.

Attaching other documents

You can attach any type of document to a card or wiki page in Mingle.

To attach a document, click the Edit link and scroll down to the bottom of the page.
Click the Browse button and locate the document you want to attach.
Click the Save link.

Removing attachments

Remove an attachment by clicking the X next to the attachment name at the bottom of the wiki page.

Help