1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Capítulo 4. Extending GNU Solfege</title><link rel="stylesheet" href="../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GNU Solfege 3.14.5 Manual do Usuário"><link rel="up" href="index.html" title="GNU Solfege 3.14.5 Manual do Usuário"><link rel="prev" href="inverting-intervals.html" title="Inverting intervals"><link rel="next" href="lesson-files.html" title="Lesson files"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Capítulo 4. Extending GNU Solfege</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inverting-intervals.html">Anterior</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="lesson-files.html">Próxima</a></td></tr></table><hr></div><div class="chapter" lang="pt-BR"><div class="titlepage"><div><div><h2 class="title"><a name="extending-solfege"></a>Capítulo 4. Extending GNU Solfege</h2></div></div></div><div class="toc"><p><b>Índice</b></p><dl><dt><span class="sect1"><a href="extending-solfege.html#extending-intro">Introduction</a></span></dt><dt><span class="sect1"><a href="lesson-files.html">Lesson files</a></span></dt><dd><dl><dt><span class="sect2"><a href="lesson-files.html#File-encoding">File encoding</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Useful-characters">Useful unicode characters</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Comments">Comments</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Types">Types</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Global-variables">Global variables</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Lesson-file-contents">Lesson file contents</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Header-block">Header block</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Question-block">Question block</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#music-object"><code class="literal">music</code> objects</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#functions">Functions</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#lf-operators">Operators</a></span></dt></dl></dd><dt><span class="sect1"><a href="chord-module.html">The <code class="literal">chord</code> module</a></span></dt><dt><span class="sect1"><a href="compareintervals-module.html">The <code class="literal">compareintervals</code> module</a></span></dt><dt><span class="sect1"><a href="dictation-module.html">The <code class="literal">dictation</code> module</a></span></dt><dt><span class="sect1"><a href="elembuilder-module.html">The <code class="literal">elembuilder</code> module</a></span></dt><dd><dl><dt><span class="sect2"><a href="elembuilder-module.html#elembuilder-element-block">The element block</a></span></dt><dt><span class="sect2"><a href="elembuilder-module.html#elembuilder-header-block">The header block</a></span></dt><dt><span class="sect2"><a href="elembuilder-module.html#elembuilder-question-block">The question block</a></span></dt></dl></dd><dt><span class="sect1"><a href="harmonicinterval-module.html">The <code class="literal">harmonicinterval</code> module</a></span></dt><dt><span class="sect1"><a href="idbyname-module.html">The <code class="literal">idbyname</code> module</a></span></dt><dd><dl><dt><span class="sect2"><a href="idbyname-module.html#id3053292">Question block</a></span></dt></dl></dd><dt><span class="sect1"><a href="idproperty-module.html">The <code class="literal">idproperty</code> module</a></span></dt><dt><span class="sect1"><a href="idtone-module.html">The <code class="literal">idtone</code> module</a></span></dt><dt><span class="sect1"><a href="melodicinterval-module.html">The <code class="literal">melodicinterval</code> module</a></span></dt><dt><span class="sect1"><a href="nameinterval-module.html">The <code class="literal">nameinterval</code> module</a></span></dt><dt><span class="sect1"><a href="rhythm-module.html">The <code class="literal">rhythm</code> module</a></span></dt><dt><span class="sect1"><a href="rhythmtapping-module.html">The <code class="literal">rhythmtapping</code> module</a></span></dt><dt><span class="sect1"><a href="rhythmtapping2-module.html">The <code class="literal">rhythmtapping2</code> module</a></span></dt><dt><span class="sect1"><a href="singanswer-module.html">The <code class="literal">singanswer</code> module</a></span></dt><dt><span class="sect1"><a href="singchord-module.html">The <code class="literal">singchord</code> module</a></span></dt><dt><span class="sect1"><a href="singinterval-module.html">The <code class="literal">singinterval</code> module</a></span></dt><dt><span class="sect1"><a href="mpd-module.html">The <code class="literal">mpd</code> module</a></span></dt><dt><span class="sect1"><a href="midi-instrument-names.html">Midi instrument names</a></span></dt><dd><dl><dt><span class="sect2"><a href="midi-instrument-names.html#percussion-instrument-names">Percussion instrument names</a></span></dt></dl></dd></dl></div><div class="sect1" lang="pt-BR"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="extending-intro"></a>Introduction</h2></div></div></div><p>GNU Solfege is written so that it can easily be extended, even if
2
you do not know any computer programming. The steps are:</p><div class="itemizedlist"><ul type="disc"><li><p>Create a lesson file.</p></li><li><p>Create a learning tree for your own lesson file. You do this only once.</p></li><li><p>Add the lesson file to the learning tree.</p></li></ul></div><p>Read <a class="xref" href="lesson-files.html" title="Lesson files">“Lesson files”</a> for details on creating lesson files.
3
The easiest way to get started is to take one of the existing lesson files, and
4
modify it. Select <span class="guimenuitem">File locations</span> on the
5
<span class="guimenu">Help</span> menu to find out where the included lesson files
6
are stored, and where you should save the additional files you create.
7
It is important to store the lesson files you create in the directory intended
8
for user created lesson files, and not in the applications directory. This
9
to avoid loosing files when you upgrade the program.</p><p>
10
The file paths is not written here in the user manual because the file path
11
depends on which operating system you run.</p><p>
12
You create a learning tree by opening the learning tree editor. Select
13
<span class="guimenuitem">Learning tree</span> from the <span class="guimenu">Edit</span> menu.
14
Then click the <span class="guibutton">New</span> button and enter a file name. Solfege
15
will suggest a directory to save learning trees, and unless you a good reason
16
to do so, I suggest you save the file there. You can find the location of this
17
directory in the File locations dialog.</p><p>Then you create a menu and a submenu with the learning tree editor, and
18
finally adds the lesson file to the selected submenu by clicking the
19
<span class="guibutton">Add lesson</span> button.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="inverting-intervals.html">Anterior</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="lesson-files.html">Próxima</a></td></tr><tr><td width="40%" align="left" valign="top">Inverting intervals </td><td width="20%" align="center"><a accesskey="h" href="index.html">Principal</a></td><td width="40%" align="right" valign="top"> Lesson files</td></tr></table></div></body></html>
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Capítulo 4. Extending GNU Solfege</title><link rel="stylesheet" href="../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="GNU Solfege 3.15.9 Manual do Usuário"><link rel="up" href="index.html" title="GNU Solfege 3.15.9 Manual do Usuário"><link rel="prev" href="inverting-intervals.html" title="Inverting intervals"><link rel="next" href="lesson-files.html" title="Lesson files"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Capítulo 4. Extending GNU Solfege</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="inverting-intervals.html">Anterior</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="lesson-files.html">Próxima</a></td></tr></table><hr></div><div class="chapter" title="Capítulo 4. Extending GNU Solfege"><div class="titlepage"><div><div><h2 class="title"><a name="extending-solfege"></a>Capítulo 4. Extending GNU Solfege</h2></div></div></div><div class="toc"><p><b>Índice</b></p><dl><dt><span class="sect1"><a href="extending-solfege.html#extending-intro">Introduction</a></span></dt><dt><span class="sect1"><a href="lesson-files.html">Lesson files</a></span></dt><dd><dl><dt><span class="sect2"><a href="lesson-files.html#File-encoding">File encoding</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Useful-characters">Useful unicode characters</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Comments">Comments</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Types">Types</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Global-variables">Global variables</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Lesson-file-contents">Lesson file contents</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Header-block">Header block</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#Question-block">Question block</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#music-object"><code class="literal">music</code> objects</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#functions">Functions</a></span></dt><dt><span class="sect2"><a href="lesson-files.html#lf-operators">Operators</a></span></dt></dl></dd><dt><span class="sect1"><a href="chordvoicing-module.html">The <code class="literal">chordvoicing</code> module</a></span></dt><dt><span class="sect1"><a href="compareintervals-module.html">The <code class="literal">compareintervals</code> module</a></span></dt><dt><span class="sect1"><a href="dictation-module.html">The <code class="literal">dictation</code> module</a></span></dt><dt><span class="sect1"><a href="elembuilder-module.html">The <code class="literal">elembuilder</code> module</a></span></dt><dd><dl><dt><span class="sect2"><a href="elembuilder-module.html#elembuilder-element-block">The element block</a></span></dt><dt><span class="sect2"><a href="elembuilder-module.html#elembuilder-header-block">The header block</a></span></dt><dt><span class="sect2"><a href="elembuilder-module.html#elembuilder-question-block">The question block</a></span></dt></dl></dd><dt><span class="sect1"><a href="harmonicinterval-module.html">The <code class="literal">harmonicinterval</code> module</a></span></dt><dt><span class="sect1"><a href="idbyname-module.html">The <code class="literal">idbyname</code> module</a></span></dt><dd><dl><dt><span class="sect2"><a href="idbyname-module.html#id3084536">Question block</a></span></dt></dl></dd><dt><span class="sect1"><a href="identifybpm-module.html">The <code class="literal">identifybpm</code> module</a></span></dt><dt><span class="sect1"><a href="idproperty-module.html">The <code class="literal">idproperty</code> module</a></span></dt><dt><span class="sect1"><a href="idtone-module.html">The <code class="literal">idtone</code> module</a></span></dt><dt><span class="sect1"><a href="melodicinterval-module.html">The <code class="literal">melodicinterval</code> module</a></span></dt><dt><span class="sect1"><a href="nameinterval-module.html">The <code class="literal">nameinterval</code> module</a></span></dt><dt><span class="sect1"><a href="rhythm-module.html">The <code class="literal">rhythm</code> module</a></span></dt><dt><span class="sect1"><a href="rhythmtapping-module.html">The <code class="literal">rhythmtapping</code> module</a></span></dt><dt><span class="sect1"><a href="rhythmtapping2-module.html">The <code class="literal">rhythmtapping2</code> module</a></span></dt><dt><span class="sect1"><a href="singanswer-module.html">The <code class="literal">singanswer</code> module</a></span></dt><dt><span class="sect1"><a href="singchord-module.html">The <code class="literal">singchord</code> module</a></span></dt><dt><span class="sect1"><a href="singinterval-module.html">The <code class="literal">singinterval</code> module</a></span></dt><dt><span class="sect1"><a href="twelvetone-module.html">The <code class="literal">twelvetone</code> module</a></span></dt><dt><span class="sect1"><a href="mpd-module.html">The <code class="literal">mpd</code> module</a></span></dt><dt><span class="sect1"><a href="midi-instrument-names.html">Midi instrument names</a></span></dt><dd><dl><dt><span class="sect2"><a href="midi-instrument-names.html#percussion-instrument-names">Percussion instrument names</a></span></dt></dl></dd></dl></div><div class="sect1" title="Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="extending-intro"></a>Introduction</h2></div></div></div><p>GNU Solfege is written so that it can easily be extended, even if
2
you do not know any computer programming. The steps are:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Create a <a class="link" href="lesson-files.html" title="Lesson files">lesson file</a>
3
and save it it in the first directory
4
listed when you select <span class="guimenuitem">User Exercises</span> from the
5
<span class="guimenu">File</span> menu. Create the directory if it does not
6
exist.</p></li><li class="listitem"><p>Select <span class="guimenuitem">User Exercises</span> once again to
7
see the file show up in the list.</p></li><li class="listitem"><p>Click the link to your lesson file and enjoy!</p></li></ul></div><p>To get started, you can copy one of the lesson files included in GNU
8
Solfege. The lesson files are located in the <code class="filename">exercises/standard/lesson-files</code> subdirectory of
9
the installation directory. You can find the installation directory by
10
selecting <span class="guimenuitem">File Locations</span> from the
11
<span class="guimenu">Help</span> menu. It is important to store the lesson files you
12
create in the directory intended for user created lesson files, and not in the
13
applications directory. This because all files in the installation directory
14
may be removed while upgrading the program.</p><p>If you create many lesson files, you might want to group them together
15
in a separate subdirectory and attach them to a front page file. This way you
16
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 <code class="filename">user</code>
17
directory you found by selecting <span class="guimenuitem">User Exercises</span>
18
earlier this article. Your files might be structured like this:</p><pre class="programlisting">myfiles/myfrontpage.txt
19
myfiles/lesson-files/chords-1
20
myfiles/lesson-files/chords-2
21
</pre><p>To create a new front page file, you should select
22
<span class="guimenuitem">Edit Front Page</span> from the <span class="guimenu">File</span>
23
menu, and then click <span class="guibutton">New</span> on the toolbar of the
24
dialog that pops up.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="inverting-intervals.html">Anterior</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="lesson-files.html">Próxima</a></td></tr><tr><td width="40%" align="left" valign="top">Inverting intervals </td><td width="20%" align="center"><a accesskey="h" href="index.html">Principal</a></td><td width="40%" align="right" valign="top"> Lesson files</td></tr></table></div></body></html>
added
removed
help/pt_BR/extending-solfege.html
