Skip to main content

IDs for Cross-References

Paligo content is stored in a database and each element can have its own unique ID. Certain types of content, such as paragraphs, images and variables have a special type of ID called xinfo and this is always generated by Paligo. Other elements can have an optional ID called xml:id and these can be generated automatically by Paligo or manually by you.

Cross-references in Paligo use the id to identify the target of the cross-reference. Paligo creates the id automatically for some types of cross-reference, primarily those to components that can have a title. It is added as an xml:id attribute. But you may need to add an xml:id attribute manually for cross-references to other types of content. This applies to cross-references between topics and also cross-references to content inside the same topic, for example, to a subsection.

In most cases, we recommend that you cross-reference to a:

  • Section

  • Subsection - a section inside another section

  • A structure that can have a title, such as a table.

Note

If you want to cross-reference to a different type of content, that is only possible if that content has an xml:id. So you may need to Manually Generate IDs for Cross-references before you can link to it.

It's also possible to set Paligo to auto-generate xml:ids , see Auto-Generate IDs for Cross-References .