A file entity can be a complete document or a portion of a document, such as a chapter, section, or paragraph. It must be structurally complete, including both start and end tags.

The tags used in a file entity must be in context where the file entity is inserted into a document. For example, you can add a sect1 tag in a chapter in the DocBook document type, but you cannot add a chapter tag within a sect1.

The source file for your file entity can exist on your local hard drive, on a network file server, in a document management system, or on the World Wide Web.

You can use the Arbortext-path\custom\entities subdirectory to store entities. Putting your entity files in the custom\entities subdirectory makes them automatically available, avoiding manual steps to add them to the path. The custom\entities path is automatically prepended to the entities path at startup.

File entities are expanded in the view by default, but you can use the View > File Entities menu option to collapse them.

File entities are always expanded within the document tree, regardless of whether or not they are expanded in the view.