Template:Auto navigation/doc
This is a documentation subpage for Template:Auto navigation It contains usage information, categories and other content that is not part of the original template page. |
Theory of operation
[edit source]This template (shown above with dummy links) adds one or more links to the top or bottom of a page, separated from the rest of the content by two centered, gray horizontal lines five pixels high and width equal to 94% of the page as rendered. It is designed to assist the reader to more easily consume the book in its entirety, the links being analogues of the traditional page turning performed on physically printed volumes and placed at the extremes of the content, where such behavior is naturally triggered.
The available links it can provide are:
- The next page in the book
- The book's previous page
- The page one level higher, listed as "Home"
- The eponymous category page to the book's title, sorted by the subpage names unless an additional parameter is specified (see below)
Usage
[edit source]Parameters
[edit source]All parameters are optional.
- The name of the next page, as the first unnamed parameter.
- The name of the previous page, as the second unnamed parameter.
- deep as the third unnamed parameter or the value to the
|filing=
parameter if only the next page is being shown; this indicates pages at that level of the book should be categorized by the chapter they appear in rather than the book's titular category. - bottom as the last unnamed parameter when the template is displaying the links to both adjacent pages, or as the value of the
|border=
parameter if only showing the next page; this places the horizontal lines below the links rather than above them, allowing the template to be displayed in a manner appropriate to placement at the top of the page rather than the bottom.
Examples
[edit source]{{Auto navigation|Next page}}
{{Auto navigation|Next page|Previous page|deep|bottom}}
{{Auto navigation|Next page}}
TemplateData
[edit source]TemplateData for Auto navigation
Places links at the top or bottom of a page to its adjacent book pages, as well as the book's home page
Parameter | Description | Type | Status | |
---|---|---|---|---|
Next page | 1 | no description | Page name | required |
Previous page | 2 | no description | Page name | suggested |
Categorization style | filing 3 | no description
| Line | optional |
Horizontal separator placement | border 3 4 | no description
| Line | optional |