In la sekcio nomata “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 → 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
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 on the
menu. This was done to make it simple to just
write a lesson file, drop it in a directory and use it.
In versions prior to 3.20.3, all lesson files matching
USERDATA/exercises/*/lesson-files/*
would be listed.