Plantilla: mapa de ruta

Documentación de plantilla [ ver ] [ editar ] [ historial ] [ purgar ]

Esta plantilla se utiliza para construir plantillas de diagramas de ruta . Es el sucesor basado en Lua de las plantillas {{BS-map}}, que han sido reemplazadas por {{Routemap}} en la Wikipedia en inglés pero que todavía se utilizan en otros wikis.

Uso

{{ Mapa de ruta | barra de navegación =  | barra de navegación pos =  | barra de navegación mini =  | título =  | color del título =  | título bg =  | bg =  | en línea =  | plegable =  | colapso =  | leyenda =  | leyenda alt =  | flotador =  | estilo =  | arriba =  | nota al pie =  | ancho de texto =  | mapa = }}

Marcado para parámetro de mapa

El marcado para componer el diagrama en el |map=parámetro es diferente al de las plantillas basadas en {{BSrow}}. Las principales diferencias son los separadores en cada fila. Las subplantillas no son necesarias, ya que una nueva fila en la tabla simplemente se crea mediante un retorno de carro (nueva línea).

{{Mapa de ruta Agregue otros parámetros como |title=aquí.|mapa=¡El marcado del mapa va aquí!
}}

Básico

ID de icono \ ID de icono \ ID de icono

• Los iconos están separados por una barra invertida \ .
• Cada grupo de iconos está centrado en su fila. El ícono sin nombre (al comienzo de la fila 5 en el diagrama) se puede usar como espaciador.
• El ID de cada icono se puede ver en su información sobre herramientas . Mueva el cursor sobre los iconos para verlos.

Texto de la barra lateral

ID de icono \ ID de icono \ ID de icono ~~ dist./hora ~~ texto principal ~~ comentario ~~ comentario derecho

o

ID de icono \ ID de icono \ ID de icono ~~ texto principal

• El tercer y cuarto par de tildes se pueden omitir si no hay contenido detrás de ninguno de ellos.
• Después del último ID de icono, si solo hay un conjunto de " tilde -tilde" ( ~~), se mostrará el siguiente texto en la celda de texto principal en lugar de dist./time .
• Separar celdas de texto requiere al menos un espacio vacío; de lo contrario las tildes serán tratadas como una firma .

Celdas de texto en filas de iconos

* texto \d* texto \cd* texto ~~ texto principal

El asterisco que indica una celda de texto puede ir precedido por uno de los prefijos de ancho de los BSicons. (Los iconos B normales son cuadrados).

Superposición de iconos, enlace de iconos, color de fondo y colspan

• El separador de superposición "signo de exclamación-tilde" ( !~) debe seguir al ID del icono que se va a superponer.
• La superposición es prácticamente ilimitada, pero se debe tener en cuenta la legibilidad.
• El ancho del icono subyacente determina el ancho de la combinación, incluso si es menor que la superposición. Los iconos están alineados con sus bordes izquierdos juntos, de modo que no estarán centrados entre sí si difieren en ancho. Si la superposición se extiende más allá del icono subyacente, se superpondrá al siguiente icono (pero no a la superposición del siguiente icono).
• Cuando se utiliza la superposición de iconos y el enlace de iconos para la misma celda de iconos, el separador de enlaces de iconos ( !@) debe seguir al último ID del icono superpuesto (superior).
• El parámetro de color de fondo ( bg=) requiere 5 conjuntos de separadores de texto anteriores para ser reconocible incluso si no hay ningún texto en esa fila.

Otras opciones de formato

Filas

Además de bg=, hay varios otros parámetros, separados por comas ( ,), que se pueden utilizar para personalizar la visualización de una fila. Sólo bg=se puede utilizar para cambiar la visualización de iconos; todos los demás solo afectan las celdas de texto.

Celdas/iconos individuales

icono !_bg=púrpura\* texto __align=l!~* más texto __align=r,b= sí

• Los parámetros para un solo icono o celda de texto (por ejemplo BHF, *Text) están precedidos por dos guiones bajos ( __).
• Los parámetros para el contenido de una celda de una tabla (una pila de objetos superpuestos o un solo icono o cuadro de texto sin superposiciones) están precedidos por un signo de exclamación y un guión bajo ( !_). Para ello deberá seguir el enlace (si lo hubiera).
• Para el último elemento superpuesto en una pila, los parámetros del elemento individual (si los hay) deben preceder a los parámetros de la pila.
• La mayoría de los parámetros son los mismos que los de las filas, pero hay algunos adicionales. Además, los valores de align=y anularán los valores de los parámetros de fila bg=.color=

