forked from seisiuneer/abctools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathuserguide.html
685 lines (658 loc) · 54.4 KB
/
userguide.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
<!DOCTYPE html>
<html>
<head>
<title>ABC Transcription Tools User Guide</title>
<meta charset="UTF-8">
<meta http-equiv="Content-Type" content="text/html">
<meta content="ABC transposer ABCtransposer transpose jig reel folk" name="keywords">
<meta content="A simple-to-use ABC to standard music notation converter featuring transposition, tab generation, and PDF export." name="description">
<meta content="A simple-to-use ABC to standard music notation converter featuring transposition, tab generation, and PDF export." name="abstract">
<meta property="og:locale" content="en_US" />
<meta name="description" content="A simple-to-use ABC to standard music notation converter" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Michael Eskin's ABC Transcription Tools User Guide" />
<meta property="og:description" content="A simple-to-use ABC to standard music notation converter featuring transposition, tab generation, and PDF export." />
<meta property="og:url" content="http://michaeleskin.com/abctools/userguide.html" />
<meta property="og:site_name" content="Michael Eskin's ABC Transcription Tools User Guide" />
<meta property="og:image" content="http://michaeleskin.com/abctools/img/abc-icon.png" />
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="msapplication-TileImage" content="http://michaeleskin.com/abctools/img/abc-ms-icon-144x144.png">
<meta name="theme-color" content="#ffffff">
<meta name="apple-mobile-web-app-title" content="ABC Tools">
<meta name="application-name" content="ABC Tools">
<meta name="viewport" content="width=860">
<link rel="apple-touch-icon" sizes="57x57" href="http://michaeleskin.com/abctools/img/abc-apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="http://michaeleskin.com/abctools/img/abc-apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="http://michaeleskin.com/abctools/img/abc-apple-icon-72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="http://michaeleskin.com/abctools/img/abc-apple-icon-76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="http://michaeleskin.com/abctools/img/abc-apple-icon-114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="http://michaeleskin.com/abctools/img/abc-apple-icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="http://michaeleskin.com/abctools/img/abc-apple-icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="http://michaeleskin.com/abctools/img/abc-apple-icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="http://michaeleskin.com/abctools/img/abc-apple-icon-180x180.png">
<link rel="icon" type="image/png" sizes="192x192" href="http://michaeleskin.com/abctools/img/abc-android-icon-192x192.png">
<link rel="icon" type="image/png" sizes="32x32" href="http://michaeleskin.com/abctools/img/abc-favicon-32x32.png">
<link rel="icon" type="image/png" sizes="96x96" href="http://michaeleskin.com/abctools/img/abc-favicon-96x96.png">
<link rel="icon" type="image/png" sizes="16x16" href="http://michaeleskin.com/abctools/img/abc-favicon-16x16.png">
<link rel="manifest" href="http://michaeleskin.com/abctools/img/abc-manifest.json">
<style>
p {
font-size:14pt;
font-family:"Helvetica";
line-height: 28px;
}
h1 {
font-size:16pt;
font-family:"Helvetica";
margin-bottom:32px;
}
hr {
margin-top:24px;
margin-bottom:24px;
}
body {
padding:10px;
text-align: center;
}
#maindiv{
position: absolute;
left: 50%;
margin-right: -50%;
transform: translate(-50%, 0%);
text-align: left;
width: 800px;
background-color: white;
}
.image_holder{
text-align: center;
}
.toc{
margin-top:0px;
margin-bottom:12px;
}
</style>
</head>
<body style="padding:10px">
<div id="maindiv">
<div style="text-align: center;">
<font id="pagetitle" face="Comic Sans MS" size="5">ABC Transcription Tools User Guide</font><br/>
<p>This ABC to notation converter was developed by <a href="http://michaeleskin.com" target="_blank">Michael Eskin</a>.</p>
<p>Full project source may be found on: <a href="https://github.com/seisiuneer/abctools" target="_blank">GitHub</a>.</p>
<p>Try it out here: <a href="http://michaeleskin.com/abc" target="_blank">ABC Transcription Tools</a>.</p>
</div>
<hr>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/eVOLh2Z-GDU" title="ABC Transcription Tools Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<hr id="introduction">
<h1>Introduction</h1>
<p>ABC Transcription Tools is a free, web-based, open-source tool for converting music in ABC format to standard notation and tablature.</p>
<p>Generate tunebook PDF files with title pages, table of contents, tune index, custom headers, footers, tune incipits (notation or raw ABC), and sharing QR codes using the tool's built-in PDF Export feature.</p>
<p>It also has easy-to-use features to transpose and sort your ABC tunebooks.</p>
<p>You can fully customize the look of your notation using the standard ABC spacing and font annotations.</p>
<p>The tool also includes the ability to easily share your tunes with others via ABC Share URLs and QR Codes.</p>
<p>The underlying ABC rendering technology is Paul Rosen's incredible <a href="https://www.abcjs.net/" target="_blank">abcjs</a> Javascript library.</p> <hr>
<h1>Table of Contents</h1>
<p class="toc"><a href="#responsive_design">Responsive Design</a></p>
<p class="toc"><a href="#optimized_for_editing_large_tunebooks">Optimized for Editing Large Tunebooks</a></p>
<p class="toc"><a href="#getting_started">Getting Started</a></p>
<p class="toc"><a href="#abc_editor">ABC Editor</a></p>
<p class="toc"><a href="#viewing_the_notation_full_screen">Viewing the Notation Full Screen</a></p>
<p class="toc"><a href="#notation_tablature_display_controls">Notation/Tablature Display Controls</a></p>
<p class="toc"><a href="#basic_controls">Basic Controls</a></p>
<p class="toc"><a href="#sorting_your_abc_tunes">Sorting Your ABC Tunes</a></p>
<p class="toc"><a href="#advanced_controls">Advanced Controls</a></p>
<p class="toc"><a href="#playing_your_tunes">Playing Your Tunes</a></p>
<p class="toc"><a href="#selecting_the_instrument_for_playback">Selecting the Instrument for Playback</a></p>
<p class="toc"><a href="#pdf_tunebook_settings">PDF Tunebook Settings</a></p>
<p class="toc"><a href="#pdf_page_headers_and_footers">PDF Page Headers and Footers</a></p>
<p class="toc"><a href="#adding_a_pdf_title_page">Adding a PDF Tunebook Title Page</a></p>
<p class="toc"><a href="#adding_a_pdf_tunebook_table_of_contents_and_index">Adding a PDF Tunebook Table of Contents and Index</a></p>
<p class="toc"><a href="#printing_your_tunes">Printing Your Tunes</a></p>
<p class="toc"><a href="#sharing_controls">Sharing Controls</a></p>
<p class="toc"><a href="#abc_share_url_examples">ABC Share URL Examples</a></p>
<p class="toc"><a href="#qr_code_example">QR Code Example</a></p>
<p class="toc"><a href="#adding_a_qr_code_to_the_pdf_export">Adding a QR Code to the PDF Export</a></p>
<p class="toc"><a href="#reading_the_qr_codes">Reading the QR Codes</a></p>
<p class="toc"><a href="#shared_tunes_open_full_screen">Shared Tunes Open Full Screen</a></p>
<p class="toc"><a href="#staff_and_title_spacing_overrides">Staff and Title Spacing Overrides</a></p>
<p class="toc"><a href="#custom_font_overrides">Custom Font Overrides</a></p>
<p class="toc"><a href="#iphone_ipad_chord_entry_issue_fix">iPhone/iPad Chord Entry Issue Fix</a></p>
<p class="toc"><a href="#abc_specification">ABC Specification</a></p>
<p class="toc"><a href="#abc_21_quick_reference_card">ABC Quick Reference Card</a></p>
<p class="toc"><a href="#general_midi_instrument_list">General MIDI Instrument List</a></p>
<p class="toc"><a href="#donate">Donate</a></p>
<p class="toc"><a href="#support">Support</a></p>
<hr id="responsive_design">
<h1>Responsive Design</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/3_g3xj6XOnY" title="Responsive Design" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p>On desktop browsers, the tool will dynamically adjust its layout based on window size and shape to allow you to most efficiently view and edit your ABC tunes.</p>
<hr id="optimized_for_editing_large_tunebooks">
<h1>Optimized for Editing Large Tunebooks</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/Jl2HRoCiPRU" title="Optimizations for Large Tune Books" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p>The tool only redraws the changes to the tune you are working on, so is very quick even when editing large tune sets.</p>
<p>When you first load a set of tunes into the tool from an ABC file, it will render all of them once, which might take a bit of time for a large set of tunes.</p>
<p>After that, editing of the tunes is very fast, just click the tune and start editing.</p>
<p>Any changes you make to the ABC will be instantly shown in the notation.</p>
<p>Note: Some global operations such as changing from standard notation to tablature or transposing the entire tune set requires a complete redraw of all the tunes, but these are relatively rare operations compared to day-to-day editing and rendering of the ABC itself.</p>
<hr id="getting_started">
<h1>Getting Started</h1>
<div class="image_holder">
<img src="img/ug1.jpg"/>
</div>
<p>The text on top shows currently loaded ABC file or Share URL name and the current number of tunes found in the ABC Editor.</p>
<p>New ABC - Creates a simple example tune in ABC to get you started.</p>
<p>Open ABC - Opens an .abc or .txt file from your computer and loads it into the ABC Editor.</p>
<p>Save ABC - Saves the contents of the ABC editor to a file.</p>
<p>The saved file will be in your browser's Downloads directory.</p>
<p>Export PDF - Exports the currently displayed score as a high quality PDF file.</p>
<p>Play - Copies one or more ABC tunes to the clipboard and then opens them in Paul Rosen's amazing <a href="https://editor.drawthedots.com/" target="_blank">abcjs Quick Editor</a> tool for playback. Full details below in the <a href="#playing_your_tunes">Playing Your Tunes</a> section.</p>
<p>Copy All - Copies all the ABC text to the system clipboard so you can easily paste it into social media posts, emails, or other tools.</p>
<p>Page number settings are found in the settings panel.</p>
<p>Show Controls / Hide Controls - Shows/Hides all the control buttons below.</p>
<p>? - Click this to hide the header at the top so you can have more room to work on your music. Click it again to show the header.</p>
<hr id="abc_editor">
<h1>ABC Editor</h1>
<div class="image_holder">
<img src="img/ug2.jpg"/>
</div>
<p>Type or paste your ABC notation here.</p>
<p>Changes are reflected immediately in the displayed notation below the ABC Editor.</p>
<p>You may also paste some ABC text into the ABC Editor or just start typing.</p>
<p>On desktop systems, the text entry box can be resized by dragging the lower right corner.</p>
<p>Click on any tune in the ABC to have the notation scroll into view. </p>
<p>Click in the notation for any tune and the ABC area will be autoscrolled so that the ABC for the tune is displayed (or within a few lines, browser dependent).</p>
<p><strong>Note:</strong> The tune autoscroll features are <strong>not</strong> available on iOS or Android devices.</p>
<hr id="viewing_the_notation_full_screen">
<h1>Viewing the Notation Full Screen</h1>
<div class="image_holder">
<img src="img/ug3.jpg"/>
</div>
<p>If any ABC is present in the ABC Editor, this double-arrow control shows up on the top right corner of the page.</p>
<p>The control hides or shows the ABC Editor and all controls so you can view your notation fullscreen.</p>
<p>Click once to hide the ABC Editor and all controls.</p>
<p>Click again to show the ABC Editor and all controls.</p>
<hr id="notation_tablature_display_controls">
<h1>Notation/Tablature Display Controls</h1>
<div class="image_holder">
<img src="img/ug4.jpg"/>
</div>
<p>These control how the notation is displayed.</p>
<p>Sheet Music - Standard notation only.</p>
<p>Note Names - Shows standard notation and note names below.</p>
<p>Mandolin - Shows standard notation and tablature for Mandolin.</p>
<p>Zouk GDAD - Shows standard notation and tablature for GDAD-tuned Bouzouki.</p>
<p>Mandola - Shows standard notation and tablature for CGDA-tuned Mandola.</p>
<p>Guitar - Shows standard notation and tablature for standard EADGBE-tuned guitar.</p>
<p>DADGAD - Shows standard notation and tablature for DADGAD-tuned guitar.</p>
<p>Whistle Tab - Shows standard notation and tablature for whistle in the key of D.</p>
<p><strong>Note:</strong> For notes that go below D on of the whistle, the suggested "folded" octave-up fingerings are shown.</p>
<hr id="basic_controls">
<h1>Basic Controls</h1>
<div class="image_holder">
<img src="img/ug5a.jpg"/>
</div>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/b9BQEUb6XcI" title="Transposition" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>Transpose Down - Transposes the selected tunes down one semitone.</p>
<p>Transpose Up - Transposes the selected tunes up one semitone.</p>
<p>To transpose multiple tunes, just click anywhere in the first tune you want to transpose, and drag to select any part of additional tunes you want transposed.</p>
<p>To transpose all the tunes at once, select them all before clicking the Tranpose buttons.</p>
<p></p>
<p>Show/Hide Advanced - Shows/Hides a new panel (described below) with several additional ABC filtering and display controls.</p>
<p>Show/Hide Sharing - Shows/Hides a new panel (described below) with options for sharing your tune set via URL or QR code.</p>
<p>Clear ABC - Clears the ABC Editor so you can start over.</p>
<hr id="sorting_your_abc_tunes">
<h1>Sorting Your ABC Tunes</h1>
<p></p>
<p>Sort ABC - Sorts all the tunes in the ABC area in alphabetical order by tune name.</p>
<p>Tune names that start with "The" will have the "The" moved to the end of the tune name before the alphabetical sorting.</p>
<p>Holding down the Shift key while clicking this button will also treat "A " and "An " the same way as "The " for sorting.</p>
<hr id="advanced_controls">
<h1>Advanced Controls</h1>
<div class="image_holder">
<img src="img/ug8.jpg"/>
</div>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/NbbX1BHVtyo" title="Stripping Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>Hide/Show Annotations - Hides/Shows most ABC annotations like Composer, Discography, History, Tempo, etc. in the generated notation.</p>
<p>Holding down the Shift key while clicking this button will strip the annotations from the ABC itself.</p>
<p>Hide/Show Text - Hides/Shows any %%center or %%text based text annotations in the ABC in the generated notation.</p>
<p>Holding down the Shift key while clicking this button will strip the text annotations from the ABC itself.</p>
<p>Hide/Show Chords - Hides/Shows any chords entered in the ABC in the generated notation.</p>
<p>Holding down the Shift key while clicking this button will strip the chords from the ABC itself.</p>
<p>The ABC filtering buttons are enabled if Annotations, Text, or Chords are detected in the ABC.</p>
<p>Tab Name Settings: (only enabled if Mandolin, Bouzouki, Mandola, or Guitar tablature is being displayed).</p>
<p>Hide/Show Tab Names: Hides/Shows the instrument names and capo settings on the tablature.</p>
<p>When the tab instrument names are hidden, the spacing between the staves is somewhat reduced.</p>
<p>Hiding the tab names may, or may not, depending on the height of the staves, be useful for getting more staves on a single PDF page.</p>
<p>Capo Settings: (only enabled if Mandolin, Bouzouki, Mandola, or Guitar tablature is being displayed).</p>
<p>Capo - Allows you to set a capo setting from 0 to 12 frets for the Mandolin, Bouzouki, Mandola, or Guitar tablature.</p>
<p>Staff Display Settings:</p>
<p>Set Staff Spacing - Allows you to set a wider or narrower gap between the staffs.</p>
<p>A value of 0 corresponds to an ABC %%staffsep of 40</p>
<hr id="playing_your_tunes">
<h1>Playing Your Tunes</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/-JvOFaotgtY" title="Playing your Tunes (New and Improved)" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p>To play a specific tune, click once (don't select) anywhere in the ABC for the tune and then click "Play".</p>
<p>The tool will automatically find the tune you've clicked on and send it to the abcjs Quick Editor for playback.</p>
<p>If there is a text selection in the ABC area, whatever is selected will be sent.</p>
<p>You can use this to send more than one tune to the abcjs Quick Editor</p>
<p>The abcjs Quick Editor only plays the first tune in it's own ABC editor.</p>
<p>If you select more than one tune in the ABC editor, and click "Play", you will need to edit the ABC in the abcjs Quick Editor editor to bring the tune you are interested in playing to the top.</p>
<p>The abcjs Quick Editor can also export MIDI and audio files of tunes.</p>
<p>Once you are happy with the playback, copy the ABC from the "abcjs Quick Editor tool, then paste the edited ABC back into this tool for further editing.</p>
<p>If you single-clicked and played one tune, the entire tune will be selected when you come back to the tool from the abcjs Quick Editor.</p>
<p>This makes it simple to paste any changes you might have made and copied from the abcjs Quick Editor.</p>
<hr id="selecting_the_instrument_for_playback">
<h1>Selecting the Instrument for Playback</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/i6oKpGzS2lo" title="Playing your Tunes (New and Improved)" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p>You may select which instrument sound the abcjs Quick Editor uses for playback of your tunes.</p>
<p>By default, the instrument used is a piano.</p>
<p>To choose the sound when played, add an additional line to your ABC right after any headers and before the ABC notes, for example for a flute sound:</p>
<p></p>
<p><strong>%%MIDI program 74</strong></p>
<p></p>
<p>To change the instrument used for playback, change the MIDI program # above to one of:</p>
<p>74 - Flute, 49 - Fiddle, 23 - Accordion, 25 - Guitar, or 0 - Piano</p>
<p></p>
<p><strong>For example:</strong></p>
<p>X: 1<br/>
T: The Kesh<br/>
R: Jig<br/>
M: 6/8<br/>
L: 1/8<br/>
K: Gmaj<br/>
<strong>%%MIDI program 74</strong><br/>
D|: GAG GAB | ABA ABd | edd gdd | edB dBA |<br/>
GAG GAB | ABA ABd | edd gdB |1 AGF G2D :|2 AGF G2A||<br/>
|: B2B dBd | ege dBA | BAB dBG | ABA AGA |<br/>
B2 B dBd | ege dBd | gfg aga |1 bgg g2A :|2 bgg g2D |]</p>
<p></p>
<p>Any General MIDI (level 1) instrument number can be selected.</p>
<p>Visit <a href="https://www.midi.org/specifications-old/item/gm-level-1-sound-set" target="_blank">https://www.midi.org/specifications-old/item/gm-level-1-sound-set</a> for the full list of MIDI instruments and their program numbers.<p>
<hr id="pdf_tunebook_settings">
<h1>PDF Tunebook Settings</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/jtiVzXB8xhQ" title="PDF Generation Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>The tool has a powerful built-in PDF tunebook generator that provides more flexibility than the browser's print feature, particularly in the area of adding custom page headers and footers, title page, table of contents, or a tune index.</p>
<p>It can format PDF tunebooks with one or multiple tunes per page, something the native browser's Print command cannot accomplish.</p>
<p></p>
<p>The PDF generator also includes an option to append a Share URL QR code to the end of the PDF document.</p>
<p>All of this is done using custom ABC comment-based annotation (described below).</p>
<p><strong>PDF Tunes/Page</strong> - Select whether you want One Tune/Page, Multiple Tunes/Page, Tune Note Incipits, or ABC Incipits (unsorted or alphabetically sorted by tune name) in the PDF along with the paper size (Letter or A4):</p>
<p>
<div class="image_holder">
<img src="img/ug7a4.jpg"/>
</div>
<p>One - Letter: Each tune is placed on a new page in the PDF. Paper size = Letter</p>
<p>Multiple - Letter: Tunes are added one after another down each page in the PDF. Paper size = Letter</p>
<p>Notes Incipits - Letter: Notation for the first line of each tune is added one after another down each page in the PDF. Paper size = Letter</p>
<p>ABC Incipits - Letter: First few bars of the ABC each tune is added one after another down each page in the PDF. Paper size = Letter</p>
<p>ABC Incipits Sorted - Letter: First few bars of the ABC each tune is added one after another down each page in the PDF in tune name sorted order. Paper size = Letter</p>
<p>One - A4: Each tune is placed on a new page in the PDF. Paper size = A4</p>
<p>Multiple - A4: Tunes are added one after another down each page in the PDF. Paper size = A4</p>
<p>Notes Incipits - A4: Notation for the first line of each tune is added one after another down each page in the PDF. Paper size = A4</p>
<p>ABC Incipits - A4: First few bars of the ABC for each tune is added one after another down each page in the PDF. Paper size = A4</p>
<p>ABC Incipits Sorted - A4: First few bars of the ABC for each tune is added one after another down each page in the PDF in tune name sorted order. Paper size = A4</p>
<p>Default is: One - Letter</p>
<p></p>
<p>When exporting multiple tunes per page to PDF the tool will do its best to layout the output to not split tunes between pages, unless the tune itself is longer than one page.</p>
<p></p>
<p>When exporting multiple tunes per page, if you want to manually force a tune to a new page in the PDF, add:</p>
<p></p>
<p>%%newpage</p>
<p></p>
<p>on a new line immediately at the end of tunes after which you want to force a page break.</p>
<p></p>
<p>This will allow you to easily format a tune book where you want to override the automatic tune layout.</p>
<p></p>
<p><strong>PDF Tunebook Notes Incipits:</strong></p>
<p></p>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/ik9ObQXlBLU" title="PDF Tunebook Notes Incipits" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>Exporting a PDF tunebook with notes incipits allow you create a "cheat sheet" for the tunebook that includes just the notation for first line of each tune.</p>
<p>The tune notes incipits can be in standard notation or any of the available tablatures.</p>
<p></p>
<p>Tune notes incipits are generated stripping all ABC annotation and for tablature, hiding the tablature name to try and fit as many tunes on one page as possible.</p>
<p></p>
<p>Additionally, manually inserted %%newpage requests are ignored for incipit generation.</p>
<p></p>
<p><strong>PDF Tunebook ABC Incipits:</strong></p>
<p></p>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/OC5uFL2X6yQ " title="PDF Tunebook ABC Incipits" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>Exporting a PDF tunebook with ABC incipits allow you create a "cheat sheet" for the tunebook that includes just the first few measures of the ABC for each tune.</p>
<p></p>
<p><strong>PDF Page Number Position Options:</strong></p>
<div class="image_holder">
<img src="img/ug7b.jpg"/>
</div>
<p>Choose between: None, Top Left, Top Center, Top Right, Bottom Left, Bottom Center, Bottom Right, Top Left/Right, Top Right/Left, Bottom Left/Right, and Bottom Right/Left.</p>
<p>The Left/Right and Right/Left settings alternate the location between the left/right or right/left sides of the page for printing on both sides of the paper.</p>
<p>Default is: None</p>
<p><strong>Show or Hide Page Number on First Page Options:</strong></p>
<div class="image_holder">
<img src="img/ug7c2.jpg"/>
</div>
<p>Choose whether the page number will be shown on the first page of the PDF.</p>
<p>Default is: Yes</p>
<hr id="pdf_page_headers_and_footers">
<h1>PDF Page Headers and Footers</h1>
<p>You may add custom page headers and footers to your exported PDF files by including the following ABC comment-based annotations anywhere in your ABC:</p>
<p></p>
<p>%pageheader (your header text goes here...)</p>
<p>%pagefooter (your footer text goes here...)</p>
<p></p>
<p>There are also several useful user macros you can include in your page header or footer text that will be expanded in the PDF:</p>
<p></p>
<p>$PDFNAME - Matches the saved PDF filename</p>
<p>$PAGENUMBER - Current page number</p>
<p>$DATEMDY - Current date in M-D-Y format</p>
<p>$DATEYMD - Current date in Y-M-D format</p>
<p>$TIME - Current time in HH:MM format</p>
<p>$TUNECOUNT - Number of tunes in the ABC</p>
<p>$TUNENAMES - All of the tune names in the ABC separated by /</p>
<p>The tune names width is limited to about 70 characters before it will append "+ (remaining number of tunes) more" to the first few tune names.</p>
<p></p>
<p>Example ABC with page header and page footer annotations that include user macros:</p>
<p></p>
<p>%pageheader "The Tarbolton" from the Michael Coleman set - Saved on $DATEMDY at $TIME<br/>
%pagefooter $PDFNAME - Page $PAGENUMBER<br/>
X:1<br/>
T:The Tarbolton<br/>
M:4/4<br/>
K:Edor<br/>
Beed e2BA|GBAF GFEF|Dddc d2AG|FAGE FEDF|<br/>
Eeed efge|fedf e2BA|GABG FGAF|BGAF GEE2:|<br/>
|:gfef gebe|gebe gfec|d2fd Adfd|cdAG FDEF|<br/>
GABG FGAF|E2ef gfed|BcdB A2FA|BGAF GEE2:|</p>
<p></p>
<p>Results in a PDF that looks like this:</p>
<p></p>
<p></p>
<div class="image_holder">
<img src="img/ug11.jpg"/>
</div>
<p></p>
<p></p>
<p>Note: Only the first instance of the %pageheader or %pagefooter annotation is processed, any additional instances are ignored.</p>
<p></p>
<p>Page numbers can be added along with page headers and footers.</p>
<p>If you add a page header and you have selected top-centered page numbers, the page number will be hidden.</p>
<p>If you add a page footer and you have selected bottom-centered page numbers, the page number will be hidden.</p>
<p></p>
<p>Since these annotations are ABC comment-based, they will just appear to be normal comments in other ABC software.</p>
<hr id="adding_a_pdf_title_page">
<h1>Adding a PDF Title Page</h1>
<p></p>
<p>To add a title page to your PDF tunebook, simply add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%addtitle (your tunebook title text goes here...)</p>
<p></p>
<p>To add a smaller subtitle below the title on the title page, simply add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%addsubtitle (your tunebook title page subtitle text goes here...)</p>
<p></p>
<p>Note: The subtitle only appears if a title page is requested.</p>
<p>For a title page with just a subtitle and no subtitle, just enter %addtitle with no text after it and then add %addsubtitle with your subtitle text.</p>
<p></p>
<p>As with the %pageheader and %pagefooter annotation, only the first instance of the %addtitle and %addsubtitle annotation is processed, any additional instances are ignored.</p>
<p></p>
<hr id="adding_a_pdf_tunebook_table_of_contents_and_index">
<h1>Adding a PDF Tunebook Table of Contents and Index</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/B1jJmxSQ36M" title="PDF Table of Contents and Tunebook Index" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>To add a table of contents to the start of of your PDF tunebook listing each tune name and page number in the same order the tunes appear in the ABC, simply add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%addtoc (your tunebook table of contents title text goes here...)</p>
<p></p>
<p>To append an sorted tunebook table of contents to the start of your PDF tunebook listing each tune name and page number in alphabetical order by tune name, simply add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%addsortedtoc (your tunebook sorted table of contents title text goes here...)</p>
<p></p>
<p>Tune names that start with "The" will have the "The" moved to the end of the tune name before the sorting.</p>
<p></p>
<p>To append an unsorted tunebook index to the end of your PDF tunebook listing each tune name and page number in the same order they are in the ABC, simply add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%addindex (your tunebook index unsorted title text goes here...)</p>
<p></p>
<p>To append an sorted tunebook index to the end of your PDF tunebook listing each tune name and page number in alphabetical order by tune name, simply add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%addsortedindex (your tunebook sorted index title text goes here...)</p>
<p></p>
<p>Tune names that start with "The" will have the "The" moved to the end of the tune name before the sorting.</p>
<p></p>
<p>As with the %pageheader and %pagefooter annotation, only the first instance of the %addtoc, %addsortedtoc, %addindex, and %addsortedindex annotations are processed, any additional instances are ignored.</p>
<p></p>
<hr id="printing_your_tunes">
<h1>Printing Your Tunes</h1>
<p>Overview of printing from the browser:</p>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/6AlzAVNTRQA" title="Printing you Tunes" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<p></p>
<p>You may quickly print your tunes or generate a PDF using your browser's built-in print and PDF export features.</p>
<p>Tunes printed or exported from the browser are limited to one tune per page.
<p>You may choose portrait or landscape orientation from your browser's print settings.</p>
<p>Additional advanced settings such as printing multiple-pages per page and setting custom margins may be available in your browser's print settings dialog.</p>
<p>Experiment with both the browser's print settings page orientation and "multiple page on one page" options to see what is possible.</p>
<p><strong>Note:</strong>If you want to print a tunebook automatically formated with multiple tunes per page, you must use the tool's PDF Export feature described in the next section.</p>
<hr id="sharing_controls">
<h1>Sharing Controls</h1>
<p style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="720" height="393" src="https://www.youtube.com/embed/I8KcG4swmUQ" title="Sharing Tunes with ABC Share URLs and QR Codes" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></p>
<div class="image_holder">
<img src="img/ug9.jpg"/>
</div>
<p>ABC Share URLs and QR Codes are a quick and easy way to share your ABC tunes with friends or to post tunes on social media sites.</p>
<p>Anyone with the ABC Share URL or QR Code can view, edit, save, and share their own copy of the tunes.</p>
<p>Share URLs and QR Codes also include the instrument selected, whether or not to show the top bar and links, display size, line spacing, PDF tunes/page setting, page number position, and page number on first page settings.</p>
<p>For Mandolin, Bouzouki, Mandola, and Guitar tablature, the link also includes the capo setting and whether or not to show the tablature name.</p>
<p>Share URL: Copying and pasting this link in a browser address bar will open the ABC Tools website and copy in the tune set ABC and tablature settings.</p>
<p>If the share URL link is too long to work in most browsers, the Share URL buttons will be disabled and you will see a message suggesting sharing fewer tunes.</p>
<p>Test Share URL - Opens the ABC Share URL in a new browser tab.</p>
<p>Copy Share URL - Copies the ABC Share URL to the system clipboard so you can easily paste it into social media posts, emails, or other tools.</p>
<p>Save Share URL - Saves the ABC Share URL to a text file.</p>
<p>The saved file will be in your browser's Downloads directory.</p>
<p>Generate QR Code - Once an ABC Share URL is generated, if it is short enough to fit in a QR code (less than 2600 characters), this button is activated.</p>
<p>The QR Code is a visual representation of an ABC Share URL that you can scan with the Camera app on your iOS or Android device.</p>
<p>Clicking the button will generate a QR code in .PNG format for the ABC Share URL and open it in a new browser tab.</p>
<p>In the newly opened tab, you can click the link below the image to save the QR code to your system.</p>
<hr id="abc_share_url_examples">
<h1>ABC Share URL Examples</h1>
<p>Clicking these ABC Share URL links, created with the tool, will launch the tool and load the listed tune set you can start working with immediately:</p>
<p><a href="http://michaeleskin.com/abctools/abctools.html?lzw=KQBwhg5gpgFlYBMoCcAEAiAygGwJZgCMZUA5AewBcoBndVABTOwGsxqAoUSKAMzMpSoAwsnhUEqAO64KxGBQogAXAHoVAW1wBjGGCjYazXADsAdFrLqVhLZ0QIKZLagAqhA6jI9hZY1T8cwPYUMh5YeITE5FS0DEysgfbUAK4EIRQeALJgCsLIYMYyOqgAtKgAIr5g2KiZycggMACepa6W6i0A8qiYydh4AG4FnACOyBZI7OwAGkqoAIzsLnMucKgAQthgWsySOSjsQnPZuSIFRTDsAEpzIPFg7JlzAEwqACzsADJz8yoAHOwANJzcrqMAAK3YAB8lAAxCTrBAqdYqKEAQVhqAAouV0QAadZ4ipYqGwrHY2FQ9hohFIlHozFYynlTFo5EqNmw1E4ioAPixSipMNhaI2WihCGeqBpUJ4EBUPBUqCgCFlUGVzypCC0KiRytV61FZKhLOl7M53PKfIFUNQU1mqGeSzmgJyMAMUGMAHIOEdajkKHlzhQdNdbvdHi93l8fv8gXN1ppjNClNrdUqeFAJesNqqoLzvCqoVpRWjxew03rM9nc8XzWKofMNlL1lpBS2pTxeRAoUKlGBvNBZRIkArURBC6qS9LeVn2DwJFBxQgcyWoYbUCLG82Nor5e2d63e3aZnMAMzO2oAW50UAAh9gfYdjgGg4UQ5cbqg7iwHk9HdG3wLHGwLSimaItmyKKoLa05oryOaweqegwYqYBjlASpaOsVIQRsUFKrBpa8pitpMmaKI6myMFNhuaLkgedFSr27CQNYSoEGAMGoDwXGZjBJYqDqyqisWObrMxrHyuhqCcdxvE8eq6LOJhiqYcJ66lpJbEyXJtoKfxxZssJUCidhYowdSkHstxcEkdx5EEVRhH4dKzEALqcMYUCSOA0D2j8l7ZMYLSigA6rg2ASCQuAQPIYbfhG-6vB8QG-ACoGghC0I0qgK4MpuuIAOLiWipIqEVHJ8jh1IjjhGKFVCJX4SaUrlAhgrgRIvFQtAyq8uKZbKmOPYLnlKiYXSqK1TxYC9eqRZaOqnESlKCAdbaAWOpeYXVNQMA+qgADEixfj+rCRgBqWxhlcxFWCkIQFKE4qPKUKQKgQ4ri1RWioiVJPZ9e6oh9X2lU1UpFc8gp2kVvJ-WVRXkji654laKOEujuLsHDCNNcjuKY9ixWQ9DVKnqgF7LKgu3YPth1HU6Z1JVG13Abd0oPSmJJDbwUJLqgOpIjq9K8zw-NSkuuEqeLAtC0J7IFcaaJnp1MJIphaqC-VmLK-D0rilAksa9N-HYUrPP6xi6Kq5twDeb53BbYs1OrOqaLGMYkAwAQUAQAl51-qzMbs-GFRczCBEWtKqpRyoXIx8W6rrANmmbmV1LmvHSoynHCcyktGyp02CDeJKB6l3lWZ9jwxta0bErOEeG5buwADa8y1-q9eatqDaV0gnVt88ec57HWf51OyepwPmqbRTTrU-QUBUBs+QIAYTRPszv6XSlIfpWH93ZTCEk-QTUJYqWKJsk1ObalSZ+GvjxOX9fHKolDqC42rSiIlXNYIA4W+kAtOaJKq33YP-JAgDgE5jRDfT+kM0Qwy2lTOYJAfJgmQMwFeAcWZXQPiBEEEclC5VLvzWkityFZn4g3GaFCVS5moSOLMTYxrrXWAeDh1cUzAy4hOShzDRasJ7lSfhQMhGIhYQA9hrDuEjgQseKY7AgA&format=noten&ssp=0&pdf=multi&pn=br&fp=yes&name=Sliabh_Notes_Polkas" target="_blank">Three sets of polkas from the group "Sliabh Notes"</a></p>
<p><a href="http://michaeleskin.com/abctools/abctools.html?lzw=BoLgjAUAKiUBYFMAEUCGAnARgewDYBdsA7CAWRAGEAfCAaRAFEATbdCAIQQSaQQCZ2AQSoBxIQDEkI8Q3FUAIkyYBjJEz6CRVcZoZIZ8uRAZceCAGYBzBFXPdzvAcJGD2I-S7lvBkkQwZ8IDRUIJZ2DtaYNpHIYQjKVOrmPIJMyVTKTJr68rI0Lm4ePlQBFkhxTFTsmexIgnw6VZ5S-oE0EKB80LCISAAyxGGsPBR4uPGEbOTUdCAiEAB+IgDMgkjVTJZUCOwL7Hy8lkzsouIu6zVUgspCLbn5Z2sbWzt7B+oWVJZ8qBHcJ2A6jc1n5ckEDtdbqC+FRgqErKhytwXrt9mo+J9vr8kccrsC7jDFpZlojrJttqj3hjzF9MNiyQCgVCGPI2hD8aCGLCIABSHlEBAAdwADqhrBAOiBlt14MgAMqoACWuFYAHIAM7rYgC-BkSg0ejyCD1HRqcwLcwwtJlY5vK4NNZpOyJITucTyeQnY0Os0WmG-G2U+2mp02Y7Zd2s7khVB8BaxpC-NJUAMOW37WyYOlIOnmVBUTB5hx2T4QQt+xPmy0p8JqIMmx3mZ2A8OSQQetl1nx1D0ndpAA&w=50&format=noten" target="_blank">Michael Coleman set ("The Tarbolton" - "The Longford Collector" - "The Sailor's Bonnet")</a></p>
<p><a href="http://michaeleskin.com/abctools/abctools.html?lzw=BoLgBAjAUAKuCyBXAlgJwKYEMB22DkAzlAMLgByymANlWAGrVXpUCeUASuAFLIDmU8cADYA9AA4oAGXARxUANLgAQgFtk2KAB8QAEyUBBMAG8dAXwNLNO9ADNjN0+muaj6UzYBM6Y7cfObmHZYIjYi6JpQeoYWVrb2fuE2AEaYYDZOLm6e3kYOTkogEdoWxmboAMwuZiVGmO62mkopaRmu7l7x+RE1ZR6WJub6SmmVKXaYHkmaASFhnXqFWiAGAGLGAOKmAKIe6y76pisAIltgx1uaK-qGQ5ZKOjrzllADqxvbu-uHJ2cnl0Ngaw2TQQNKhdAiR65PwFTQeMFhSFgWy8TRFEC1ep2JLlESTERTTHpca4jyYESYabNdI6TLtHK+JzhKDEsBJDzAmzQuITAAU5QhoXJmjGYAmU1BoV4IQZeWshXhUplT00AF0wFAoEA&w=50&format=noten" target="_blank">"Muireann's" jig (by Niall Vallely) for Anglo Concertina</a></p>
<hr id="qr_code_example">
<h1>QR Code Example</h1>
<p>Michael Coleman set ("The Tarbolton" - "The Longford Collector" - "The Sailor's Bonnet"):</p>
<div class="image_holder">
<img src="img/ug10.png"/>
<p>Try scanning this code with the Camera app on your iOS or Android phone.</p>
</div>
<hr>
<p>I have several example QR codes for tune sets on my Flickr account at:</p>
<p><a href="https://flic.kr/s/aHBqjArRJZ" target="_blank">ABC Tune Set QR Codes on Flickr</a></p>
<hr id="adding_a_qr_code_to_the_pdf_export">
<h1>Adding a QR Code to the PDF Export</h1>
<p>To append a QR code for your tune set as a final page on your PDF, add the following comment-based annotation anywhere in the ABC:</p>
<p></p>
<p>%qrcode</p>
<p></p>
<p>Note that the QR code page itself includes the PDF page header and footer but does not include a page number.</p>
<p></p>
<p>Here is an example of a tune set QR code included in the exported PDF:</p>
<div class="image_holder">
<img src="img/ug12.jpg"/>
</div>
<p></p>
<p>Note: If a QR code has been requested, and the Share URL for the set of tunes is too long to generate a QR code (more than 2600 characters), you will see an informative message at the end of the PDF export suggesting sharing fewer tunes.</p>
<p>If you are able to generate a QR code in the Sharing Controls, then the Share URL is short enough to embed a QR code in a PDF.</p>
<hr id="reading_the_qr_codes">
<h1>Reading the QR Codes</h1>
<p>All devices should easily be able to read the simpler QR codes generated for sets of one to three tunes.</p>
<p></p>
<p>Most iOS devices are able to read even the most complex QR codes generated by this tool using the built-in Camera app.</p>
<p></p>
<p>Some Android devices may have trouble reading the most complex codes with their built-in Camera app.</p>
<p></p>
<p>I suggest trying the free Google Lens app, available on the Google Play Store:</p>
<p></p>
<p><a href="https://play.google.com/store/apps/details?id=com.google.ar.lens&hl=en_US&gl=US" target="_blank">Google Lens</a></p>
<p></p>
<hr id="shared_tunes_open_full_screen">
<h1>Shared Tunes Open Full Screen</h1>
<p>Shared tunes, when opened from a Share URL or QR code, are initially displayed with the ABC Editor and controls hidden so you can see the music full-screen.</p>
<p>Click the Maximize/Minimize arrow to show the ABC Editor and controls.</p>
<hr id="staff_and_title_spacing_overrides">
<h1>Staff and Title Spacing Overrides</h1>
<p>The Staff Spacing value in the Advanced Controls can be easily overridden by setting a %%staffsep value in the ABC just below the tune header.</p>
<p>This can be very useful particularly for getting as much tab notation on a single page as possible.</p>
<p>Any spacing overrides must be applied on a tune-by-tune basis.</p>
<p>For the absolute minimum spacing between staffs, turn off the tab names, hide the tune annotations, and add the following just below the tune header:</p>
<p><strong>%%staffsep 0</strong></p>
<p>Try experimenting with different %%staffsep values until you get the result you want.</p>
<p>Setting the %%staffsep value manually too low may sometimes result in overlapping staff rendering.</p>
<p>To override the default space between the title and the first staff of music, you can add a custom %%musicspace value in the ABC just below the tune header, for example:</p>
<p><strong>%%musicspace 10</strong></p>
<p>Try experimenting with different %%musicspace values until you get the result you want.</p>
<p><strong>All supported spacing parameters</strong></p>
<p>Here is the full list of ABC spacing-related parameters available in abcjs:</p>
<p>%%topspace<br/>
%%titlespace<br/>
%%subtitlespace<br/>
%%composerspace<br/>
%%musicspace<br/>
%%partsspace<br/>
%%vocalspace<br/>
%%wordsspace<br/>
%%textspace<br/>
%%staffsep<br/>
%%sysstaffsep</p>
<p>Please refer to the <a href="http://abcnotation.com/wiki/abc:standard:v2.1" target="_blank">official ABC 2.1 specification</a> for more details.</p>
<p>Another good reference is this handy ABC 2.1 Quick Reference Card put together by Stephen Merrony: </p>
<p><a href="http://michaeleskin.com/documents/ABCquickRefv0_6.pdf" target="_blank">ABC Quick Reference Card</a></p>
<p><strong>Example of custom spacing:</strong></p>
<div class="image_holder">
<img src="img/ug13a.jpg"/>
</div>
<hr id="custom_font_overrides">
<h1>Custom Font Overrides</h1>
<p>As per the ABC 2.1 specification, custom font overrides are possible, giving you maximum control over the appearance of your notation.</p>
<p><strong>Available ABC Font Annotations:</strong></p>
<p>%%titlefont font-style size<br/>
%%subtitlefont font-style size<br/>
%%composerfont font-style size<br/>
%%partsfont font-style size<br/>
%%tempofont font-style size<br/>
%%gchordfont font-style size (used for chords symbols)<br/>
%%annotationfont font-style size (used for "^..." annotations)<br/>
%%infofont font-style size<br/>
%%textfont font-style size<br/>
%%vocalfont font-style size (used for for w:)<br/>
%%wordsfont font-style size (used for W:)</p>
<p>Generally, these will use the PostScript font-style naming convention, for example:</p>
<p>Times, Helvetica, Courier, Verdana, Times-Bold, Helvetica-Italic, etc.</p>
<p>The size parameter should be an integer, but is optional.</p>
<p>Place your font override annotations just below the X: and above the T: ABC tune headers.</p>
<p><strong>For example:</strong></p>
<p>X: 1<br/>
%%titlefont Palatino 30<br/>
%%infofont Palatino 18<br/>
%%gchordfont Palatino Bold 14<br/>
T: The Road to Lisdoonvarna<br/>
R: slide<br/>
M: 12/8<br/>
L: 1/8<br/>
K:Edor<br/>
D|:"Em"E2B B2A B2c d3|"D"F2A ABA D2E FED|<br/>
"Em"E2B B2A B2c d3|"D"cdc B2A "Em"B2E E3:|<br/>
|:"Em"e2f gfe "Bm"d2B Bcd|"A"c2A ABc "Bm"d2B B3|<br/>
"Em"e2f gfe "Bm"d2B Bcd|"A"cdc B2A "Em"B2E E3:|</p>
<p><strong>Result:</strong></p>
<div class="image_holder">
<img src="img/ug14.jpg"/>
</div>
<p><strong>Web Safe Fonts</strong></p>
<p>The following "web safe" fonts at a minimum should be supported by all browsers:</p>
<p style="font-family: Helvetica;font-size: 16pt;">Helvetica (sans-serif)</p>
<p style="font-family: Trebuchet MS;font-size: 16pt;">Trebuchet MS (sans-serif)</p>
<p style="font-family: Gill Sans;font-size: 16pt;">Gill Sans (sans-serif)</p>
<p style="font-family: Verdana;font-size: 16pt;">Verdana (sans-serif)</p>
<p style="font-family: Times New Roman;font-size: 16pt;">Times New Roman (serif)</p>
<p style="font-family: Georgia;font-size: 16pt;">Georgia (serif)</p>
<p style="font-family: Palatino;font-size: 16pt;">Palatino (serif)</p>
<p style="font-family: Baskerville;font-size: 16pt;">Baskerville (serif)</p>
<p style="font-family: Courier;font-size: 16pt;">Courier (monospace)</p>
<p style="font-family: Monaco;font-size: 16pt;">Monaco (monospace)</p>
<p style="font-family: Bradley Hand;font-size: 16pt;">Bradley Hand (cursive)</p>
<p>Font availability varies with browser and platform. Many other fonts may be available on your system.</p>
<p><strong>More information is available here:</strong></p>
<p><a href="https://blog.hubspot.com/website/web-safe-html-css-fonts" target="_blank">Web Safe CSS Fonts</a></p>
<p><a href="http://iosfonts.com/" target="_blank">iOS Fonts</a></p>
<hr id="iphone_ipad_chord_entry_issue_fix">
<h1>iPhone/iPad Chord Entry Issue Fix</h1>
<p>If you are trying to enter ABC chords, for example "D" or "Am", on an iPhone or iPad, iOS will, by default stick in "smart quotes" instead of standard double quotes.</p>
<p>To fix this, go into your device's Settings and under the General/Keyboard tab, and turn off "Smart Punctuation".</p>
<p>After you do this, you will be able to add standard double quotes.</p>
<hr id="abc_specification">
<h1>ABC Specification</h1>
<p>The full specification for ABC notation can be found at <a href="http://abcnotation.com/wiki/abc:standard:v2.1" target="_blank">The ABC Music Standard 2.1 (Dec 2011)</a></p>
<hr id="abc_21_quick_reference_card">
<h1>ABC 2.1 Quick Reference Card</h1>
<p>Download this handy ABC 2.1 Quick Reference Card put together by Stephen Merrony: </p>
<p><a href="http://michaeleskin.com/documents/ABCquickRefv0_6.pdf" target="_blank">ABC Quick Reference Card</a></p>
<hr id="general_midi_instrument_list">
<h1>General MIDI Instrument List</h1>
<p>Visit <a href="https://www.midi.org/specifications-old/item/gm-level-1-sound-set" target="_blank">https://www.midi.org/specifications-old/item/gm-level-1-sound-set</a> for the full list of MIDI instruments and their program numbers to use for choosing instruments in the abcjs Quick Editor for playback.<p>
<hr id="donate">
<h1>Donate</h1>
<p>If you find my ABC Transcription Tools useful, please consider tossing a few bucks into one of my virtual tip jars:</p>
<p style="text-align: center" class="notranslate">PayPal</br><a href="https://paypal.me/MichaelEskin" target="_blank">https://paypal.me/MichaelEskin</a></p>
<p style="text-align: center" class="notranslate">Venmo</br>@MichaelEskin</p>
<hr id="support">
<h1>Support</h1>
<p>Have an issue with a specific tune, want to report a bug, or suggest a new feature?</p>
<p>Click here: <a href="support.html" target="_blank">ABC Transcription Tools Support</a> to go to the support page for the tool.</p>
<hr>
</div>
</div>
</body>
<script>
//
// Are we on iOS?
//
function isIOS() {
if (/iPad|iPhone|iPod/.test(navigator.platform)) {
return true;
} else {
return navigator.maxTouchPoints &&
navigator.maxTouchPoints > 2 &&
/MacIntel/.test(navigator.platform);
}
}
function DoStartup() {
//
// iOS Styling adaptation
//
var gIsIOS = isIOS();
if (gIsIOS) {
// Fix the title font
var elem = document.getElementById("pagetitle");
elem.size = 5;
elem.style.fontFamily = "Helvetica";
}
}
//
// Wait for the document to be ready, then fire a function
//
function WaitForReady(fn) {
if (document.readyState !== 'loading') {
fn();
return;
}
document.addEventListener('DOMContentLoaded', fn);
}
//
// Wait for the document to be ready, then startup
//
WaitForReady(DoStartup);
</script>
</html>