nrinas/GuitarTeX2
1
0
Fork 0
mirror of https://github.com/workinghard/GuitarTeX2.git synced 2025-12-14 10:52:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

initial commit

Browse Source
This commit is contained in:
workinghard
2022-01-05 23:09:35 +01:00
parent 1c785e825c
commit da23cdd254
56 changed files with 1529 additions and 403 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/GuitartTeX2-documentation_de.pdf Normal file
View File

Binary file not shown.

461
doc/GuitartTeX2-documentation_de.tex Executable file
View File

@@ -0,0 +1,461 @@
\documentclass[12pt]{article}
\usepackage[latin1]{inputenc}
\usepackage{amsmath}
\usepackage[german]{babel}
\usepackage{listings}
\usepackage{verbatim}
\usepackage{graphicx}
\newcommand{\ul}{\underline{~}}
\begin{document}
\section{Einf"uhrung}
$GuitarTeX_2$ ist ein Werkzeug f<>r Gitarristen, die gut aussehende Ausdrucke ihrer Musikst<73>cke
oder Liederb<72>cher aus ihren Chord- oder Chordpro-Dateien anfertigen wollen. Es benutzt das
weit verbreitete Chord Format mit einigen Erweiterungen.\\
Es basiert auf einer Idee von Martin Leclerc und Mario Dorion aus Kanada und ihrem Programm
Chord (Version 3.5 von 1993). Um $GuitarTeX_2$ zu nutzen, ben<65>tigen Sie Kenntnisse des Programmes
Chord (wird sp<73>ter erkl<6B>rt). Obwohl das Satzsystem \LaTeX ~von $GuitarTeX_2$ genutzt wird, m<>ssen
sie wenig (oder nichts) <20>ber \LaTeX ~wissen. $GuitarTeX_2$ produziert Postscript- oder PDF-Dateien
automatisch, wenn Sie das m<>chten. Die von $GuitarTeX_2$ unterst<73>tzten Direktiven des Programms
Chord werden erl<72>utert.
\subsection{Eigenschaften}
\begin{itemize}
\item
Grafische Benutzeroberfl<66>che mit integriertem Editor
\item
Druckt gut aussehende Liedbl<62>tter mit Akkorden unter Benutzung von Proportionalschriften
\item
Ausgabeformate \LaTeX, Postscript und PDF
\item
Kompatibel mit ChordPro-Format, Import von ASCII-Dateien
\item
Notensatz mit den \LaTeX-Paketen MusixTeX, MusixLyr und TabDefs
\item
Flexibles Seitenlayout (Gr<47><72>e, R<>nder...)
\item
Benutzerdefinierte Farben f<>r Refrain, Bridge ...
\item
Optionale Ausgabe von Akkordsymbolen am Ende eines St<53>ckes
\item
ASCII-Tabulaturen und eingebaute Funktionen f<>r Gitarrten- und Bass-Tabulaturen
\item
\LaTeX-Kommandos k<>nnen in Chord-Dateien verwendet werden (f<>r Profis)
\end{itemize}
\subsection{Beispiel}
$GuitarTeX_2$ konvertiert eine Datei mit Text und Akkorden im Chord-Format in
eine \LaTeX-Datei. Ein Beispiel f<>r eine Chord-Datei: \\
\\
{\bf\{title:The Manual Song\} \\
\{st:No-one has yet claimed responsibility\} \\
~[D]I print verses [A7]in a [D]row, \\
The next line gets put [A7]down be[D]low, \\
Mumble mumble [A7]rhymes with [D]grow [G] [G\#] [A] \\
Done this verse, now [A7sus4]on we [quietly]go! \\
\\
\{soc\} \\
~[D]This is the [Bm]manual song \\
~[A7]No-one really knows what's [D]goin' on \\
~[D]This is the [F\#m]manual song \\
~[A7]And now the chorus is already [D]gone \\
\{eoc\} \\
\\
~[D]The second verse is [A7]like the [D]first, \\
The music poor, the [A7]verse is [D]worse, \\
I wrote this since [A7]I'd get [D]sued, \\
If I used real songs. [A7]This'll [D]do. \\
\\
\{c:repeat chorus\} } \\
\\
\includegraphics[width=1.1\textwidth]{pics/example1.pdf}
\\
Wenn Sie sich mit \LaTeX ~auskennen, k<>nnen Sie die Ausgabedatei auch manuell ver<65>ndern,
bevor Sie sie in Postscript oder PDF umwandeln. Der Vorteil ist, dass Sie alle M<>glichkeiten
von \LaTeX ~einschlie<69>lich der vielen Zusatzpackete wie graphics oder MusicTeX einsetzen k<>nnen.
\section{Installation}
\subsection{Woher bekomme ich $GuitarTeX_2$}
Die aktuelle Version bekommen Sie immer auf der Download-Seite des $GuitarTeX_2$-Projektes:
http://sourceforge.net/projects/guitartex2.
\subsection{Systemanforderungen}
$GuitarTeX_2$ ist ein Java Programm welches Betriessystemunabh<62>gig entwickelt wurde.
Ben"otigt werden:
\begin{itemize}
\item
Java 1.4 oder h<>her
\item
PDF - Betrachter (z.B. Acrobat Reader, xpdf)
Bei MacOS X braucht man es nicht
\item
Internetverbindung (optinal)
\item
\LaTeX (optional)
\end{itemize}
\subsection{Installation}
Laden sie sich das bin<69>re Paket (GuitarTeX2.jar) herunter. Je nachdem wie sie Ihr
System konfiguriert haben, reicht es darauf zu Doppelklicken oder mit
''java -jar GuitarTeX2.jar'' aus der Kommandozeile zu starten. \\
\\
Es wird beim ersten Starten eine lokale Konfigurationsdatei
angelegt. Diese ist im Homeverzeichnis des Benutzers zu finden. Sie kann nachtr<74>glich
ver<65>ndert werde und wird immer beim starten zuerst ausgelesen.
\section{Der Editor $GuitarTeX_2$}
<Hier kommt bald eine genaue Beschreibung>
\section{Unterst<EFBFBD>tzte Chord-Direktiven}
Direktiven sind Befehle zwischen geschweiften Klammern, die das Aussehen der erzeugten
Ausgabe steuern. Einige h<>ufig ben<65>tigte Direktiven k<>nnen durch eine Abk<62>rzung ersetzt
werden (siehe Beispiele). $GuitarTeX_2$ bringt einige neue Direktiven mit, die das original
Chord Programm nicht kennt.
\subsection{Spezielle Zeichen}
Einige Zeichen haben in GuitarTeX eine besondere Bedeutung:
\begin{itemize}
\item
\# am Anfang einer Zeile markiert einen Kommentar. Die Zeile wird von $GuitarTeX_2$ ignoriert
\item
/ darf nur in Akkorden mit Bass verwendet werden (z.B. A/E)
\end{itemize}
\subsection{Seitenlayout}
Die Direktive geometry bietet flexible M<>glichkeiten, das Layout einer Seite anzupassen.
Sie benutzt das \LaTeX-Paket geometry. Die folgende Beschreibung ist ein (modifizierter)
Teil der Original-Dokumentation.
\\
Das geometry Paket bietet viele automatische Ausrichtungen, so dass nur wenige manuelle
Angaben zum Seitenlayout erforderlich sind. In diesem Fall reicht ein einfaches \\
\\
{\bf\{geometry:a4paper\}} \\
\\
Das Setzen von Seitenr<6E>ndern erfolgt mit \\
\\
{\bf\{geometry:margin=2.5cm\}} \\
\\
wenn alle R<>nder einer Seite 2,5 Zentimeter betragen sollen.
L<>ngenangaben erfolgen in
\begin{itemize}
\item
Zentimeter (cm)
\item
Millimeter (mm)
\item
Inch (in)
\item
Punkt (pt)
\end{itemize}
\subsubsection{Grunds"atzliches}
Das Seitenlayout besteht aus einer einfachen Struktur: Die Seite (paper) enth<74>lt einen
Textk<74>rper (total-body, druckbarer Bereich) und R<>nder. Der Textk<74>rper besteht aus Kopf-
und Fu<46>zeile, dem eigentlichen Text und (optional) den Randbemerkungen. Die vier R<>nder
hei<65>en left-margin, right-margin, top-margin und bottom-margin.\\
\begin{itemize}
\item
paper: total-body (printable area) and margins
\item
total-body: head, body(text area), foot and marginal notes
\item
margins: left-, right-, top- and bottom-margin
\end{itemize}
Jeder Rand wird von der jeweiligen Kante der Seite aus gemessen, z.B. left-margin meint
den Abstand zwischen linker Seitenkante und dem Textk<74>rper. Die Gr<47><72>en von paper, totalbody
und margins stehen in diesen Ralationen:
\begin{itemize}
\item
paperwidth = left + width + right
\item
paperheight = top + height + bottom
\end{itemize}
\subsubsection{Optionen}
Optionen der Direktive geometry: \\
\begin{tabular}{|l|l|}
\textbf{Name} & \textbf{Bedeutung} \\
\hline
landscape & schaltet um auf Querformat \\
portrait & schaltet um auf Hochformat \\
twoside & schaltet auf zweiseitige Ausgabe um. Die linken und rechen R<>nder werden bei geraden
und ungeraden Seiten symmetrisch angeordnet. \\
reversemp & Randbemerkungen erscheinen am linken Rand (statt am rechten Rand) \\
nohead & keine Reservierung von Platz f<>r Kopfzeilen \\
nofoot & keine Reservierung von Platz f<>r Fu<46>zeilen \\
noheadfoot & keine Reservierung von Platz f<>r Kopf- und Fu<46>zeilen \\
a4paper, a5paper & spezifizert die Papiergr<67><72>e, ohne Wert anzugeben \\
paperwidth & Breite des Papiers. paperwidth=$<$paperwidth$>$ \\
paperheight & H<>he des Papiers. paperheight=$<$paperheight$>$ \\
width & Breite des Textk<74>rpers. width=$<$width$>$or totalwidth=$<$width$>$. Diese Angabe
sollte nicht mit der Textbreite (textwidth) verwechselt werden. width enth<74>lt die
Textbreite und die Breite der Randbemerkungen. \\
height & H<>he des Textk<74>rpers (einschlie<69>lich Kopf- und Fu<46>zeile). height=$<$height$>$ \\
left & linker Rand. left=$<$leftmargin$>$ \\
right & rechter Rand. right=$<$rightmargin$>$ \\
top & oberer Rand. top=$<$topmargin$>$ \\
bottom & unterer Rand. bottom=$<$bottommargin$>$ \\
margin & alle R<>nder. margin=$<$margin$>$ \\
textwidth & Breite des Textes. textwidth=$<$width$>$ \\
textheight & H<>he des Textes. textheight=$<$height$>$ \\
marginpar & Breite der Randbemerkungen. marginpar=$<$length$>$ \\
marginparsep & Abstand zwischen Text und Randbemerkungen. marginparsep=$<$length$>$ \\
head & H<>he der Kopfzeile. head=$<$length$>$ \\
headsep & Abstand zwischen Kopfzeile und Text. headsep=$<$length$>$ \\
foot & Abstand zwischen Fu<46>zeile und Text. foot=$<$length$>$ \\
\end{tabular}
\subsubsection{Beispiele}
Setzen Sie die H<>he des Textk<74>rpers auf 10in, den unteren Rand auf 2cm. Der obere
Rand wird automatisch berechnet:\\
\\
{\bf\{geometry:height=10in,bottom=2cm\}} \\
\\
oder: \\
\\
{\bf\{g:height=10in,bottom=2cm\}} \\
\\
oder: \\
\\
{\bf\{geometry:height=10in\} \\
\\
\{g:bottom:=2cm\}} \\
\\
Setzen Sie den linken, rechten und oberen Rand auf 3cm, 2cm und 2.5in.
Es wird keine Kopfzeile ben<65>tigt. \\
\\
{\bf\{geometry:left=3cm,right=2cm, nohead,top=2.5in\}} \\
\\
oder: \\
\\
{\bf\{geometry:left=3cm\} \\
\{geometry:right=2cm\} \\
\{geometry:nohead\} \\
\{geometry:top=2.5in\}} \\
\\
oder : \\
\\
{\bf\{g:left=3cm,right=2cm\} \\
\{g:nohead, top=2.5in\}} \\
\\
und so weiter ... \\
<09>ndern Sie die Breite der Randbemerkungen auf 3cm \\
\\
{\bf\{geometry:marginpar=3cm\} \\
\{geometry:marginpar=3cm, reversemp\}} \\
\\
l<>sst die Randbemerkungen am linken Rand ausgeben.\\
Verwenden sie A5-Papier im Querformat: \\
\\
{\bf\{geometry:a5paper, landscape\}} \\
\subsection{Dokumentenstrukur}
\subsubsection{title}
Der Titel eines St<53>ckes wird durch die Direktive title markiert. Der
Titel wird zentriert mit einer vergr<67><72>erten Schrift ausgegeben.
In Dokumenten mit mehreren St<53>cken verursacht title einen Seitenumbruch. \\
Beispiel:\\
\\
{\bf\{title:Go Down Moses\} \\
\{t:Go Down Moses\}} \\
\subsubsection{subtitle}
Die Direktive \textbf{subtitle} dient zur Darstellung zus<75>tzlicher
Informationen, wie z.B. Interpret oder Komponist. \\
Beispiel: \\
\\
{\bf\{subtitle:written by John Lennon / Paul McCartney\} \\
\{st:written by John Lennon / Paul McCartney\}} \\
\subsubsection{bridge}
Eine Bridge wird mit \{bridge\} oder \{sob\} (start of bridge) am Anfang,
und \{/bridge\} oder \{eob\} (end of bridge) am Ende markiert. Die Bridge
wird auf Farbdruckern in blau ausgegeben. Die Farbe kann mit der Direktive
color\underline{~}bridge angepasst werden (siehe Abschnitt namens color\underline{~}xxx).\\
Beispiel: \\
\\
{\bf \{bridge\} \\
I want her [Ab]everywhere [Fm] \\
And if [Bbm]she's beside me [C7]I know I need [Fm]never care \\
~[Bb]But to love her [C7]is to meet her \\
\{/bridge\}} \\
\subsubsection{chorus}
Ein Refrain wird mit \{chorus\} oder \{soc\} (start of chorus) am Anfang und mit \{/chorus\}
oder \{eoc\} (end of chorus) am Ende markiert. Der Refrain wird auf Farbdruckern in rot
ausgegeben. Die Farbe kann mit der Direktive color\underline{~}chorus angepasst werden
(siehe Abschnitt namens color\underline{~}xxx).\\
Beispiel: \\
\\
{\bf\{chorus\} \\
Oh, I get [C]by with a little [G]help from my [D]friends \\
Mm, I get [C]high with a little [G]help from my [D]friends \\
Oh, I'm gonna [C]try with a little [G]help from my [D]friends \\
\{/chorus\}} \\
\subsubsection{instr}
Ein Instrumental-Teil wird mit \{instr\} oder \{soi\} (start of instrumental) am Anfang
und \{/instr\} oder \{eoi\} (end of instrumental) am Ende markiert. Der Instrumental-Teil
wird auf Farbdruckern in grau ausgegeben. Die Farbe kann mit der Direktive
color\underline{~}instr angepasst werden (siehe Abschnitt namens color\underline{~}xxx).
\subsubsection{np}
np steht f<>r eine ''neue Seite'' und erzeugt einen Seitenumbruch.\\
Beispiel: \\
{\bf\{np\}} \\
\subsubsection{tab}
Tabulaturen werden mit \{tab\} oder \{sot\} (start of tablature) am Anfang und \{/tab\}
oder \{eot\} (end of tablature) am Ende markiert. Tabulaturen werden auf Farbdruckern
in gr<67>n ausgegeben. Die Farbe kann mit der Direktive color\underline{~}tab directive
angepasst werden (siehe Abschnitt namens color\underline{~}xxx). Tabulaturen werden
in einer nichtproportionalen Schriftart ausgegeben.\\
Beispiel: \\
\includegraphics[width=15cm]{pics/tabs1.pdf}
\subsection{Fonts}
Die Direktiven zur Beeinflussung der Schriftart und -farbe k<>nnen irgendwo in Ihrer Datei
stehen. Trotzdem ist es hilfreich sie am Anfang zu platzieren. Die angegebenen Werte
gelten f<>r das ganze Dokument.
\subsubsection{font\underline{~}size}
\LaTeX ~kennt drei Schriftgr<67><72>en 10pt, 11pt and 12pt. GuitarTeX nutzt normalerweise
11pt (Titel und Untertitel werden automatisch vergr<67><72>ert). Wenn Sie z.B. 12pt
verwenden wollen, schreiben Sie:\\
\\
{\bf\{font\underline{~}size:12\}} \\
\\
Achtung: schreiben Sie nicht 12pt statt 12!\\
\subsubsection{color\underline{~}xxx}
Mit den folgenden Direktiven k<>nnen Sie die Textfarbe f<>r Refrain, Bridge,
Instrumental-Teil Tabulaturen und zweite Stimme anpassen. F<>r die zweite Stimme
k<>nnen Sie auch die Hintergrundfarbe <20>ndern, so dass Sie z.B. wei<65>e Schrift auf einem
farbigen Hintergrund verwenden k<>nnen. Das erleichtert den S<>ngern hoffentlich
die Orientierung bei mehreren Textzeilen. \\
Die Direktiven hei<65>en: \\
\begin{itemize}
\item
color\underline{~}chorus
\item
color\underline{~}bridge
\item
color\underline{~}instr
\item
color\underline{~}tab
\item
color\underline{~}second
\item
color\underline{~}second\underline{~}back
\end{itemize}
Als Parameter wird eine durch Kommas getrennte Liste von Werten zwischen null und
eins, die die Farben rot, gr<67>n und blau repr<70>sentieren.\\
Beispiel: \\
\\
{\bf\{color\underline{~}chorus:.5,.5,1\}}
\subsection{Gitarren- und Bass-Tabulaturen}
$GuitarTeX_2$ kennt zwei neue Direktiven zur Darstellung von Tabulaturen:
\begin{itemize}
\item
\{guitartab: \} f<>r Gitarren-Tabulaturen
\item
\{basstab: \} f<>r Bass-Tabulaturen
\end{itemize}
Jede guitartab oder basstab Direktive stellt eine Zeile mit sechs bzw vier Linien dar.
Sie k<>nnen mit \{guitartab: \} oder \{basstab: \} auch leere Tabulaturen erzeugen.
Setzen Sie eine Leerzeile vor die Direktive, damit die Tabulatur am linken Rand beginnt.\\
Die Klammern k<>nnen enthalten:
\begin{itemize}
\item
normaler Text, der unterhalb der Tabulatur ausgegeben wird
\item
Noten im Format [string;fret], z.B. [2;5] f<>r 5. Bund auf der A-Saite
\item
Taktstriche (durch das Zeichen $|$ dargestellt)
\item
Zus<75>tzlicher Leerraum mit ''\ul{}''
\end{itemize}
Beispiel: leere Gitarrentabulatur \\
\\
{\bf\{guitartab:\}} \\
\\
Beispiel: Eine Bass-Tabulatur mit Text \\
\\
{\bf\{basstab:some text\}} \\
\\
Beispiel: Noten, Taktstriche und Leerraum \\
\\
{\bf\{guitartab:[2;3][3;0][3;2][3;3]$|$[4;0]\ul\ul[4;2]\ul\ul[5;0]\ul\ul[5;1]$|$\}} \\
\\
Beispiel: Text unter den Noten anordnen \\
\\
{\bf\{guitartab:[2;3]do [3;0]re [3;2]mi [3;3]fa $|$[4;0]so [4;2]la [5;0]si [5;1]do$|$\}} \\
\\
Beispiel: Eine einfache Bass-Tabulatur \\
\\
{\bf\{basstab:[2;5][2;5]$|$[2;5][2;5]$|$[3;5][3;5]$|$[2;5][2;5]$|$[3;7][3;7]$|$[3;5][3;5]$|$[2;5]\}} \\
\\
Beispiel: Akkorde \\
\\
{\bf\{guitartab:[2;3]\&[3;5]\&[4;5]C (power chord) $|$[2;3]\&[3;2]\&[4;0]\&[5;1]C chord\}} \\
\subsection{N"utzliches}
\subsubsection{define}
Mit der Direktive define k<>nnen Sie ein Akkord-Symbol am Ende eines St<53>ckes erstellen.
Die Direktive kann irgendwo im St<53>ck platziert sein.\\
define verf<72>gt <20>ber acht Parameter:\\
\begin{itemize}
\item
den Akkordnamen
\item
die Nummer des ersten Bundes
\item
sechs Nummern f<>r die sechs Saiten (ein x bedeutet, dass die Saite nicht gespielt wird)
\end{itemize}
Beispiel:\\
\\
{\bf\{define:A 1 x n 2 2 2 n\} \\
\{define:Cm 3 x 1 3 3 2 1\} \\
\{define:Gm/Bb 4 3 2 2 1 x x\}} \\
\subsubsection{comment}
Die Direktive comment f<>gt einen Text ein, der nicht zum eigentlichen St<53>ck geh<65>rt. \\
Beispiel: \\
\\
{\bf\{comment: repeat chorus\} \\
\{c: repeat chorus\}} \\
\subsubsection{margin}
Die Direktive margin erzeugt eine Randbemerkung. Diese k<>nnen z.B. dazu genutzt werden,
Hinweise f<>r den Musiker einzuf<75>gen.\\
Beispiel: \\
\\
{\bf\{margin:Fade Out\} \\
\{m:Fade Out\}} \\
\subsubsection{second}
In einigen St<53>cken hat die zweite Stimme nicht nur eine andere Melodie, sondern auch
einen anderen oder versetzt gesungenen Text. Bekannte Beispiele sind "California Dreaming"
von The Mamas And The Papas und "Help" von den Beatles. Wenn Sie die zweite Stimme mit
der Direktive second markieren erscheint sie in wei<65>er Schrift auf grauem Hintergrund.
Wegen der proportionalen Schrift m<>ssen Sie ein wenig experimentieren, um die korrekte
Ausrichtung zwischen erster und zweiter Stimme zu erhalten.\\
Beispiel: \\
\\
{\bf[G] When I was younger so much [Hm]younger than today \\
\{second:When when I was young\} \\
~[Em] I never needed anybody's [C]help in [F]any [G]way \\
\{second:I never need help in any way\} \\
~[G]But now these days are gone and I'm [Bm]not so self assured \\
\{second:Now these days are gone\} \\
~[Em] Now I find I've changed my mind, \\
\{second:And now I find\} \\
I've [C]opened [F]up the [G]doors \\
\{second:I've opened up the doors\}} \\
\section{\LaTeX-Kommandos und Pakete verwenden}
\subsection{\LaTeX-Kommandos}
Wie in der Einf<6E>hrung erw<72>hnt, brauchen Sie nichts <20>ber \LaTeX ~zu wissen, um $GuitarTeX_2$
zu nutzen. Wenn Sie sich mit \LaTeX ~auskennen, k<>nnen Sie dessen M<>glichkeiten nutzen,
um Ihre Ergebnisse weiter zu verbessern. Alle Zeilen, die mit einem Backslash beginnen,
werden in die erzeute \LaTeX-Datei <20>bernommen. Sie k<>nnen das einfach mit einem Kommando
wie diesem testen: \\
\\
{\bf$\backslash$marginpar\{test\}} \\
\\
Das Ergebnis ist eine Randbemerkung mit dem Wort ''test''.
Die \LaTeX-Kommandos werden an der Stelle ausgef<65>hrt, an der sie in der Datei vorkommen.
Manche Kommandos m<>ssen allerdings in der sog. Pr<50>ambel der \LaTeX-Datei erscheinen.
Das geschieht mit der Direktive preamble:\\
\\
{\bf\{preamble:$\backslash$usepackage(fancyheadings)\}}\\
\\
Die Direktive preamble kann irgendwo im Dokument stehen. Die enthaltenen Kommandos
erscheinen in der \LaTeX-Pr<50>ambel in der Reihenfolge, in der sie in der Chord-Datei stehen.
\end{document}

38
doc/GuitartTeX2-documentation_en.aux Normal file
View File

@@ -0,0 +1,38 @@
\relax
\providecommand\babel@aux[2]{}
\@nameuse{bbl@beforestart}
\babel@aux{english}{}
\@writefile{toc}{\contentsline {section}{\numberline {1}Overview}{1}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {1.1}Features}{1}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {1.2}Beispiel}{2}{}\protected@file@percent }
\@writefile{toc}{\contentsline {section}{\numberline {2}Installation}{4}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}Woher bekomme ich $GuitarTeX_2$}{4}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {2.2}Systemanforderungen}{4}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {2.3}Installation}{4}{}\protected@file@percent }
\@writefile{toc}{\contentsline {section}{\numberline {3}Der Editor $GuitarTeX_2$}{4}{}\protected@file@percent }
\@writefile{toc}{\contentsline {section}{\numberline {4}Unterst\"utzte Chord-Direktiven}{5}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {4.1}Spezielle Zeichen}{5}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {4.2}Seitenlayout}{5}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.1}Grunds"atzliches}{6}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.2}Optionen}{7}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.3}Beispiele}{7}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {4.3}Dokumentenstrukur}{9}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.1}title}{9}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.2}subtitle}{9}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.3}bridge}{9}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.4}chorus}{10}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.5}instr}{10}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.6}np}{10}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.7}tab}{10}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {4.4}Fonts}{12}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.4.1}font\underline {~}size}{12}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.4.2}color\underline {~}xxx}{12}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {4.5}Gitarren- und Bass-Tabulaturen}{13}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {4.6}N"utzliches}{14}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.1}define}{14}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.2}comment}{14}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.3}margin}{15}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.6.4}second}{15}{}\protected@file@percent }
\@writefile{toc}{\contentsline {section}{\numberline {5}\LaTeX -Kommandos und Pakete verwenden}{16}{}\protected@file@percent }
\@writefile{toc}{\contentsline {subsection}{\numberline {5.1}\LaTeX -Kommandos}{16}{}\protected@file@percent }
\gdef \@abspage@last{16}

