Skip to content

Commit

Permalink
Merge pull request #57 from musicEnfanthen/tutorials
Browse files Browse the repository at this point in the history
Tutorials: Final steps of march tutorial
  • Loading branch information
ahankinson authored Dec 13, 2018
2 parents 22d4909 + b975bd1 commit 66af13e
Show file tree
Hide file tree
Showing 39 changed files with 1,206 additions and 2 deletions.
6 changes: 4 additions & 2 deletions _tutorials/102_march/102_March.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,11 @@
layout: tutorials
type: tutorial
name: "March"
fullname: "A Quickstart tutorial for MEI encoding"
fullname: "An advanced tutorial for MEI encoding"
data: "102_march.json"
---
Welcome! In this tutorial you will learn how to encode the following music example in MEI:

"MarchExample"
![Hallingdal Bataljons Marsch](../102_march.png)

By the way: this is the beginning of _Hallingdal Bataljons Marsch_, the Opus 1 of the Norwegian composer [Johan Halvorsen](https://de.wikipedia.org/wiki/Johan_Halvorsen) (1864–1935).
426 changes: 426 additions & 0 deletions _tutorials/102_march/102_march.json

Large diffs are not rendered by default.

Binary file added _tutorials/102_march/102_march.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
5 changes: 5 additions & 0 deletions _tutorials/102_march/step-05/102_march_step-05-desc.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<div>
<p id="tutorialGoal">It's time to combine what you've learned in last two steps: In this step you will encode at once the next measure and the second note of the example.</p>

<p id="tutorialTask">In the editor below, add another <code>&lt;measure&gt;</code> element (<code>n="1"</code>) with staff and layer next to the existing pickup measure. Add the second note of the example (a quarter note e4) to this new measure. Don’t worry about the measure being too short in given time signature – you’ll fill it in in the next steps.</p>
</div>
10 changes: 10 additions & 0 deletions _tutorials/102_march/step-05/102_march_step-05-prefill.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
<section>
<measure n="0">
<staff n="1">
<layer>
<note pname="b" oct="3" dur="4" />
</layer>
</staff>
</measure>
<!-- Your encoding goes here -->
</section>
43 changes: 43 additions & 0 deletions _tutorials/102_march/step-05/102_march_step-05.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
<mei xmlns="http://www.music-encoding.org/ns/mei">
<meiHead>
<fileDesc>
<titleStmt>
<title type="main">March</title>
</titleStmt>
<pubStmt></pubStmt>
</fileDesc>
</meiHead>
<music>
<body>
<mdiv>
<score>
<scoreDef key.sig="3f" meter.sym="cut">
<staffGrp>
<staffDef n="1" lines="5" clef.shape="G" clef.line="2" />
</staffGrp>
</scoreDef>
<?preview-start?>
<?edit-start?>
<section>
<measure n="0">
<staff n="1">
<layer>
<note pname="b" oct="3" dur="4" />
</layer>
</staff>
</measure>
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
</layer>
</staff>
</measure>
</section>
<?edit-end?>
<?preview-end?>
</score>
</mdiv>
</body>
</music>
</mei>
7 changes: 7 additions & 0 deletions _tutorials/102_march/step-06/102_march_step-06-desc.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<div>
<p id="tutorialGoal">In this step you will encode a beamed group of notes.</p>

<p>To group notes under a beam within a measure, the <code>&lt;beam&gt;</code> element is to be used. The <code>&lt;beam&gt;</code> element is a container for a series of explicitly beamed events that begins and ends entirely within a measure.</p>

<p id="tutorialTask">In the editor below, please add a <code>&lt;beam&gt;</code> element at the specified position before adding the two child <code>&lt;note&gt;</code>s separately (e flat and g).</p>
</div>
8 changes: 8 additions & 0 deletions _tutorials/102_march/step-06/102_march_step-06-prefill.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
<!-- Your encoding goes here -->
</layer>
</staff>
</measure>
47 changes: 47 additions & 0 deletions _tutorials/102_march/step-06/102_march_step-06.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
<mei xmlns="http://www.music-encoding.org/ns/mei">
<meiHead>
<fileDesc>
<titleStmt>
<title type="main">March</title>
</titleStmt>
<pubStmt></pubStmt>
</fileDesc>
</meiHead>
<music>
<body>
<mdiv>
<score>
<scoreDef key.sig="3f" meter.sym="cut">
<staffGrp>
<staffDef n="1" lines="5" clef.shape="G" clef.line="2" />
</staffGrp>
</scoreDef>
<?preview-start?>
<section>
<measure n="0">
<staff n="1">
<layer>
<note pname="b" oct="3" dur="4" />
</layer>
</staff>
</measure>
<?edit-start?>
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
<beam>
<note pname="e" oct="4" dur="8" />
<note pname="g" oct="4" dur="8" />
</beam>
</layer>
</staff>
</measure>
<?edit-end?>
</section>
<?preview-end?>
</score>
</mdiv>
</body>
</music>
</mei>
7 changes: 7 additions & 0 deletions _tutorials/102_march/step-07/102_march_step-07-desc.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<div>
<p id="tutorialGoal">In this step you will learn how to encode dotted durations.</p>

<p>To encode a dotted rhythm, you need to use a <code>@dots</code> attribute on a <code>&lt;note&gt;</code> element and set the number of dots as the attribute's value, e.g. <code>“1”</code> or <code>“2”</code>.</p>

<p id="tutorialTask">Please encode the rest of the measure (<code>n=1</code>) in the editor below by adding two <code>&lt;note&gt;</code> elements with different rhythmic values (dotted quarter, eighth) next to the <code>&lt;beam&gt;</code> element.</p>
</div>
12 changes: 12 additions & 0 deletions _tutorials/102_march/step-07/102_march_step-07-prefill.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
<beam>
<note pname="e" oct="4" dur="8" />
<note pname="g" oct="4" dur="8" />
</beam>
<!-- Your encoding goes here -->
</layer>
</staff>
</measure>
49 changes: 49 additions & 0 deletions _tutorials/102_march/step-07/102_march_step-07.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
<mei xmlns="http://www.music-encoding.org/ns/mei">
<meiHead>
<fileDesc>
<titleStmt>
<title type="main">March</title>
</titleStmt>
<pubStmt></pubStmt>
</fileDesc>
</meiHead>
<music>
<body>
<mdiv>
<score>
<scoreDef key.sig="3f" meter.sym="cut">
<staffGrp>
<staffDef n="1" lines="5" clef.shape="G" clef.line="2" />
</staffGrp>
</scoreDef>
<?preview-start?>
<section>
<measure n="0">
<staff n="1">
<layer>
<note pname="b" oct="3" dur="4" />
</layer>
</staff>
</measure>
<?edit-start?>
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
<beam>
<note pname="e" oct="4" dur="8" />
<note pname="g" oct="4" dur="8" />
</beam>
<note dur="4" dots="1" pname="f" oct="4"></note>
<note dur="8" pname="d" oct="4"></note>
</layer>
</staff>
</measure>
<?edit-end?>
</section>
<?preview-end?>
</score>
</mdiv>
</body>
</music>
</mei>
5 changes: 5 additions & 0 deletions _tutorials/102_march/step-08/102_march_step-08-desc.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<div>
<p id="tutorialGoal">Ok, let's encode the complete next measure to repeat all the things you've learned in the previous steps.</p>

<p id="tutorialTask">Please encode the next measure (<code>n=2</code>) in the editor below. Add a staff and layer element which contains 4 child elements: a quarter <code>&lt;note&gt;</code>, a <code>&lt;beam&gt;</code> with two eighth <code>&lt;note&gt;</code>s and a dotted quarter <code>&lt;note&gt;</code> with an eighth <code>&lt;note&gt;</code>.</p>
</div>
1 change: 1 addition & 0 deletions _tutorials/102_march/step-08/102_march_step-08-prefill.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<!-- Your encoding goes here -->
62 changes: 62 additions & 0 deletions _tutorials/102_march/step-08/102_march_step-08.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
<mei xmlns="http://www.music-encoding.org/ns/mei">
<meiHead>
<fileDesc>
<titleStmt>
<title type="main">March</title>
</titleStmt>
<pubStmt></pubStmt>
</fileDesc>
</meiHead>
<music>
<body>
<mdiv>
<score>
<scoreDef key.sig="3f" meter.sym="cut">
<staffGrp>
<staffDef n="1" lines="5" clef.shape="G" clef.line="2" />
</staffGrp>
</scoreDef>
<?preview-start?>
<section>
<measure n="0">
<staff n="1">
<layer>
<note pname="b" oct="3" dur="4" />
</layer>
</staff>
</measure>
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
<beam>
<note pname="e" oct="4" dur="8" />
<note pname="g" oct="4" dur="8" />
</beam>
<note pname="f" oct="4" dur="4" dots="1" ></note>
<note pname="d" oct="4" dur="8"></note>
</layer>
</staff>
</measure>
<?edit-start?>
<measure n="2">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4"></note>
<beam>
<note pname="e" oct="4" dur="8" ></note>
<note pname="g" oct="4" dur="8" ></note>
</beam>
<note pname="b" oct="4" dur="4" dots="1"></note>
<note pname="g" oct="4" dur="8" ></note>
</layer>
</staff>
</measure>
<?edit-end?>
</section>
<?preview-end?>
</score>
</mdiv>
</body>
</music>
</mei>
9 changes: 9 additions & 0 deletions _tutorials/102_march/step-09/102_march_step-09-desc.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<div>
<p id="tutorialGoal">You should be prepared now to encode the note values of the final two measures of the example.</p>

<p>Ignore the additional elements, such as dynamics, slurs and accents at this point as they will be adressed in the next steps separately.</p>

<p>The pause is encoded with a <code>&lt;rest&gt;</code> element having a <code>@dur</code> attribute similar to the <code>&lt;note&gt;</code> element.</p>

<p id="tutorialTask">Please encode the final two measures (<code>n=3</code> & <code>n=4</code>) of the example in the editor below. Add <code>&lt;measure&gt;</code>, <code>&lt;staff&gt;</code> and <code>&lt;layer&gt;</code> elements as well as the corresponding <code>&lt;note&gt;</code>, <code>&lt;beam&gt;</code> or <code>&lt;rest&gt;</code> elements. This is the most ambitious step of the tutorial. If you feel lost or unsure at any time, try to follow the hints that are displayed next to the editor box.</p>
</div>
1 change: 1 addition & 0 deletions _tutorials/102_march/step-09/102_march_step-09-prefill.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<!-- Your encoding goes here -->
88 changes: 88 additions & 0 deletions _tutorials/102_march/step-09/102_march_step-09.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
<mei xmlns="http://www.music-encoding.org/ns/mei">
<meiHead>
<fileDesc>
<titleStmt>
<title type="main">March</title>
</titleStmt>
<pubStmt></pubStmt>
</fileDesc>
</meiHead>
<music>
<body>
<mdiv>
<score>
<scoreDef key.sig="3f" meter.sym="cut">
<staffGrp>
<staffDef n="1" lines="5" clef.shape="G" clef.line="2" />
</staffGrp>
</scoreDef>
<?preview-start?>
<section>
<measure n="0">
<staff n="1">
<layer>
<note pname="b" oct="3" dur="4" />
</layer>
</staff>
</measure>
<measure n="1">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4" />
<beam>
<note pname="e" oct="4" dur="8" />
<note pname="g" oct="4" dur="8" />
</beam>
<note pname="f" oct="4" dur="4" dots="1" ></note>
<note pname="d" oct="4" dur="8"></note>
</layer>
</staff>
</measure>
<measure n="2">
<staff n="1">
<layer>
<note pname="e" oct="4" dur="4"></note>
<beam>
<note pname="e" oct="4" dur="8" ></note>
<note pname="g" oct="4" dur="8" ></note>
</beam>
<note pname="b" oct="4" dur="4" dots="1"></note>
<note pname="g" oct="4" dur="8" ></note>
</layer>
</staff>
</measure>
<?edit-start?>
<measure n="3">
<staff n="1">
<layer>
<beam>
<note dur="8" pname="a" oct="4"></note>
<note dur="8" pname="b" oct="4"></note>
<note dur="8" pname="c" oct="5"></note>
<note dur="8" pname="d" oct="5"></note>
</beam>
<note dur="4" pname="e" oct="5"></note>
<beam>
<note dur="8" pname="d" oct="5"></note>
<note dur="8" pname="b" oct="4"></note>
</beam>
</layer>
</staff>
</measure>
<measure n="4">
<staff n="1">
<layer>
<note dur="4" pname="c" oct="5"></note>
<note dur="4" pname="b" oct="4"></note>
<rest dur="4"/>
</layer>
</staff>
</measure>
<?edit-end?>
</section>
<?preview-end?>
</score>
</mdiv>
</body>
</music>
</mei>
Loading

0 comments on commit 66af13e

Please sign in to comment.