Get Started

Learn how to use the Advanced Codeblocks Macros and create your first codeblocks.

Accessing Advanced Codeblocks

To get started - add a Advanced Codeblocks Macro to your Confluence Page:

  1. Go to your Confluence Page and click edit.

  2. Select in the toolbar Insert more content > Other macros

  3. Now you can search for Advanced Codeblocks and should see three macros.

  4. Choose now between Advanced Codeblocks Multi, Advanced Codeblocks Multi Remote or Advanced Codeblocks Single and select it by clicking.

Create your first codeblocks with the Multi Macro

To create your first codeblocks, follow the steps above and:

  1. Choose the Advanced Codeblocks Multi Macro.

  2. You will get to the Insert Advanced Codeblocks Multi screen where you can adjust the parameters.

  3. For the beginning we assign our codebox the Title My first codeblocks and enable Show Download Links.

  4. Click on Insert.

In the preview you see a message that you have to feed the Advanced Codeblocks Multi with content. This will happen in the next step.

Now you get back to your Confluence Page with the inserted Advanced Codeblocks Multi Macro. The codebox body is still empty so we're going to feed it with some content.

  1. Copy the following code "My first codeblocks" and paste it into the macro body.

  2. Click on Save.

  3. The output will be a codebox with two codeblocks testsystem 1 and testsystem 2.

My first codeblocks
[testsystem 1]
server.domain = www.myserver1.com
document.root = /www/server1
[testsystem 2]
server.domain = www.myserver2.com
document.root = /www/server2

[content]
Listen 80
<VirtualHost *:80>
   ServerName ${server.domain}
   DocumentRoot "${document.root}"
</VirtualHost>

Create a single codeblock with the Single Macro

To create your first single codeblock, follow the steps above and:

  1. Choose the Advanced Codeblocks Single.

  2. You will get to the Insert Advanced Codeblocks Single screen where you can adjust the parameters.

  3. For the beginning we assign our codebox the Title Single Code Snippet Demo and enable Show Download Links.

  4. Also do we select the Theme called dark-spring.

  5. Click on Insert.

In the preview you see a message that you have to feed the Advanced Codeblocks with content. This will happen in the next step.

Now you get back to your Confluence Page with the inserted Advanced Codeblocks Single Macro. The codebox body is still empty so we're going to feed it with some content.

  1. Copy the following code "Single Code Snippet Demo" and paste it into the macro body.

  2. Click on Save.

  3. The output will be a codebox with a single codeblock import React ....

Plain Macro Body
The Advanced Codeblocks Single Macro outputs the macro body directly. No variable replacements are executed. If you need variable replacements from a base template use the Multi Macro.

Single Code Snippet Demo
import React from 'react'

const MyComp = () => <div>foo</div>

Celebrate!

Congratulations. You have created your first codebox with two codeblocks and variable replacements (Multi) and a codebox with a single code snippet (Single) and can now explore the user interface.