Ĉapitro 4. Extending GNU Solfege
Antaŭen |  | Sekven

# Ĉapitro 4. Extending GNU Solfege

## Introduction

GNU Solfege is written so that it can easily be extended, even if you do not know any computer programming. The steps are:

- Create a lesson file and save it it in `USERDATA/exercises/user/lesson-files` . You can also see the full file name for the directory when you select File → User Exercises. Create the directory if it does not exist.

- Select File → User Exercises (F9) again to see the file show up in the list.

- Click the link to your lesson file and enjoy!

To get started, you can copy one of the lesson files included in GNU Solfege. The lesson files are located in the `exercises/standard/lesson-files` subdirectory of the installation directory INSTALLDIR. You can see the full name of INSTALLDIR for your operating system by selecting Help → File Locations. It is important to store the lesson files you create in the directory intended for user created lesson files, and not in the applications directory. This because all files in the installation directory may be removed while upgrading the program.

If you create many lesson files, you might want to group them together in a separate subdirectory and attach them to a front page file. This way you have a set of files in a subdirectory that you can easily distribute to other students. So create a new directory side by side the `user` directory you found by selecting User Exercises earlier this article. Your files might be structured like this:

    myfiles/myfrontpage.txt
    myfiles/lesson-files/chords-1
    myfiles/lesson-files/chords-2

To create a new front page file, you should select Edit Front Page from the File menu, and then click New on the toolbar of the dialog that pops up.

The only way `USERDATA/exercises/user` is different from any other directory below `USERDATA/exercises` is that all lesson files saved in `USERDATA/exercises/user/lesson-files` are listed when you press F9 or select File → User Exercises.

Antaŭen |  | Sekven
Inversigo de intervaloj | Hejmen | Plugins or user contributed exercise modules