แม่แบบ:TOC link/doc

This template create a link depending on the context of transclusion. It should be used only in a Page:*. It creates either a link to a given page number (in Page:* numbering) passed in parameter 1, or a link (parameter 3) to a subpage name (parameter 2) of a book. This template can be used also in context (... See p. 243) outside table of contents.

Example: Take the book whose title is Transactions of the Geological Society, 1st series, vol. 1 in the main space, the corresponding page names are [[Page:Transactions of the Geological Society, 1st series, vol. 1.djvu/xxxx]] where xxxx is the page number in the djvu file; these pages may have a different number on the scanned book, for instance page #203 in the djvu file may be the scan of p. 191 in the scanned book; so in order to show 191 you write this:

{{TOC link|203|On the Wrekin and on the Great Coal-field of Shropshire|191}}

1. In Page:Transactions of the Geological Society, 1st series, vol. 1.djvu/425 the created link is [[Page:Transactions of the Geological Society, 1st series, vol. 1.djvu/203|191]].
2. When this page is transcluded in main namespace, the created link is [[../On the Wrekin and on the Great Coal-field of Shropshire#191|191]]. (see Transactions of the Geological Society, 1st series, vol. 1/Index).
3. Transclusion of a page using this template work also from an Index: page but only if the name of the index is identical to the name of the djvu file, in this case the created link is identical to #1.
4. Parameter 3 is used as anchor, typically this is used in context like (see p. 123) to allow links with anchor from a book to itself.

• If you would like a link with complex formatting like italics, which cannot be used in links, the optional parameter 4 is used. Parameter 4 will function as the link text, and parameter 3 will function as the link target (i.e. parameter 3 does not have the italic text, and parameter 4 does). An example of this is here, for Chapters 4 & 16, where some words are italic.

Note

1. that the name of an index must always be the same as the name of the corresponding djvu file; a renaming will be necessary if the names are different, though this is only needed if you want to link from a transcluded Page: in an Index:
2. formatting of text style, eg. small capitals, needs to wrap around the outside of the template, not be placed inside the template

Rationale

1. Using relative links allow to rename works without creating link through redirect, both page in main (top-level page and sub-page should be renamed as a whole) or the djvu and its subpages can be renamed without maintenance burden
2. Avoiding relative link directly in Page:, which create a blue link when transclued in main but a red link in Page:
3. It avoid link to Page: in main which can confuse reader if they don't understand what namespace and transclusion are.
4. It allows a short way to express a link from a works to itself.