1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144
|
<HTML>
<HEAD><TITLE>eTktab README FILE</TITLE></HEAD>
<BODY>
<H2>eTktab</H2>
<P>Author: Jason Sonnenschein
<A HREF=http://etktab.sourceforge.net>Homepage</A>
Email: <A HREF=mailto:jes_jm@yahoo.com>jes_jm@yahoo.com</A></P>
<P>Please read the <A HREF=LICENSE.html>License</A> for this program.</P>
<P>
This program is used to write out guitar tablature in the typical
style of ascii tab, often found around the internet. The code is based on
TkTab by Giovanni Chierico. Many of the ideas for the alerations found here
came from emacs tablature mode by Mark R. Rubin. Guitar icon by Sandy at
<A HREF=http://www.aroundthepixel.com>Around the Pixel</A>. Windows and
Mac binaries were created with Tcl/Tk wrapper programs--Drag & Drop Tclets
and Freewrap.</P>
<P>
Some keybindings changed between version 2.1 and 2.5 to make room for new
features. <B>NOTE: All keybindings specified in this file are true for
U.S. keyboard ONLY</B> and are merely here to illustrate how to use the
program. Look at eTktab's help window after loading a keybindings file
appropriate to your keyboard.</P>
<P>
The program will initially run with English and United States keyboard support.
To change the language support or keybindings, do the following:
<OL>
<LI>Download alternate language and/or keyboard definitions from the eTktab website (or create your own, by editing one of the available files)
<LI>Place the files in a known place on your system (preferably where eTktab resides)
<LI>Run eTktab
<LI>Select the menu entry 'Edit->Preferences->Language'
<LI>Locate the downloaded .etl file on your system
<LI>Select the menu entry 'Edit->Preferences->Keybindings'
<LI>Locate the downloaded .etk file on your system
</OL></P>
<P>
The 'Save' feature will save files in eTktab's native file format.
This is the only format the program can load. Use the 'Export' feature
to create a text file of the tablature as it appears on the screen for use
in email, newsgroups, etc. Exported tablature will only look correct in a
<B>non-proportional</B> font, such as Courier.</P>
<DL>
<DT><B>VERSION 1 USERS NOTE</B>
<DD>
The file format changed from version 1 to version 2. eTktab version
two will no longer read or write version 1 files. You can convert
files with the included script (<TT>fileconvert-v1-to-v2</TT>.)
</DL>
<P>
When eTktab is run without an initial document, it will begin with the
number of strings in the tablature that you specified in the preferences.
New windows pulled up via keypress will also have this number of strings.
Menus allow new documents of any type.
<UL>
<LI> On <I>Unix</I> machines, an initial file may be loaded by putting the
filename on the command line.
<LI><I>Macintosh</I> and <I>Windows</I> users can double-click on a document
to bring up eTktab with that document.
</UL></P>
<P>
The note insertion method mimics the ideas of tab mode in emacs. In 'chord'
mode, the cursor will not advance after a new note is placed, so other notes
of the chord can be put above and below it. In lead mode, the cursor is
advanced after each note insertion, and tablature to the right of the cursor is pushed forwards by the newly inserted tab. The base position for the 'hand'
may be moved up and down the fretboard with the + and - keys, or the
base fret menu, then the note is inserted with the following keys:</P>
<P><PRE>
STRING (guitar) STRING (bass)
E A D G B E E A D G
+-------------+ +---------+
F base+0 | 1 2 3 4 5 6 | F base+0 | 1 2 3 4 |
R base+1 | q w e r t y | OR R base+1 | q w e r |
E base+2 | a s d f g h | E base+2 | a s d f |
T base+3 | z x c v b n | T base+3 | z x c v |
</PRE></P>
<P>
So... for example, if the status bar reads that base fret is currently 5,
hitting the 's' key will add to the tab a '7' on the A string.</P>
<P>
Using Shift with the first row of keys play the 'open string' (fret 0,) no
matter what the base fret is currently set to.</P>
<P>
A dialog box can be called up to alter the tuning of the strings in the
tablature by pressing the Tuning button or with the ';' key.</P>
<P>
Note alterations, such as hammer-on and pull-off, may be added and removed
from any note. All their keybindings are Alt-<something>
(Option on <I>Macintosh</I>). Two modifiers are allowed on bar lines...
they are left repeat and right repeat. Notes may only have one modifier,
but bar lines may have both left and right modifiers simultaneously.</P>
<P>
Cutting and pasting via keyboard is done by placing a 'mark' somewhere in
the tablature, then moving the cursor to the other end of the zone you'd
like to select. At that point, you cut or copy the selected tablature,
move to where you want to paste and paste it. You may 'unplace' the mark
with the same key you use to set a mark. The delete or backspace keys
will perform a 'clear' if a mark is currently set (cut without adding to
the paste buffer.) Otherwise, they have functions related to the current
position in the tab.</P>
<P>
Cut/paste within eTktab will only work between documents of the same
type (same number of strings.) Tablature pasted into other programs
(word processors, email, etc.) only looks right in <B>non-proportional</B>
fonts, such as Courier.</P>
<P>
Mouse bindings:
<UL>
<LI>In the <I>Unix</I> version, clicking the left mouse button moves the cursor.
Clicking and dragging with the left button highlights an area. Clicking
with the right mouse button extends the highlighted area. Clicking with
the middle mouse button pastes.
<LI>On <I>Windows and Mac</I>, all that holds true for the left button, above,
is true for left button (or the Mac's single button.) Paste functionality
is on the right button. Extending the highlighted area is done via
shift-left button.
</UL>
Note that mouse clicks/drags, etc. need to be within a line of tab.
Clicks in the blank spaces between lines are ignored.</P>
<P>
An 'undo/redo' feature was added in version 2.0. It remembers 10 steps.
Remembering more steps means using more memory. If you have the source...
tune as you see fit.</P>
<P>
The rest of the key bindings are explained in the help screen, which
may be called up with the help button at the top of the window, or by hitting
'?' or Control-h (Command-h on <I>Macintosh</I>)</P>
</BODY>
</HTML>
|