Skip to content

Commit

Permalink
Merge pull request #683 from musicEnfanthen/feature/fix-guidelines-ve…
Browse files Browse the repository at this point in the history
…rsion

tutorials/website: fix guidelines version
  • Loading branch information
rettinghaus authored Sep 10, 2024
2 parents 54379fa + 17e719b commit 12967e4
Show file tree
Hide file tree
Showing 26 changed files with 62 additions and 62 deletions.
2 changes: 1 addition & 1 deletion _tutorials-ES/100_structure/100_structure_end.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ <h3>¡Felicidades!</h3>
<li>saber diferenciar entre dos secciones principales de un archivo MEI, la sección responsable de la información de metadatos (<code>&lt;meiHead&gt;</code>) y la sección responsable de la información sobre el contenido musical (<code>&lt;music&gt;</code>).</li>
</ul>
<p>
Dado que los temas tratados en este tutorial hacen referencia al capítulo <a href="https://music-encoding.org/guidelines/v4/content/shared.html#sharedStructuralElements" target="_blank" rel="noopener, noreferrer">Structural Elements</a> (<i>Elementos estructurales</i>) de las Directrices MEI, se recomienda consultar este capítulo siempre que se necesite información más detallada.
Dado que los temas tratados en este tutorial hacen referencia al capítulo <a href="/guidelines/v5/content/shared.html#sharedStructuralElements" target="_blank" rel="noopener, noreferrer">Structural Elements</a> (<i>Elementos estructurales</i>) de las Directrices MEI, se recomienda consultar este capítulo siempre que se necesite información más detallada.
</p>
<p>
Por supuesto, se necesita mucho más para un archivo de MEI completo: nos hemos dejado toda la información sobre cualquier contenido musical como compases, pentagramas, o notas, y también hay que aprender a configurar el compás, la tonalidad, y las claves. Aquí hay otros tutoriales que recomendamos como los siguientes pasos para aprender a codificar en MEI. Por supuesto, siempre puedes volver a ellos (o incluso a este) cuando lo necesites.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
En este tutorial, te familiarizarás con algunos antecedentes XML muy básicos y aprenderás acerca de la estructura externa de un documento MEI válido. Aprenderás a identificar las diferentes partes de un archivo MEI y qué tipo de información puedes esperar de ellas.
</p>
<p>
Los temas tratados en este tutorial hacen referencia al capítulo <a href="https://music-encoding.org/guidelines/v4/content/shared.html#sharedStructuralElements" target="_blank" rel="noopener, noreferrer">Structural Elements</a> (<i>Elementos estructurales</i>) de las Directrices MEI. Es recomendable consultar este capítulo siempre necesites información más detallada.
Los temas tratados en este tutorial hacen referencia al capítulo <a href="/guidelines/v5/content/shared.html#sharedStructuralElements" target="_blank" rel="noopener, noreferrer">Structural Elements</a> (<i>Elementos estructurales</i>) de las Directrices MEI. Es recomendable consultar este capítulo siempre necesites información más detallada.
</p>
<p>
Ten en cuenta que el código que escribas en este tutorial no puede ser renderizado inmediatamente porque carece de información sobre cualquier contenido musical.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
Primer paso: proporcionar algunas notas para un acorde.
</p>
<p>
En MEI, el concepto de acorde significa que "dos o más notas suenan simultáneamente en la misma capa con la misma duración (véase <a href="https://music-encoding.org/guidelines/v4/elements/chord.html" target="_blank" rel="noopener, noreferrer">Especificación de los elementos</a>). Por lo tanto, un acorde se forma a partir de dos o más notas que perteneces a la misma voz (capa) y tienen una estructura rítmica idéntica (duración). (Hay casos donde las notas de un acorde no tienen la misma duración; sin embargo, estos casos no son cubiertos por este tutorial básico.)
En MEI, el concepto de acorde significa que "dos o más notas suenan simultáneamente en la misma capa con la misma duración (véase <a href="/guidelines/v5/elements/chord.html" target="_blank" rel="noopener, noreferrer">Especificación de los elementos</a>). Por lo tanto, un acorde se forma a partir de dos o más notas que perteneces a la misma voz (capa) y tienen una estructura rítmica idéntica (duración). (Hay casos donde las notas de un acorde no tienen la misma duración; sin embargo, estos casos no son cubiertos por este tutorial básico.)
</p>
<p>
Para poder codificar ese "sonido simultáneo" en MEI, se utiliza el elemento <code>&lt;chord&gt;</code>. El uso es bastante claro: muchos elementos <code>&lt;note&gt;</code> dentro de la misma capa se cierran con un elemento <code>&lt;chord&gt;</code> y el atributo de duración (@dur) pasa del elemento <code>&lt;note&gt;</code> al elemento <code>&lt;chord&gt;</code> (puesto que la duración es la misma para todas las notas).
Expand Down
10 changes: 5 additions & 5 deletions _tutorials-ES/104_rests/104_rests_end.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,18 @@ <h3>¡Felicidades!</h3>
En este tutorial has aprendido a codificar silencios en MEI. Los elementos que hemos visto son:
<ul>
<li>
<a href="/guidelines/v4/elements/rest.html" target="_blank" ref="noopener, noreferrer">&lt;rest&gt;</a>
<a href="/guidelines/v5/elements/rest.html" target="_blank" ref="noopener, noreferrer">&lt;rest&gt;</a>
</li>
<li>
<a href="/guidelines/v4/elements/mrest.html" target="_blank" ref="noopener, noreferrer">&lt;mRest&gt;</a>
<a href="/guidelines/v5/elements/mRest.html" target="_blank" ref="noopener, noreferrer">&lt;mRest&gt;</a>
</li>
<li>
<a href="/guidelines/v4/elements/multirest.html" target="_blank" ref="noopener, noreferrer">&lt;multiRest&gt;</a>
<a href="/guidelines/v5/elements/multiRest.html" target="_blank" ref="noopener, noreferrer">&lt;multiRest&gt;</a>
</li>
<li>
<a href="/guidelines/v4/elements/space.html" target="_blank" ref="noopener, noreferrer">&lt;space&gt;</a>
<a href="/guidelines/v5/elements/space.html" target="_blank" ref="noopener, noreferrer">&lt;space&gt;</a>
</li>
</ul>
Estos elementos están casi siempre vacíos (no contienen texto ni elementos hijos). Con el elemento <code>&lt;space&gt;</code>, ya conociste un mecanismo bastante avanzado de alineación de varias voces que comparten un pentagrama en MEI. Si te interesa, también puedes investigar los atributos <code>@next</code> y <code>@prev</code> de la clase de atributos <a href="/guidelines/v4/attribute-classes/att.linking.html" target="_blank" ref="noopener, noreferrer">att.linking</a> de MEI (disponibles en <code>&lt;note&gt;</code> y otros eventos). Esa clase de atributos permite dejar un rastro a través de un archivo MEI que hace posible seguir las voces a través de múltiples capas (y pentagramas, si es necesario). Esto puede facilitar el análisis de un archivo MEI, aunque no es necesario en la mayoría de casos.
Estos elementos están casi siempre vacíos (no contienen texto ni elementos hijos). Con el elemento <code>&lt;space&gt;</code>, ya conociste un mecanismo bastante avanzado de alineación de varias voces que comparten un pentagrama en MEI. Si te interesa, también puedes investigar los atributos <code>@next</code> y <code>@prev</code> de la clase de atributos <a href="/guidelines/v5/attribute-classes/att.linking.html" target="_blank" ref="noopener, noreferrer">att.linking</a> de MEI (disponibles en <code>&lt;note&gt;</code> y otros eventos). Esa clase de atributos permite dejar un rastro a través de un archivo MEI que hace posible seguir las voces a través de múltiples capas (y pentagramas, si es necesario). Esto puede facilitar el análisis de un archivo MEI, aunque no es necesario en la mayoría de casos.
</p>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
Si necesitas más información para completar la siguiente tarea, por favor consulta los tutoriales de <a href="./100-structure.html">Fundamentos de XML y estructura mínima de MEI</a> e <a href="./101-quickstart.html">Iniciación rápida</a>.
</p>
<p>
Según la <a href="/guidelines/v4/elements/rest.html" target="_blank" rel="noopener, noreferrer">Especificación MEI</a>, un silencio es "un evento no sonoro que se encuentra en la fuente que se transcribe". La codificación es sencilla, basta con utilizar un elemento <code>&lt;rest&gt;</code> con un atributo <code>@dur</code>.
Según la <a href="/guidelines/v5/elements/rest.html" target="_blank" rel="noopener, noreferrer">Especificación MEI</a>, un silencio es "un evento no sonoro que se encuentra en la fuente que se transcribe". La codificación es sencilla, basta con utilizar un elemento <code>&lt;rest&gt;</code> con un atributo <code>@dur</code>.
</p>
<p class="tutorialTask">
Codifica un silencio de negra.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div>
<p>
Cuando la partitura presenta varios instrumentos/voces en un mismo pentagrama, a veces es necesario "empujar" algunos de estos eventos, como las notas, a una posición posterior en el compás sin indicar silencios. Esto suele ocurrir cuando el documento a codificar cambia de la notación basada en acordes a las plicas separadas en un mismo compás (consultar la figura de abajo). Dado que MEI utiliza el elemento <a href="/guidelines/v4/elements/layer.html" target="_blank" rel="noopener, noreferrer">&lt;layer&gt;</a> para codificar las distintas capas/instrumentos/voces en una partitura y que, en el ejemplo mostrado en la siguiente figura, un instrumento cambia de capa a medio compás, los "agujeros" en dicho compás necesitan rellenarse. Para esto se utiliza el elemento <code>&lt;space&gt;</code>.
Cuando la partitura presenta varios instrumentos/voces en un mismo pentagrama, a veces es necesario "empujar" algunos de estos eventos, como las notas, a una posición posterior en el compás sin indicar silencios. Esto suele ocurrir cuando el documento a codificar cambia de la notación basada en acordes a las plicas separadas en un mismo compás (consultar la figura de abajo). Dado que MEI utiliza el elemento <a href="/guidelines/v5/elements/layer.html" target="_blank" rel="noopener, noreferrer">&lt;layer&gt;</a> para codificar las distintas capas/instrumentos/voces en una partitura y que, en el ejemplo mostrado en la siguiente figura, un instrumento cambia de capa a medio compás, los "agujeros" en dicho compás necesitan rellenarse. Para esto se utiliza el elemento <code>&lt;space&gt;</code>.
<img style="display: block; margin: .5rem auto; width: 240px;" src="../tutorials/104_rests-spaces.png" alt="Una situación que necesita elementos espaciales"/>
</p>
<p>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,6 @@ <h1>Entender ODD</h1>
Este tutorial introducirá los conceptos básicos del lenguaje ODD, que se utiliza para definir el MEI. En un segundo tutorial, presentaremos los flujos de trabajo y las herramientas que ayudan a crear personalizaciones individuales. Es muy recomendable familiarizarse primero con las estructuras subyacentes en este tutorial.
</p>
<p>
Hay que admitir que este es uno de los temas más avanzados en torno a MEI, y ciertamente se necesita algo de tiempo para familiarizarse con el uso del ODD. Sin embargo, la amplia Comunidad MEI está más que feliz de <a href="/community/community-contacts.html" target="_blank" rel="noopener, noreferrer">responder a las preguntas</a>, y lo mismo ocurre con el <a href="/community/technical-team.html" target="_blank" rel="noopener, noreferrer">Equipo Técnico MEI</a>. Tómate tu tiempo con este tutorial, y también echa un vistazo al <a href="https://music-encoding.org/guidelines/v4/content/introduction.html#meicustomization" target="_blank" rel="noopener, noreferrer">capítulo correspondiente de las Directrices MEI</a>. Con el tiempo, serás capaz de dominar la disciplina suprema de usar estándares de DH como MEI - sólo <b>continúa</b> a partir de aquí :-)
Hay que admitir que este es uno de los temas más avanzados en torno a MEI, y ciertamente se necesita algo de tiempo para familiarizarse con el uso del ODD. Sin embargo, la amplia Comunidad MEI está más que feliz de <a href="/community/community-contacts.html" target="_blank" rel="noopener, noreferrer">responder a las preguntas</a>, y lo mismo ocurre con el <a href="/community/technical-team.html" target="_blank" rel="noopener, noreferrer">Equipo Técnico MEI</a>. Tómate tu tiempo con este tutorial, y también echa un vistazo al <a href="/guidelines/v5/content/introduction.html#meiCustomization" target="_blank" rel="noopener, noreferrer">capítulo correspondiente de las Directrices MEI</a>. Con el tiempo, serás capaz de dominar la disciplina suprema de usar estándares de DH como MEI - sólo <b>continúa</b> a partir de aquí :-)
</p>
</div>
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div>
<p>
A pesar de su nombre, la configuración para trabajar con ODD suele requerir al menos <u>dos</u> archivos <em>lógicos</em> (aunque pueden repartirse entre muchos más archivos del sistema de ficheros, como se muestra en el siguiente paso de este tutorial). El primero de estos archivos es el llamado <em>fuente</em>: contiene la especificación completa del formato, en este caso MEI. En nuestro repositorio, se encuentra en el archivo <a href="https://github.com/music-encoding/music-encoding/blob/develop/source/mei-source.xml" target="_blank" rel="noopener, noreferrer">mei-source.xml</a>. Además de ese archivo, se requiere una <em>personalización</em> separada para especificar qué partes de la especificación deben utilizarse en un contexto determinado. El objetivo de ODD es permitir la personalización flexible del esquema. MEI proporciona un conjunto de <a href="https://music-encoding.org/guidelines/v4/content/introduction.html#meiprofiles" target="_blank" rel="noopener, noreferrer">perfiles predefinidos</a>, que no son más que personalizaciones del esquema MEI.
A pesar de su nombre, la configuración para trabajar con ODD suele requerir al menos <u>dos</u> archivos <em>lógicos</em> (aunque pueden repartirse entre muchos más archivos del sistema de ficheros, como se muestra en el siguiente paso de este tutorial). El primero de estos archivos es el llamado <em>fuente</em>: contiene la especificación completa del formato, en este caso MEI. En nuestro repositorio, se encuentra en el archivo <a href="https://github.com/music-encoding/music-encoding/blob/develop/source/mei-source.xml" target="_blank" rel="noopener, noreferrer">mei-source.xml</a>. Además de ese archivo, se requiere una <em>personalización</em> separada para especificar qué partes de la especificación deben utilizarse en un contexto determinado. El objetivo de ODD es permitir la personalización flexible del esquema. MEI proporciona un conjunto de <a href="/guidelines/v5/content/introduction.html#meiProfiles" target="_blank" rel="noopener, noreferrer">perfiles predefinidos</a>, que no son más que personalizaciones del esquema MEI.
</p>
<p>
Para utilizar MEI (o cualquier otro formato basado en ODD), el archivo <em>customization</em> se utiliza para controlar cómo se compilará el archivo <em>source</em>. Existen varios formatos de destino para esa compilación, que se explican en otra parte<!-- TODO: Add reference to second tutorial -->. El objetivo más común es un archivo <a href="https://relaxng.org/" target="_blank" rel="noopener, noreferrer">RelaxNG</a>, que contiene tanto las jerarquías de RelaxNG como las reglas adicionales de Schematron definidas en el ODD, y puede utilizarse para la validación contra ambos tipos de esquema. Todos los demás formatos de salida posibles no se utilizan habitualmente para MEI. (Nota: volveremos a dar una breve explicación de Schematron más adelante en este tutorial).
Expand Down
Loading

0 comments on commit 12967e4

Please sign in to comment.