namespace base

Overview

The namespace base is the URL prefix under which a Semantic Site publishes all mesh identifiers. It is outside the mesh’s folder tree and is determined by the hosting platform.

Only sites have a namespace base. Meshes (and sites) also have a root node, which corresponds to the top-level folder of the mesh.

Platform mappings (GitHub Pages examples)

  • User/Org site base:
    • https://org.github.io/
    • Mesh path /ns/people/alice/ publishes at https://org.github.io/ns/people/alice/
  • Project site base with a mesh repo:
    • https://org.github.io/repo/
    • Mesh path /ns/people/alice/ publishes at https://org.github.io/repo/ns/people/alice/
  • Project site base with an Embedded Mesh

Guidance

  • Prefer relative or site-root-absolute paths inside the mesh; do not hardcode full base IRIs so the mesh remains portable across hosting locations (see Reference Iri Choices).
  • The base is a deployment concern; the mesh folder tree should be valid regardless of where it is served.

Backlinks