Plantilla:Mapa de ruta

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

Esta plantilla se utiliza para construir plantillas de diagramas de ruta . Es la sucesora basada en Lua de las plantillas {{ BS-map }} , que fueron reemplazadas por {{Routemap}} en la Wikipedia en inglés, pero que aún se utilizan en otras 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 =  | fondo del título =  | fondo = | en línea =  | colapsable = | contraer = | leyenda = | leyenda alt = | flotante = | estilo = | superior = | nota al pie = | ancho del texto = | mapa = }}          

Marcado para el parámetro del 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 se crea simplemente con un retorno de carro (nueva línea).

Básico

ID del icono \ ID del icono \ ID del icono

• Los iconos están separados por la barra invertida \ .
• Cada grupo de iconos está centrado en su fila. El icono sin nombre (al comienzo de la fila 5 del diagrama) se puede utilizar como espaciador.
• El ID de cada icono se puede ver en la 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./tiempo ~~ texto principal ~~ observación ~~ observación derecha

o

ID del icono \ ID del icono \ ID del icono ~~ texto principal

• El tercer y cuarto par de tildes se pueden omitir si no hay contenido despué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 .
• Para separar celdas de texto se requiere al menos un espacio vacío; de lo contrario, las tildes se tratarán 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 de uno de los prefijos de ancho de los BSicons. (Los BSicons 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 ícono que se va a superponer.
• La superposición es prácticamente ilimitada, pero hay que tener en cuenta la legibilidad.
• El ancho del icono subyacente determina el ancho de la combinación, incluso si es menor que el de la superposición. Los iconos se alinean con sus bordes izquierdos juntos, de modo que no se centrarán 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).
• Al utilizar la superposición de íconos y el enlace de íconos para la misma celda de ícono, el separador de enlace de íconos ( !@) debe seguir al último ID de ícono superpuesto (superior).
• El parámetro de color de fondo ( bg=) requiere 5 conjuntos de separadores de texto precedentes para ser reconocible incluso si no hay texto alguno en esa fila.

Otras opciones de formato

Filas

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

Celdas/iconos individuales

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

• Los parámetros para un solo ícono o celda de texto (por ejemplo BHF, *Text) están precedidos por dos guiones bajos ( __).
• Los parámetros del contenido de una celda de 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 ( !_). Esto debe seguir al enlace (si lo hay).
• 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 bg=anularán color=los valores de los parámetros de fila.

Plegable

• Ajuste |text-width=(o |tw=) el parámetro hasta que no haya interrupción.
  • La unidad es "px" por defecto, pero otras unidades como "em" son aceptables.
  • Verifique el mapa en un navegador diferente y en la vista móvil, y aumente el ancho del texto si está roto.
• 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 más ancha no plegable.
  • 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 " colapsado " a " nulo " cambiará el estado predeterminado de la sección colapsable a no colapsada.

Reemplazo plegable

• Tanto las filas de reemplazo como las reemplazadas deben tener el mismo ancho que la fila más ancha no colapsable del diagrama.
• Si desea ocultar la fila reemplazada después de expandir el elemento contraíble, use el ícono ( leer) como relleno vacío como en el ejemplo 4.2.
• En cualquier caso, es importante proporcionar un ancho de texto suficiente. En este caso, el uso de text-width=120 rompería la alineación de los íconos.
• Los elementos contraíbles están deshabilitados 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 doble

Para diagramas más grandes y complicados, a menudo es ú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./tiempo izquierda ! ! ID de icono ~~ dist./tiempo derecha ~~ texto principal derecha ~~ observación derecha ~~ observación derecha-derecha

o

¡ Texto principal izquierdo ! ¡ Identificación del 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 ícono.
• 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 que el 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, se puede omitir esa definición de ancho, como en el ejemplo 6.2.
• Defina el ancho general de la tabla con el {{{style}}}parámetro if {{{text-width}}}por sí solo no puede evitar una ruptura.
• Si se está aplastando la celda de icono vacía de la fila colapsable, utilice el icono 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 Routemap

Políticas de conversión

Muchos de los colaboradores 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 de BS heredadas por Routemap basado en Lua. Los oponentes consideran que los marcados de mapas de Routemap son demasiado esotéricos para que los editores que no están familiarizados con el marcado de Routemap los modifiquen. Mientras que los defensores apoyan una conversión completa para un mejor rendimiento. No se ha llegado a un consenso en este 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 plantilla en la página de inclusión, lo que significa que la plantilla no se expande en su apariencia prevista sino que solo se muestra el enlace a la página de plantilla, por lo que existe una necesidad inminente de traducir el mapa al diseño de Routemap para reducir el tamaño de inclusión posterior a la expansión.
• Si no hay ningún 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 cuestiona el cambio en Routemap, conserve el diseño de la plantilla de fila de la base de datos.

Opciones técnicas

Todas las plantillas de fila de BS han tenido contrapartes sustituibles creadas; por lo tanto, la conversión se puede realizar fácilmente anteponiendo subst:y anexando /safesubsta cada nombre de plantilla de fila de BS en el mapa. Por ejemplo, cambie {{BS2|STR|BHF|0|1|2|3|O1=uSTRq}}en el mapa a {{subst:BS2/safesubst|STR|BHF|0|1|2|3|O1=uSTRq}}, 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 el Bloc de notas o Notepad++ , pero la regla de búsqueda para las plantillas de fila de BS idealmente debería ser una expresión regular , como \{\{(BS\d*(\-2)?)\|→ {{subst:$1/safesubst|, para evitar plantillas con nombres similares como BSto y BSsplit en caso de que estén presentes en el mapa.

La "edición en modo 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 puedes utilizar la función "convertbs" del Módulo:Routemap.

Función convertbs

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:

{{ #invoke : Mapa de ruta | convertbs |< nowiki ></ nowiki >}}

Luego, copie y pegue el código del mapa BS-map o BS-table original entre las <nowiki>etiquetas (o, alternativamente, pegue el encabezado de invocación de convertbs antes del código del mapa original y la </nowiki>}}terminación después del código del mapa) y show preview . Generará la versión safesubst y mostrará las versiones originales (para comparación) del código del mapa. Copie el código safesubst del área de vista previa al área de edición y debe 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:convertbs|1=}}

Si no funciona, es posible que no hayas copiado parte del código relevante, como el marcado de tablas para diagramas de tablas BS, o que hayas 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 independiente que se incrustará en un cuadro de información, incluya inline=1 entre <includeonly>...</includeonly>las etiquetas. También es útil {{{navbar pos}}} para ubicar mejor la {{ Navbar }} .

Datos de plantilla

Estos son los datos de plantilla de esta plantilla que utilizan TemplateWizard, VisualEditor y otras herramientas. Consulte un informe de uso de parámetros mensual para Template:Routemap en artículos basados ​​en sus datos de plantilla.

TemplateData para el mapa de ruta

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

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