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 proporcionas, 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 u otra información de presentación. 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 u otra información de presentación. 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 diagrama de acordes. Se muestra en la parte inferior del diagrama de acordes y en la proyección de letras.
• {key: ...} o {k: ...} o {ok: ...} La tonalidad de la canción escrita como una tonalidad con preferencia enarmónica y una "m" opcional para indicar menor. - alfabético, p. ej. Bb o Em
• {capo: ...} El traste capo establecido como número de trastes - numérico
• {tempo: ...} Los golpes por minuto (BPM) - numérico
• {time: ...} La métrica - valor numérico sobre compás, p. ej. 3/4
• {duration: ...} La duración de la canción para el 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, utilizar para himnos, años, etc. Puedes ordenar canciones por número para referencia.
• {flow: ...} La disposición de secciones - lista de etiquetas de sección. Consulta Flujo para obtener más detalles sobre la disposición del flujo de una canción.
• {midi: ...} Los comandos MIDI para 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 Visualizador de canciones. Consulta Sintaxis MIDI para saber cómo expresar comandos MIDI como texto en OnSong.
• {pitch: ...} Las notas para reproducir al usar la función Diapasón.
• {keywords: ...} o {topic: ...} La lista de etiquetas para usar con búsqueda de temas. Consulta Temas para obtener más información sobre la navegación por tema.
• {copyright: ...} o {footer: ...} Especifica el texto del pie de página de copyright que aparecerá en la parte inferior de la página o en la 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 más detalles sobre cómo establecer restricciones para tu canción.

Etiquetas en línea

Estas etiquetas se utilizan dentro del contenido de la canción y se pueden usar para definir secciones o para dar formato a 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 para aparecer en negrita.
• {comment_italic: ...} o {ci: ...} Define texto para 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 puente con una etiqueta de sección opcional.
• {end_of_bridge} o {eob} Declara el final de una sección 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 una tablatura que OnSong renderiza con una fuente monoespaciada.
• {end_of_tab} o {eot} Declara el final de una sección de tablatura.
• {new_page} o {np} Se utiliza para declarar una página nueva.
• {new_physical_page} o {npp} Se utiliza para declarar una página nueva.

Etiquetas de formato

Las siguientes etiquetas se utilizan para definir el tamaño y la fuente predeterminada para letras y acordes en el diagrama 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 utilizar 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 utilizar 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 aceptada, 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