FAQ ☁️
Is it possible to export Git assets to PDF or Word?
Yes, you can export Git assets (including files and other content) as part of a PDF or Word export of your Confluence page.
Can we access data from a Bitbucket instance protected by a firewall?
It depends on your exact setup. You can opt-in for static-IPs for all the traffic from Include Bitbucket for Confluence Cloud. Then allow traffic through your firewall from these IPs. Read the documentation for the exact requirements.
Is it possible to include data from a private repository from Bitbucket Cloud?
Yes, data from a private repository can be included from Bitbucket Cloud. Just add the macro you need (e.g. Bitbucket File) with the details of the data you want to include, and the app will show a link to grant access to the repository.
How is authentication handled to access private resources?
Confluence Edition | Bitbucket Edition | Authentication |
---|---|---|
Confluence Cloud | Bitbucket Cloud | There are options: OAuth: Every Confluence user needs to authenticate via OAuth to Bitbucket Cloud in order to access included private repository files. They must have a Bitbucketaccount as well. They only see private files they see on Bitbucket Cloud as well. Shared Access Token: All Confluence users access Bitbucket Cloud with a configured access token. They do not need any account on Bitbucket. They see included files which the token has access to. |
Confluence Cloud | Bitbucket Data Center | An access token of a specific user is shared and used for all Confluence Users. |
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)
How can I resize images in my files so they don’t take the full width and height?
You can add custom sizes to images in Markdown using HTML. While Markdown is great for formatted text, it doesn't natively support resizing images. But with the img
tag, you can easily control image dimensions.
For example:
<img src="image.jpg" width="400" height="400"/>
Can I customize the file layout when exporting via PDF (e.g. image size)?
Yes, you can customize the layout for PDF exports, including the image size, by modifying the Confluence PDF stylesheet. For example, adding the following CSS rule to the PDF stylesheet will ensure that the images in the exported file are displayed at the same size:
img { width: 85%; height: 85%; }
For more details on customizing PDF exports, you can refer to the official Atlassian documentation: Customize Exports to PDF.
How can I include the C4-PlantUML library in my .puml
files so the app renders them?
You can use !include <C4/C4_Container>
for including the C4-PlantUML library.
Example:
@startuml
!include <C4/C4_Container>
Person(personAlias, "Label", "Optional Description")
Container(containerAlias, "Label", "Technology", "Optional Description")
System(systemAlias, "Label", "Optional Description")
System_Ext(extSystemAlias, "Label", "Optional Description")
Rel(personAlias, containerAlias, "Label", "Optional Technology")
Rel_U(systemAlias, extSystemAlias, "Label", "Optional Technology")
@enduml
Reference: https://plantuml.com/stdlib#062f75176513a666
Branches with Slashes
Branches with slashes in their name (eg bugfix/issue-123
, feature/abc
) are supported. You can copy and paste the Bitbucket File URL from the branch into Confluence in order for the app to pick it up.
How can I include the PlantUML Standard library?
To use the official Standard Library for PlantUML, you can use the following syntax in the PlantUML file:
!include <awslib/AWSCommon>
!include <awslib/Groups/all>
!include <awslib/ApplicationIntegration/MQ>
!include <awslib/Database/DocumentDB>
!include <awslib/Database/RDS>
!include <awslib/Containers/Containers>
!include <awslib/Storage/SimpleStorageService>
!include <awslib/Storage/SimpleStorageServiceGlacier>
!include <awslib/ApplicationIntegration/APIGateway>
!include <awslib/SecurityIdentityCompliance/Cognito>
!include <awslib/Database/DocumentDB>
!include <awslib/Database/RDS>
!include <awslib/Compute/Lambda>
!include <awslib/InternetOfThings/IoTThingGeneric>