Template:Building link/doc - Revision history

76561197969631737: swapped out old Apothecarys example for new -ies example

2025-10-28T03:26:11Z

swapped out old Apothecarys example for new -ies example

← Older revision		Revision as of 03:26, 28 October 2025
Line 72:		Line 72:
	=== Other examples ===		=== Other examples ===

	<pre>{{Building link\|Ranch\|s}}</pre>		<pre>{{Building link\|Ranch\|es}}</pre>
	Formats the link so the name appears plural, but still links to the correct page (hover to see tooltip, or click):		Formats the link so the name appears plural, but still links to the correct page (hover to see tooltip, or click):

	{{Building link\|Ranch\|s}}		{{Building link\|Ranch\|es}}


	<pre>{{Building link\|Apothecary\|s\|size=none}}</pre>		<pre>{{Building link\|Apothecary\|ies\|size=none}}</pre>
	Mentioning how important {{Building link\|Apothecary\|s\|size=none}} are to your villagers ~~does format~~ the ~~building name correctly as plural. The pages for~~ the ~~names of buildings ending in~~ ''-y'' ~~when plural like~~ the ~~{{Building link\|Brewery\|s\|size=none}} have already been created~~ as ~~redirect pages, so you may use them freely:~~		Mentioning how important {{Building link\|Apothecary\|ies\|size=none}} are to your villagers just requires an extra switch to tell the template you need the ''-y'' replaced with ''-ies'' to format the building name correctly as plural.
	* {{Building link\|Apothecary\|s\|size=none}}
	* {{Building link\|Bakery\|s\|size=none}}
	* {{Building link\|Beanery\|s\|size=none}}
	* {{Building link\|Brewery\|s\|size=none}}
	* {{Building link\|Distillery\|s\|size=none}}
	* {{Building link\|Granary\|s\|size=none}}
	* {{Building link\|Manufactory\|s\|size=none}}
	* {{Building link\|Monastery\|s\|size=none}}
	* {{Building link\|Smithy\|s\|size=none}}
	* {{Building link\|Tinctury\|s\|size=none}}

76561197969631737: removing example where name is explicit but size is not; that's not good practice

2025-10-28T02:45:25Z

removing example where name is explicit but size is not; that's not good practice

← Older revision		Revision as of 02:45, 28 October 2025
Line 59:		Line 59:


	<pre>{{Building link\|~~name=~~Ranch\|large}}</pre>		<pre>{{Building link\|Ranch\|large}}</pre>
	Yields a larger icon for good recognition for use in tables with space that allows it:		Yields a larger icon for good recognition for use in tables with space that allows it:

	{{Building link\|~~name=~~Ranch\|large}}		{{Building link\|Ranch\|large}}

76561197969631737: /* Building */ adding "required" to name parameter

2024-10-31T02:07:39Z

Building: adding "required" to name parameter

← Older revision		Revision as of 02:07, 31 October 2024
Line 18:		Line 18:
	! Parameter !! Type !! Description		! Parameter !! Type !! Description
	\|-		\|-
	\| name \|\| string \|\| The name of the building, as it appears in the game.		\| name \|\| string \|\| '''Required.''' The name of the building, as it appears in the game.
	\|}		\|}

76561197969631737: Clarifying that this template validates the input

2024-10-31T02:00:33Z

Clarifying that this template validates the input

← Older revision		Revision as of 02:00, 31 October 2024
Line 2:		Line 2:

	Creates a link to a building's page.		Creates a link to a building's page.

			The template validates that you have correctly spelled the building name and can include an icon. Any links returned by this template '''should''' have articles and not be redlinks.

	A shortcut template exists for this template, [[Template:bl]]. You can use <code><nowiki>{{bl}}</nowiki></code> instead of <code><nowiki>{{Building link}}</nowiki></code> with the same parameters.		A shortcut template exists for this template, [[Template:bl]]. You can use <code><nowiki>{{bl}}</nowiki></code> instead of <code><nowiki>{{Building link}}</nowiki></code> with the same parameters.

