Wikipedia:Wikipedia Signpost/Templates/Article list maker/doc

This template can be used to create lists of Signpost articles. The Signpost articles can be filtered by tags, by date, and by page; can be sorted by date, page, or title; and can be outputted in formats specified by the user.

Tables
Premade templates to automatically generate informational tables from issues, months, et cetera can be found here:

Filtering articles
There are over 5000 Signpost articles, so the first step to making a list of them is to filter out the results that you don't need. Here are the parameters that you can use to do that:


 * - If you use this parameter, only the specified page will be outputted.
 * - If you use this parameter, only articles for the specified date will be outputted.
 * - Use this parameter to filter the articles by tag. You can specify an unlimited number of tags, separated by commas.
 * - If this is set to "all", then only articles that match all the tags specified in  will be outputted. Otherwise, articles matching any of the tags will be outputted.
 * - Don't output any articles before this date.
 * - Don't output any articles later than this date.
 * - Only output articles by this author. This should be the username of the author, without the "User:" prefix (e.g. ).
 * - The direction to sort the articles in, either "ascending" or "descending". The default is "ascending".
 * - The field to sort the articles by. Valid options are "date", "page", and "title". The default is "date".
 * - Skip X articles from the beginning of the list to be returned
 * - Limit the number of articles returned to a specified value

Blank template
This is the full template, with all possible parameters.

Outputting articles
This template outputs a series of rows, formatted with data from the articles specified using the parameters in above. It is up to you to specify what parameters appear when in each row. To do this, you have two options, a row format string, or a row template.

Whichever option you choose, you can use the rowseparator argument to specify a custom separator for each row. As a special case, if you use newline, the separator will be a new line character.

Parameters
Both row format strings and row templates take the same parameters, although their syntax is slightly different. Row format strings take parameters that look like, and row templates take parameters that look like. The available parameters are:


 * - The article date, e.g..
 * - The page the article is found on, e.g..
 * - The article title, e.g..
 * - The subpage name the article is stored on, e.g..
 * - The page the article is found on. If any tags matched this article, the first one in alphabetical order is used as the fragment (the section link). If the user specified research, this might be, and if they specified newsandnotes, research, wmf it might be.

Row format strings
Row format strings are specified with the rowformat parameter. These strings take row parameters that look like,   and.

For example, the following code:

Produces the following output:

Row templates

 * The following is a an automatically updated list of subpages, current as of :

Row templates are specified with the rowtemplate parameter. This must be the title of a template that is used to format the rows. Row templates take parameters that look like, and.

For example, Wikipedia Signpost/Templates/Article list maker/Example has the content: *, : |

And the code:

Produces the following output:

While row templates require you to create an extra page, they have the advantage of allowing you to process the parameters with parser functions, etc. For example, you could include the code  to output the year only.

No articles
If the filter parameters you specify result in no articles being selected, you can use the noarticles parameter to specify the text to include where the articles would be. The default is the text " No articles found for the arguments specified ".

Example:

Where this is used
The following is a (not exhaustive!) list of templates and use cases where this is a dependency.
 * Wikipedia Signpost/Templates/Single talk, which uses the "comment section" template, and is used on pages like Wikipedia talk:Wikipedia Signpost/Single/2022-11-28.
 * Wikipedia Signpost/Author and all its subpages.
 * Wikipedia Signpost/Tag and all its subpages.