Under maintenance

Heretto Help

Show Page Sections

Useful Actions

Share Links to Files

Send a link to a file in your Content Library. This link opens Heretto CCMS and highlights the file in the file listing.

In the Content Library, right-click a folder or a file and select Copy Share URL.
You can share the link with other Heretto CCMS users.

Star Folders and Files

Star important folders and files so you can easily access them later in your Starred folder.

Note: Files that you star are only visible in your Starred folder. Other users do not have access to your Starred folder.
  1. In the Content Library, click the star next to files you want to track.
  2. In the Browse tab, click Starred to open your Starred folder.

Create a Folder

Use the Create a new folder to create a new folder for organizing your files.

  1. In the Content Library, click the Create a new folder.
    Figure 1. Create a new folder Button
    New folder button in the Content Library
  2. Add a meaningful folder name.
    Note:

    The valid characters for file and folder names are:

    • lowercase letters (a-z)

    • uppercase letters (A-Z)

    • numbers (0-9)

    • underscore (_), hyphen (-), and period (.)

    This applies to creating files and folders and renaming files and folders.

  3. Click Create.

Rename a Folder or File

Change the name of an existing file or folder.

  1. In the Content Library, right-click the desired resource(s) and select Rename.

    You can select a number of files and folders and rename them in one operation. You can select a range of resources while pressing the Shift key.

  2. Enter a new name for each file.
    Note:

    The valid characters for file and folder names are:

    • lowercase letters (a-z)

    • uppercase letters (A-Z)

    • numbers (0-9)

    • underscore (_), hyphen (-), and period (.)

    This applies to creating files and folders and renaming files and folders.

    Optionally, you can add a comment for the rename operation.

  3. Click Rename.

Move Folders and Files

Move files and folders to a new location in the Content Library.

  1. In the Content Library, right-click the desired resources and select Move.

    You can select a number of files and folders and move them in one operation. You can select a range of resources while pressing the Shift key.

  2. Click Select Location.
  3. Navigate to and select a folder location.
  4. Click Select.
  5. Click Move.

Select a Range of Files

You can quickly select multiple files in the Content Library by selecting a range of files.

  1. In the Content Library, navigate to the directory where you want to select a range of files.
  2. Select the first file in the range of files that you want to select.
    select a range of files
  3. Hold Shift and click the last file in the range of files that you want to select.
    select a file range part 2

Upload Files to Heretto CCMS

You can upload various files types to Heretto CCMS, including DITA files, images, configuration files, and other allowed files.

For more information about files you can upload to Heretto CCMS, see What file types can I upload to Heretto CCMS?.

  • Ensure that the document type (DOCTYPE) declarations in your DITA files do not contain the DITA version number (1.1, 1.2, or 1.3). Otherwise your files will be invalid after upload. When a version number is not included in the DOCTYPE declaration, Heretto CCMS defaults to the latest DITA version.

    An example of a DOCTYPE declaration with a DITA version number (1.3):

    <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 1.3 Concept//EN" "concept.dtd">

    An example of a DOCTYPE declaration without a DITA version number:

    <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
  1. In the Content Library, navigate to the folder where you want to upload your files and click Upload a new file.
  2. In the Select files to upload window, click to choose files or drag and drop files to upload.
    Select files to upload window
  3. If you selected any files that already exist in the Content Library folder and you don't want to overwrite them, clear the corresponding Overwrite files with the same names check box.
  4. If you selected any ZIP files that you do not want to be automatically unzipped, clear the corresponding Unzip check box.
  5. Click Upload Files.

stops the upload process and prevents files form being saved in the CCMS.

Download Files from the Content Library

Downloading files from the Content Library can be useful for local development.

In the Content Library, do any of the following:
  • To download a folder, right-click the folder and select Download.
  • To download a single file, right-click the file and select Download > File.
  • To download a file and the file dependencies, right-click the file and select Download > File + Dependencies.

Duplicate Files

You can duplicate images, topics, and maps, but you cannot duplicate folders.

Check if the files you want to duplicate are referencing other files.
Important: You can check this by examining the outgoing links in the Links tab. If there are outgoing links, duplicating the file to a new location in one operation would result in broken links in the file. If you want to avoid broken links, first duplicate the file to the same location and then move it to a new location.
  1. In the Content Library, right-click the desired files and select Duplicate.

    You can select a number of resources and duplicate them in one operation. You can select a range of resources while pressing the Shift key.

  2. Optional: Click Select Location and navigate to and select where you want to copy the file(s) to.
  3. Click Save.
Note:

