Make all links relative to the root catalog

[mojodna]

Motivation: allow relative links to be easily resolved without traversing up a catalog tree and to provide information on the catalog structure within a single document that would otherwise have to be determined by reading multiple documents.

Introduce href:from to indicate the path from the root to the current document.

At this point, self becomes the filename and duplicates the filename portion of href:from, so that may indicate an additional direction.

The only absolute URL in this catalog is now the root catalog's self. That, too, could be removed and stashed in a sidecar file to be used for resolution.

Inclusion of the path from a root document (rel=root), allows knowledge of the root document’s URI to be used to resolve relative links in child documents. The root document’s rel=self can be absolute or it can be provided externally, allowing all links in a catalog to be relative (including rel=self).

href:from is a proposal with no prior art; HTML 4’s rev attribute comes close to describing this relationship, but isn’t quite right (and was dropped in HTML5). It also duplicates rel=self, potentially suggested an alternative link role (to self) where the href is the path from the root document. (This breaks link crawlers, as href is expected to be relative from the current document, rather than from another.)

Refs radiantearth/stac-spec#401

[fredliporace]

@mojodna this should be hurricane-harvey/0831/..., right?

[mojodna]

No, this is right. From collections/, the reverse link needs to go up a level to descend a different sibling.