O objetivo deste tutorial é ensinar a criar um layout customizado no Confluence, sem precisar criar plugins, de uma forma bem simples e eficiente. Começaremos falando um pouco sobre como as páginas são montadas e em seguida iremos para a prática. Ao término deste tutorial o leitor terá conhecimento suficiente para customizar o Confluence criando layouts muito mais interessantes.

Como o Confluence monta as páginas

Antes de colocarmos a mão na massa é necessário sabermos como a página final é montada e como funciona cada parte dela. Abaixo estão os tipos de layouts do Confluence e os decoradores que fazem parte de cada um:

As descrições abaixo foram retiradas da própria página de configuração de layouts no Confluence.

Layout de site: São usados para desenhar os controles que envolvem cada página dentro do site. Se você deseja mudar a aparência do site: por exemplo mudar os headers ou os footers, mover menus ou adicionar links customizados, você irá querer modificar seu conteúdo.
Decorators:

• Main Layout - Define header e footer genéricos para todas as páginas do 'space'.
• Global Layout - Define a aparência do dashboard e do perfil dos usuários.
• Popup Layout - Janelas Popup tais como o popup de histórico de usuário são exibidos usando este layout.
• Printable Layout - O layout usado para exibir as páginas quando o usuário clica no ícone printable no canto superior direito da página.

Layouts de conteúdo: Controlam a aparência do conteúdo tais como páginas e itens de notícias: eles não mudam a forma como as páginas propriamente ditas são exibidas, mas eles lhe permitem alterar como os comentários são circundados ou como os arquivos anexados são exibidos.
Decorators:

• Space Layout - Controla como o space é exibido.
• Page Layout - Controla como a página é exibida.
• Mail Layout - Controla como mail é exibido.
• Blog Post Layout - Controla como um blog post é exibido.

Layout de exportação: Layouts de exportação controlam a aparência dos spaces e das páginas quando eles são exportados para o HTML. Se você usa o Confluence para gerar um website estático, ou você comumente distribui HTML exportado de páginas ou spaces, provavelmente você vai querer modificar esses layouts.
Decorators:

• Space Export Layout - Quando você exporta um space para HTML, este layout é usado para gerar a página index.
• Page Export Layout - Quando você executa uma exportação, cada página é convertida para um HTML usando este template.

Como já deve ter imaginado, o conteúdo que estaremos gerando, na realidade, são templates do Velocity. A partir deles o Confluence monta a página e a disponibiliza para o usuário na Internet. No escopo destes templates o Confluence disponibiliza algumas variáveis e macros que podem possuir recursos ou informações importantes para o layout que está sendo desenvolvido. Consulte a lista nos links informados.