Repository snippets

Navigation:  More Advanced Procedures > Working with Repositories >

Repository snippets

 Previous pageReturn to chapter overviewNext page

Show/Hide Hidden Text

In addition to styles, a repository can also contain topic files. These files are automatically available to all projects linked to the repository as snippets. They can be inserted directly with the Insert Snippet tool, with the special From Repository section.

Since the repository styles are also available in all linked projects, all the snippets contained in the repository will be formatted the same in all the linked projects where they are used. In addition to this, the repository provides an easy, centralized place to edit the snippets. Just as with the repository styles, editing the topic files in the repository automatically updates the content of the snippets in all projects where they are used.

This only applies when you link the snippets, of course! If you insert the snippets in paste mode they become part of the target topic and later changes to the source will not have any effect.

Click to expand/collapseUsing and editing repository snippets

Using repository snippets:

•Repository topics are available automatically as snippets as soon as the repository is linked to a project. To insert a snippet from the linked repository just select the snippet tool and use the From Repository option to access the repository snippets. See Re-using content with snippets for details.

Editing repository snippets:

To edit the snippets in the repository you need to open the repository and edit the topic files there.

1.Select Open in the File menu and select .hmxr as the file type to open.

2.Open the repository file and edit the topic files just as you would in a normal Help & Manual project. Repositories don't have a table of contents. You need to edit the files in the Project Files > Topic Files section.
Click to expand/collapseEditing a project when the repository is not available

Sometimes you may need to edit a project when the repository it is linked to is not available. When you do this your linked snippets will not be visible because the link is "live". You will just see entries in your topics showing that the snippets cannot be found. They will become visible again as soon as the repository is available again – for example when you are back in the office and your laptop is connected to the office network where the repository is stored.

What you can't do is insert new snippets from the repository when the repository is not available. After all, it's not available...