Wikipedia:Route diagram template/Transwiki guide

Route diagram template project involves lots of templates to be functional, in order to allow the map in other Wiki which has not yet adopted this project to display correctly, you will need to copy the required templates carefully. If you have more questions regarding transwikiing this project, go to the home discussion page, Wikipedia talk:Route diagram template, and leave the message.

Icon

You do not need to upload any icons to your local Wiki because they are shared in Wikimedia Commons. However, if your Wiki project is not directly affiliated to Wikimedia Foundation such as Wikia, you do need to upload all the license-free icons to your local Wiki web space. You can find all the icons of this project in Commons:category:BSicon and its subcategories, or check the catalog of pictograms for list of explanation of the icons. For starter, you will at least need (KBHFa), (BHF), (STR) and (KBHFe) to comprise the most basic map.

Template

This project was originally created by German Wikipedians, but since its adoption to English Wikipedia, the project/templates continue to expand while the German Wikipedians prefer to keep the project as simple as possible. However, because the English Wikipedia counterpart has a backward compatibility with the German code (map code in German Wikipedia technically works fine in English Wikipedia without additional modification), it is highly recommended to apply the English Wikipedia version.

Fundamental template

{{Superimpose2}} & {{Superimpose2/base}} for the 5-layer icon overlapping function.
{{BS-overlap}}
{{BSpx}}
{{BS-map}} & {{BS-map/map}}, you may need to translate the text "legend" if your Wiki is not in English. Also you may add more parameter definition of your home language in the "#switch:" parser which is applied to decide which legend page to be linked to. The following 3 templates are often used together for 1 map. On June 5, 2011 they were replaced by BS-map for the sake of simplicity. However, these templates are already widely used even outside of English Wikipedia. If you know you will be copying most of the existing maps to your home Wiki and do not want to bother with replacing them by BS-map, you should adopt these templates as well but tell the other editors to stop using them:
- {{Railway line header}}
- {{BS-header}}
- {{BS-table}}, may require translating the text "legend".
{{Navbar}}, most Wikimedia projects already have this template adopted. If not, you may need to ask admin of your local Wiki to help because it requires editing common CSS page which is not open to normal user. If you do not want to bother with it, remove the transclusion of Navbar from BS-map and BS-header.
{{BS-Infobox}}
{{BS-alt}}
- BS-alt was created under the Wikipedia:alternative text for images guideline. However, the overwhelmingly large amount of the icons for this project proves this template too difficult to be maintained or translated. If you want to skip BS-alt by voiding the alt attribute of all icons in the BS row templates altogether, copy the {{BS-overlap/noalt}} to your BS-overlap instead.

Row template

The number in these row templates indicates how many grid the template provides to display the icon horizontally. Theoretically it can be expanded endlessly, 8 icons per row is enough in most cases. Otherwise the map will spread too far and other method of rendering the map is recommended over this project. Create more row templates on demand or the admin may delete the unused.

{{BSrow}}, {{BS}}, {{BS2}}, {{BS3}}, etc.
{{BSrow-sc}}, {{BS-startCollapsible}}, {{BS2-startCollapsible}}, {{BS3-startCollapsible}}, etc.
{{BSrow-2}}, {{BS-2}}, {{BS2-2}}, {{BS3-2}}, etc.

The BSrow* templates are used to define the master format for its child templates. This is especially helpful for wiki of right-to-left writing system so editor only needs to modify the BSrow* template rather than the rest of the child row templates one by one.

Legend

The "legend" in BS-map or BS-table which links to any of these pages:

{{Railway line legend}} for generic railway map, the default legend.
{{Railway track legend}} for railway track and platform alignment diagram.
{{Bus route legend}} for any type of bus route map.
{{Waterways legend}} for waterway or canal map.
Trails icon catalog for footpath map.

Although most legend pages use the template namespace, you can apply other namespace like project, help or even no namespace (for general article if it is your personal Wiki) if you see fit, just remember to revise the legend link in the BS-map and BS-table.

