Using the wiki toolbar
Most common wiki formatting tasks are available as buttons in the wiki toolbar. The toolbar also allows you to insert template macros for creating tables, graphs, links and layout in wiki pages.
Using the wiki toolbar to format text
To use the toolbar to format text, select the text to format and click on the relevant icon in the toolbar.
Bold text
To bold text, select the text and click on the toolbar icon
The third *word* in this sentence is bold
Preview
Italicize text
To italicize text, select the text and click on the toolbar icon
The third _word_ in this sentence is italicized
Preview
Underline text
To underline text, select the text and click on the toolbar icon
The third +word+ in this sentence is underlined
Preview
Strike-through text
To strike-through text, select the text and click on the toolbar icon
The third -word- in this sentence is struck-through
Preview
Color text
To change the color of text, select the text and click on the toolbar icon
The third %{color:red}word% in this sentence is red
The third %{color:#FF0000}word% in this sentence is red
Preview
The default color is red, to change the color either replace "red" in the markup with one of the other 16 web colors. W3C has listed 16 color names that will validate with any HTML validator. The color names are: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, and yellow. There are 150 cross browser color names you can use in addition.
You can otherwise type in a hexadecimal color value, as shown in the second line of markup.
Apply heading level
To apply header styling to a line of text, select the line and click on the appropriate heading level icon
h1. This line is H1 heading
h2. This line is H2 heading
h3. This line is H3 heading
Preview
For a heading style to be applied there must be a blank line both above and below the line you're styling. If the preview looks like this:
h1. This line is H1heading then you probably don't have the necessary blank lines.
Create bulleted list
To create a bulleted list, select the rows that will comprise the list and click on the toolbar icon
* list item one
* list item two
* list item three
Preview
Create numbered list
To create a numbered list, select the rows that will comprise the list and click on the toolbar icon
# list item one
# list item two
# list item three
Preview
Right indent text
To right indent text, select the text to be indented and click on the toolbar icon as many times as you want the text to be indented (each click adds a level of indentation rightwards)
p(. right indent once
p((. right indent twice
p(((. right indent three times
Preview
For right indenting to be applied there must be a blank line both above and below the lines you're styling. If the preview looks like this:
p(. right indent onceheading then you probably don't have the necessary blank lines.
Left indent text (Outdent)
To left indent (outdent) text, select the text to be indented and click on the toolbar icon as many times as you want the text to be outdented (each click removes a level of right indentation)
p. a fully outdented line
Preview
Left indenting has no effect except to remove a level of right indentation. Once there are no levels of right indentation remaining, the text will just remain left justified.
Inline images
To show images inline, attach the image to the card or wiki page and use the following markup:
!imagename!
Preview
If the image is attached to another card or page in Mingle you can use the following markup: !#card number/imagename! e.g. !#1/Picture_1.png! or !page name/imagename! e.g. !QA Central/Picture_1.png! to display them.
Inline links
To show links inline, use the following markup:
"name":url
Preview
If you want to link to an attachment on the card or wiki page in Mingle you can use the following markup: [[#card number/filename] e.g. [[#1/Mingle.txt]] or [[page name/filename]] e.g. [[QA Central/Mingle.txt]]
Using the wiki toolbar to create charts and tables
Charts
Wiki page Layout
You can use one or two column layout blocks to organize information in a wiki page or card. In Mingle this kind of layout is often referred to as a dashboard.
You can take a look at this example project overview page to see how that might look with some charts and tables included.
One-column layout
To create a single column layout block, this will create a named section within a wiki page which spans the wiki page and encloses other wiki content.
{% dashboard-panel %}
{% panel-heading %}A heading for the layout{% panel-heading %}
{% panel-content %}
Some wiki content for layout
{% panel-content %}
{% dashboard-panel %}
Preview
Where you would substitute appropriate text and content for A heading for the layout, and Some wiki content for layout respectively. The layout content can include any other wiki formatting or content, however nesting layout blocks is not recommended except as part of a two-column layout.
Two-column layout
To create a two column layout block, this will create a set of named sections within a wiki page, organized into two columns of equal width.
{% two-columns %}
{% left-column %}
{% dashboard-half-panel %}
{% panel-heading %}Top Left heading{% panel-heading %}
{% panel-content %}
Top Left content
{% panel-content %}
{% dashboard-half-panel %}
{% left-column %}
{% right-column %}
{% dashboard-half-panel %}
{% panel-heading %}Top Right heading{% panel-heading %}
{% panel-content %}
Top Right content
{% panel-content %}
{% dashboard-half-panel %}
{% right-column %}
{% two-columns %}
{% two-columns %}
{% left-column %}
{% dashboard-half-panel %}
{% panel-heading %}Second Left heading{% panel-heading %}
{% panel-content %}
Second Left content
{% panel-content %}
{% dashboard-half-panel %}
{% left-column %}
{% two-columns %}
Preview
Where you would substitute appropriate text and content for xxx left/right panel, and Some content. You can add multiple
{% dashboard-half-panel %}
blocks on each side of the layout.
Mixed column layout
This is an example of using both one-column and two-column layout blocks in the same page
{% dashboard-panel %}
{% panel-heading %}A heading for the layout{% panel-heading %}
{% panel-content %}
Some wiki content for layout
{% panel-content %}
{% dashboard-panel %}
{% two-columns %}
{% left-column %}
{% dashboard-half-panel %}
{% panel-heading %}Top Left heading{% panel-heading %}
{% panel-content %}
Top Left content
{% panel-content %}
{% dashboard-half-panel %}
{% left-column %}
{% right-column %}
{% dashboard-half-panel %}
{% panel-heading %}Top Right heading{% panel-heading %}
{% panel-content %}
Top Right content
{% panel-content %}
{% dashboard-half-panel %}
{% right-column %}
{% two-columns %}
{% two-columns %}
{% left-column %}
{% dashboard-half-panel %}
{% panel-heading %}Second Left heading{% panel-heading %}
{% panel-content %}
Second Left content
{% panel-content %}
{% dashboard-half-panel %}
{% left-column %}
{% two-columns %}
Preview
Section line
Creates a section line separating sections of text
Section one
---
Section two
Preview
Macros
The project macro
The project macro icon will print out the current project's project identifier.
You do not need to put project name. Just use the macro syntax provided as below will return the identifier for current project.
{{ project }}
Preview
The project variable macro
The project variable icon allow users to view the value of any project variable on current project.
{{
project-variable
name: (Current_Iteration)
}}
Preview
The average query macro
The average query macro allow users to get the average value of the specified numeric property. The outcome of average query is returned in numeric format.
{{
average query: SELECT 'Planning Estimate' WHERE Type = Story and Iteration = 'Iteration 1'
}}
Preview
The value query macro
Using the value query macro user can simply display the value of the specified property or aggregate the value and then display. The outcome of the value query can be numeric, text or date.
{{
value query: SELECT value_or_aggregate WHERE condition1 AND condition2
}}
Example
The value query is often used to refer any specific value in a sentence or table for reporting purposes.
The planned size for 'Iteration 1' is {{value query: SELECT 'Planned Size' WHERE Type = Iteration and name = 'Iteration 1'}}.
The total number of stories for 'Iteration 1' is {{ value query: SELECT Count(*) WHERE Type = Story and Iteration = 'Iteration 1' }}.
The priority of story #117 is {{ value query: SELECT Priority WHERE number = 117 }}.
The Start date of 'Iteration 1'= {{ value query: SELECT 'start date' WHERE Type = Iteration and name = 'Iteration 1' }}.
Preview
