Template:Forum link/doc

This template simplifies links to Bogleheads forum posts or topics in an article. These will typically use the reference tags. The template is preferable to normal external links because:
 * It gives a consistent format for links to the Bogleheads forum
 * If the forum URL changes, the template can change to match

Usage


Parameters are:
 * t: The topic number. Each topic has a unique identifier. This is the numeric value in the URL after the . Generally, you should link to the topic unless you want to specify a specific reply further down into the topic, in which case you can provide the post number (p) parameter value.
 * p: The post number. Each post within a topic has a unique identifier which is obtained by clicking on the post's title. This is the link in the top-left corner of every post. It is the numeric value in the URL after the.
 * title: The link text to display. Typically this will be the discussion topic title.
 * date: (optional) The date of the topic or post. Please add the date, as many financial topics are date sensitive and the reader may wish to know if the post is many years old. Suggested format is (D)D Month YYYY (for example 7 July 2012) but any format will be output as entered.
 * author: (optional). The author of the topic or post.
 * quote: (optional). Any relevant quote from the topic or post. Do not include quotation marks as these are included automatically.

Use only the topic number or post number, but not both. Link to the topic when you want to emphasize the overall topics. Link to the post when you want to focus on a particular reply within the overall topic. Where both a topic number and a post number are given, only the post number is used, and the topic number is ignored.

Examples
Forum topic  has the topic number 88005. To link to it with this template, use:



Results in:



Forum post  has the post number 1263932. To link to it with this template, use:



Results in:



Ideally, include the date of the original topic if you use the t parameter, or of the specific post if you use the p parameter. For example:



Results in:



In many cases, you will link to a Bogleheads forum topic using the reference  tags. For example:



Results in the following, with a footnote reference after the sentence (the footnote appears at the bottom of the page, in the References section):


 * The 3-Fund portfolio is an excellent investment strategy.

To use the author and quote parameters:



Results in:


 * The 3-Fund portfolio is an excellent investment strategy.

TemplateData
{	"params": { "p": { "label": "Post number", "description": "Each post within a topic has a unique identifier which is obtained by clicking on the post's title. This is the link in the top-left corner of every post. It is the numeric value in the URL after the p =. Use either \"p\" to cite a post or \"t\" to cite a topic - not both.", "type": "number" },		"title": { "label": "Title", "description": "The link text to display. If \"p\" is entered, enter the post tile. Typically, this starts with \"Re:\". Enter the topic title if \"t\" is selected.", "type": "string", "required": true },		"t": { "label": "Topic number", "description": "Each topic has a unique identifier. This is the numeric value in the URL after the t=. Generally, you should link to the topic unless you want to specify a specific reply further down into the topic, in which case you can provide the post number (p) parameter value. Use either \"p\" to cite a post or \"t\" to cite a topic - not both.", "type": "number", "suggested": true },		"author": { "label": "Author", "description": "(optional). The author of the topic or post.", "type": "string" },		"date": { "label": "Date", "description": "(optional) The date of the topic or post. Please add the date, as many financial topics are date sensitive and the reader may wish to know if the post is many years old. Suggested format is (D)D Month YYYY (for example 7 July 2012) but any format will be output as entered.", "type": "string" },		"quote": { "label": "Quote", "description": "(optional). Any relevant quote from the topic or post. Do not include quotation marks as these are included automatically.", "type": "string" }	},	"description": "Simplifies links to Bogleheads forum topics or posts in an article. ", "paramOrder": [ "t", "title", "p", "author", "date", "quote" ] }