Jump to content

Module:TrainingPages/doc

From Wikipedia, the free encyclopedia
This is an old revision of this page, as edited by Wnt (talk | contribs) at 05:43, 27 March 2013 (Parameters). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

This module is intended to accept the name of a page (defaulting to the page currently being displayed), look it up in an index of pages, step forward or backward by some number of pages (usually 1), and give back the name of the page at that position.

Use {{#invoke:TrainingPages|function|parameters}} to invoke

Functions

The available functions are:

  • next_page: the next page on the index list
  • last_page: the preceding page on the index list
  • page_number: the number the page indicated is in the list
  • total_pages: the total number of pages in the index
  • main: allows you to flip forward or backward an arbitrary number of pages

Parameters

(All parameters are available to every function, except displacement which only matters for main)

  • currentpage is the page you are starting from (the one you're looking up in the index)
  • if currentpage is blank or omitted, the mw.title.getCurrentTitle() function is used to locate the current page. (So far as I know, this is always the page that matters, the one everything ultimately gets transcluded to, not the template or module)
  • defaultpage is the page to be returned if there is no next page, previous page, or page displaced by n in the index. Can be blank, in which case the module output will be blank if this happens.
  • indexmodule is the name of the index module with the list of all the pages. The pages should be in a list from beginning to end. There are three ways to format this:
  • Indexmodule can be in module space (e.g. Module:TrainingPages/default index) in which case they must consist of return {'Name of first page','Name of second page','Name of third page' ... etc.}.
  • Indexmodule can be in some other space, not in module format, in which case it need merely contain a list of Wikilinks in double square brackets. Everything outside the brackets is ignored, and every link in double square brackets is counted. The only limitation is that in this version anything in double square brackets is taken as a link, even if nowiki applies or it is in other brackets or has a newline in it or something that prevents it from appearing as a proper link. You can put a pair of nowiki or noninclude tags between the two opening square brackets as a kludge to avoid having this happen, if need be.
  • (If omitted, the indexmodule still defaults to Module:TrainingPages/default index, so common tasks might be added to it. However, no provision has been made to prevent from paging from one set into another, so unless this only sees use in one consistent overall set of trainingpages that is a bad idea unless upgraded.)
  • displacement specifies how many pages to go forward or back in the main module.