Edit online

Projects and Publishing

Oxygen Content Fusion offers the ability to manage DITA Projects. Users with a Content Fusion Author role can create such projects, import content, and manage its lifecycle from creation, to review, to publishing as PDF or Oxygen WebHelp Responsive.

What is a Project in Content Fusion?

A Content Fusion Project:
  • Provides Git-based storage for DITA content.
  • Allows authors to create content with AI assistance.
  • Provides a graphical interface to manage review tasks within the project.
  • Helps Authors build WebHelp or PDF outputs via Publications and Deliverables.

Main Projects Page

Projects is one of the two main components (along with Review Tasks) within the Content Fusion browser interface. The main Projects page shows all the projects you have access to.

Figure 1. Main Projects Page

To open an existing project, simply click on it. This opens the project's Publications page by default.

Creating a New Project

Click the New project button to create a new project. This opens a dialog box where you can choose between two options for creating a project:

  • Import from Git - Configure the connection to your Git repository. It includes the following fields:
    • Name - The name of the project.
    • Description - The description of the project. It is displayed under the project's name in the main Projects page.
    • Project URL - The URL of the Git repository.
    • Branch - The default branch of the project.
    • Visibility - You can choose between Public (accessible by all members) or Private (restricts access to select members).
    • Username and Access Token - You can enter the Git credentials (username and access token) using this option.
      Note:
      The personal access token for GitHub must have the following permissions:
      • Repository permissions > Contents > Read and Write.
      • You should also specify which repositories it has access to.
    • Git Account - Use this option to select a preconfigured Git account.
    • Once you are done configuring the details, click the Create project button to finish the creation process.
  • Create from a template - Choose the following configuration options:
    • Name - The name of the project.
    • Description - The description of the project. It is displayed under the project's name in the main Projects page.
    • Visibility - You can choose between Public (accessible by all members) or Private (restricts access to select members).
    • Template - You can choose from predefined templates to create a project. The available templates include:
      • An empty project
      • A "starter" DITA project
      • Two sample DITA projects:
      Note:
      A project created from a template is stored internally in Content Fusion. Later, you can link an external Git repository, and all the content will be moved to that repository.

The newly created project is automatically opened with the project's Publications page displayed.

Create a Project from a Git Repository

A URL query parameter in the form of /projects/new-from-url?url= can be used to create a project from a Git repository. The URL parameter accepts either a Git repository URL or a download archive URL generated by a Git server. For the archive URL option, the generated archive should have a root folder where the content is located. An optional folder parameter can be used to specify the folder where the content is located that will be used to create the project.

Git repository URL example: https://example.com/projects/new-from-url?url=https://github.com/user/repo&folder=template_1

Archive URL example: https://example.com/projects/new-from-url?url=https://github.com/user/repo/archive/refs/heads/main.zip&folder=template_1

Branch Management

When a project is open, the second stripe contains a label to make it clear that you are editing inside the Personal Workspace and it includes a branch management drop-down menu. The current branch is displayed inside the box and you can click it to select a different branch (all the Git branches from your project are available).

Figure 2. Top Header Stripes Inside a Project
In addition to being able to change the branch, the branch management drop-down also contains the following actions:
  • Create new branch - Opens a dialog box where you can choose the name for a new branch and an existing branch to base it on.
  • Delete branch - Opens a confirmation dialog box where you have the option to delete the current branch.
  • Merge into current branch - Opens a dialog box where you can select an existing branch to merge into the current branch.
    Figure 3. Merge Branch Dialog Box

    In the Merge Branch dialog box, you can select which branch to merge into the current one. Click Merge to initiate the process. If the merge succeeds without conflicts, a Merge successful message is displayed.

    If there are files with conflicting changes, a special branch merging conflict resolution dialog box is initiated where you can choose a merge action for each particular conflict and you can view each version of a conflicted file in a side-by-side comparison view.

Note:
When trying to merge branches inside the Personal Workspace, the merge cannot be processed if you have any local outgoing changes. In this case, a warning dialog box is displayed informing you that the outgoing changes must be committed or discarded before attempting the merge.