If you find some of the term difficult to be translated into your home language, you can ring the code of the row by  to hide it temporary until other editor helps the translation.

Optional template

{{BSrow-replace}}, {{BS-replace}}, {{BS2-replace}}, {{BS3-replace}}, etc. Replace the BS#-startCollapsible template with one of these templates in the map when the collapsed section expanded.
{{BSkm}} for fractional display of text.
{{BS!}} for generating non-image color stripe with its height adjustable by parameter, primarily used by Russian and other Slavic metro maps.
{{RoutemapRouteIcon}} & {{RoutemapRoute}} for display of arrow icons in the text column.
{{Railway line header (center)}}, {{Railway line header2}}, {{Railway line header2 (center)}}, variations of {{Railway line header}}.
{{BS-daten}} and {{Infobox UK railway}}, infoboxes under {{Railway line header}}, may require translation.
{{BS-table3}}, {{infobox rdt}} for transcluding map in other infobox.
{{Rdt intro}} for adding description in map template page, may require translation.
{{BSicon quote}} (bsq) for quoting the icon in discussion page.
{{Colorbox}} for adding a colored square before the map title for indicating the livery color of the subject. According to WP:COLOR guideline, this is better than coloring the text or background of text for the sake of accessibility.

Major difference in other Wikimedia project

This section compares the major differences of other Wikimedia projects with English Wikipedia. If you have modified the RDT project in your home Wikimedia project, please kindly add or update the status in here.

Last update: 15 January 2012
Features	DE	EN	FR	HE	JA	KO	PT	RU	SV	UK	ZH
{{Railway line header}}, {{BS-header}}, {{BS-table}}	Partial	Yes	Partial	Yes	Yes	No	Yes	Yes	Yes	Yes	Yes
{{BS-map}}	No	Yes	Partial	No	No	Partial	Yes	Yes	No	No	Yes
BS# row templates (basic)	Yes	Yes	Partial	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
BS#-startCollapsible row templates	No	Yes	No	No	Yes	No	Yes	Yes	No	No	Yes
BS#-2 row templates	No	Yes	No	No	Yes	Partial	Yes	Yes	Partial	Partial	Yes
Icon overlapping (available layers)^[1]	No	5	4*	5	2*	1	5	5	No	1	5
Icon wikilink^[1]	No	Yes	No	Yes	No	No	Yes	Yes*	No	Yes*	Yes

^1 Parameters of all kinds of BS# row templates.

DE - German Wikipedia

{{Railway line header}} is not needed to define the standalone map table style.
To translate the map of de:Vorlage:BSe to conventional BS# row templates, add the letter e before every icon name in the row template.

FR - French Wikipedia

{{Railway line header}} and {{BS-header}} are merged into fr:Modèle:BS-table. This is somehow similar to {{BS-map}} but still requires the syntax, {|, for calling the table manually.
BS# row templates employ a different set of icon names which we strongly discourage. Because it makes it difficult to adopt the maps from French Wikipedia to other Wiki. Also it requires a separate template (Modèle:LCF_[French icon name]) for every icon individually before using the icon in the BS row template.
If you want to use the original icon name in French Wikipedia, use the BS#bis row templates instead (known as "Modèles internationaux"/"international template").
BS#bis templates support 4-layer icon overlapping while the basic BS# row templates do not. You can overlap 2 icons over the base icon (O# and O#2) and two icons under the base icon (U# and U#2).

JA - Japanese Wikipedia

Parameter name of second icon layer is P# instead of O#2.

KO - Korean Wikipedia

{{Railway line header}}, {{BS-header}} and {{BS-table}} are merged into one single template, ko:틀:노선도, this is now adopted back to English Wikipedia as {{BS-map}} and its functionality is further expanded.

RU - Russian Wikipedia, UK - Ukrainian Wikipedia

The parameter name of icon wikilink in row templates is link# instead of L#.