forked from seisiuneer/abctools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
support.html
182 lines (159 loc) · 8.9 KB
/
support.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
<!DOCTYPE html>
<html>
<head>
<title>ABC Transcription Tools Support</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" />
<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/abctools.html" />
<meta property="og:site_name" content="Michael Eskin's ABC Transcription Tools" />
<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;
}
</style>
</head>
<body>
<div id="maindiv">
<div style="text-align: center;">
<font face="Comic Sans MS" size="5" id="pagetitle">ABC Transcription Tools Support</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><strong>If you have a problem with the ABC Transcription Tools on a specific tune or tune set:</strong></p>
<p>First generate a Share URL for the problematic tune or tune set by first clicking on the "Sharing Controls" button (outlined in the image below):</p>
<div class="image_holder">
<img style="width:720px;" src="img/grabshareurl.jpg"/></p>
</div>
<p>This will bring up the Share URL text box (also outlined in the image).</p>
<p>Copy the complete Share URL text shown in the text box and send it to me via email:</p>
<p><a href="mailto:seisiuneer@gmail.com?subject=ABC Tools Support Request">Click here to email me an ABC Tools Support Request</a></p>
<p>Be sure to paste the entire Share URL text into the email.</p>
<p>With that Share URL, I'll be able to see exactly what you're seeing in the tool.</p>
<p>Note: If you see a message in the Share URL box that the share link is too long, you may have to reduce the amount of ABC until the share link can be less than 8000 characters long.</p>
<hr>
<h1>Make Sure You Are Running The Latest Version</h1>
<p>If you aren't seeing the latest features, make sure you have the latest version of the code by clearing your browser cache or doing a force reload on the converter page.</p>
<hr>
<h1>Known Issues and Limitations</h1>
<p><strong>Safari Rendering Issues</strong></p>
<p>Occasionally, desktop Safari on Mac renders some ornamentation like grace notes incorrectly.</p>
<p>If this happens, try using Chrome or Firefox instead. No fix at this time.</p>
<p><strong>URL Query String Length Limitations</strong></p>
<p>The URL sharing feature uses URL query strings to send the ABC data and settings. There may be a browser-specific limit for how long one of these strings can be.</p>
<p>If the share link is longer than 8100 characters, you will get a message suggesting sharing fewer tunes.</p>
<p>Typically 10-15 two-part tunes should work for URL sharing with no problem.</p>
<p><strong>Reading the QR Codes</strong></p>
<p>All devices should easily be able to read the simpler QR codes generated for sets of one to three tunes.</p>
<p>It appears that 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>Some Android devices may have trouble reading the most complex codes with their built-in Camera app.</p>
<p>I suggest trying the free Google Lens app, available on the Google Play Store:</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>For older devices one user recommended this free app from the Google Play Store:</p>
<p><a href="https://play.google.com/store/apps/details?id=com.google.zxing.client.android&hl=en_GB&gl=US" target="_blank">Xing Barcode Scanner</a></p>
<p>He says you should specifically put the Xing app in QR code detection mode, not automatic mode.</p>
<hr>
<h1>New Feature Requests</h1>
<p>I'm always interested in any suggestions and ideas for new features or enhancements!</p>
<p><a href="mailto:seisiuneer@gmail.com?subject=ABC Tools Feature Suggestion">Click here to email me a feature suggestion!</a></p>
<hr>
</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>