====== GuitarTeX2 ======
GuitarTeX2 ist ein Programm zum Setzen von Liedern mit Akkordsymbolen für Gitarre

===== Shortcuts =====
<sortable 1>
^Shortcut ^Bedeutung^
|''Strg'' + ''c''|Akkord ''C'' einfügen, <wrap important>**nicht** kopieren (Zwischenablage)</wrap>|
|''Strg'' + ''d''|Akkord ''D'' einfügen|
|''Strg'' + ''e''|Akkord ''E'' einfügen|
|''Strg'' + ''f''|Akkord ''F'' einfügen|
|''Strg'' + ''g''|Akkord ''G'' einfügen|
|''Strg'' + ''a''|Akkord ''A'' einfügen|
|''Strg'' + ''h''|Akkord ''H'' einfügen|
|''Strg'' + ''x''|ausschneiden (Zwischenablage)|
|''Strg'' + ''v''|einfügen (Zwischenablage)|
</sortable>


===== Syntax =====
<sortable 2>
^Code ^Bedeutung^
|<code latex>{soc}{/eoc} </code> oder <code latex>{chorus}{/chorus} </code> |Refrain|
|<code latex>{sob}{/eob} </code> oder <code latex>{bridge}{/bridge} </code> |Strophe (wird standardmäßig blau dargestellt)|
|<code latex>{title: A Title}</code>  |Songtitel|
|<code latex>{subtitle: Singer}</code>  |Komponist/Interpret|
|<code latex>{even}</code>  |Seitenzahl unterdrücken|
|<code latex>{font_size: XX} </code>|Schriftgröße setzen|
|<code latex>{a: COMMENT}</code> oder <code latex>{c: COMMENT}</code> oder <code latex>{comment: COMMENT}</code>|Kommentar (fettgedruckt)|
|<code latex>[X]</code>|Akkord "X" (wird über dem Text fettgedruckt dargestellt, muss innerhalb von Strophe oder Refrain stehen) <wrap tip>lässt sich mit den Shortcuts schnell einfügen</wrap>|
|<code latex>{geometry: a5paper, top= XXcm, left = XXcm, right = XXcm, bottom= XXcm}</code>|Setzen von Papiergröße und Seitenrändern|
</sortable>

===== Fehler "Exception in thread "main" sun.awt.X11.XException: Cannot write XdndAware property" =====
Die Fehlermeldung "Exception in thread "main" sun.awt.X11.XException: Cannot write XdndAware property"
 beim Start von GuitarTeX kann durch den Parameter ''DsuppressSwingDropSupport'' vermieden werden:
<code bash>
java -DsuppressSwingDropSupport=true -jar GuitarTeX2.jar
</code>

===== TeX2PDF deaktiviert =====
Der standardmäßig verwendete Server zum Umwandeln des TeX-Codes in ein PDF ist nicht mehr erreichbar. Dadurch wird der Menüeintrag "TeX2PDF" bzw. das entsprechende Icon ausgegraut bzw. deaktiviert und in der integrierten Konsole erscheint folgende Meldung:
<code>
# Trying to connect to guitartex2.servebbs.net 3121
# Bad host name given.
# Made server connection
# open connection failed: java.lang.NullPointerException
# close connection failed: java.lang.NullPointerException
</code>
Als Alternative kann ''guitartex2.nikolai-rinas.de'' in den Einstellungen gespeichert werden, siehe entsprechenden [[https://github.com/workinghard/GuitarTeX2/issues/1|Bugreport]].

<WRAP tip round>
Ab Version 3.5.0 ist diese Einstellung richtig gesetzt. 
</WRAP>
===== gtxtabs Verbesserungen =====
Die Abstände zwischen den Zahlen und den Linien in der Tabdarstellung lassen sich vergrößern, in dem dieser Code einfügt wird.
Durch den ersten Marginwert wird der horizontale Abstand eingestellt. 
<code latex>
\renewcommand{\gtxtabs}[2]{{\makebox[0cm][l]{\raisebox{#1}{\adjustbox{margin=0.25ex 0ex, bgcolor=white}{#2}}}}}
</code>
Standard (0ex):\\
{{:tab_0ex.png|Standard (0ex)}}

Angepasst (0.25ex):\\
{{:tab_0.25ex.png|Angepasst (0.25ex)}}


<WRAP tip round>
Diese Anpassung funktioniert erst ab Version 3.5.0.
</WRAP>




===== Links =====
  * [[https://github.com/workinghard/GuitarTeX2|GuitarTeX2 Homepage]]