Icono de documentación de plantilla Documentación de la plantilla[ver] [editar] [historial] [purgar]

Objetivo

Esta plantilla se trata de un atajo para enlazar a los artículos sobre barcos que usan el formato "prefijo nombre del barco (año/numeral)". La razón para utilizar esta plantilla es que cuando el nombre del barco ha sido desambiguado, habría que escribirlo todo dos veces. Por ejemplo, la denominación "ARA General Belgrano" corresponde a dos navíos diferentes, uno asignado en 1898 y otro asignado en 1938. Si quisiéramos enlazar al primero habría que escribir [[ARA General Belgrano (1898)|ARA General Belgrano]]

En este caso, esta plantilla lo reduce a la mitad aproximadamente: {{barco|ARA|General Belgrano|1898}}.

De igual modo, reduce el número de caracteres a emplear cuando se quiera obviar alguno de los elementos que conforman el nombre del artículo de destino.

Uso

La sintaxis de la plantilla {{Barco}} es la siguiente:

{{Barco|Prefijo|Nombre del barco|ID|Parámetro de control}}

Parámetros

  • Prefijo: en general, el acrónimo naval oficial utilizado en la armada a la que pertenece el buque. Pero también puede ser el tipo de buque si el tipo antecede al nombre del barco en el título del artículo (por ejemplo, para el Bismarck, descrito en el artículo [[Acorazado Bismarck]], se usaría {{barco|Acorazado|Bismarck}}). Este parámetro es opcional.
  • Nombre del barco: nombre del buque. Este parámetro es obligatorio.
  • ID: puede ser el número de casco, el año de lanzamiento, el número de gallardete o, en general, el término utilizado entre paréntesis para desambiguar el nombre del artículo (por ejemplo, para el submanino Nautilus, descrito en el artículo [[Nautilus (1800)]], se usaría {{barco||Nautilus|1800}}). Este parámetro es opcional.

Ejemplos

Plantilla Wikicódigo equivalente Título del artículo Resultado final
{{barco||Méndez Núñez|1924}} [[Méndez Núñez (1924)|Méndez Núñez]] [[Méndez Núñez (1924)]]  Méndez Núñez (1924)
{{barco||Fernando Poo|motonave}} [[Fernando Poo (motonave)|Fernando Poo]] [[Fernando Poo (motonave)]]  Fernando Poo (motonave)
{{barco|motonave|Fernando Poo}} [[motonave Fernando Poo|Fernando Poo]] [[motonave Fernando Poo]] motonave Fernando Poo

Parámetro opcional de control

Existe un cuarto parámetro que controla que textos aparecen en el artículo. Se trata de un número entre 1 y 6, ambos incluidos, que transformado en su equivalente binario actúa como máscara que determina cuáles de los parámetros anteriores (tratados como bits) aparecen. Como la notación binaria no tiene por qué ser conocida, se incluye una tabla a continuación:

Valor decimal Valor binario Parámetros afectados
Ninguno 111 {{ |Prefijo|Nombre del barco|ID| }}
1 001 {{ |Prefijo|Nombre del barco|ID| }}
2 010 {{ |Prefijo|Nombre del barco|ID| }}
3 011 {{ |Prefijo|Nombre del barco|ID| }}
4 100 {{ |Prefijo|Nombre del barco|ID| }}
5 101 {{ |Prefijo|Nombre del barco|ID| }}
6 110 {{ |Prefijo|Nombre del barco|ID| }}

A continuación podemos ver algunos ejemplos del uso:

Valor Parámetros
mostrados
Ejemplo Wikicódigo equivalente Resultado final
Ninguno todos {{barco|HMCS|Kootenay|H75}} [[HMCS Kootenay (H75)|HMCS Kootenay (H75)]] HMCS Kootenay (H75)
1 3.º {{barco|HMCS|Kootenay|H75|1}} [[HMCS Kootenay (H75)|H75]] H75
2 2.º {{barco|HMCS|Kootenay|H75|2}}} [[HMCS Kootenay (H75)|Kootenay]] Kootenay
3 2.º y 3.º {{barco|HMCS|Kootenay|H75|3}}} [[HMCS Kootenay (H75)|Kootenay (H75)]] Kootenay (H75)
4 resultado no válido {{barco|HMCS|Kootenay|H75|4}}} [[HMCS Kootenay (H75)|{{error|Parámetro opcional no válido}}]] Parámetro opcional no válido
5 1.º y 3.º {{barco|HMCS|Kootenay|H75|5}}} [[HMCS Kootenay (H75)|HMCS (H75)]] HMCS (H75)
6 1.º y 2.º {{barco|HMCS|Kootenay|H75|6}}} [[HMCS Kootenay (H75)|HMCS Kootenay]] HMCS Kootenay
2.º
(sin 3.º)
{{barco|acorazado|Bismarck|4=2}} Uso alternativo: {{barco|acorazado|Bismarck||2}} [[acorazado Bismarck|Bismarck]] Bismarck

Nota: téngase cuidado con el tercer parámetro si no se utiliza el segundo. En el ejemplo de más arriba con el Yamato, el texto "|4=2" significa dar al cuarto parámetro el valor de "dos", mientras que la sintaxis alternativa utiliza un par de plecas, "||2", para poner el valor "dos" en la posición del cuarto parámetro.

Parámetro opcional para prefijo

El parámetro up (del inglés unlinked prefix, "prefijo no enlazado") puede usarse para tener un prefijo que no forme parte del enlace. Cuando se fija su valor a "yes", la plantilla hace que se muestre el prefijo antes del wikienlace. Este parámetro debe usarse con uno de los parámetros opcionales de control descritos en la sección anterior (de otra forma, el prefijo aparecerá dos veces, una dentro y otra fuera del wikienlace).

Ejemplos
  • {{barco|acorazado|Yamato|1941|2|up=yes}}

se muestra como:

Si se usa sin uno de los parámetros opcionales de control:

  • {{barco|acorazado|Yamato|1941|up=yes}}

da esto:

Plantillas derivadas

Para aquellos buques de armadas que usan acrónimos navales (prefijos), que existan gran cantidad de artículos, existen plantillas derivadas que evitan la colocación de la palabra "barco", reduciendo así aún más la cantidad de caracteres a emplear:

Esta documentación está transcluida desde Plantilla:Barco/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.