Attaching objects and links to wiki pages
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), 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 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.
- Click the Save link.
Mingle updates the wiki page 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 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 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 wiki page, or you can also make the graphic display on the wiki page.
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 wiki page, double-check the exact file name at the bottom of the wiki page 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 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 must 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.
Back to Using the Mingle wiki