Skip to main content

Create an Informal Topic Branch

Branches make it possible to update without affecting the original content. They are handled almost the same way for topics, publications, informal topics and admonitions.

However, Forks from informal topics cannot be branched from inside a publication or topic because they are only a collection of reusable elements inside a topic. They are not standalone components like regular topics.

Therefore, you have to branch the informal topic in the Content Manager. Then manually replace the inserted informal topic with the branch in affected topics, see Replace an Informal Topic Branch.

Tip

If an informal topic serves as a reusable component in a publication, you can filter the content in your informal topic instead of branching it, see Filtering / Profiling and Publish Multiple Versions of Content.

To create a branch of your informal topic:

  1. Select the dotted menu (...) to the right of the informal topic in the Content Manager.

  2. Select Branching and choose New branch.

    Select_New_Branch.jpg

    The branch will appear below the file it originates from.

  3. Enter a branch Label. This label will appear next to the name and makes it easier to identify different branches of the same content. [Optional, but recommended].

    Create branch dialog. It has a Label field for adding a label to the branch upon creation.

    Tip

    You can add branch labels afterwards as well, see Add or Edit Branch Labels

  4. To control where Paligo stores the new branched content, check the Select location for new branch box. You can then browse to the folder you want Paligo to use.

    Select location for new branch box. It is checked and Paligo shows a field with a browse button that you can use to choose the folder.

    If you leave Select location for new branch unchecked, Paligo will add the branched content to the same folder as the parent version of the content.

  5. Choose whether you want to Open new branch in editor. Check the box for yes or leave it clear for no.

  6. Select Create.