Book Image

Atlassian Confluence 5 Essentials

By : Stefan Kohler
Book Image

Atlassian Confluence 5 Essentials

By: Stefan Kohler

Overview of this book

Every idea, concept, and project needs documentation, which is traditionally kept in a variety of documents on different devices. Confluence 5 centralizes that documentation and provides it in one single location, available from almost any device and location. Atlassian Confluence 5 Essentials is a practical, hands-on guide explaining not only how to install and administrate Confluence, but also everything you need to create, share, and collaborate on your documentation. This book will give you everything you need to get started with Confluence. Before you can start creating content, Confluence needs to be available. That is exactly where we start with this book; installing Confluence. Through a number of clear, practical exercises you will go from installation and administration, to creating content and involving your teammates. This book will teach you how to quickly create compelling content. You will learn how to involve your teammates in the process, using the Confluence workbox and share features. You will learn how Confluence can be customized with regards to look and feel, extra functionality, and integration with other tools, so that there is nothing in your way when you want to introduce Confluence 5 within your organisation. If you need to develop better collaboration on mission critical projects, then this book is for you!
Table of Contents (17 chapters)
Atlassian Confluence 5 Essentials
Credits
About the Author
About the Reviewers
www.PacktPub.com
Preface
Index

Building your first plugin


When you have installed the Atlassian SDK, you can start building your first plugin. We will be building a new Confluence macro, which can be used to format content.

We will take a look at:

  • The macro interface, which is the base of all macros

  • The xhtml-macro module

  • Adding resources, such as a stylesheet, to your plugin

We will be building a macro that displays links as buttons.

Creating the plugin project

First, we have to create our plugin skeleton using the Atlassian SDK and load our new project into Eclipse.

  1. Open a command prompt and navigate to the location for you new plugin.

  2. Enter the following command to create a new Confluence plugin:

    atlas-create-confluence-plugin
    
  3. When prompted, enter the following information to identify your plugin:

    groupId

    com.example.confluence

    artifactId

    button-macro

    version

    1.0-snapshot

    package

    com.example.confluence.button

  4. Confirm your entries when prompted.

  5. Start Eclipse.

  6. Select File | Import... from the Eclipse menu...