Plegable

• Ajuste el parámetro |text-width=(o |tw=) hasta que no haya interrupción.
  • La unidad es "px" de forma predeterminada, pero se aceptan otras unidades como "em".
  • Verifique el mapa en un navegador diferente y en la vista móvil, y aumente el ancho del texto si se rompe.
• El número de icono de la primera fila de la sección plegable debe ser igual o mayor que el número de icono de la fila no plegable más ancha.
  • Como en el ejemplo 3.2, utilice un icono vacío de medio ancho. ( d) como relleno cuando se mezclan filas pares e impares en el mismo mapa.
• Cambiar " contraído " a " nulo " cambiará el estado predeterminado de la sección contraíble a no contraído.

Reemplazo plegable

• Tanto las filas reemplazadas como las reemplazadas deben ser tan anchas como la fila no plegable más ancha del diagrama.
• Si desea ocultar la fila reemplazada después de expandir el elemento plegable, use el ícono ( leer) como relleno vacío como en el ejemplo 4.2.
• En cualquier caso, tenga en cuenta proporcionar un ancho de texto suficiente. Aquí, usar text-width=120 rompería la alineación de los íconos.
• Los elementos plegables se desactivan intencionalmente en la vista móvil, por lo que la fila reemplazada nunca será visible. Tenga esto en cuenta al crear un diagrama.

Barra lateral de texto dual

Para diagramas más grandes y complicados, suele ser útil tener una barra lateral de texto tanto a la izquierda como a la derecha.

observación izquierda-izquierda ~~ observación izquierda ~~ texto principal izquierda ~~ dist./hora izquierda ! ! ID de icono ~~ dist./hora derecha ~~ texto principal derecha ~~ observación derecha ~~ observación derecha-derecha

o

texto principal izquierdo ! ! ID de icono ~~ texto principal derecho

• Las celdas de texto de la izquierda requieren "signo de exclamación-espacio-signo de exclamación" ( ! !) que las separa de las celdas de iconos.
• Si no hay ~~un separador "tilde-tilde" ( ) a la izquierda de "signo de exclamación-espacio-signo de exclamación", el texto a la izquierda del separador se mostrará en la celda de texto principal izquierda .

Barra lateral de texto doble plegable

• Aplicar |text-width=para eliminar la rotura:
  • Sólo 1 valor:right main text+right remark
  • 3 valores, separados por comas:right dist./time,right main text+right remark,right-right remark
  • 6 valores:Left-left remark,left remark+left main text,left dist./time,right dist./time,right main text+right remark,right-right remark
  • Si el número de valores no es igual a 1, 3 o 6, se ignorará todo el parámetro.
• Si el ancho del texto del comentario de derecha a derecha es menor de lo necesario, se puede omitir su definición de ancho, como en el ejemplo 6.1.
• Si una celda de texto específica no se utiliza en ninguna parte del mapa, esa definición de ancho se puede omitir, como en el ejemplo 6.2.
• Defina el ancho general de la tabla con el {{{style}}}parámetro si {{{text-width}}}por sí solo no puede evitar una ruptura.
• Si se está aplastando la celda del ícono vacío de la fila plegable, use el ícono vacío ( leer) para corregir las columnas de iconos.

Filas de relleno

Descripción general de la sintaxis

Transición de la plantilla de fila BS heredada al marcado de mapa de ruta

Políticas de conversión

Muchos contribuyentes del proyecto English Route Diagram Template durante la implementación de Routemap tienen opiniones contradictorias sobre la justificación de reemplazar todos los mapas de las plantillas de filas BS heredadas por el Routemap basado en Lua. Los oponentes consideran que las marcas de mapas de Routemap son demasiado esotéricas para que los editores que no están familiarizados con las marcas de Routemap las modifiquen. Si bien sus defensores apoyan una conversión completa para un mejor rendimiento. No se ha llegado a un consenso por el momento, por lo que cualquier transición sin actualizar masivamente la apariencia del mapa para reflejar el servicio y/o el cambio estructural en la realidad solo debe realizarse con las siguientes consideraciones:

