User Macro Language Reference

[Kevin Rappold]

I am new to Confluence macros but not to programming in general. So I know the types of things i want to do but can't find a very good reference style document on the language syntax of the user macro tool. The examples help but do not show all the variations, etc.

[Bill Bailey · Accepted solution]

Yeah, getting started writing complex macros is a bit of a challenge, mainly because it is a mix of Velocity and Confluence Java Objects (not all of which are available in the Velocity context).

So I use this as a reference: http://velocity.apache.org/engine/1.7/.

And this forum is a huge help. There are a few articles like these (mine is listed first):

• Confluence-articles/Getting-Started-with-User-Macros-Writing-a-Wrapper-Macro/ba-p/979571
• A-User-Macro-to-Create-a-Table-From-an-Attached-CSV-File-Par (Davin has written a few)

They help in learning some of the tricks for performing more complex task. And then just lots and lots of Internet searches (and unfortunately, velocity gets a lot of non useful hits).

But yes, a dummy's guide to Confluence macros would be very useful. It took me quite some time to come up to speed.

[Kevin Rappold]

thanks so much...this really helped me.