Internal Links

Internal links can be used in HTML fields. In that case, the href attribute of a tags and the src attribute of img tags should not contain a URL, contrary to normal use of HTML, but should contain a JCR node name of a childnode of the HTML field. That childnode should be of type hippo:facetselect. Of course, these childnodes should have unique names within the context of their parent HTML field.

You can see this in the CMS console. In the screenshot below, the html field of a document contains an image and has therefor a childnode of type hippo:facetselect (that fact is not visible here). The facetselect childnode has the name Roomba_original.jpg. This name is also used in the src attribute of the html img tag. This facetselect also 'happens' to points to an image of that same name. This virtual node is shown with a green/blue folder image.

If in a single HTML field there are several internal references to the same referenceable node, it is possible to have several different hippo:facetselect childnodes for them and also possible to have them point to the same hippo:facetselect. The first way is conform the semantics if the references are only the same by accident, i.e. may change independently, while the second way is conform the semantics if the references are the same by definition, i.e. may change only together.