• El mapa del diseño de plantilla de fila BS heredado ha excedido el límite de tamaño de la plantilla en la página de transclusión, lo que significa que la plantilla no se expande a su apariencia prevista sino que solo se muestra el enlace a la página de la plantilla, por lo que existe una necesidad inminente de traducir el mapa en el diseño del mapa de ruta para reducir el tamaño de inclusión posterior a la expansión.
• Si no hay problema con el tamaño de la plantilla, respete la preferencia del colaborador inicial de la primera versión completa del diagrama. Si ese colaborador impugna el cambio en el mapa de ruta, conserve el diseño de la plantilla de fila BS.

Opciones técnicas

A todas las plantillas de filas BS se les han creado contrapartes sustituibles; por lo tanto, la conversión se puede realizar fácilmente anteponiendo subst:y añadiendo /safesubstcada nombre de plantilla de fila BS en el mapa. Por ejemplo, cambie {{BS2|STR|BHF|0|1|2|3|O1=uSTRq}}el mapa a {{subst:BS2/safesubst|STR|BHF|0|1|2|3|O1=uSTRq}}y luego publique los cambios; producirá STR!~uSTRq\BHF~~0~~1~~2~~3. El proceso se puede acelerar utilizando la función "reemplazar todo" de la herramienta de edición avanzada o un editor de texto independiente como Notepad o Notepad++ , pero lo ideal es que la regla de búsqueda para las plantillas de filas BS sea una expresión regular , como \{\{(BS\d*(\-2)?)\|→ {{subst:$1/safesubst|, para poder Evite plantillas con nombres similares como BSto y BSsplit en caso de que estén presentes en el mapa.

La "edición en modo de columna" puede evitar el problema de buscar y reemplazar para agregar safesubst:todas las filas de manera eficiente. Esta función es común en editores de texto avanzados como Geany , ^[1] Notepad++ ^[2] y Sublime Text ^[3] .

También puede utilizar la función "convertbs" del Módulo: Mapa de ruta.

Conversión de funciones

Copie y pegue el siguiente código en cualquier área de edición de esta wiki, tal vez la página del mapa en la que está trabajando:

{{ #invocar : Mapa de ruta | convertidos |< nowiki ></ nowiki >}}

Luego copie y pegue el código de mapa BS-map o BS-table original entre las <nowiki>etiquetas (como alternativa, pegue el encabezado invoke convertbs antes del código del mapa original y el </nowiki>}}final después del código del mapa) y muestre la vista previa . Generará la versión segura y mostrará las versiones originales (para comparar) del código del mapa. Copia el código de seguridad del área de vista previa al área de edición y debes eliminar todo #invoke:Routemap|convertbssi la vista previa del nuevo código funciona correctamente.

En la Wikipedia en inglés, la plantilla {{ subst:convertbs }} se puede utilizar como acceso directo:

{{subst:convierte|1=}}

Si no funciona, es posible que no haya copiado parte del código relevante, como el marcado de tablas para diagramas de tablas BS, o que haya copiado código que en realidad pertenece a otra cosa.

Incrustar en el cuadro de información

• Utilice {{{inline}}} para eliminar la barra de título y el borde de la tabla. Si crea una plantilla separada que se incrustará en un cuadro de información, ajuste inline=1 en <includeonly>...</includeonly>etiquetas. Además, {{{navbar pos}}} es útil para localizar mejor la {{ Navbar }}.

Datos de plantilla

Estos son los TemplateData para esta plantilla utilizados por TemplateWizard, VisualEditor y otras herramientas. Vea un informe mensual de uso de parámetros para Plantilla:Mapa de ruta en artículos basados ​​en sus TemplateData.

TemplateData para mapa de ruta

Plantilla para mostrar diagrama compuesto por imágenes de iconos y etiquetas de texto en estilo uniforme.

La documentación anterior está transcluida de Plantilla:Routemap/doc . ( editar | historial )
Los editores pueden experimentar en las páginas sandbox ( editar | diff ) y casos de prueba ( editar ) de esta plantilla .
Agregue categorías a la subpágina /doc . Subpáginas de esta plantilla .