Attaching objects and links to cards
While editing a card description in Mingle, you can:
- attach links to websites, other cards and wiki pages
- insert graphics (to display within the card or as just an attachment), and
- attach other documents (e.g. Microsoft Word documents).
How to attach links, graphics and documents
- Sign in to Mingle and navigate to the project with the cards you want to update (if you're not already working within the project).
- Locate the card you want to edit.
- You may also find cards attached to wiki pages or to other cards, or from Mingle's search.
- Click the card name link to open the card.
Mingle displays all details for the card.
- Click the Edit link.
Or, if the card does not yet have a description, click the Add description link.
Mingle opens the card for editing.
- If you want to:
- create a link to another 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 a wiki page, type the exact name of the wiki page between double brackets, e.g. [[wiki_page]].
- 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.
- Click the Save link.
Mingle updates the card with the changes you made, and attaches any files you indicated.
- If you attached a graphic file and you now want to embed this graphic within the card, 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!.
- Click the Save link.
Mingle saves the changes you made to the card. If you've embedded a picture and typed the attached graphic's name correctly, Mingle displays the graphic in the description window.
Attaching links to websites, cards and other wiki pages
From within a card, you can create links to external websites, wiki pages and other cards. See the table below for the markup to apply.
| Formatting |
Markup |
Preview |
|
Link to cards
(Note: 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 |
See the following related cards, 231, 533, 74 |
| Link to external URL |
See "The ThoughtWorks Website":http://www.thoughtworks.com for details
|
See The ThoughtWorks Website for details
|
| Footnote link |
This is covered elsewhere[1]
|
This is covered elsewhere1
|
| Footnote location |
fn1. Down here, in fact |
1 Down here, in fact |
|
Link to a wiki page within the project
(Note: you must type the page reference exactly as it appears in Mingle with the same capitalization.)
|
See [[Mingle_Markup]] for details |
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 |
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 card, or you can also make the graphic display on the card.
See the table below for the markup to apply.
Note: 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 card, double-check the exact file name at the bottom of the card after saving.
| Formatting |
Markup |
Preview |
|
Link to an image
|
!Mingle_Logo.png! |
|
| Link to an image on an external website |
!http://studios.thoughtworks.com/mingle/images/Mingle_Logo.png! |
|
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 card (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 card.
If you have also made the graphic display on the card, you must also click the Edit link and remove the 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 card.
Back to Working with cards