Acorn, if I commit to following the instructions from your latest PDF draft, and if you have unlimited patience, I think the best approach is for me to simply relay to you when there is ambiguity in the instructions, or when there is insufficient information for a beginner to proceed. (I might be wrongly assuming that your instructions are intended for everyone from beginner to advanced, but as you have given them to me knowing that I am a beginner and that I am ignorant, I think I am assuming correctly.)
Under the ‘Alternative’ section, you seem to be saying two different things: “Simply removing the 'class="xar_meplayer"' statement will avoid the need for the above; it is still part of your upload and can be avoided, as follows...” The first part of the instruction, before the semicolon, seems to be complete in itself, saying that all you need to do is remove this ‘statement’ from the code (actually the beginner doesn’t know that this ‘statement’ is to be found in the Xara player body code, I only know what you’re referring to here because you mentioned it to me before). But then in the same sentence you seem to be saying that if you do something else in addition to this then the problem will be avoided; and you go on to give instructions about creating a box in which to place code. So, this creates confusion for the beginner, who doesn’t know whether to follow the instruction in the first part of the sentence (to simply remove the code statement), or to follow the instruction in the second part of the sentence (create a new box), or if he should actually do both.

I decided, probably mistakenly, to start from scratch on a blank web page and create a box, as you said, 400px by 60px. I then opened the properties window, went to placeholder and copied your code into the body, clicked the apply tab > OK. Seems simple enough, even though as a beginner I didn’t understand your explanation of the code: “'src' is empty and it created externally with a simply JavaScript call” Should that read, ‘and is created’? Either way this statement conveys no meaning to a beginner because a beginner doesn’t know what src is, he doesn’t know what ‘empty’ is, he doesn’t know what ‘created externally’ is and he doesn’t know what a ‘simply JavaScript call’ is.

The instructions in the next section, ‘1 line Jukebox Construction’, is where the beginner, if he is no smarter than me, gets really confused: “The following code is for deployment into a Xara design where the MP3 is part of the external assets of the design and so is located in the index_html_files/ folder.” I don’t know where the ‘index_html_files/folder” is or how to locate it, or even if it has been created yet if I haven’t made an MP3 a ‘part of the external assets’ (which I don’t know the meaning of). So, I am going to assume that the ‘index_html_files/folder’ is the folder with the suffix, ‘_xar_files’ that is automatically created when you save a new Xara website project. (By the way, if this is correct, I now know why I couldn’t find the MP3 files in this xar_files folder before. It was because by default the small box at the bottom right of the window, just above the Open and Cancel tabs was only displaying “Image (PNG, JPEG, GIF)” files. When I clicked the drop-down menu arrow, it gave the option of “All Files”. With All files displayed I could now see my MP3 files in the folder.)

The ambiguity is in which box to place the following new code: <script>
function aplayer(song) {
document.getElementById('audiplay').setAttribute(' src', 'index_html_files/' +
song);
}<
/script>)

There is ambiguity because your next statement is: “Assumes the MP3s will be added to the 'index_html_files/' folder (See Adding your Songs)” When I went to this “Adding your Songs” section of your PDF, it instructed me to create another box—which I did. And for this box I opened the placeholder window, and I clicked the ‘Replace with Graphic File’ section like you said to; then I browsed to the _xar_files folder (which might be a different folder to the Index HTML folder you are referring to?) and I opened an MP3 file, which now has its title displayed in this section. Part of the ambiguity is in your next instruction:

“As no song is selected on page load, it is appropriate to include this JavaScript in the same
Box's Placeholder Body (see Body Code).” Which box? Now I have two boxes. Is it the box I have created for the MP3 file, or is it the original box I created with the first code I copy-pasted into it? (You have “see Body Code” in brackets at the end of the sentence, but I can’t find anywhere in your PDF a section called, Body Code. Unless this is a link that doesn’t work in my version of Adobe Reader?) Anyway, supposing I choose the original box: Where do I copy-paste the new code/javascript? Do I copy it before the other code or after it? Do I need to press the Enter/Return key after the original code and start a new line, or do I just paste it next to it? I took a wild guess, hit the Enter/Return key and pasted it after the other code.

I have probably done everything wrong so far but I have got to the point in the instructions where I am completely stuck: “1 Line External Javascript Calls”. Under sub-headings such as Restart and Pause you have a short line of code which I don’t know what to do with. If I am to copy-paste it, where should it go? I have no idea what an ‘element with link’ is.

Also further down your PDF you have what is probably the most important part of the process?
“Xara Design: Click Edit Design File to open an example design directly in your Xara application.” Where do I find this “Edit Design File” tab or link in Xara? If your purple underlined words in the PDF document are meant to be links they are not working as such, like I said, in my version of Adobe Reader which is pretty up to date. Could be me being dumb again?