Wikipedia

User:JL-Bot/Project content/documentation

< User:JL-Bot | Project content
This is an old revision of this page, as edited by JLaTondre (talk | contribs) at 14:31, 3 January 2010 (→Project Parameter: add guidance on template). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

This template is used to have the bot generate a listing of a Project's recognized content.

Usage

Place the template where you want the content displayed: 

{{User:JL-Bot/Project content
|project parameter (see below)
|content parameters (see below)
|optional parameters (see below)
}}

The bot expects to see a single parameter per line with the closing }} on its own line. Failure to follow that will cause the bot to ignore parameters.

The template contains no content so it does not impact the visual appearance of the page which transcludes it.

It will only work in the following namespaces:

  • User:
  • User talk:
  • Project:
  • Project talk:
  • Portal:
  • Portal talk:

Project Parameter

The project parameter defines how the bot is to identify project content. One of the two following parameters needs to be provided:

  • |template = Name of project template
  • |category = Name of project category

The template parameter needs to have the name of the talk page template that is used by the project to identify articles within its scope. For example, WikiProject Physics uses the {{physics}} template so the parameter for them would be |template = Physics. If there are redirects to the template (ex. {{WPPhysics}} to {{physics}}), pages tagged with the redirect will still be picked up as they show up in the target's transclusions. However, do not use a redirect as the template name as only pages tagged with the redirect will be picked up.

The category parameter needs to have the name of the category that is used by the project to identify articles within its scope.

The template parameter will override the category parameter if both are present.

Content Parameters

The content parameters define the content types to be listed. The following types are supported:

The content will be listed in the order the parameters appear in the template.

Optional Parameters

The following optional parameters are supported:

  • |compact -- specifies compact layout instead of column layout (ex: article1 · article2)
  • |columns = # -- defines the # of columns to be displayed in default column layout
  • |icons -- specifies the use of content type icons
  • |heading = # -- defines the heading level (number of "="s) to use; the default is level 2
  • |pictures-list -- specifies pictures should be listed (obeying the columns, icons, and compact options)

The compact option overrides the columns and icons options.

Pictures will use the <gallery></gallery> syntax if the pictures-list option is not set.

Output

The results will be written to same page as the template. They will be prefaced by a comment header and followed by a comment footer. This header and footer are not visible on the displayed page, but are needed to allow the bot to identify prior results.

  • header = <!-- Start of content generated by JL-Bot -->
  • footer = <!-- End of content generated by JL-Bot -->

If the bot doesn't find a valid header and footer (ex. first run), it will place the results immediately below the template. If it does find a valid header and footer (updates), it will replace the content between the header and footer with the new results.

Retrieved from "https://en.wikipedia.org/w/index.php?title=User:JL-Bot/Project_content/documentation&oldid=335636347"