Page Paths

The BookWiki application allows for the creation of books that are comprised of chapters and pages that form a hierarchical structure. That is, pages can be nested multiple levels. Each page in a book has a specific name and the location of the page within the book is specified by the page path or the path to the specific page.

Page paths, which are used to identify a specific page, resemble directory paths in a file system. For example,

   /Chapter1/FirstSection

refers to the page named FirstSection within the chapter named Chapter1.

Page paths can be specified by an absolute path or as a relative path. An absolute path specifies the hierarchical pages that must be followed from the root or top of the document to reach the specified page. A relative path, on the other hand, indicates how to reach a specific page relative to the current page.

For illustration, assume the page hierarchy of the book is as follows:

├─ FrontPage
│
├─ Chapter1
│    ├─ Page1
│    ├─ Page2             <--- current page
│    │    ├─ SubPage1
│    │    └─ SubPage2
│    └─ Page3
│    
├─ Chapter 2
│    ├─ PageA
│    ├─ PageB
│    │    └─ SubPageX
│    └─ PageC
│         └─ SubPageY
│
├─ Chapter 3

and that the current page is Page2 within Chapter1.

A page path is required for links to internal wiki pages and with some commands and environments when referencing a page other than the current page for access to an attachment or a page variable. The format or syntax of the link is the same. The format of path must be one of the following (note, here we use the ink= command to show the paths, but the format would be the same anytime when a page path is required):

Page3

A path that begins with the name of a page refers to the sibling of the current page or a descendant of sibling (e.g. Page3/Child1).

./SubPage1

A path that begins with ./ refers to the child or a descendant of the current page.

../

A path that contains only ../ refers to the parent of the current page.

../Chapter2

A path that begins with ../ and includes at least a page name refers to the sibling of the parent of the current page (i.e. 'uncle' page)

../Chapter2/PageA

The same as the previous example, except the path refers to the child of a sibling of the parent of the current page (i.e. 'cousin' page).

An absolute path is specified by including the entire path from the top of the document tree to the specific page:

/Chapter2

A path that begins with a single slash / indicates an absolute path that is traversed from the top of the document (i.e. the book) to the specific page. The name of each descendant must be included in the page with slashes (/) separating each page level.

/Chapter2/PageC/SubPageY

Another absolute path with three levels.

//AnotherBook/Chapter1/Page1

A path that begins with double slashes indicates a path to a page in another book hosted on the same system. Here, we are referring to Page1 of Chapter1 in AnotherBook. When referencing pages in a different book, only absolute paths can be used.