Insert a cross-reference (xref) to a file or web site in the XMetaL editor
Use the xref element to insert a hypertext link to remote systems, FTP sites, or local files outside the repository.
When you are cross-referencing files outside the repository, you may use either absolute or relative pathnames. However, you should keep in mind that setups vary in different machines. When you specify the path for your cross-referenced file you’d better be sure that the path makes sense with regard to the machine (and the local network) where the files will be installed.
Highlight a word or phrase where you want to insert the xref.
Note: The text you highlight must be within an element that allows xrefs.
- Use Search to display topics in the Search Results view.
Right-click any topic, then select
from the menu.Note: This inserts an XML cross-reference (xref). You'll need to edit its attributes so that it references the actual file or remote location.
- Place your cursor on the newly created <xref>.
- Open the Attribute Inspector.
In the <xref> tag's
href attribute, type the location you want to reference.
The following table shows the types of location accepted by the href attribute and their syntax.
Location type Syntax Web site http://sitename Secure web site https://sitename FTP site ftp://sitename Secure FTP site ftps://sitename Local file file://driveletter/filename
The following screen shot shows an example of an edited href attribute.
- In the <xref> tag's scope attribute, select external.