ChordPro

El formato de archivo ChordPro es un formato común utilizado en otras aplicaciones de software. OnSong entiende este formato de forma nativa. OnSong reconoce archivos con las siguientes extensiones de archivo: .chordpro, .chopro, .cho, .crd, .pro

El formato ChordPro permite que la información de la canción se exprese en etiquetas delimitadas por llaves. Esta información se puede dividir lógicamente en etiquetas de metadatos y etiquetas en línea.

Etiquetas de metadatos

Estas son etiquetas ChordPro que usarías en la sección de metadatos de la canción. En las siguientes etiquetas, tres puntos (...) representan el texto que proporciones, que va entre los dos puntos y la llave de cierre. Por ejemplo:

{title: Amazing Grace}
{key: G}

OnSong admite las siguientes etiquetas ChordPro:

• {title: ...} o {t: ...} El título de la canción.
• {subtitle: ...}, {st: ...} o {su: ...} El nombre del artista o cualquier otra información de crédito. Puedes especificar varios artistas separando los nombres con un punto y coma. - Kim Walker-Smith; Chris Quilala
• {album: ...} El nombre del álbum donde se encuentra la canción.
• {artist: ...} o {a: ...} El nombre del artista o cualquier otra información de crédito. Puedes especificar varios artistas separando los nombres con un punto y coma. - Kim Walker-Smith; Chris Quilala
• {author: ...} El nombre de la persona que creó el gráfico de acordes. Se muestra en la parte inferior del gráfico de acordes y en la proyección de letras.
• {key: ...} o {k: ...} o {ok: ...} La tonalidad de la canción escrita como una clave con preferencia enarmónica y una "m" opcional para indicar menor. - alfabético, por ejemplo Bb o Em
• {capo: ...} El cejilla a establecer como número de trastes - numérico
• {tempo: ...} Los latidos por minuto (BPM) - numérico
• {time: ...} La firma de tiempo - numérico de pulso sobre compás, por ejemplo 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, úsalo para himnos, años, etc. Puedes ordenar canciones por el número como referencia.
• {flow: ...} La disposición de secciones - lista de etiquetas de secciones. Consulta Flujo para obtener detalles sobre cómo organizar el flujo de una canción.
• {midi: ...} Los comandos MIDI a enviar cuando se ve la canción. Consulta Sintaxis MIDI para saber cómo expresar comandos MIDI como texto en OnSong.
• {midi-index: ...} Los comandos MIDI que activarán la apertura de esta canción en el Visor de canciones. Consulta Sintaxis MIDI para saber cómo expresar comandos MIDI como texto en OnSong.
• {pitch: ...} Las notas a reproducir al usar la función Tubería de afinación.
• {keywords: ...} o {topic: ...} La lista de etiquetas a usar con búsqueda de tema. Consulta Temas para obtener más información sobre cómo examinar por tema.
• {copyright: ...} o {footer: ...} o {f: ...} Especifica el texto del pie de página de copyright a aparecer en la parte inferior de la página o proyección de letras.
• {ccli: ...} El número CCLI de la canción.
• {restrictions: ...} La gestión de derechos para la lista delimitada por comas de restricciones de la canción. Consulta Restricciones para obtener detalles sobre cómo establecer restricciones para tu canción.
• {composer: ...} Los individuos que escribieron la música de la canción. Esta lista debe estar separada con punto y coma para valores separados.
• {lyricist: ...} Los individuos que escribieron la letra de la canción. Esta lista debe estar separada con punto y coma para valores separados.

Etiquetas en línea

Estas etiquetas se utilizan dentro del contenido de la canción y se pueden usar para definir secciones o para formatear partes de la canción.

• {define: ...} se utiliza para definir diagramas de acordes personalizados. Consulta Definir acordes para obtener más información.
• {comment: ...} o {c: ...} Define un comentario y aparece como una instrucción musical.
• {comment_bold: ...} o {cb: ...} Define texto a aparecer en negrita.
• {comment_italic: ...} o {ci: ...} Define texto a aparecer en cursiva.
• {guitar_comment: ...} o {gc: ...} Define un comentario que aparece como una instrucción musical.
• {start_of_verse: ..} o {sov} Declara el inicio de una sección de verso con una etiqueta de sección opcional.
• {end_of_verse} o {eov} Declara el final de una sección de verso.
• {start_of_chorus: ...} o {soc} Declara el inicio de una sección de coro con una etiqueta de sección opcional.
• {end_of_chorus} o {eoc} Declara el final de una sección de coro.
• {start_of_bridge: ...} o {sob} Declara el inicio de una sección de puente con una etiqueta de sección opcional.
• {end_of_bridge} o {eob} Declara el final de una sección de puente.
• {start_of_part: ..} o {sop} Declara el inicio de una parte con una etiqueta de sección opcional.
• {end_of_part} o {eop} Declara el final de una parte.
• {start_of_tab} o {sot} Declara el inicio de tabulatura que OnSong renderiza en una fuente de espaciado fijo.
• {end_of_tab} o {eot} Declara el final de una sección de tabulatura.
• {new_page} o {np} Se utiliza para declarar una nueva página.
• {new_physical_page} o {npp} Se utiliza para declarar una nueva página.

Etiquetas de formato

Las siguientes etiquetas se utilizan para definir el tipo y tamaño de fuente predeterminados para letras y acordes en el gráfico de acordes.

• {textsize: ...} Define el tamaño de las letras como un valor numérico en puntos.
• {textfont: ...} Define el nombre de la fuente a usar para las letras. Debe ser compatible con la plataforma.
• {chordsize: ...} Define el tamaño de los acordes como un valor numérico en puntos.
• {chordfont: ...} Define el nombre de la fuente a usar para los acordes. Debe ser compatible con la plataforma.

Extensiones de archivo compatibles

El formato de archivo ChordPro es único en que es una sintaxis comúnmente acordada, pero no un formato estándar. Esto significa que varios proveedores pueden implementarlo de diferentes maneras y con diferentes extensiones de archivo. OnSong admite las siguientes extensiones de archivo al importar archivos con formato ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm