File locations

In de paragraaf “Introduction” we showed you just enough to place your lesson file to get started. This sections give you all the details how files and directories are set up.

Where to save your lesson files depends on the operating system you run. On Windows XP:

C:\Users and Settings\Username\My Documents\GNU Solfege\exercises

Linux:

/home/Username/.solfege/exercises

And often the directory names are translated too. So to simplify this page we will write USERDATA whenever we refer to the directory containing exercises/. To find the value of USERDATA on your computer you should select HelpFile locations and then «Solfege user data» in the dialog that opens.

Lesson files and front page files are grouped together in subdirectories below USERDATA/exercises. You can have as many subdirectories as you like in USERDATA/exercises. Each file that matches USERDATA/exercises/*/* will be read by the program and used as a front page file if it has the correct format. Other files will silently be ignored. This means that you can have more than one front page file is a subdirectory, and extra files, like README and COPYRIGHT files are ignored.

Lesson files should be saved in a directory named lesson-files in the same directory as the front page file is saved. So if you create some exercises with jazz progressions, you might have this file structure on your computer:

USERDATA/exercises/jazzprog/page.txt
USERDATA/exercises/jazzprog/lesson-files/prog1
USERDATA/exercises/jazzprog/lesson-files/prog2
USERDATA/exercises/jazzprog/lesson-files/prog3

User lesson files

There is one folder name below USERDATA/exercises that is special. In addition to what described above, all lesson files in USERDATA/exercises/user/lesson-files will be shown when you select User Exercises on the File menu. This was done to make it simple to just write a lesson file, drop it in a directory and use it.

Opmerking

In versions prior to 3.20.3, all lesson files matching USERDATA/exercises/*/lesson-files/* would be listed.