76561197969631737: /* Errors */ adding some space between examples

2024-10-19T03:04:07Z

Errors: adding some space between examples

← Older revision		Revision as of 03:04, 19 October 2024
Line 101:		Line 101:
	<pre>{{Building link}}</pre>		<pre>{{Building link}}</pre>
	With no arguments: {{Building link}}		With no arguments: {{Building link}}


	<pre>{{Building link\|Library}}</pre>		<pre>{{Building link\|Library}}</pre>
	Naming a building that doesn't exist in the game: {{Building link\|Library}}		Naming a building that doesn't exist in the game: {{Building link\|Library}}


	<pre>{{Building link\|huge\|Ranch\|es}}</pre>		<pre>{{Building link\|huge\|Ranch\|es}}</pre>
	The same goes for swapping the order of the parameters so that the building is not first: {{Building link\|huge\|Ranch\|es}}		The same goes for swapping the order of the parameters so that the building is not first: {{Building link\|huge\|Ranch\|es}}

76561197969631737: /* Errors */ adding parameter order error when building is not first

2024-10-18T02:16:54Z

Errors: adding parameter order error when building is not first

← Older revision		Revision as of 02:16, 18 October 2024
Line 104:		Line 104:
	<pre>{{Building link\|Library}}</pre>		<pre>{{Building link\|Library}}</pre>
	Naming a building that doesn't exist in the game: {{Building link\|Library}}		Naming a building that doesn't exist in the game: {{Building link\|Library}}

			<pre>{{Building link\|huge\|Ranch\|es}}</pre>
			The same goes for swapping the order of the parameters so that the building is not first: {{Building link\|huge\|Ranch\|es}}

76561197969631737: /* Other examples */ fixing mentioning default is no icon

2024-10-18T02:14:20Z

Other examples: fixing mentioning default is no icon

← Older revision		Revision as of 02:14, 18 October 2024
Line 91:		Line 91:

	<pre>{{Building link\|Trappers' Camp\|s\|size=gigantic}}</pre>		<pre>{{Building link\|Trappers' Camp\|s\|size=gigantic}}</pre>
	Specifying an icon size that is not recognized does not return an error. Instead, ~~the default medium-sized~~ icon ~~is used~~:		Specifying an icon size that is not recognized does not return an error. Instead, it defaults to no icon:

	{{Building link\|Trappers' Camp\|s\|size=gigantic}}		{{Building link\|Trappers' Camp\|s\|size=gigantic}}

76561197969631737: /* Basic usage */ Updating with default is no icon

2024-10-18T01:10:27Z

Basic usage: Updating with default is no icon

