Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Section
Column
width60%

The Gliffy Confluence Plugin allows users to incorporate flowcharts and diagrams on pages in order to communicate more effectively. Gliffy provides an the easy way to create professional-quality flowcharts, diagrams, floor plans, technical drawings, and more. All diagrams are stored inside Confluence. To add a Gliffy diagram to a page, simply go under the Add menu in the upper right of any Confluence page and select Diagram.

Please see the Gliffy Confluence Plugin page at the Gliffy site for additional information, applications, and examples.

 

Gliffy Macro Usage

When a diagram is added to a page, the Gliffy macro is placed within the text body of the page. The macro, which appears as {gliffy:name=DiagramName}, is visible in Edit mode. A number of parameters, or attributes, can be applied to the macro to take advantage of additional options. These parameters are described in the Full notation guide (a link to which is available on the right side of any page in Edit mode) and in the left column in the following table. Multiple parameters can be applied to a single diagram; each parameter should be separated by the pipe, "|", character.

Column
width40%
Panel
titleBGColor#B0C4DE
titleTopics
Table of Contents

Usage: {gliffy:name=DiagramName|parameter1=setting1|parameter2=setting2|...}

Parameter

Inclusion

Summary

name

required

The name of the diagram. This name must be unique for the current page.

space

required if page attribute used, otherwise optional

The space key of the page to which the diagram is attached. (Used to display a diagram on multiple pages.)

page

required if space attribute used, otherwise optional

The name of the page to which the diagram is attached. (Used to display a diagram on multiple pages.)

pageid

optional

The id of the page to which the diagram is attached. (An alternative to using the space and page attributes.)

size

optional, default is L

The size of the image that will be shown. Possible values are L (full size), M (medium), S (small), and T (thumbnail)

align

optional, default is left

Horizontal alignment of the diagram image on the page. Possible values are left, center, and right.

alt

optional, default is diagram name

Image tag alternative text.

border

optional, default is true

Display the border around an image.


Copying Pages
Section
Column

When a page containing a Gliffy diagram is copied, the diagram is copied as part of the new page. However, the diagram may not display on the new page until the version parameter is removed from the {gliffy} macro.

As a diagram is updated, the {gliffy} macro automatically updates itself to display the most recent version of the diagram using its version parameter:
{gliffy:name=Diagram|align=left|size=L|version=12}

When the page is copied, the version of the diagram on the copied page is reset to 1, but the macro on the copied page remains the same as on the original page. To allow the (copied) diagram to display properly, Edit the page and remove the version parameter:
{gliffy:name=Diagram|align=left|size=L}

Column


Using a Gliffy Diagram as a Template

An existing Gliffy diagram can be used as a starting template for a new diagram.

  1. On a wiki page, while in View mode, go under the Add menu and select Gliffy Diagram.
  2. After the Gliffy interface loads, the create a new document panel will display.
    Section
    Column
    width60%
    1. In the left column, select use an existing diagram.
    2. In the middle column, Spaces, locate and select the space containing the existing diagram. Note that the spaces account for capitalization in the sorting arrangement, with all capital letters preceding all lowercase letters.
    3. In the right column, Documents, locate and select the existing diagram.
    4. Click the create document button.
    Column
    width40%

  3. The diagram will be available to edit. After editing the diagram, still within the Gliffy interface, go under the file menu and select Save or Save and Close. A prompt will appear to provide the new diagram with a name. After typing a name, and setting additional parameters if desired, click the save button.
    • Selecting Save will keep the Gliffy interface open.
    • Selecting Save and Close will close the interface and return the browser to the wiki page.
    • Selecting Close by itself does NOT save any changes and will return the browser to the wiki page.