Include from GitLab to Confluence Cloud
Include from GitLab to Confluence Cloud
Breadcrumbs

Changelog

Maintenance

  • Update to third party dependencies

Bug Fixes

  • Fix Markdown strikethrough extension rendering

  • Fix certain relative paths not being resolved in AsciiDoc included files

  • Fix OAuth redirection flow for Confluence Live Pages

Maintenance

  • Update to third party dependencies

  • Documentation link update

  • Authentication flow update to prep for a future Forge requirement

Announcement

  • Continued Progress on Atlassian Forge Migration

    • As part of our ongoing migration of Include from GitLab to Confluence to the Atlassian Forge framework, we have now replaced the Get Started page with a new Forge-based module.

    • This update is another step forward in aligning with Atlassian's cloud app development standards. While this change modernizes our app architecture behind the scenes, it does not impact the user experience or functionality at this stage.

    • We’ll continue to roll out updates incrementally to ensure a smooth and transparent transition. For more information on the migration plan and future updates, please refer to our full communication here.

Announcement

  • 🚀 Preparing for Atlassian Forge Migration

    • As part of our efforts to transition Include from GitLab to Confluence to the Atlassian Forge framework, our first release focuses on converting to the Forge manifest file. This is a foundational step in the migration process and will not introduce any changes to the app’s functionality or user experience.

    • For a detailed overview of our migration plan, including key timelines and what to expect, please refer to our full communication here.

Maintenance

  • Update to third party dependencies

New Features

  • Added support for !include directives in PlantUML diagrams embedded in AsciiDoc and Markdown files.

    • Users can now include external PlantUML files using the !include directive for PlantUML embedded in Markdown and AsciiDoc files. This will enable better modularization and reuse of diagram components across files in the same repository.

Bug Fixes

  • Fixed an issue with relative images in AsciiDoc files not displaying and resulting in an error.

Announcement

New Features

  • Added support for !include directives in PlantUML diagrams.

    • Users can now include external PlantUML files using the !include directive, enabling better modularization and reuse of diagram components across files in the same repository.

Improvements

  • Enhanced navigation for Table of Contents links in Markdown and AsciiDoc files.

    • Previously, clicking a Table of Contents link would take the user to the source file in Git. Now, the links navigate directly to the corresponding section within the file in Confluence.

  • PlantUML diagrams are now visible when exporting Confluence pages to PDF using the Confluence PDF Exporter.

Maintenance

  • Update to third party dependencies

Maintenance

  • Upgraded to the latest Plant UML version

Maintenance

New Features

  • Supporting PlantUML in Markdown files 🥳

Improvements

  • Improved “Getting Started” Pages 😀

  • Ensure code block are syntax highlighted even when missing a language in the AsciiDoc file

Bug Fixes

  • Fix PDF Export duplicated images due to limitation with Confluence caching mechanism

  • Show error when migration Bitbucket workspace is not found

  • Fix issue with Markdown rendering failure with “illegal group reference“

Maintenance

  • Third party dependency updates

Improvements

  • Support rendering of Markdown block elements

  • Improve how AsciiDoc code blocks are displayed in Scroll Viewport

Bug Fixes

  • Display block img tags in Markdown

  • Display message regarding AsciiDoc syntax errors

Maintenance

  • Third party dependency updates

Maintenance

  • Upgrade to HTTP2

    • We are upgrading the app to use HTTP2. The installation of your app will be migrated usually within 48 hours to the new HTTP2 enabled domain.

Maintenance

  • Third party dependency updates

Bug Fixes

  • Support for alternative port for self managed GitLab instances

Improvements

  • Added additional languages for syntax highlight support

    • Q

    • reStructured

    • Groovy

    • Protobuf

  • Support PDF Export for meta-data macros like pull requests, etc

  • Add additional ports to authorised list for URL in app configuration

Bug Fixes

  • Ensured AsciiDoc styles are applied for AsciiDoc files.

Maintenance

  • Third party dependency updates

Announcement

  • Lifting limitation on OAuth process when in Incognito mode

    • We lift the limitation we previously had off the back of a security fix that affected the OAuth process when accessing content from private repositories, specifically under the following conditions:

      • Chrome

        • Incognito Mode: Browsers in incognito mode often block third-party cookies, which interferes with the OAuth authentication process.

      • Safari

        • Default Settings: Safari’s default setting, "Prevent Cross-Site Tracking," can prevent the necessary cookies from being shared across sites, disrupting the OAuth flow.

      • Firefox

        • Default Standard Settings: that includes Enhanced Tracking Protection and Total Cookie Protection. These protections interfere with the OAuth process, as it often relies on third-party cookies to manage authentication across different domains.

      • Other Browser Security Settings: If your browser has additional third-party security restrictions enabled (e.g., blocking third-party cookies), these settings can also impact the OAuth process.

    • Users under these conditions should now be able to follow the OAuth process normally.