← Older revision		Revision as of 01:10, 18 October 2024
Line 47:		Line 47:
	=== Basic usage ===		=== Basic usage ===

	<pre>{{Building link\|~~Ranch~~}}</pre>		<pre>{{Building link\|Trappers' Camp}}</pre>
	~~Yields~~ a ~~suitably sized icon~~ for ~~recognition and~~ use in ~~tables:~~		Makes a simple text-only link to the {{Building link\|Trappers' Camp}} article for use in-line in paragraphs like this that discuss villagers trapping and gathering things. Remember that using the small version of building icons like the {{Building link\|Trappers' Camp\|size=small}} is strongly advised against, because there aren't enough pixels to make them recognizable to the broad audience of this wiki.

	~~{{Building link\|Ranch}}~~

			<pre>{{Building link\|Trappers' Camp\|size=medium}}</pre>
			Yields an icon just big enough to be recognizable. Suitable for tables that list the buildings where layout provides some space for icons:

	~~<pre>{{Building link\|Trapper's Camp\|size=none}}</pre>~~		{{Building link\|Trappers' Camp\|size=medium}}
	Skips the icon, like in {{Building link\|Trappers' Camp\|size=none}} so it's easy to flow into paragraphs about villagers trapping and gathering things. The small version of building icons isn't very recognizable, as you can see in {{Building link\|Trappers' Camp\|size=~~small~~}} ~~so no icon is strongly advised.~~


	<pre>{{Building link\|name=Ranch\|large}}</pre>		<pre>{{Building link\|name=Ranch\|large}}</pre>
	Yields a larger icon for ~~great~~ recognition:		Yields a larger icon for good recognition for use in tables with space that allows it:

	{{Building link\|name=Ranch\|large}}		{{Building link\|name=Ranch\|large}}
Line 64:		Line 64:

	<pre>{{Building link\|Ranch\|size=huge}}</pre>		<pre>{{Building link\|Ranch\|size=huge}}</pre>
	Yields the largest icon, which is great for headlining tables ~~about~~ this building:		Yields the largest icon, which is great for headlining tables featuring this building:

	{{Building link\|Ranch\|size=huge}}		{{Building link\|Ranch\|size=huge}}

76561197969631737: /* Parameters */ changing doc to default iconsize being none

2024-10-17T01:24:51Z

Parameters: changing doc to default iconsize being none

← Older revision		Revision as of 01:24, 17 October 2024
Line 32:		Line 32:
	* <code>large</code>		* <code>large</code>
	* <code>huge</code>		* <code>huge</code>
	The default for buildings is <code>~~medium~~</code>, ~~which is larger than line heights in~~ paragraphs ~~but is large enough to be recognizable~~.		The default for buildings is <code>none</code>, suitable for paragraphs.
	\|-		\|-
	\| display \|\| string \|\| If you include <code>display=notext</code> only the icon will be rendered. There are currently no other options for this parameter.		\| display \|\| string \|\| If you include <code>display=notext</code> only the icon will be rendered. There are currently no other options for this parameter.
Line 39:		Line 39:
	\|}		\|}

	Building links that are written into paragraphs should use ~~either~~ no ~~icon or a small~~ icon, ~~neither of~~ which is the default. The small icon for buildings is not recognizable (compared to species, resources, or specializations). Avoid it unless necessary, but it is available in case it is needed.		Building links that are written into paragraphs should use no icon, which is the default. The small icon for buildings is not recognizable (compared to species, resources, or specializations). Avoid it unless necessary, but it is available in case it is needed.

	Note that adding "s" after the template call no longer includes the "s" in the link as it used to.		Note that adding "s" after the template call no longer includes the "s" in the link as it used to.

76561197969631737: /* Other examples */ reordering examples within this section

2024-10-15T03:43:15Z

Other examples: reordering examples within this section

← Older revision		Revision as of 03:43, 15 October 2024
Line 74:		Line 74:

	{{Building link\|Ranch\|s}}		{{Building link\|Ranch\|s}}


	~~<pre>{{Building link\|Trappers' Camp\|s\|size=gigantic}}</pre>~~
	~~Specifying an icon size that is not recognized does not return an error. Instead, the default medium-sized icon is used:~~

	~~{{Building link\|Trappers' Camp\|s\|size=gigantic}}~~


Line 94:		Line 88:
	* {{Building link\|Smithy\|s\|size=none}}		* {{Building link\|Smithy\|s\|size=none}}
	* {{Building link\|Tinctury\|s\|size=none}}		* {{Building link\|Tinctury\|s\|size=none}}


			<pre>{{Building link\|Trappers' Camp\|s\|size=gigantic}}</pre>
			Specifying an icon size that is not recognized does not return an error. Instead, the default medium-sized icon is used:

			{{Building link\|Trappers' Camp\|s\|size=gigantic}}

	=== Errors ===		=== Errors ===

← Older revision		Revision as of 03:26, 28 October 2025
Line 72:		Line 72:
	=== Other examples ===		=== Other examples ===

	<pre>{{Building link\|Ranch\|s}}</pre>		<pre>{{Building link\|Ranch\|es}}</pre>
	Formats the link so the name appears plural, but still links to the correct page (hover to see tooltip, or click):		Formats the link so the name appears plural, but still links to the correct page (hover to see tooltip, or click):

	{{Building link\|Ranch\|s}}		{{Building link\|Ranch\|es}}


	<pre>{{Building link\|Apothecary\|s\|size=none}}</pre>		<pre>{{Building link\|Apothecary\|ies\|size=none}}</pre>
	Mentioning how important {{Building link\|Apothecary\|s\|size=none}} are to your villagers ~~does format~~ the ~~building name correctly as plural. The pages for~~ the ~~names of buildings ending in~~ ''-y'' ~~when plural like~~ the ~~{{Building link\|Brewery\|s\|size=none}} have already been created~~ as ~~redirect pages, so you may use them freely:~~		Mentioning how important {{Building link\|Apothecary\|ies\|size=none}} are to your villagers just requires an extra switch to tell the template you need the ''-y'' replaced with ''-ies'' to format the building name correctly as plural.
	* {{Building link\|Apothecary\|s\|size=none}}
	* {{Building link\|Bakery\|s\|size=none}}
	* {{Building link\|Beanery\|s\|size=none}}
	* {{Building link\|Brewery\|s\|size=none}}
	* {{Building link\|Distillery\|s\|size=none}}
	* {{Building link\|Granary\|s\|size=none}}
	* {{Building link\|Manufactory\|s\|size=none}}
	* {{Building link\|Monastery\|s\|size=none}}
	* {{Building link\|Smithy\|s\|size=none}}
	* {{Building link\|Tinctury\|s\|size=none}}

← Older revision		Revision as of 02:16, 18 October 2024
Line 104:		Line 104:
	<pre>{{Building link\|Library}}</pre>		<pre>{{Building link\|Library}}</pre>
	Naming a building that doesn't exist in the game: {{Building link\|Library}}		Naming a building that doesn't exist in the game: {{Building link\|Library}}

			<pre>{{Building link\|huge\|Ranch\|es}}</pre>
			The same goes for swapping the order of the parameters so that the building is not first: {{Building link\|huge\|Ranch\|es}}

← Older revision		Revision as of 01:10, 18 October 2024
Line 47:		Line 47:
	=== Basic usage ===		=== Basic usage ===

	<pre>{{Building link\|~~Ranch~~}}</pre>		<pre>{{Building link\|Trappers' Camp}}</pre>
	~~Yields~~ a ~~suitably sized icon~~ for ~~recognition and~~ use in ~~tables:~~		Makes a simple text-only link to the {{Building link\|Trappers' Camp}} article for use in-line in paragraphs like this that discuss villagers trapping and gathering things. Remember that using the small version of building icons like the {{Building link\|Trappers' Camp\|size=small}} is strongly advised against, because there aren't enough pixels to make them recognizable to the broad audience of this wiki.

	~~{{Building link\|Ranch}}~~

			<pre>{{Building link\|Trappers' Camp\|size=medium}}</pre>
			Yields an icon just big enough to be recognizable. Suitable for tables that list the buildings where layout provides some space for icons:

	~~<pre>{{Building link\|Trapper's Camp\|size=none}}</pre>~~		{{Building link\|Trappers' Camp\|size=medium}}
	Skips the icon, like in {{Building link\|Trappers' Camp\|size=none}} so it's easy to flow into paragraphs about villagers trapping and gathering things. The small version of building icons isn't very recognizable, as you can see in {{Building link\|Trappers' Camp\|size=~~small~~}} ~~so no icon is strongly advised.~~


	<pre>{{Building link\|name=Ranch\|large}}</pre>		<pre>{{Building link\|name=Ranch\|large}}</pre>
	Yields a larger icon for ~~great~~ recognition:		Yields a larger icon for good recognition for use in tables with space that allows it:

	{{Building link\|name=Ranch\|large}}		{{Building link\|name=Ranch\|large}}
Line 64:		Line 64:

	<pre>{{Building link\|Ranch\|size=huge}}</pre>		<pre>{{Building link\|Ranch\|size=huge}}</pre>
	Yields the largest icon, which is great for headlining tables ~~about~~ this building:		Yields the largest icon, which is great for headlining tables featuring this building:

	{{Building link\|Ranch\|size=huge}}		{{Building link\|Ranch\|size=huge}}