How to add wiki markup to all pages in the Documentation theme?

Hi,

we're using Documentation Theme, that doesn't allow you to customize layouts.

So, what should we do?

If we switch to another one, we'll lose our current settings (colors, fonts, etc).

We just want to add one macro at all the pages below the context.

Please help!

3 answers

1 accepted

This widget could not be displayed.

You can customise theme's Page Layout (ie. page.vmd) to do that. For documentation theme, you'll need to edit confluence-install/confluence/WEB-INF/classes/com/atlassian/confluence/setup/atlassian-bundled-plugins.zip/doctheme-x.x.jar/doctheme/decorators/page.vmd. And add anything you want after where the content is. You can create the content as a user macro, and then add the macro in the layout, for example:
<div class="wiki-content">
$body
</div>
<div id="additional">
$helper.renderConfluenceMacro("{cheese}")
</div>

It's either you extract the jar, modify and rezip it to atlassian-bundled.plugins.zip, or you upload the modified jar as a plugin which will replace the bundled one. You might want to refer to this documentation.

This widget could not be displayed.

and can I insert Wiki markup this way?

I believe you meant macro, which is a yes, I have edited my answer above. If what you meant is a wiki markup, you might want to create that as a user macro, then just add the user macro in the layout.

This widget could not be displayed.

Super! Thanks a lot!

By the way, is it true if we upgrade our Confluence instance from 3.5 say to 3.6 or whaterver, such changes will be lost?

Yes, those changes will need to be made manually when upgrading to a newer version of Confluence. Please refer to our documentation for guidance on this process:

http://confluence.atlassian.com/display/DOC/Upgrading+Custom+Layouts

We're currently building a new Windows/Linux Installer for Confluence 4.0 which will address issues with upgrading customisecd instances in a future release.

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published Jul 30, 2018 in Confluence

How Manon Soubies-Camy uses Confluence + Trello to organize webinar notes and her knitting stash

@Manon Soubies-Camy is an engineer who has been an avid Atlassian user since 2014. She helps companies of all sizes transform the way they work with the Atlassian stack, including Jira and Confl...

854 views 8 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you