Security

  • We've addressed a security vulnerability in the OAuth implementation.

    • Limitations:

      • The security fix introduces limitations that affect the OAuth process, specifically under the following conditions:

        • Chrome

          • Incognito Mode: Browsers in incognito mode often block third-party cookies, which interferes with the OAuth authentication process.

        • Safari

          • Default Settings: Safari’s default setting, "Prevent Cross-Site Tracking," can prevent the necessary cookies from being shared across sites, disrupting the OAuth flow.

        • Firefox

          • Default Standard Settings: that includes Enhanced Tracking Protection and Total Cookie Protection. These protections interfere with the OAuth process, as it often relies on third-party cookies to manage authentication across different domains.

        • Other Browser Security Settings: If your browser has additional third-party security restrictions enabled (e.g., blocking third-party cookies), these settings can also impact the OAuth process.

      • Refer to the FAQ for more details.

      • Action Required:

        • Re-authentication: All users will be required to re-authenticate with GitLab when using our app to render content from private GitLab repositories in Confluence.

        • Access Token Revocation: GitLab access tokens issued before this update have been revoked. Users are asked to configure the tokens again in the app configuration under the Confluence Admin settings.

    • Recommendations:

      • Review your account activity for any suspicious behavior and report it to our support team.

New Features

  • Confluence Cloud Dark theme support 🕶️

Improvements

  • Support inline HTML Image tags in Markdown

    • Example: Here is an inline image: <img src="image.jpeg" width="100" alt="Alt text"/>

Bug Fixes

  • CSV Table UI rendering

  • Files with spaces rendered

  • Handle Markdown link path url spaces in Markdown

Improvements

  • Add branch meta data to File Macro UI

  • Improve code block rendering in Markdown files

Maintenance

  • Third party dependency updates

New Features

  • Support Rendering Mermaid files (.mmd & .mermaid)

    • Now supporting Mermaid file as well as Mermaid in Markdown.✨

Improvements

  • Improved database encryption

  • Improved UI for all macros

Maintenance

  • Update to third party dependencies

Bug Fixes

  • Collapsible option should defaulted to true for file and directory macro

Maintenance

  • Third party library updates

Improvements

  • Show Title when rendering AsciiDoc files

Maintenance

  • Third party library updates

Bug Fixes

  • Fixed an issue where the settings page didn’t work with previously configured self managed GitLab instances.

Bug Fixes

  • Bug fix affecting Admins in non-default groups not being able to access settings. In newer Confluence sites, the roles names include the site name. Bugfix uses a more appropriate API to check if the user is an Administrator.

New Features

  • Collapsible File Option

    • Including files and directories has gotten easier with the collapsible file option. The option can be activated in the File & Directory macro configuration menu which will allow you to collapse and expand the files included.

Improvements

  • Supporting limited HTML in Markdown

    • Support for additional limited HTML within Markdown files has been added which will improve the rendering of HTML tables and certain HTML tags like <details> and <summary> .

  • Improved styling of Markdown tables

    • We have improved the styling of tables with Markdown to help you distinguish table content at a glance.

Bug Fixes

  • Support for rendering PlantUML files & blocks in AsciiDoc

  • Fix issue where images with spaces or special characters in their name couldn’t be included in Markdown

  • Slashes at the end of repos URL is handled correctly in the Pull Request macro

New Features

  • Support for Shared Access Token Authentication

    • By default Include GitLab for Confluence uses personal OAuth to access private repositories. This ensures that each Confluence user can only access private repositories that they have access to, but requires a that each user has a GitLab account.

    • You can change the authentication to a shared access token for all Confluence user. This allows all users to see included files without any GitLab account.

New Features

  • Mermaid Support

    • Mermaid in Markdown now supported & rendered. ✨

Security

  • Enhanced privacy and security measures taken to delete any data stored when app is un-installed.

New Features

  • PlantUML Support

    • Included PlantUML files are now supported and rendered. ✨

Maintenance

  • We released some updates related to normal maintenance and security.

Improvements

  • Adjust timeout so each included Asciidoc file has a 5 second fetch timeout to allow using Asciidoc files
    with many includes.

  • Increase file max limit of files from 20 to 50 rendered including for the Directory Macro

New Features

  • Support for Including Directories

    • You can now include all files in a directory at once with the new GitLab Directory macro. Include your configuration files, REST API docs and other documentation directories from GitLab to share with your team.

    • If you add new files or delete existing ones in a directory, the changes will be automatically reflected in the Confluence page.

Improvements

Improvements

  • Improved configuration panel layout.

  • Updated the Getting Started links.

  • Updated to the latest Scribe OAuth library.

Bug Fixes

  • Fixed bug where the static IP was not used for the OAuth authentication.