667
doc/GuitartTeX2-documentation_en.log Normal file
View File

@@ -0,0 +1,667 @@
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021) (preloaded format=pdflatex 2021.4.22) 5 JAN 2022 23:07
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**GuitartTeX2-documentation_en.tex
(./GuitartTeX2-documentation_en.tex
LaTeX2e <2020-10-01> patch level 4
L3 programming layer <2021-02-18>
(/usr/local/texlive/2021/texmf-dist/tex/latex/base/article.cls
Document Class: article 2020/04/10 v1.4m Standard LaTeX document class
(/usr/local/texlive/2021/texmf-dist/tex/latex/base/size12.clo
File: size12.clo 2020/04/10 v1.4m Standard LaTeX file (size option)
)
\c@part=\count179
\c@section=\count180
\c@subsection=\count181
\c@subsubsection=\count182
\c@paragraph=\count183
\c@subparagraph=\count184
\c@figure=\count185
\c@table=\count186
\abovecaptionskip=\skip47
\belowcaptionskip=\skip48
\bibindent=\dimen138
)
(/usr/local/texlive/2021/texmf-dist/tex/latex/base/inputenc.sty
Package: inputenc 2020/08/01 v1.3d Input encoding file
\inpenc@prehook=\toks15
\inpenc@posthook=\toks16
(/usr/local/texlive/2021/texmf-dist/tex/latex/base/latin1.def
File: latin1.def 2020/08/01 v1.3d Input encoding file
))
(/usr/local/texlive/2021/texmf-dist/tex/latex/amsmath/amsmath.sty
Package: amsmath 2020/09/23 v2.17i AMS math features
\@mathmargin=\skip49
For additional information on amsmath, use the `?' option.
(/usr/local/texlive/2021/texmf-dist/tex/latex/amsmath/amstext.sty
Package: amstext 2000/06/29 v2.01 AMS text
(/usr/local/texlive/2021/texmf-dist/tex/latex/amsmath/amsgen.sty
File: amsgen.sty 1999/11/30 v2.0 generic functions
\@emptytoks=\toks17
\ex@=\dimen139
))
(/usr/local/texlive/2021/texmf-dist/tex/latex/amsmath/amsbsy.sty
Package: amsbsy 1999/11/29 v1.2d Bold Symbols
\pmbraise@=\dimen140
)
(/usr/local/texlive/2021/texmf-dist/tex/latex/amsmath/amsopn.sty
Package: amsopn 2016/03/08 v2.02 operator names
)
\inf@bad=\count187
LaTeX Info: Redefining \frac on input line 234.
\uproot@=\count188
\leftroot@=\count189
LaTeX Info: Redefining \overline on input line 399.
\classnum@=\count190
\DOTSCASE@=\count191
LaTeX Info: Redefining \ldots on input line 496.
LaTeX Info: Redefining \dots on input line 499.
LaTeX Info: Redefining \cdots on input line 620.
\Mathstrutbox@=\box47
\strutbox@=\box48
\big@size=\dimen141
LaTeX Font Info: Redeclaring font encoding OML on input line 743.
LaTeX Font Info: Redeclaring font encoding OMS on input line 744.
\macc@depth=\count192
\c@MaxMatrixCols=\count193
\dotsspace@=\muskip16
\c@parentequation=\count194
\dspbrk@lvl=\count195
\tag@help=\toks18
\row@=\count196
\column@=\count197
\maxfields@=\count198
\andhelp@=\toks19
\eqnshift@=\dimen142
\alignsep@=\dimen143
\tagshift@=\dimen144
\tagwidth@=\dimen145
\totwidth@=\dimen146
\lineht@=\dimen147
\@envbody=\toks20
\multlinegap=\skip50
\multlinetaggap=\skip51
\mathdisplay@stack=\toks21
LaTeX Info: Redefining \[ on input line 2923.
LaTeX Info: Redefining \] on input line 2924.
)
(/usr/local/texlive/2021/texmf-dist/tex/generic/babel/babel.sty
Package: babel 2021/03/24 3.56 The Babel package
(/usr/local/texlive/2021/texmf-dist/tex/generic/babel/babel.def
File: babel.def 2021/03/24 3.56 Babel common definitions
\babel@savecnt=\count199
\U@D=\dimen148
\l@babelnohyphens=\language87
(/usr/local/texlive/2021/texmf-dist/tex/generic/babel/txtbabel.def)
\bbl@readstream=\read2
)
\bbl@dirlevel=\count266
(/usr/local/texlive/2021/texmf-dist/tex/generic/babel-english/english.ldf
Language: english 2017/06/06 v3.3r English support from the babel system
Package babel Info: \l@canadian = using hyphenrules for english
(babel) (\language0) on input line 102.
Package babel Info: \l@australian = using hyphenrules for ukenglish
(babel) (\language21) on input line 105.
Package babel Info: \l@newzealand = using hyphenrules for ukenglish
(babel) (\language21) on input line 108.
))
(/usr/local/texlive/2021/texmf-dist/tex/latex/listings/listings.sty
(/usr/local/texlive/2021/texmf-dist/tex/latex/graphics/keyval.sty
Package: keyval 2014/10/28 v1.15 key=value parser (DPC)
\KV@toks@=\toks22
)
\lst@mode=\count267
\lst@gtempboxa=\box49
\lst@token=\toks23
\lst@length=\count268
\lst@currlwidth=\dimen149
\lst@column=\count269
\lst@pos=\count270
\lst@lostspace=\dimen150
\lst@width=\dimen151
\lst@newlines=\count271
\lst@lineno=\count272
\lst@maxwidth=\dimen152
(/usr/local/texlive/2021/texmf-dist/tex/latex/listings/lstmisc.sty
File: lstmisc.sty 2020/03/24 1.8d (Carsten Heinz)
\c@lstnumber=\count273
\lst@skipnumbers=\count274
\lst@framebox=\box50
)
(/usr/local/texlive/2021/texmf-dist/tex/latex/listings/listings.cfg
File: listings.cfg 2020/03/24 1.8d listings configuration
))
Package: listings 2020/03/24 1.8d (Carsten Heinz)
(/usr/local/texlive/2021/texmf-dist/tex/latex/tools/verbatim.sty
Package: verbatim 2020-07-07 v1.5u LaTeX2e package for verbatim enhancements
\every@verbatim=\toks24
\verbatim@line=\toks25
\verbatim@in@stream=\read3
)
(/usr/local/texlive/2021/texmf-dist/tex/latex/graphics/graphicx.sty
Package: graphicx 2020/09/09 v1.2b Enhanced LaTeX Graphics (DPC,SPQR)
(/usr/local/texlive/2021/texmf-dist/tex/latex/graphics/graphics.sty
Package: graphics 2020/08/30 v1.4c Standard LaTeX Graphics (DPC,SPQR)
(/usr/local/texlive/2021/texmf-dist/tex/latex/graphics/trig.sty
Package: trig 2016/01/03 v1.10 sin cos tan (DPC)
)
(/usr/local/texlive/2021/texmf-dist/tex/latex/graphics-cfg/graphics.cfg
File: graphics.cfg 2016/06/04 v1.11 sample graphics configuration
)
Package graphics Info: Driver file: pdftex.def on input line 105.
(/usr/local/texlive/2021/texmf-dist/tex/latex/graphics-def/pdftex.def
File: pdftex.def 2020/10/05 v1.2a Graphics/color driver for pdftex
))
\Gin@req@height=\dimen153
\Gin@req@width=\dimen154
)
(/usr/local/texlive/2021/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def
File: l3backend-pdftex.def 2021-03-18 L3 backend support: PDF output (pdfTeX)
\l__color_backend_stack_int=\count275
\l__pdf_internal_box=\box51
)
(./GuitartTeX2-documentation_en.aux)
\openout1 = `GuitartTeX2-documentation_en.aux'.
LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 12.
LaTeX Font Info: ... okay on input line 12.
LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 12.
LaTeX Font Info: ... okay on input line 12.
LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 12.
LaTeX Font Info: ... okay on input line 12.
LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 12.
LaTeX Font Info: ... okay on input line 12.
LaTeX Font Info: Checking defaults for TS1/cmr/m/n on input line 12.
LaTeX Font Info: ... okay on input line 12.
LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 12.
LaTeX Font Info: ... okay on input line 12.
LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 12.
LaTeX Font Info: ... okay on input line 12.
\c@lstlisting=\count276
(/usr/local/texlive/2021/texmf-dist/tex/context/base/mkii/supp-pdf.mkii
[Loading MPS to PDF converter (version 2006.09.02).]
\scratchcounter=\count277
\scratchdimen=\dimen155
\scratchbox=\box52
\nofMPsegments=\count278
\nofMParguments=\count279
\everyMPshowfont=\toks26
\MPscratchCnt=\count280
\MPscratchDim=\dimen156
\MPnumerator=\count281
\makeMPintoPDFobject=\count282
\everyMPtoPDFconversion=\toks27
) (/usr/local/texlive/2021/texmf-dist/tex/latex/epstopdf-pkg/epstopdf-base.sty
Package: epstopdf-base 2020-01-24 v2.11 Base part for package epstopdf
Package epstopdf-base Info: Redefining graphics rule for `.eps' on input line 4
85.
(/usr/local/texlive/2021/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg
File: epstopdf-sys.cfg 2010/07/13 v1.3 Configuration of (r)epstopdf for TeX Liv
e
))
Underfull \hbox (badness 10000) in paragraph at lines 15--23
[]
LaTeX Font Info: Trying to load font information for OMS+cmr on input line 5
2.
(/usr/local/texlive/2021/texmf-dist/tex/latex/base/omscmr.fd
File: omscmr.fd 2019/12/16 v2.5j Standard LaTeX font definitions
)
LaTeX Font Info: Font shape `OMS/cmr/bx/n' in size <12> not available
(Font) Font shape `OMS/cmsy/b/n' tried instead on input line 52.
<pics/example1.pdf, id=1, 614.295pt x 794.97pt>
File: pics/example1.pdf Graphic file (type pdf)
<use pics/example1.pdf>
Package pdftex.def Info: pics/example1.pdf used on input line 73.
(pdftex.def) Requested size: 429.00238pt x 555.1894pt.
Underfull \hbox (badness 10000) in paragraph at lines 49--78
[]
Underfull \hbox (badness 10000) in paragraph at lines 49--78
[]
Underfull \hbox (badness 10000) in paragraph at lines 49--78
[]
Underfull \hbox (badness 10000) in paragraph at lines 49--78
[]
Underfull \hbox (badness 10000) in paragraph at lines 49--78
[]
Overfull \hbox (39.00238pt too wide) in paragraph at lines 49--78
[]
[]
[1
{/usr/local/texlive/2021/texmf-var/fonts/map/pdftex/updmap/pdftex.map}]
[2]
Overfull \vbox (6.6894pt too high) has occurred while \output is active []
[3 <./pics/example1.pdf>]
Overfull \hbox (31.3243pt too wide) in paragraph at lines 82--84
\OT1/cmr/m/n/12 Die ak-tuelle Ver-sion bekom-men Sie im-mer auf der Download-Se
ite des $\OML/cmm/m/it/12 GuitarTeX[]$\OT1/cmr/m/n/12 -
[]
Underfull \hbox (badness 10000) in paragraph at lines 101--108
[]
Overfull \hbox (12.74258pt too wide) in paragraph at lines 101--108
\OT1/cmr/m/n/12 ist im Homev-erze-ich-nis des Be-nutzers zu finden. Sie kann na
chtr^^?aglich ver^^?andert
[]
[4]
Underfull \hbox (badness 10000) in paragraph at lines 125--140
[]
Underfull \hbox (badness 10000) in paragraph at lines 125--140
[]
Underfull \hbox (badness 10000) in paragraph at lines 125--140
[]
Underfull \hbox (badness 10000) in paragraph at lines 125--140
[]
Underfull \hbox (badness 10000) in paragraph at lines 151--155
[]
[5]
Overfull \hbox (816.15584pt too wide) in paragraph at lines 173--205
[]
[]
[6]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
Underfull \hbox (badness 10000) in paragraph at lines 206--248
[]
[7]
Underfull \hbox (badness 10000) in paragraph at lines 250--257
[]
Underfull \hbox (badness 10000) in paragraph at lines 250--257
[]
[8]
Underfull \hbox (badness 10000) in paragraph at lines 258--264
[]
Underfull \hbox (badness 10000) in paragraph at lines 258--264
[]
LaTeX Font Info: Font shape `OMS/cmr/m/n' in size <12> not available
(Font) Font shape `OMS/cmsy/m/n' tried instead on input line 265.
Underfull \hbox (badness 10000) in paragraph at lines 265--276
[]
Underfull \hbox (badness 10000) in paragraph at lines 265--276
[]
Underfull \hbox (badness 10000) in paragraph at lines 277--288
[]
Underfull \hbox (badness 10000) in paragraph at lines 277--288
[]
[9]
Underfull \hbox (badness 10000) in paragraph at lines 294--297
[]
<pics/tabs1.pdf, id=206, 614.295pt x 794.97pt>
File: pics/tabs1.pdf Graphic file (type pdf)
<use pics/tabs1.pdf>
Package pdftex.def Info: pics/tabs1.pdf used on input line 304.
(pdftex.def) Requested size: 426.79134pt x 552.32666pt.
Overfull \hbox (36.79134pt too wide) in paragraph at lines 298--305
[]
[]
[10]
Overfull \vbox (3.82666pt too high) has occurred while \output is active []
[11 <./pics/tabs1.pdf>]
Underfull \hbox (badness 10000) in paragraph at lines 310--317
[]
Underfull \hbox (badness 10000) in paragraph at lines 310--317
[]
Underfull \hbox (badness 10000) in paragraph at lines 310--317
[]
Underfull \hbox (badness 10000) in paragraph at lines 318--324
[]
Underfull \hbox (badness 10000) in paragraph at lines 338--343
[]
[12]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Overfull \hbox (5.17915pt too wide) in paragraph at lines 365--388
\OMS/cmsy/b/n/12 f\OT1/cmr/bx/n/12 guitartab:[2;3]do [3;0]re [3;2]mi [3;3]fa $\
OMS/cmsy/m/n/12 j$\OT1/cmr/bx/n/12 [4;0]so [4;2]la [5;0]si [5;1]do$\OMS/cmsy/m/
n/12 j$\OMS/cmsy/b/n/12 g
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Overfull \hbox (13.32501pt too wide) in paragraph at lines 365--388
\OMS/cmsy/b/n/12 f\OT1/cmr/bx/n/12 basstab:[2;5][2;5]$\OMS/cmsy/m/n/12 j$\OT1/c
mr/bx/n/12 [2;5][2;5]$\OMS/cmsy/m/n/12 j$\OT1/cmr/bx/n/12 [3;5][3;5]$\OMS/cmsy/
m/n/12 j$\OT1/cmr/bx/n/12 [2;5][2;5]$\OMS/cmsy/m/n/12 j$\OT1/cmr/bx/n/12 [3;7][
3;7]$\OMS/cmsy/m/n/12 j$\OT1/cmr/bx/n/12 [3;5][3;5]$\OMS/cmsy/m/n/12 j$\OT1/cmr
/bx/n/12 [2;5]\OMS/cmsy/b/n/12 g
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
Overfull \hbox (11.55823pt too wide) in paragraph at lines 365--388
\OMS/cmsy/b/n/12 f\OT1/cmr/bx/n/12 guitartab:[2;3]&[3;5]&[4;5]C (power chord) $
\OMS/cmsy/m/n/12 j$\OT1/cmr/bx/n/12 [2;3]&[3;2]&[4;0]&[5;1]C
[]
Underfull \hbox (badness 10000) in paragraph at lines 365--388
[]
[13]
Overfull \hbox (2.75983pt too wide) in paragraph at lines 390--393
\OT1/cmr/m/n/12 Mit der Di-rek-tive de-fine k^^?onnen Sie ein Akkord-Symbol am
Ende eines St^^?uckes
[]
Underfull \hbox (badness 10000) in paragraph at lines 390--393
[]
Underfull \hbox (badness 10000) in paragraph at lines 401--406
[]
Underfull \hbox (badness 10000) in paragraph at lines 401--406
[]
Underfull \hbox (badness 10000) in paragraph at lines 407--412
[]
Underfull \hbox (badness 10000) in paragraph at lines 407--412
[]
[14]
Underfull \hbox (badness 10000) in paragraph at lines 413--419
[]
Underfull \hbox (badness 10000) in paragraph at lines 413--419
[]
Underfull \hbox (badness 10000) in paragraph at lines 420--438
[]
Underfull \hbox (badness 10000) in paragraph at lines 420--438
[]
Underfull \hbox (badness 10000) in paragraph at lines 440--457
[]
Underfull \hbox (badness 10000) in paragraph at lines 440--457
[]
Underfull \hbox (badness 10000) in paragraph at lines 440--457
[]
Underfull \hbox (badness 10000) in paragraph at lines 440--457
[]
[15] [16] (./GuitartTeX2-documentation_en.aux) )
Here is how much of TeX's memory you used:
4039 strings out of 478994
57614 string characters out of 5858184
377111 words of memory out of 5000000
21499 multiletter control sequences out of 15000+600000
411163 words of font info for 54 fonts, out of 8000000 for 9000
1141 hyphenation exceptions out of 8191
68i,7n,74p,251b,262s stack positions out of 5000i,500n,10000p,200000b,80000s
{/usr/local/texlive/2021/texmf-
dist/fonts/enc/dvips/cm-super/cm-super-ts1.enc}</usr/local/texlive/2021/texmf-d
ist/fonts/type1/public/amsfonts/cm/cmbsy10.pfb></usr/local/texlive/2021/texmf-d
ist/fonts/type1/public/amsfonts/cm/cmbx10.pfb></usr/local/texlive/2021/texmf-di
st/fonts/type1/public/amsfonts/cm/cmbx12.pfb></usr/local/texlive/2021/texmf-dis
t/fonts/type1/public/amsfonts/cm/cmmi12.pfb></usr/local/texlive/2021/texmf-dist
/fonts/type1/public/amsfonts/cm/cmr10.pfb></usr/local/texlive/2021/texmf-dist/f
onts/type1/public/amsfonts/cm/cmr12.pfb></usr/local/texlive/2021/texmf-dist/fon
ts/type1/public/amsfonts/cm/cmr8.pfb></usr/local/texlive/2021/texmf-dist/fonts/
type1/public/amsfonts/cm/cmsy10.pfb></usr/local/texlive/2021/texmf-dist/fonts/t
ype1/public/cm-super/sfrm1200.pfb>
Output written on GuitartTeX2-documentation_en.pdf (16 pages, 150707 bytes).
PDF statistics:
271 PDF objects out of 1000 (max. 8388607)
162 compressed objects within 2 object streams
0 named destinations out of 1000 (max. 500000)
11 words of extra memory for PDF output out of 10000 (max. 10000000)

BIN
doc/GuitartTeX2-documentation_en.pdf Normal file
View File

Binary file not shown.

BIN
doc/GuitartTeX2-documentation_en.synctex.gz Normal file
View File

Binary file not shown.

459
doc/GuitartTeX2-documentation_en.tex Executable file
View File

@@ -0,0 +1,459 @@
\documentclass[12pt]{article}
\usepackage[latin1]{inputenc}
\usepackage{amsmath}
\usepackage[english]{babel}
\usepackage{listings}
\usepackage{verbatim}
\usepackage{graphicx}
\newcommand{\ul}{\underline{~}}
\begin{document}
\section{Overview}
$GuitarTeX_2$ is a tool mainly for guitar players. It can generate nice looking song sheets with
guitar riffs, tabs und melodies. It uses the well known chord format with some minor additions. \\
\\
It's based on the idea from Martin Leclerc and Mario Dorion from Canada. They developed Chord version 3.5 in 1993.
$GuitarTeX_2$ is very similar to the original version. It uses the same syntax. The only difference is the used
language Java to parse the chord file and generate the \LaTeX source file. Usually you don't need to know
this because it's happening in the background. The output you usually see is a generated PDF. But it's helpful
to know this in case you already know \LaTeX and want to adjust something very specific.
\subsection{Features}
\begin{itemize}
\item
Grafical user interface with integrated basic editor
\item
Prints nice looking chords, melodies, riffs
\item
Output formats \LaTeX and PDF
\item
Compatible with ChordPro-format, import if ASCII-files possible
\item
Musical notation with \LaTeX-packages MusixTeX, MusixLyr and TabDefs
\item
Flexible page layout (size, border...)
\item
Custom colors for chorus, bridge ...
\item
Optional output of chord definitions at the end of the page
\item
ASCII-tabs, guitar tabs and base tabs
\item
Generated \LaTeX files can be customized for advanced users
\end{itemize}
\subsection{Example}
$GuitarTeX_2$ konvertiert eine Datei mit Text und Akkorden im Chord-Format in
eine \LaTeX-Datei. Ein Beispiel f<>r eine Chord-Datei: \\
\\
{\bf\{title:The Manual Song\} \\
\{st:No-one has yet claimed responsibility\} \\
~[D]I print verses [A7]in a [D]row, \\
The next line gets put [A7]down be[D]low, \\
Mumble mumble [A7]rhymes with [D]grow [G] [G\#] [A] \\
Done this verse, now [A7sus4]on we [quietly]go! \\
\\
\{soc\} \\
~[D]This is the [Bm]manual song \\
~[A7]No-one really knows what's [D]goin' on \\
~[D]This is the [F\#m]manual song \\
~[A7]And now the chorus is already [D]gone \\
\{eoc\} \\
\\
~[D]The second verse is [A7]like the [D]first, \\
The music poor, the [A7]verse is [D]worse, \\
I wrote this since [A7]I'd get [D]sued, \\
If I used real songs. [A7]This'll [D]do. \\
\\
\{c:repeat chorus\} } \\
\\
\includegraphics[width=1.1\textwidth]{pics/example1.pdf}
\\
Wenn Sie sich mit \LaTeX ~auskennen, k<>nnen Sie die Ausgabedatei auch manuell ver<65>ndern,
bevor Sie sie in Postscript oder PDF umwandeln. Der Vorteil ist, dass Sie alle M<>glichkeiten
von \LaTeX ~einschlie<69>lich der vielen Zusatzpackete wie graphics oder MusicTeX einsetzen k<>nnen.
\section{Installation}
\subsection{Woher bekomme ich $GuitarTeX_2$}
Die aktuelle Version bekommen Sie immer auf der Download-Seite des $GuitarTeX_2$-Projektes:
http://sourceforge.net/projects/guitartex2.
\subsection{Systemanforderungen}
$GuitarTeX_2$ ist ein Java Programm welches Betriessystemunabh<62>gig entwickelt wurde.
Ben"otigt werden:
\begin{itemize}
\item
Java 1.4 oder h<>her
\item
PDF - Betrachter (z.B. Acrobat Reader, xpdf)
Bei MacOS X braucht man es nicht
\item
Internetverbindung (optinal)
\item
\LaTeX (optional)
\end{itemize}
\subsection{Installation}
Laden sie sich das bin<69>re Paket (GuitarTeX2.jar) herunter. Je nachdem wie sie Ihr
System konfiguriert haben, reicht es darauf zu Doppelklicken oder mit
''java -jar GuitarTeX2.jar'' aus der Kommandozeile zu starten. \\
\\
Es wird beim ersten Starten eine lokale Konfigurationsdatei
angelegt. Diese ist im Homeverzeichnis des Benutzers zu finden. Sie kann nachtr<74>glich
ver<65>ndert werde und wird immer beim starten zuerst ausgelesen.
\section{Der Editor $GuitarTeX_2$}
<Hier kommt bald eine genaue Beschreibung>
\section{Unterst<EFBFBD>tzte Chord-Direktiven}
Direktiven sind Befehle zwischen geschweiften Klammern, die das Aussehen der erzeugten
Ausgabe steuern. Einige h<>ufig ben<65>tigte Direktiven k<>nnen durch eine Abk<62>rzung ersetzt
werden (siehe Beispiele). $GuitarTeX_2$ bringt einige neue Direktiven mit, die das original
Chord Programm nicht kennt.
\subsection{Spezielle Zeichen}
Einige Zeichen haben in GuitarTeX eine besondere Bedeutung:
\begin{itemize}
\item
\# am Anfang einer Zeile markiert einen Kommentar. Die Zeile wird von $GuitarTeX_2$ ignoriert
\item
/ darf nur in Akkorden mit Bass verwendet werden (z.B. A/E)
\end{itemize}
\subsection{Seitenlayout}
Die Direktive geometry bietet flexible M<>glichkeiten, das Layout einer Seite anzupassen.
Sie benutzt das \LaTeX-Paket geometry. Die folgende Beschreibung ist ein (modifizierter)
Teil der Original-Dokumentation.
\\
Das geometry Paket bietet viele automatische Ausrichtungen, so dass nur wenige manuelle
Angaben zum Seitenlayout erforderlich sind. In diesem Fall reicht ein einfaches \\
\\
{\bf\{geometry:a4paper\}} \\
\\
Das Setzen von Seitenr<6E>ndern erfolgt mit \\
\\
{\bf\{geometry:margin=2.5cm\}} \\
\\
wenn alle R<>nder einer Seite 2,5 Zentimeter betragen sollen.
L<>ngenangaben erfolgen in
\begin{itemize}
\item
Zentimeter (cm)
\item
Millimeter (mm)
\item
Inch (in)
\item
Punkt (pt)
\end{itemize}
\subsubsection{Grunds"atzliches}
Das Seitenlayout besteht aus einer einfachen Struktur: Die Seite (paper) enth<74>lt einen
Textk<74>rper (total-body, druckbarer Bereich) und R<>nder. Der Textk<74>rper besteht aus Kopf-
und Fu<46>zeile, dem eigentlichen Text und (optional) den Randbemerkungen. Die vier R<>nder
hei<65>en left-margin, right-margin, top-margin und bottom-margin.\\
\begin{itemize}
\item
paper: total-body (printable area) and margins
\item
total-body: head, body(text area), foot and marginal notes
\item
margins: left-, right-, top- and bottom-margin
\end{itemize}
Jeder Rand wird von der jeweiligen Kante der Seite aus gemessen, z.B. left-margin meint
den Abstand zwischen linker Seitenkante und dem Textk<74>rper. Die Gr<47><72>en von paper, totalbody
und margins stehen in diesen Ralationen:
\begin{itemize}
\item
paperwidth = left + width + right
\item
paperheight = top + height + bottom
\end{itemize}
\subsubsection{Optionen}
Optionen der Direktive geometry: \\
\begin{tabular}{|l|l|}
\textbf{Name} & \textbf{Bedeutung} \\
\hline
landscape & schaltet um auf Querformat \\
portrait & schaltet um auf Hochformat \\
twoside & schaltet auf zweiseitige Ausgabe um. Die linken und rechen R<>nder werden bei geraden
und ungeraden Seiten symmetrisch angeordnet. \\
reversemp & Randbemerkungen erscheinen am linken Rand (statt am rechten Rand) \\
nohead & keine Reservierung von Platz f<>r Kopfzeilen \\
nofoot & keine Reservierung von Platz f<>r Fu<46>zeilen \\
noheadfoot & keine Reservierung von Platz f<>r Kopf- und Fu<46>zeilen \\
a4paper, a5paper & spezifizert die Papiergr<67><72>e, ohne Wert anzugeben \\
paperwidth & Breite des Papiers. paperwidth=$<$paperwidth$>$ \\
paperheight & H<>he des Papiers. paperheight=$<$paperheight$>$ \\
width & Breite des Textk<74>rpers. width=$<$width$>$or totalwidth=$<$width$>$. Diese Angabe
sollte nicht mit der Textbreite (textwidth) verwechselt werden. width enth<74>lt die
Textbreite und die Breite der Randbemerkungen. \\
height & H<>he des Textk<74>rpers (einschlie<69>lich Kopf- und Fu<46>zeile). height=$<$height$>$ \\
left & linker Rand. left=$<$leftmargin$>$ \\
right & rechter Rand. right=$<$rightmargin$>$ \\
top & oberer Rand. top=$<$topmargin$>$ \\
bottom & unterer Rand. bottom=$<$bottommargin$>$ \\
margin & alle R<>nder. margin=$<$margin$>$ \\
textwidth & Breite des Textes. textwidth=$<$width$>$ \\
textheight & H<>he des Textes. textheight=$<$height$>$ \\
marginpar & Breite der Randbemerkungen. marginpar=$<$length$>$ \\
marginparsep & Abstand zwischen Text und Randbemerkungen. marginparsep=$<$length$>$ \\
head & H<>he der Kopfzeile. head=$<$length$>$ \\
headsep & Abstand zwischen Kopfzeile und Text. headsep=$<$length$>$ \\
foot & Abstand zwischen Fu<46>zeile und Text. foot=$<$length$>$ \\
\end{tabular}
\subsubsection{Beispiele}
Setzen Sie die H<>he des Textk<74>rpers auf 10in, den unteren Rand auf 2cm. Der obere
Rand wird automatisch berechnet:\\
\\
{\bf\{geometry:height=10in,bottom=2cm\}} \\
\\
oder: \\
\\
{\bf\{g:height=10in,bottom=2cm\}} \\
\\
oder: \\
\\
{\bf\{geometry:height=10in\} \\
\\
\{g:bottom:=2cm\}} \\
\\
Setzen Sie den linken, rechten und oberen Rand auf 3cm, 2cm und 2.5in.
Es wird keine Kopfzeile ben<65>tigt. \\
\\
{\bf\{geometry:left=3cm,right=2cm, nohead,top=2.5in\}} \\
\\
oder: \\
\\
{\bf\{geometry:left=3cm\} \\
\{geometry:right=2cm\} \\
\{geometry:nohead\} \\
\{geometry:top=2.5in\}} \\
\\
oder : \\
\\
{\bf\{g:left=3cm,right=2cm\} \\
\{g:nohead, top=2.5in\}} \\
\\
und so weiter ... \\
<09>ndern Sie die Breite der Randbemerkungen auf 3cm \\
\\
{\bf\{geometry:marginpar=3cm\} \\
\{geometry:marginpar=3cm, reversemp\}} \\
\\
l<>sst die Randbemerkungen am linken Rand ausgeben.\\
Verwenden sie A5-Papier im Querformat: \\
\\
{\bf\{geometry:a5paper, landscape\}} \\
\subsection{Dokumentenstrukur}
\subsubsection{title}
Der Titel eines St<53>ckes wird durch die Direktive title markiert. Der
Titel wird zentriert mit einer vergr<67><72>erten Schrift ausgegeben.
In Dokumenten mit mehreren St<53>cken verursacht title einen Seitenumbruch. \\
Beispiel:\\
\\
{\bf\{title:Go Down Moses\} \\
\{t:Go Down Moses\}} \\
\subsubsection{subtitle}
Die Direktive \textbf{subtitle} dient zur Darstellung zus<75>tzlicher
Informationen, wie z.B. Interpret oder Komponist. \\
Beispiel: \\
\\
{\bf\{subtitle:written by John Lennon / Paul McCartney\} \\
\{st:written by John Lennon / Paul McCartney\}} \\
\subsubsection{bridge}
Eine Bridge wird mit \{bridge\} oder \{sob\} (start of bridge) am Anfang,
und \{/bridge\} oder \{eob\} (end of bridge) am Ende markiert. Die Bridge
wird auf Farbdruckern in blau ausgegeben. Die Farbe kann mit der Direktive
color\underline{~}bridge angepasst werden (siehe Abschnitt namens color\underline{~}xxx).\\
Beispiel: \\
\\
{\bf \{bridge\} \\
I want her [Ab]everywhere [Fm] \\
And if [Bbm]she's beside me [C7]I know I need [Fm]never care \\
~[Bb]But to love her [C7]is to meet her \\
\{/bridge\}} \\
\subsubsection{chorus}
Ein Refrain wird mit \{chorus\} oder \{soc\} (start of chorus) am Anfang und mit \{/chorus\}
oder \{eoc\} (end of chorus) am Ende markiert. Der Refrain wird auf Farbdruckern in rot
ausgegeben. Die Farbe kann mit der Direktive color\underline{~}chorus angepasst werden
(siehe Abschnitt namens color\underline{~}xxx).\\
Beispiel: \\
\\
{\bf\{chorus\} \\
Oh, I get [C]by with a little [G]help from my [D]friends \\
Mm, I get [C]high with a little [G]help from my [D]friends \\
Oh, I'm gonna [C]try with a little [G]help from my [D]friends \\
\{/chorus\}} \\
\subsubsection{instr}
Ein Instrumental-Teil wird mit \{instr\} oder \{soi\} (start of instrumental) am Anfang
und \{/instr\} oder \{eoi\} (end of instrumental) am Ende markiert. Der Instrumental-Teil
wird auf Farbdruckern in grau ausgegeben. Die Farbe kann mit der Direktive
color\underline{~}instr angepasst werden (siehe Abschnitt namens color\underline{~}xxx).
\subsubsection{np}
np steht f<>r eine ''neue Seite'' und erzeugt einen Seitenumbruch.\\
Beispiel: \\
{\bf\{np\}} \\
\subsubsection{tab}
Tabulaturen werden mit \{tab\} oder \{sot\} (start of tablature) am Anfang und \{/tab\}
oder \{eot\} (end of tablature) am Ende markiert. Tabulaturen werden auf Farbdruckern
in gr<67>n ausgegeben. Die Farbe kann mit der Direktive color\underline{~}tab directive
angepasst werden (siehe Abschnitt namens color\underline{~}xxx). Tabulaturen werden
in einer nichtproportionalen Schriftart ausgegeben.\\
Beispiel: \\
\includegraphics[width=15cm]{pics/tabs1.pdf}
\subsection{Fonts}
Die Direktiven zur Beeinflussung der Schriftart und -farbe k<>nnen irgendwo in Ihrer Datei
stehen. Trotzdem ist es hilfreich sie am Anfang zu platzieren. Die angegebenen Werte
gelten f<>r das ganze Dokument.
\subsubsection{font\underline{~}size}
\LaTeX ~kennt drei Schriftgr<67><72>en 10pt, 11pt and 12pt. GuitarTeX nutzt normalerweise
11pt (Titel und Untertitel werden automatisch vergr<67><72>ert). Wenn Sie z.B. 12pt
verwenden wollen, schreiben Sie:\\
\\
{\bf\{font\underline{~}size:12\}} \\
\\
Achtung: schreiben Sie nicht 12pt statt 12!\\
\subsubsection{color\underline{~}xxx}
Mit den folgenden Direktiven k<>nnen Sie die Textfarbe f<>r Refrain, Bridge,
Instrumental-Teil Tabulaturen und zweite Stimme anpassen. F<>r die zweite Stimme
k<>nnen Sie auch die Hintergrundfarbe <20>ndern, so dass Sie z.B. wei<65>e Schrift auf einem
farbigen Hintergrund verwenden k<>nnen. Das erleichtert den S<>ngern hoffentlich
die Orientierung bei mehreren Textzeilen. \\
Die Direktiven hei<65>en: \\
\begin{itemize}
\item
color\underline{~}chorus
\item
color\underline{~}bridge
\item
color\underline{~}instr
\item
color\underline{~}tab
\item
color\underline{~}second
\item
color\underline{~}second\underline{~}back
\end{itemize}
Als Parameter wird eine durch Kommas getrennte Liste von Werten zwischen null und
eins, die die Farben rot, gr<67>n und blau repr<70>sentieren.\\
Beispiel: \\
\\
{\bf\{color\underline{~}chorus:.5,.5,1\}}
\subsection{Gitarren- und Bass-Tabulaturen}
$GuitarTeX_2$ kennt zwei neue Direktiven zur Darstellung von Tabulaturen:
\begin{itemize}
\item
\{guitartab: \} f<>r Gitarren-Tabulaturen
\item
\{basstab: \} f<>r Bass-Tabulaturen
\end{itemize}
Jede guitartab oder basstab Direktive stellt eine Zeile mit sechs bzw vier Linien dar.
Sie k<>nnen mit \{guitartab: \} oder \{basstab: \} auch leere Tabulaturen erzeugen.
Setzen Sie eine Leerzeile vor die Direktive, damit die Tabulatur am linken Rand beginnt.\\
Die Klammern k<>nnen enthalten:
\begin{itemize}
\item
normaler Text, der unterhalb der Tabulatur ausgegeben wird
\item
Noten im Format [string;fret], z.B. [2;5] f<>r 5. Bund auf der A-Saite
\item
Taktstriche (durch das Zeichen $|$ dargestellt)
\item
Zus<75>tzlicher Leerraum mit ''\ul{}''
\end{itemize}
Beispiel: leere Gitarrentabulatur \\
\\
{\bf\{guitartab:\}} \\
\\
Beispiel: Eine Bass-Tabulatur mit Text \\
\\
{\bf\{basstab:some text\}} \\
\\
Beispiel: Noten, Taktstriche und Leerraum \\
\\
{\bf\{guitartab:[2;3][3;0][3;2][3;3]$|$[4;0]\ul\ul[4;2]\ul\ul[5;0]\ul\ul[5;1]$|$\}} \\
\\
Beispiel: Text unter den Noten anordnen \\
\\
{\bf\{guitartab:[2;3]do [3;0]re [3;2]mi [3;3]fa $|$[4;0]so [4;2]la [5;0]si [5;1]do$|$\}} \\
\\
Beispiel: Eine einfache Bass-Tabulatur \\
\\
{\bf\{basstab:[2;5][2;5]$|$[2;5][2;5]$|$[3;5][3;5]$|$[2;5][2;5]$|$[3;7][3;7]$|$[3;5][3;5]$|$[2;5]\}} \\
\\
Beispiel: Akkorde \\
\\
{\bf\{guitartab:[2;3]\&[3;5]\&[4;5]C (power chord) $|$[2;3]\&[3;2]\&[4;0]\&[5;1]C chord\}} \\
\subsection{N"utzliches}
\subsubsection{define}
Mit der Direktive define k<>nnen Sie ein Akkord-Symbol am Ende eines St<53>ckes erstellen.
Die Direktive kann irgendwo im St<53>ck platziert sein.\\
define verf<72>gt <20>ber acht Parameter:\\
\begin{itemize}
\item
den Akkordnamen
\item
die Nummer des ersten Bundes
\item
sechs Nummern f<>r die sechs Saiten (ein x bedeutet, dass die Saite nicht gespielt wird)
\end{itemize}
Beispiel:\\
\\
{\bf\{define:A 1 x n 2 2 2 n\} \\
\{define:Cm 3 x 1 3 3 2 1\} \\
\{define:Gm/Bb 4 3 2 2 1 x x\}} \\
\subsubsection{comment}
Die Direktive comment f<>gt einen Text ein, der nicht zum eigentlichen St<53>ck geh<65>rt. \\
Beispiel: \\
\\
{\bf\{comment: repeat chorus\} \\
\{c: repeat chorus\}} \\
\subsubsection{margin}
Die Direktive margin erzeugt eine Randbemerkung. Diese k<>nnen z.B. dazu genutzt werden,
Hinweise f<>r den Musiker einzuf<75>gen.\\
Beispiel: \\
\\
{\bf\{margin:Fade Out\} \\
\{m:Fade Out\}} \\
\subsubsection{second}
In einigen St<53>cken hat die zweite Stimme nicht nur eine andere Melodie, sondern auch
einen anderen oder versetzt gesungenen Text. Bekannte Beispiele sind "California Dreaming"
von The Mamas And The Papas und "Help" von den Beatles. Wenn Sie die zweite Stimme mit
der Direktive second markieren erscheint sie in wei<65>er Schrift auf grauem Hintergrund.
Wegen der proportionalen Schrift m<>ssen Sie ein wenig experimentieren, um die korrekte
Ausrichtung zwischen erster und zweiter Stimme zu erhalten.\\
Beispiel: \\
\\
{\bf[G] When I was younger so much [Hm]younger than today \\
\{second:When when I was young\} \\
~[Em] I never needed anybody's [C]help in [F]any [G]way \\
\{second:I never need help in any way\} \\
~[G]But now these days are gone and I'm [Bm]not so self assured \\
\{second:Now these days are gone\} \\
~[Em] Now I find I've changed my mind, \\
\{second:And now I find\} \\
I've [C]opened [F]up the [G]doors \\
\{second:I've opened up the doors\}} \\
\section{\LaTeX-Kommandos und Pakete verwenden}
\subsection{\LaTeX-Kommandos}
Wie in der Einf<6E>hrung erw<72>hnt, brauchen Sie nichts <20>ber \LaTeX ~zu wissen, um $GuitarTeX_2$
zu nutzen. Wenn Sie sich mit \LaTeX ~auskennen, k<>nnen Sie dessen M<>glichkeiten nutzen,
um Ihre Ergebnisse weiter zu verbessern. Alle Zeilen, die mit einem Backslash beginnen,
werden in die erzeute \LaTeX-Datei <20>bernommen. Sie k<>nnen das einfach mit einem Kommando
wie diesem testen: \\
\\
{\bf$\backslash$marginpar\{test\}} \\
\\
Das Ergebnis ist eine Randbemerkung mit dem Wort ''test''.
Die \LaTeX-Kommandos werden an der Stelle ausgef<65>hrt, an der sie in der Datei vorkommen.
Manche Kommandos m<>ssen allerdings in der sog. Pr<50>ambel der \LaTeX-Datei erscheinen.
Das geschieht mit der Direktive preamble:\\
\\
{\bf\{preamble:$\backslash$usepackage(fancyheadings)\}}\\
\\
Die Direktive preamble kann irgendwo im Dokument stehen. Die enthaltenen Kommandos
erscheinen in der \LaTeX-Pr<50>ambel in der Reihenfolge, in der sie in der Chord-Datei stehen.
\end{document}

BIN
doc/pics/example1.pdf Normal file
View File

Binary file not shown.

BIN
doc/pics/tabs1.pdf Normal file
View File

Binary file not shown.