Metadatos

Las metatiquetas son una forma de proporcionar información sobre una canción y se expresan en una sección de metadatos. Los metadatos se expresan en la primera sección de la canción antes de la primera línea en blanco o hasta que no se encuentren más metatiquetas. Las metatiquetas son pares nombre/valor donde el nombre está a la izquierda y el valor a la derecha separados por dos puntos. Solo una metatiqueta puede aparecer por línea. Por favor, consulte el Formato de archivo ChordPro para obtener detalles sobre cómo expresar metadatos en el formato ChordPro.

OnSong asigna automáticamente la primera línea de un archivo de texto como el título de la canción si no está en formato de metatiqueta. Además, la segunda línea se considera el artista/crédito de la canción a menos que se defina una metatiqueta. A continuación se muestra un ejemplo de una sección típica de metadatos de canción que establece el título y el artista como la primera y segunda líneas, así como la clave y el tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Etiquetas de metadatos

OnSong admite las siguientes etiquetas:

• Title: El título de la canción. Esto también se puede expresar en la primera línea del contenido de la canción.
• Artist: El nombre del artista u otra información de crédito. Esto también se puede expresar en la segunda línea del contenido de la canción. Puede especificar múltiples artistas separando los nombres con un punto y coma. - Kim Walker-Smith; Chris Quilala
• Author: El nombre de la persona que creó el diagrama de acordes. Se muestra en la parte inferior del diagrama de acordes y en la proyección de letras.
• Key: La clave de la canción escrita como una clave con preferencia enarmónica y una "m" opcional para indicar menor. - alfabético, p. ej. Bb o Em
• TransposedKey: La clave deseada en la que se debe tocar la canción, que puede ser diferente de la clave en la que se escribió. - alfabético, p. ej. Bb o Em
• In: es un sinónimo de la etiqueta de metadatos de clave transpuesta.
• Capo: El capo a establecer como número de trastes. Típicamente es un número entero positivo (1 a 11) pero también puede ser un número entero negativo. - numérico
• Tempo: Los latidos por minuto (BPM). - numérico
• Time: La signatura de tiempo. - numérico de pulso sobre compás, p. ej. 3/4
• Duration: La duración de la canción para desplazamiento automático. - segundos o mm:ss
• Book: El nombre del libro o libros en los que colocar la canción. Esta es una lista delimitada por comas de nombres de libros en los que se colocará la canción. Si el libro no existe, se creará automáticamente.
• Number: El número de la canción - numérico. Úselo para himnos, años, etc. Puede ordenar canciones por número como referencia.
• Flow: El arreglo de secciones. - lista de etiquetas de sección. Consulte Flow para obtener detalles sobre cómo organizar el flujo de una canción.
• MIDI: Los comandos MIDI a enviar cuando se visualiza la canción. Consulte Sintaxis MIDI para saber cómo expresar comandos MIDI como texto en OnSong.
• MIDI-Index: Los comandos MIDI que abrirán esta canción en el Visor de canciones. Consulte Sintaxis MIDI para saber cómo expresar comandos MIDI como texto en OnSong.
• Keywords: o Topic: La lista de etiquetas para usar con búsqueda por tema. Consulte Topics para obtener más información sobre cómo explorar por tema.
• Copyright: o Footer: o f: La información de derechos de autor de la canción. Esto aparecerá en la parte inferior del diagrama de acordes y la proyección de letras.
• CCLI: El número CCLI de la canción. Esto aparecerá en la parte inferior del diagrama de acordes y la proyección de letras.
• Restrictions: Estas son restricciones que previenen ciertas acciones dentro de una canción. Consulte Restrictions para obtener detalles sobre cómo establecer restricciones para su canción.
• Pitch: La nota o notas a tocar cuando se utiliza la función Pitch Pipe. Se define como una lista de notas separadas por espacios con octavas opcionales. - p. ej. A3 C#4 E5
• Subdivision: o Beat: le permite elegir la subdivisión para la canción. Esto puede ser un valor que incluya: whole, half, quarter, eighth, shuffle, o sixteenth. Alternativamente, puede usar un número entero como 1, 2, 4, 8, o 16.
• Transpose: El número de semitonos para transportar la canción. Se utiliza a mitad de la canción para modular la canción hacia arriba o hacia abajo y se adapta con la clave establecida en los deslizadores de transposición. Este número debe ser un número entero positivo o negativo.
• Tuning: La afinación del instrumento a asignar a la canción. Estas son específicas del instrumento y actualmente solo se admite guitarra con estos valores: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G, u Open E.
• Scene: La escena a reproducirse cuando se carga la canción. Esto se puede establecer ingresando el nombre de la escena después de los dos puntos.

Etiquetas en línea

Algunas etiquetas se pueden usar dentro de una canción para afectar la transposición a mitad de la canción. Estas incluyen:

• Capo: se puede usar para aplicar un capo a mitad de la canción, modulando la canción hacia abajo para proporcionar acordes a tocar con el capo aplicado. Puede ajustar la dirección de modulación en Configuración de Capo. Típicamente es un número entero positivo (1 a 11) pero también puede ser un número entero negativo para eliminar un capo anterior. - numérico
• Key: para establecer la clave explícitamente en la canción. Si rodea el valor con corchetes al usar acordes entre corchetes, la clave resultante también será transpuesta. - alfabético, p. ej. Bb o Em
• Transpose: transpone la canción el número deseado de semitonos. Es un número entero positivo o negativo. Por ejemplo, use 2 o +2 para transportar la canción una segunda mayor, o use -3 para transportar hacia abajo tres semitonos. - numérico

Etiquetas de sección

Algunas etiquetas se pueden usar para proporcionar información sobre cada sección de la canción. Estas incluyen:

• MIDI: Los comandos MIDI a enviar cuando se selecciona la sección. Consulte Sintaxis MIDI para saber cómo expresar comandos MIDI como texto en OnSong.
• Scene: La escena a reproducirse cuando se selecciona la sección. Esto se puede establecer ingresando el nombre de la escena después de los dos puntos.

Nota: Las metatiquetas no distinguen entre mayúsculas y minúsculas