The Excerpt Macro is used to mark a part of a page's content for re-use. By itself, the excerpt macro does not change the display of a page. However, defining an excerpt enables other macros such as excerpt-include and blog-posts macros to display the specified content elsewhere.
A page can only have *ONE* excerpt.
The Code
{excerpt}
Content to be included on another page.
{excerpt}
This is the plugin libraries navigation bar, which was created using the excerpt and excerpt-include macros. The panel displays the name of the page where the 'excerpted' content is being pulled from. It can be removed by adjusting the 'nopanel' parameter (see below):
If any changes are made to the content within the body of the excerpt macro, it will automatically be changed on any pages it is being 'excerpted'. This makes the excerpt and excerpt-include macros ideal for creating navigation bars.
Controls whether the square panel border around the excerpt should be removed. Also controls whether the name of the page where the 'excerpted' content is being pulled from is displayed.
Displays the most popular labels used throughout a Wiki space.
Specifies the total number of labels to display in the heatmap.
spacekey
none
Restricts the list of popular labels to the specified space.
style
list
Displays the list of popular labels in standard bullet-point 'list' form or as a 'heatmap'. The heatmap style uses different font sizes depending on their rank of popularity, ordered by label names. The list style orders labels by popularity (highest first).
Generates a list of content associated with a specific label or labels.
The 'sort' attribute is an optional attribute that allows you to configure how the children are sorted. Use the 'reverse' attribute to optionally reverse the sorting.
operator
OR
The operator to apply to the supplied lists of labels. By default, a page with any of the labels will be listed. By using operator=AND, only pages with all of the supplied labels will be listed.
Lists all tagged labels from every page which has one or more labels in common with the current page.
Specifies the total number of labels to display in the list.
scope
global
Specifies the scope of labels to be displayed in the list. Valid values include:
global — covers all non-personal spaces in the Confluence installation.
space — the current space.
personal — your own personal space.
style
list
Displays the list of recently used labels in a horizontal 'list' style or in a 'table' style. The table style includes additional information such as the page to which the label was added user who added it.
title
none
Adds a title to the top of the list in table style. Titles are only visible when the List Style (style) parameter has been set to table.
Creates a hyper-linked alphabetically listed index of all labels within the current space.
Specify which page to display children for in a current space or in a different space. If the page parameter is '/', then the macro will list all the current space's top-level pages i.e. those without parents. If the page parameter is a space key followed by a colon (e.g "children:page=DOC:"), then the top-level pages of that space will be listed.
depth
none
Specify the depth of descendents to display.
If your *children* macro includes both 'all=true' and 'depth=X' parameter-value combinations where X is a number, 'all=true' takes precedence. If an 'all=false' and 'depth=X' parameter-value combination is used, 'depth=X' takes precedence.
first
none
Restrict the number of children displayed at the top level.
style
none
Specify the style in which descendents are displayed.
excerpt
false
Display the child pages' excerpts, if they exist.
sort=creation sort=title sort=modified
Manual if manually ordered, otherwise alphabetical
he 'sort' attribute is an optional attribute that allows you to configure how the children are sorted. Specify 'creation' to sort by content creation date, 'title' to sort alphabetically on title and 'modified' to sort of last modification date.
reverse
false
Use this parameter in conjunction with the 'sort' parameter described above. Set 'reverse=true' to change the sort from ascending to descending order.
The search macro searches your Confluence site based on search terms specified in the macro code, and displays the results on the wiki page.
Page:Help(Praxis) ... trouble logging in to the Community Forum page, please contact us mailto:praxis@mit.edu for help. The rest of this site does not require login to view the content. Receiving error messages ... Sep 10, 2007 16:38
Page:Help!(YaWHOI!) ... can be added as help text inserturlhere. I recommend putting the URL itself as help text since we will print the most current version of the handbook every year ... can add content using the Rich Text editor too. For wiki markup ... Sep 17, 2013 17:24
Page:Help(PAOC-Labguide) ... Below is an example: tank5.jpg Launch Video http://paoc.mit.edu/labweb/lab1/taylorclip.mpg Advanced Users To find help on advanced posting syntax, go here https://wikis.mit.edu/confluence/renerer/notationhelp.action?section=all Migrated to Confluence 4.0Posting Help Mar 24, 2009 16:12
Space:Wiki Help user guide and support documentation for the MIT wiki service Jul 28, 2009 15:29 Labels: news, help, training, support
The search terms which this macro will use to generate its results. You can refine your search query by using operators such as 'AND' and 'OR'. For example:
In the macro browser Search Terms entry box: my_query1 AND my_query2
In wiki markup editor: "search:query=my_query1 AND my_query2"
maxLimit
no limit
Set a limit to the number of search results displayed.
spacekey
all
Specify the key of the space you want to search in. Note that this is case sensitive.
type
all
Specify the content type. The content types are: page, comment, blogpost, attachment, userinfo (the content of user profiles only), spacedesc (the content of space descriptions only) and mail.
lastModified
all
Specify a period of time in weeks, days, hours and/or minutes, to see the content modified within that time frame. For example:
2h 35m
3d 30m These are the values you can use:
w = weeks
d = days
h = hours
m = minutes If no time category is specified, Confluence assumes minutes. If you specify more than one time period (e.g. weeks and days), the periods must be separated by a space and they can come in any order. The time categories are not case sensitive e.g. '4d' is the same as '4D'.
contributor
all
Specify the username of a Confluence user, to show only content created or updated by that user.
The index macro creates a hyper-linked alphabetical index of all pages within the current space.
The top section of the Index contains a cell for letter of the alphabet, including separate cells for numbers and symbols. Each of these cells indicates the number of pages in which the first letter of the title matched the corresponding letter, number or symbol in the cell.
The lower section is effectively an extended version of the top section. However, each cell shows the page name followed by the first few sentences of content on that page.
Error: The XML content could not be parsed. There is a problem at line 196, column 3. Parser message: Unexpected close tag </p>; expected </xml>. at [row,col {unknown-source}]: [196,3]
The gallery macro displays a gallery of thumbnail images in a table, based on the images attached to a Wiki page. When viewing the page, a user can click a thumbnail image to zoom into the full-size image and then view the images as a slide show.
The gallery will ignore any pictures specified by exclude=picture file name i.e. they will not be included in the gallery. You can specify more than one picture, separated by commas. Example: exclude=my picture.png,my picture2.gif.
include
nclude all the pictures on the page.
If you specifically include one or more pictures, the gallery will show only those pictures. Format is include=picture file name. You can specify more than one picture, separated by commas. Example: include=my picture.png,my picture2.gif.
page
current
Specify the title of the page which contains the images you want displayed. If the page is in the same space as the page containing the macro, use the format page=My Page Name. To specify a page in a different space, use page=SPACEKEY:My Page Name, such as page=DOC:Gallery Macro.
reverseSort
Nothing, i.e. sort order is ascending.
Used in conjunction with 'sort' parameter above. Use 'reverseSort' to reverse the sort order, from ascending to descending.
sort
None i.e. the sort order is unspecified and therefore unpredictable.
Specify an attribute to sort the images by that attribute. Sort order is ascending, unless you specify the 'reverseSort' parameter (see below). Options are:
'name' – file name.
'comment' – comment linked to the attached file.
'date' – date/time last modified.
'size' – size of the attached file.
Creates a table displaying the history of a page including version number, author, date and any comments associated with the change.
Error: The XML content could not be parsed. There is a problem at line 7485, column 6. Parser message: Unexpected close tag </form>; expected </input>. at [row,col {unknown-source}]: [7485,6]
Error: The XML content could not be parsed. There is a problem at line 9, column 9. Parser message: Unexpected close tag </div>; expected </input>. at [row,col {unknown-source}]: [9,9]
Specify the label associated with the pages you want to show in the navigation map.
title
none
Specify a title for the navigation map.
wrapAfter
5
Specify the number of cells in a row.
cellWidth
90px
Specify the cell width.
cellHeight
60px
Specify the cell height.
theme
Confluence
Define a theme for the navmap. If you want to create your own navmap 'look and feel' (for example, one with rounded corners), you need to add a customised navmap macro theme file to the WEB-INF/classes/templates/macros directory. The file name convention to use is navmap-mytheme.vm. Use the name of your choice for the mytheme part of the file name, which is also the value you use for this parameter. Hence, if your theme was called navmap-roundededges.vm, use the value of roundededges for this parameter.
