document

Documents in Principia

A [LaTeX] document may have any name and any extension, and, may reside in any directory.

This is not the case for a [Principia] document.

---

• Documents in Principia
  • Document names
  • Packages

---

Document names

• The name of a Principia document must begin with a capital letter, followed by alpha-numeric characters.

For example, while Foo, Foo3 and Foo3t are legal names, foo, 3Foo, tFoo3 and Foo_3 are not.

Note that there is no notion of a Principia file. Such notions pertain only to an [embedding]. There is, for example, the notion of a [PriTeX file], which is a LaTeX file embedding a single Principia document.

• Each embedding will impose a relationship between the name of the embedded Principia document and the name of the embedding file (or url).

A PriTeX file embedding a Principia document called Foo must have file-name Foo.tex, for example.

---

Packages

Principia documents are not stand-alone-entities, rather, each document is a member of a [package]. Embeddings impose location constraints on files based on the package name.

For example, a [PriTeX file] embedding a document of package aaa.bbb must reside in a directory .../src/aaa/bbb in Linux and ...\src\aaa\bbb, where ... can be any super-directory.