Appendix

Principle

In this chapter, we will see how to use Harmony Assistant to easily create web pages incorporating your music.
Directly from your Web page, visitors will be able to view, print, download or listen to your tunes.
You do not need any knowledge of HTML (the markup language for Web pages), nor a Web page editor to accomplish this.
There will be nothing to install on your visitors side (no plugin, no add-on)

NB: The Myriad Music Plug-in was deprecated by recents web browsers which don't support it anymore. If you created web pages using the Myriad Music Plug-in you can use Scripts>File>Convert Site to Myrweb to convert them.

Software

You will need :

• Harmony Assistant in a registered version.
• A software utility to upload your files to your Website (for example, FTP explorer).

Step-by-step example

I own several copyright-free music scores from various composers, which I have entered into Harmony. I want now to publish them on the Internet.

First step: setting up the files

On my hard disk, I create a folder called "Music"

In this folder, I create as many subfolder as there are composers: one for "Mozart", "Sibelius", "Bach", etc.; or by genre: "Classical", "Baroque", "Pop-Rock".

I copy the appropriate music files (ending with ".myr") into each subfolder.


The file tree is now created, and my files are sorted.



Second step: creating the list

I run Harmony Assistant and select "File>Jukebox"

I create a new list by clicking 

I click  and save the empty list in the "Music" folder. I choose "web.box" as the name. The location of the "web.box" file in the "Music" folder is important. Be sure to save it there.

In the "Action" pop-up menu, I select "Re-create the whole list according to the box file location". The list is created automatically and includes all the musical files in my file tree.

My list is now created. If I add files to any subfolder after this, I will simply have to generate the list again, using the same method.



Third step : automatic web page generation

In the "Actions" pop-up menu, I select "Export list to web".

I choose a target folder for example "webexport" which is empty.


If web export enhanced setup is enabled in global setup, the setup is asked.


The Web pages are created.

Fourth step : publishing pages

With my upload utility (here SmartFTP), I drag and drop the "webexport" folder to my site. The files are uploaded, and my music pieces are now published.

If my site is (for example) "http://www.john_doe.com", my pieces will be available at: "http://www.john_doe.com/webexport/index.html"

HTML pages appearance setup

Generated web pages are based on a configuration file written in the HTML language.
If you know the HTML language, you can modify this file (in the jukebox, "Actions>Configure web export" pop-up menu) and change the appearance of the resulting pages.

When you edit this file, a copy of the original file will be created in the preferences folder. To go back to the original version, select "Go back to default values of the web export" in the "Actions" pop-up menu.

This file is divided into sections. A section starts with its name between braces, for example {HEADER}, and ends with {End}
The sections are:
{HEADER} : Header of each HTML page
{HEADEXTPLUG} : Additional header for Plug-in export mode
{NBCOLUMN} : Number of columns for the simple export
{DURATION} : Total duration display in plug-in mode
{NEWLINE} : Line break
{TITLE} : Main web page title
{EACHFILEPLUG} : Entry for each file in plug-in mode
{EACHFILESTD} : Entry for each file in simple mode
{MAINLINE} : Entry for each folder in the main page
{FOOTER}: Footer for each page

Certain keywords, written between $, will be replaced with their respective values:

$Creator$ : Folder name
$File$ : File name
$Totalduration$ : Total duration for all files in the main page
$Duration$ : File duration
$Karaoke$ : writes "Karaoke" when lyrics are included in the file.
$Author$ : Author name
$Remark$ : remarks from within the file
$CommandePlug$ : Plug-in configuration command.
$New$ : Displays text from the {New} section if the file is more recent than the given date.
$Date$ : File last modification date.

Do not change the section names, nor the keywords. Avoid making changes to things you do not understand, otherwise you could get ... unexpected results.