New Features

  • Support for Static IP

    • Do you want to include files or Git metadata from your GitLab self managed instance that is behind a firewall? You can now use a static IP for traffic from Include GitLab for Confluence Cloud, so that you can whitelist the app.

Improvements

  • Improved Breadcrumbs in Macros

    • We improved the breadcrumbs for the pull request and issues macros. It now also shows the filter applied and says what content is shown

Security

  • Disallowing using URLs which are not GitLab urls. This prevents including unexpected resources and having unexpected behavior if non-GitLab resources are included

New Features

  • Basic Support for CSV

    • CSV files are now rendered as a proper table:

Improvements

  • Improved Support for Various Languages

    • Added Syntax Highlighting for D, HCL, Objective-C, Swift

    • Improved Auto-Detection for Dockerfiles, HTML, Swift, Objective-C, HCL, Kotlin, D, Go

Improvements

  • Update in app links to new and improved documentation space

  • Add more file URL segment matchers in order to use copy and paste to render files

Bug Fixes

  • Allow relative links in Markdown to work properly and take the user to the url

New Features

  • Supporting GitLab Self Managed

    • Including from GitLab self managed repositories is supported. The GitLab domain has to be accessible via HTTPS and has not be behind a firewall.

    • Check the documentation for the initial setup.Improvements

Maintenance

  • Improved Security by upgrading to the latest version of some libraries

Bug Fixes

  • Add text to configuration to clarify that line number option is not available for Markdown & AsciiDoc files when using the File Macro

Maintenance

  • Improved Security by upgrading to the latest version of some libraries

New Features

  • Introducing a hide header option in the file macro configuration form

Improvements

  • Autodetect XSL file formats and render as XML

  • Add contrasting gray background color to source code in markdown so it is easier to read

Bug Fixes

  • Allow plain links to be rendered in Markdown

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Improvements

  • Added more file pattern matches in order to copy and paste files directly in Confluence pages.

Bug Fixes

  • Offer explicit logout in the Issue and Pull Request macro if user is logged in into multiple GitHub accounts.Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Improvements

  • Large image files included in the file macro are now scaled properly

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

New Features

  • In this release we have enforced the license for the app as announced in the previous release. Existing users who have not purchased a license will now need to purchase one in order to continue to see their GitLab macros.

Improvements

  • Allow users to enter a full repo URL in the issues and merge / pull requests macros allowing the macro to work seamlessly if the URL is used instead of the project path.

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

  • Improved Security by adding stricter Content Security Policies (CSP).

Maintenance

  • Improved Security by upgrading to the latest version of some libraries.

Improvements

  • Added an in-app warning message regarding the license requirement as announced in the previous release. Existing users who have not purchased a license will see a message appearing in their GitLab macros.

Announcements

  • We have converted Include GitLab for Confluence to a paid app off the back of some new features that we introduced recently like the GitLab Issue and Pull Request macros.

Bug Fixes

  • Offer explicit logout in the macro if user is logged in into multiple GitLab accounts

New Features

  • Include GitLab Issues in Confluence

    • Select the ‘GitLab Issues’ macro in Confluence to include issues from a GitLab project / repository.

New Features

  • Include GitLab Pull Requests in Confluence

    • Select the ‘GitLab Pull Requests’ macro in Confluence to include pull requests (also known as merge requests) from a GitLab project / repository in order to have an up-to-date version of it in a Confluence page.

Maintenance

  • Updated dependencies

Bug Fixes

  • Improved File Download Limits

  • Auto detect JSON file syntax highlighting

  • Accommodate extra spaces in macro parameters

  • Support GitLab URLs that do not contain dashes

Maintenance

  • Updated dependencies

Improvements

  • Update in app links to new and improved documentation space

  • Add more file URL segment matchers in order to use copy and paste to render files

Bug Fixes

  • Allow relative links in Markdown to work properly and take the user to the url

New Features

  • Supporting GitLab Self Managed

    • Including from GitLab self managed repositories is supported. The GitLab domain has to be accessible via HTTPS and has not be behind a firewall.

    • Check the documentation for the initial setup.

Maintenance

  • Improved Security by upgrading to the latest version of some libraries

New Features

  • Private repository access

    • Include GitLab now supports including files from private repositories. When creating a new GitLab File macro, provide the file link as normal. The first time this happens with a private repository file, the macro will automatically prompt you to authorize Include GitLab for private repository access.

Bug Fixes

  • Enable unlicensed access to Include GitLab

    • Include GitLab is a free app – no license is required!

New Features

  • Include GitLab files in Confluence

    • Select the ‘GitLab file’ macro in Confluence to include a file from GitLab. The file will be always up to date in Confluence.

  • Support for Markdown and AsciiDoc

    • Select Markdown or AsciiDoc in the Syntax Highlighting, then the file will be rendered.