ChordPro

El formato de archivo ChordPro es un formato común utilizado en otras aplicaciones de software. OnSong comprende 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 utilizarías en la porció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 subtítulo. 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 subtítulo. 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 de la cejilla establecido como número de trastes - numérico
• {tempo: ...} Los tiempos por minuto (BPM) - numérico
• {time: ...} La indicación de compás - tiempo numérico 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, úsalo para himnos, años, etc. Puedes ordenar canciones por número como referencia.
• {flow: ...} El arreglo de secciones - lista de etiquetas de secciones. Consulta Flow para obtener detalles sobre cómo organizar el flujo de una canción.
• {midi: ...} Los comandos MIDI para enviar cuando se visualiza la canción. Consulta MIDI Syntax 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 Song Viewer. Consulta MIDI Syntax para saber cómo expresar comandos MIDI como texto en OnSong.
• {pitch: ...} Las notas a tocar cuando se utiliza la función Pitch Pipe.
• {keywords: ...} o {topic: ...} La lista de etiquetas para usar con búsqueda por tema. Consulta Topics para obtener más información sobre cómo explorar por tema.
• {copyright: ...} o {footer: ...} o {f: ...} Especifica el texto del pie de página de copyright que 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 de la canción — lista delimitada por comas de restricciones. Consulta Restrictions 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 Defining Chords 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 que aparecerá en negrita.
• {comment_italic: ...} o {ci: ...} Define texto que 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 tablatura que OnSong representa 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 la fuente y el tamaño predeterminados para las letras y los 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 Admitidas

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