Confluence Docs 3.3 : Working with the Macro Browser
This page last changed on Jul 06, 2010 by alui.
The Macro Browser allows you to browse through Confluence's extensive range of packaged macros and preview them using a combination of selected parameters before adding them to your page. The Macro Browser provides access to all available macros in a Confluence installation, with the exception of User Macros. If additional Confluence macros have been installed on your Confluence server (for example, via the installation of a non-bundled plugin), these will also be accessible from the Macro Browser. On this page: Accessing the Macro BrowserYou can access the Macro Browser whenever you add or edit a page, blog post or comment. To access the Macro Browser,
Screenshot: Macro Browser Each macro is presented on the right-hand side of the Macro Browser by its icon, its name and a brief description of its function. Browsing for a MacroSince the Macro Browser contains 80+ individual bundled macros, it is designed to facilitate the selection of the specific macro you require, by providing two quick methods for narrowing down the entire list of macros. When the Macro Browser is first opened, it is in 'macro selection' mode. Restricting the Macro List by CategoryEach macro is assigned to one of these categories. Clicking on one of these category names reduces the list of macros to those macros associated with the chosen category only. Screenshot: Macro Browser List Restricted by Category
Restricting the Macro List by Word SearchThe search field at the top of the Macro Browser allows you to reduce the list of macros based on words (or parts of words) contained within the macro's name or its description. As you start typing a word, the macro list restricts to only those macros whose name or description matches the characters you have entered. Screenshot: Macro Browser List Restricted by Word Search
Choosing a Macro, Modifying and Inserting it onto a Page or Blog PostTo choose a macro, modify and insert it onto a page or blog post,
Inserting a Macro via AutocompleteWhen using the Rich Text Editor, you can enter a trigger character to call up a list of suggested macros to add to your page. This feature is called 'autocomplete'. Autocomplete provides you with a fast editing solution if you prefer to use key strokes rather than pointing and clicking with the mouse. Quick summary: Use '{' to see a list of suggested links. For the details, see the page about autocomplete in the Rich Text Editor. Editing an Existing Macro with the Macro BrowserIt is possible to edit an existing macro using the Macro Browser, thereby allowing you to modify its existing parameters and preview the changes. To edit an existing macro with the Macro Browser,
Screenshot: Editing an Existing Macro with the Macro Browser in 'Macro Preview' Mode Macro Browser Smart FieldsIf a macro's parameter requires the entry of a single username, space key or page title, the macro browser provides an 'auto-complete' feature to help you enter the correct value. Use the up- and down-arrows on your keyboard to move up and down the dropdown list of matching items and select the appropriate item. This feature functions similarly to the Quick Navigation Aid when searching Confluence pages. Screenshot: Macro Browser Smart Fields RELATED TOPICSTake me back to the Confluence User's Guide. ![]() ![]() ![]() ![]() ![]() ![]() |
![]() |
Document generated by Confluence on Jul 09, 2010 01:08 |