Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add tutorial steps #120

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add tutorial steps #120

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c715027
Add tutorial step 16, multiple voices.
jzohrab Apr 12, 2021
9a7eb95
Add tutorial step 17, fingerings.
jzohrab Apr 12, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion doc/style.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,10 @@ code { font-family: Courier; font-size: 14px; color: green; }

table.tabstave-keywords { font-family:monospace; margin:20px;}
table.tabstave-keywords td {padding-right:30px;}

table.fingering-keywords { font-family:monospace; margin:20px;}
table.fingering-keywords td { padding-right:30px; vertical-align:top; }

div.vex-canvas {
background-color: white;
}
}
62 changes: 62 additions & 0 deletions doc/tutorial.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -564,6 +564,68 @@ <h2>Step 15: Tablature can have stems too.</h2>
notes :8 5/5 5/4 5/3 ^3^ :16 5-6-7-8/1 :8 9s10/1 :h s9v/1</div>
</div>

<h2>Step 16: Add multiple voices for polyphonic music.</h2>
<div class="description">
Add multiple <code>voice</code> lines before <code>notes</code> lines to correctly notate polyphonic music. The stem directions are inferred from the voice order: the first voice (soprano) has stems up, and the last (bass) stems down. The voices are combined onto a single staff.
</div>

<div style="width:570; margin-left: auto; margin-right: auto;">
<div class="vex-tabdiv"
width=550 scale=1.0 editor="true"
editor_height=100>options stave-distance=30
tabstave notation=true
time=4/4
voice
notes :8 6/4 h7/4 :q 0/2 :8 T0/2 5/3 :q 3/2 | :q T3/2 :16 3/2 0/1 :8 6/2 :q T6/2 :q 0/1 |
voice
notes :w ## | :8 ## 5/3 :8 0/2 7/4 6/4 7/4 :q 0/2 |
voice
notes :q ## :8 0/4 7/5 :qd 3/4 :8 0/4 | :q 2/4 |
voice
notes :q 7/6 7/6 0/5 0/5 | 4/6 0/5 7/6 4/6 |
</div>

<h2>Step 17: Add fingerings.</h2>
<div class="description">
You can also add <code>fingering</code> after a given note.
<p />
The format for a <code>fingering</code> is:
<p />
<code>fingering/<i>[note number]</i>:<i>[position]</i>:<i>[type]</i>:<i>[value]</i></code>

<table class="fingering-keywords" style="vertical-align: top;">
<thead>
<tr><td><strong>element</strong></td><td><strong>values</strong></td></tr>
</thead>
<tbody>
<tr>
<td>note number</td>
<td>The index of the note you for which you're adding the notation. For single notes, this will be 1, and for chords it will be the position of the note in the notated chord</td>
</tr>
<tr>
<td>position</td>
<td>The position that the annotation will appear. One of a, b, l, or r (for above, below, right or left).</td>
</tr>
<tr>
<td>type</td>
<td>The type of annotation. f or s (finger or string)</td>
</tr>
<tr>
<td>value</td>
<td>The annotation to add to the rendered staff</td>
</tr>
</tbody>
</table>

</div>

<div style="width:570; margin-left: auto; margin-right: auto;">
<div class="vex-tabdiv"
width=550 scale=1.0 editor="true"
editor_height=100>options stave-distance=30
tabstave notation=true
notes :8 6/4 $.fingering/1:l:f:2.$ h7/4 $.fingering/1:l:f:3.$ :q 0/2 :8 T0/2 5/3 $.fingering/1:l:f:4.$ :q 3/2 $.fingering/1:r:f:3.$
</div>

<center>
<h2>Step N + 1: Coming soon</h2>
Expand Down