When you duplicate a file or map, all content is identical to the original file or map except that the root element ID is new and unique.

Remove Folders and Files

Move files and folders that you no longer need from your Content Library to the Trash.

Important: Before removing files, verify if the files you want to remove aren't referenced by other files. You can check this by examining the Incoming Links in the Links tab. If incoming links are present, the file is referenced by other files and deleting it would break those links.
  1. In the Content Library, right-click the desired resources and select Move to Trash.
    You can select a number of files and folders and remove them in one operation. You can select a range of resources while pressing the Shift key.
  2. Click Move to Trash.
The selected files and folders are moved to the Trash. If you entered a comment it will show in the History tab as well as the Commit column in the Trash screen.

Restore Removed Files

Restore files that were moved to the Trash and move them back into your Content Library to be used in topics and maps again.

  1. In the Content Library, click Trash to open the Trash bin.
  2. Select the remove operation that you want to restore files from.
  3. Do any of the following:
    • Select the file or files you want to restore and click Restore Selected.
    • Click Restore All.

Customize Columns in the Content Library

You can customize the view in your Content Library by adding, removing, and rearranging custom columns. Custom columns are driven by taxonomy metadata configured in Heretto CCMS.

Note: This feature may be disabled in Heretto CCMS. Ask your Customer Success Manager (CSM) if this feature can be enabled.
  1. In the Content Library, click the cog icon Settings in the top-right corner.
    Figure 2. The Settings option in the Content Library
    Layer 1
  2. In the Custom columns dialog, do any of the following:
    • To hide a column in the Content Library, clear the corresponding check box.
    • To show a column in the Content Library, select the corresponding check box.
    • To rearrange columns in the Content Library, drag-and-drop a column name to a new position.
  3. Click Save.
  4. If needed, refresh the CCMS in your browser.

You can now see custom columns in the Content Library. Your settings persist until you change them. Custom columns you configure are visible only to you and do not affect the view for other users in the CCMS.

Get a Resource UUID

Each resource in Heretto CCMS has its own Universally Unique Identifier (UUID). UUIDs are essential when working with Heretto CCMS API and are also useful in other scenarios, such as referencing resources like graphics or custom fonts in PDF Generator publishing configurations.

  1. In the Content Library, click a resource.
    The Resource Drawer opens on the right.
  2. At the bottom of the Resource Drawer, click API Info and copy the contents of the UUID field.
    a gif showing a user clicking on a map, Resource Drawer opening on the right, user going to API Info section and selecting resource UUID

Enable Dark Mode for Heretto CCMS

You can enable dark mode for Heretto CCMS by using the Dark Reader browser extension.

Important:

The Dark Reader browser extension inverts bright colors on websites to simulate dark mode. For more information, see https://darkreader.org/.

The Dark Reader browser extension is provided by a third party, and Heretto, Inc., is not responsible for any changes in behavior, functionality, or discontinuation of the extension.

  1. Open Google Chrome™ or Mozilla Firefox.
  2. Install the Dark Reader browser extension:
    OptionDescription
    If you use Google Chrome™,do the following:
    1. Go to: https://chrome.google.com/webstore/detail/dark-reader/eimadpbcbfnmbkopoojfekhnkhdbieeh?hl=en.
    2. Click Add to Chrome.
    3. In the prompt, click Add extension.
    If you use Mozilla Firefox,do the following:
    1. Go to: https://addons.mozilla.org/en-US/firefox/addon/darkreader/.
    2. Click Add to Firefox.
    3. In the top-left corner, click Add.
    4. In the top-right-corner, click OK.
    The Dark Reader browser extension Help tab opens in your web browser. By default, the extension enables dark mode on every website that you visit.
  3. Pin the extension to your toolbar.
  4. Optional: Enable dark mode only for Heretto CCMS:
    1. In the right-top corner of the browser, click .
    2. In the Dark Reader pop-up, in the Site list tab, click Invert listed only.
    3. Under Inverted list only, in the field, enter <your_organization>.heretto.com
      Where <your_organization> is the name of your organization in Heretto CCMS.
    Dark mode is enabled only for Heretto CCMS.
  5. Optional: Adjust the Dark Reader browser extension settings for Heretto CCMS:
    1. In your web browser, go to <your_organization>.heretto.com
    2. In the right-top corner of the browser, click .
    3. In the Dark Reader pop-up, click Only for <your_organization>.heretto.com
      Where <your_organization> is the name of your organization in Heretto CCMS.
    4. Adjust the Brightness, Contrast, Sepia, and Grayscale sliders.