FAQ
Is it possible to export Git assets to PDF or Word?
You can export Git files content as part of a PDF or Word export of your Confluence page.
The other Git assets are not considered. If you require them, please contact us via support@mibexsoftware.com.
Render PlantUML diagrams in Confluence based on versioned files in your private Bitbucket repository
By combining Include Bitbucket for Confluence app with PlantUML for Confluence app,
you can have your PlantUML diagrams definitions versioned in your private repository and still enjoy them rendered on your Confluence page.
To get that:
use the PlantUML Render macro and within this macro,
use the Bitbucket file macro with option Hide File Header checked
to include the PlantUML file from your repository.
For more details, please check documentation of PlantUML Render macro.
Why do I get an error when enabling Include Bitbucket for Confluence app after update to 2.0.3 or newer?
If Include Bitbucket for Confluence app fails to be enabled after an update, but producing similar error in the log:
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'markupParsers': Cannot create inner bean '(inner bean)#67aa14d9' of type
[org.eclipse.gemini.blueprint.config.internal.adapter.OsgiServiceLifecycleListenerAdapter] while setting bean property 'listeners' with key [0]; nested exception is
org.springframework.beans.factory.BeanCreationException: Error creating bean with name '(inner bean)#67aa14d9': Invocation of init method failed; nested exception is java.lang.IllegalArgumentException: Custom
bind method [addParser] not found on class class com.sun.proxy.$Proxy3483
...
Workaround:
Uninstall Include Bitbucket for Confluence app
Restart Confluence
Install version 2.0.3 or newer of Include Bitbucket for Confluence.
Enabling Include Bitbucket for Confluence app should work now.
Please let us know, if this workaround does not work for you. Thanks.
Can I add custom syntax highlighting for a programming language missing from the list of syntax options in the macro's editor?
For app versions 1.14.0 +
custom brushes for additional languages are not supported anymore due to technical problems in combination with other apps not provided by us.
For app version up to 1.13.5
We support custom syntax highlighting languages in the app, up to version 1.13.5.
You can add support for custom programming languages in the Confluence admin area:
General configuration -> Configure Code Macro -> Add a new language
You need a so called "brush" file for your new programming language. See this page about the format of these files and where you can find existing brushes.
After you have done this, you should be able to see your new programming language in the list of supported programming languages in the plug-in's macro configuration dialog.
Why do I get an error saying âConfluence New Code plug-in not foundâ?
This error indicates that the app cannot find the Confluence Code Viewer. The Code Viewer is shipped with Confluence in the âCode Macro Pluginâ and enabled by default. If you see the error message above, for some reason it isnât enabled.
Please check and enable the Code Macro Plugin:
Go to the âManager add-onsâ in the Confluence admin: âGear-Icon'->Add-ons
Select âAll Add-onsâ in the drop down menu
Search for the âCode Macro Pluginâ
Expand it, check the Add-on key, it should be âcom.atlassian.confluence.ext.newcode-macro-pluginâ
If the âCode Macro Pluginâ Add-on is disabled, you have to enable it in order to make Bitbucket for Confluence work
If the âCode Macro Pluginâ is missing or has another add-on key as listed above, please let us know and tell us the Confluence version
Why are my binary files rendered in plain text?
As of the v2.3.0 release, you may have noticed a difference in behaviour. If you ever edited a macro for a binary file and set it to 'Plain Text', we will now render it as such after this release. If you want to change this then the user has to manually unselect the Plain Text option.
Editing pages is no longer possible, how do I fix the problem?
There may be an incompatibility our plug-in has with some other plug-ins and specific Confluence versions causing this issue.
The quickest way to fix the issue seems to be to use compatible version ranges and there are two options to follow:
Upgrade to the latest Confluence version (7.20 as of this post):
Using the latest version (2.3.0) of Include Bitbucket for Confluence works on Confluence 7.20
If upgrading to the latest Confluence version is not an option then stay on the older version and downgrade Include Bitbucket for Confluence to 2.2.5
Using the older Include Bitbucket version 2.2.5 seems to work fine with that Confluence version.
How is authentication handled to access private resources?
Confluence Edition | Bitbucket Edition | Authentication |
---|---|---|
Confluence Data Center | Bitbucket Cloud | The app uses an app password. A confluence user does not need an individual Bitbucket login. Every Confluence user can view included Bitbucket files. |
Confluence Data Center | Bitbucket Data Center | The app uses an application link. Every user needs also a Bitbucket account. The user needs permissions on Bitbucket to see the file. |
Do you support advanced links embedded in an AsciiDoc?
Advanced links such as {asciidoc-dir}/../../shared/versions/stack/{source_branch}.adoc
are currently not supported and we display in the included file.
Why are images within a Markdown or AsciiDoc not rendered?
When including images in AsciiDoc or Markdown files, you should be able to include the images using absolute paths instead of relative paths:
AsciiDoc
=== Picture 1 Block
image::/images/Example.png[]
=== Picture 2 Inline
image:/images/Example.png[]
Markdown
![Alt text](src/images/image.png)