The KB used to be hosted on our very own Data Center (DC) servers. We have since migrated the KB to Confluence’s Cloud offering. While the pages themselves have transferred and are live, they still need to be “converted” to work with the Cloud’s page editor tool.
Here are some tips and tricks to help you navigate the conversion process:
Known limitations and workarounds:
This list will change as time passes
Adding macros
When adding a macro to the page, you’ll notice that it is placed at the bottom of the section/page. To work around this, place temporary Heading 2 text right below where you want the macro to be.
Macros break numbered lists
If you need to add a macro within a numbered list, switch the list to bulleted. The list is still broken, but it is not noticeable.
Adding images within macros
If your page had an image inside of a macro while it was being converted, you are all set; the image will remain inside the macro. You cannot add images inside a macro, other than Expand, in the cloud editor.
Note: an image inside a macro cannot be expanded by a click, the user must right-click to “open image in new tab”.
Embedded videos
In the past we used the HTML macro to embed videos on our pages, however this macro is not supported in the Cloud editor. Instead, we will use iFrame. This guide will show steps for a page that previous had an HTML macro, but you can find the info from the video’s source page (Kaltura) if needed.
Before converting the page to the Cloud editor, you will need to grab some information from the HTML macro.
Within the HTML macro, grab the video URL and paste it into a NotePad/Word doc for safe keeping. You only need what is in-between src=” and “ width. Notice that the whole segment is within quotation marks; that is what we need.
Convert the page into the Cloud Editor. Insert an iFrame macro and paste the video’s new URL into the URL box. Set the width to 608 and height to 400.