diff options
author | Karl Berry <karl@freefriends.org> | 2013-08-26 21:57:03 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-08-26 21:57:03 +0000 |
commit | 288848b5e24e465cc7b0d9687d0309e19f3b8e97 (patch) | |
tree | a2e08417cacb5df27ca59ddccea8a7bdbc2a3cb3 /Master/texmf-dist/doc/latex/guitarchordschemes | |
parent | c492fcca271ba84bff91e6b6237a981061ccc10d (diff) |
guitarchordschemes (26aug13)
git-svn-id: svn://tug.org/texlive/trunk@31524 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/guitarchordschemes')
-rw-r--r-- | Master/texmf-dist/doc/latex/guitarchordschemes/README | 33 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.pdf | bin | 0 -> 116509 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.tex | 442 |
3 files changed, 475 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/guitarchordschemes/README b/Master/texmf-dist/doc/latex/guitarchordschemes/README new file mode 100644 index 00000000000..0397df22b11 --- /dev/null +++ b/Master/texmf-dist/doc/latex/guitarchordschemes/README @@ -0,0 +1,33 @@ +-------------------------------------------------------------------------- +the GUITARCHORDSCHEMES package v 0.4 + + Guitar Chord and Scale Tablatures with TikZ + +2013/08/25 +-------------------------------------------------------------------------- +Clemens Niederberger +Web: https://bitbucket.org/cgnieder/guitarchordschemes/ +E-Mail: contact@mychemistry.eu +-------------------------------------------------------------------------- +Copyright 2013 Clemens Niederberger + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3 +of this license or (at your option) any later version. +The latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is Clemens Niederberger. +-------------------------------------------------------------------------- +The guitarchordschemes package consists of the files + - guitarchordschemes.sty, + - guitarchordschemes_en.tex, guitarchordschemes_en.pdf + - README +-------------------------------------------------------------------------- +If you have any ideas, questions, suggestions or bugs to report, please +feel free to contact me. +-------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.pdf b/Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.pdf Binary files differnew file mode 100644 index 00000000000..87c0de8bbaf --- /dev/null +++ b/Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.pdf diff --git a/Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.tex b/Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.tex new file mode 100644 index 00000000000..18891ca9c46 --- /dev/null +++ b/Master/texmf-dist/doc/latex/guitarchordschemes/guitarchordschemes_en.tex @@ -0,0 +1,442 @@ +% arara: xelatex +% !arara: biber +% !arara: xelatex +% !arara: xelatex +% -------------------------------------------------------------------------- +% the GUITARCHORDSCHEMES package +% +% Guitar Chord and Scale Tablatures with TikZ +% +% -------------------------------------------------------------------------- +% Clemens Niederberger +% Web: https://bitbucket.org/cgnieder/guitarchordschemes/ +% E-Mail: contact@mychemistry.eu +% -------------------------------------------------------------------------- +% Copyright 2012--2013 Clemens Niederberger +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3 +% of this license or (at your option) any later version. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3 or later is part of all distributions of LaTeX +% version 2005/12/01 or later. +% +% This work has the LPPL maintenance status `maintained'. +% +% The Current Maintainer of this work is Clemens Niederberger. +% -------------------------------------------------------------------------- +% The guitarchordschemes package consists of the files +% - guitarchordschemes.sty, +% - guitarchordschemes_en.tex, +% - guitarchordschemes_en.pdf, +% - README +% -------------------------------------------------------------------------- +% If you have any ideas, questions, suggestions or bugs to report, please +% feel free to contact me. +% -------------------------------------------------------------------------- +\documentclass[toc=index,toc=bib]{cnpkgdoc} +\docsetup{ + pkg = [use-rbc]guitarchordschemes , + subtitle = Guitar Chord and Scale Tablatures with \TikZ , + code-box = { + backgroundcolor = gray!7!white , + skipbelow = .6\baselineskip plus .5ex minus .5ex , + skipabove = .6\baselineskip plus .5ex minus .5ex , + roundcorner = 3pt , + } , + gobble = 1 +} +\usepackage{polyglossia} +\setmainlanguage{english} +\usepackage[oldstyle,proportional]{libertine} +\usepackage{libertinehologopatch} +\cnpkgusecolorscheme{friendly} + +\setmonofont[Ligatures=TeX,Scale=MatchLowercase]{Bitstream Vera Sans Mono} + +\usepackage{fnpct} +\pagestyle{headings} + +\usepackage[biblatex]{embrac}[2013/03/22] +\ChangeEmph{[}[,.02em]{]}[.055em,-.08em] +\ChangeEmph{(}[-.01em,.04em]{)}[.04em,-.05em] + +\renewcommand*\othersectionlevelsformat[3]{% + \textcolor{main}{#3\autodot}\enskip} +\renewcommand*\partformat{% + \textcolor{main}{\partname~\thepart\autodot}} + +\addcmds{ + chordscheme, + setchordscheme, + scales, + textsuperscript +} + +\usepackage{filecontents} +\usepackage{imakeidx} +\begin{filecontents*}{\jobname.ist} + heading_prefix "{\\bfseries " + heading_suffix "\\hfil}\\nopagebreak\n" + headings_flag 1 + delim_0 "\\dotfill\\hyperpage{" + delim_1 "\\dotfill\\hyperpage{" + delim_2 "\\dotfill\\hyperpage{" + delim_r "}\\textendash\\hyperpage{" + delim_t "}" + suffix_2p "\\nohyperpage{\\,f.}" + suffix_3p "\\nohyperpage{\\,ff.}" +\end{filecontents*} +\indexsetup{othercode=\footnotesize} +\makeindex[options={-s \jobname.ist},intoc,columns=3,columnsep=1em] + +\usepackage[backend=biber,style=alphabetic]{biblatex} +\addbibresource{\jobname.bib} +\begin{filecontents}{\jobname.bib} +@online{web:pietsch:fonts, + author = {Jochen Pietsch} , + title = {Jazz Fonts} , + url = {http://notation.jochenpietsch.de/index_e.html} , + urldate = {2012-05-10} +} +@package{pkg:etoolbox, + title = {\paket*{etoolbox}}, + author = {Philipp Lehman}, + date = {2011-01-21}, + version = {2.1}, + url = {http://mirror.ctan.org/macros/latex/contrib/etoolbox} +} +@package{pkg:pgfopts, + title = {\paket*{pgfopts}}, + author = {Joseph Wright}, + date = {2011-06-02}, + version = {2.1}, + url = {http://mirror.ctan.org/macros/latex/contrib/pgfopts} +} +@package{pkg:realbookchords, + title = {\paket*{realbookchords}}, + author = {Clemens Niederberger}, + date = {2013-04-29}, + version = {0.1}, + url = {https://bitbucket.org/cgnieder/guitarchordschemes/} +} +@package{pkg:tikz, + author = {Till Tantau and Mark Wibrow and Christian Feuersänger}, + title = {Ti\textit{k}Z/pgf}, + sorttitle = {TikZ}, + version = {2.10}, + date = {2010-02-25}, + url = {http://sourceforge.net/projects/pgf/}, + urldate = {2013-04-18} +} +@book{leavitt:mmfg:1, + author = {William G. Leavitt}, + title = {A Modern Method for Guitar}, + volume = {1}, + publisher = {Berklee Press Publications, Boston}, + year = {1966} +} +\end{filecontents} + + +\let\verb\lstinline +\makeatletter +\def\TikZ@logo{Ti\textit{k}Z} +\renewrobustcmd\TikZ{\TikZ@logo\index{TikZ@\TikZ@logo}} +\makeatother + +\usepackage{ccicons} + +\usepackage{acro,accsupp} +\DeclareAcronym{ctan}{ + short = ctan , + long = the \textsc{Comprehensive \TeX{} Archive Network} , + short-format = \scshape , + pdfstring = CTAN , + accsupp = CTAN +} +\acsetup{first-style=footnote} + +\setchordscheme{ + finger-format+=\biolinumLF , + name-format+=\libertineLF +} + +\TitlePicture{% +\chordscheme[ + name = Gmi7 , + position = II , + barre = {2/2-4:3} , + show-root = {4/4} , + root = {2/6:2} , + mute = {1,5} +]} +\begin{document} + +\section{License and Requirements} + +\guitarchordschemes is placed under the terms of the \LaTeX{} Project Public License, +version 1.3 or later (\url{http://www.latex-project.org/lppl.txt}). +It has the status “maintained”. + +\guitarchordschemes loads the packages \TikZ~\cite{pkg:tikz}, +\paket*{etoolbox}~\cite{pkg:etoolbox} and \paket*{pgfopts}~\cite{pkg:pgfopts}. +It also loads the \TikZ{} libraries \code{shapes.misc}, \code{arrows} and \code{calc}. +Depending on an option it also loads \paket*{realbookchords}~\cite{pkg:realbookchords}. +This package is not yet published on \ac{ctan} and thus not part of any \TeX{} +distribution. Until it is you can find it at +\url{https://bitbucket.org/cgnieder/realbookchords/}. +See section~\ref{sec:realbookchords} for details on this option. + +\section{The Commands} +This package more or less provides a single command: +\begin{beschreibung} + \Befehl{chordscheme}[<options>] + \Befehl{scales}[<option>] +\end{beschreibung} +These commands set the frame for the chord and scale tablatures and can be used +to create sheets for manually writing down tablatures: +\begin{beispiel} + \chordscheme +\end{beispiel} + +Similarly \cmd{scales} creates a frame with two more frets: +\begin{beispiel}[below] + \scales +\end{beispiel} + +\subsection{Options for \cmd*{chordscheme}} +The \oa{options} argument is where the actual details for a chord happen. These +are the available ones for \cmd{chordscheme}: +\begin{beschreibung} + \Option{name}{<chordsymbol>}\newline + Set the chord symbol. This option accepts a list of entries. + \Option{position}{<position>}\newline + Set the position for the first of the four frets. + \Option{finger}{<fret>/<string>:<label>}\newline + Specify the finger positions for a chord. This option accepts a list of entries. + The \code{:<label>} is optional. + \Option{root}{<fret>/<string>:<label>}\newline + The same as finger but uses a square instead of a circle to indicate that + this finger is playing the root of the chord. This option accepts a list of + entries. The \code{:<label>} is optional. + \Option{show-root}{<fret>/<string>}\newline + Specify positions of the root that are \emph{not} part of the actual chord + but are somewhere in the vicinity of it on the guitar neck. This option + accepts a list of entries. + \Option{barre}{<fret>/<string range>:<label>}\newline + Specify a barr\'e position for a chord. The \code{<string range>} part must + contain a two string numbers separated with a dash. This option accepts a list + of entries. The \code{:<label>} is optional. + \Option{ring}{<string>}\newline + Specify open strings. This option accepts a list of entries. + \Option{mute}{<string>}\newline + Specify muted/un-played strings This option accepts a list of entries. +\end{beschreibung} + +Let's take a look at a few examples: + +\setchordscheme{use-rbc=false} +\begin{beispiel} + \chordscheme[ + name = G , + position = I , + finger = {2/5:1} , + root = {3/6:2, 3/1:4} , + ring = {2,3,4} + ] +\end{beispiel} + +Or a more “jazzy” chord: +\begin{beispiel} + \chordscheme[ + name = G\textsuperscript{6} , + position = II , + finger = {1/4:1, 3/3:4, 2/2:3} , + root = 2/6:2 , + show-root = 4/4 , + mute = {1,5} + ] +\end{beispiel} + +One with a barr\'e: + +\begin{beispiel} + \chordscheme[ + name = Gmi\textsuperscript{7} , + position = II , + barre = 2/2-4:3 , + show-root = 4/4 , + root = 2/6:2 , + mute = {1,5} + ] +\end{beispiel} + +\subsection{Options for \cmd*{scales}} +The \oa{options} argument for \cmd{scales} are similar to the ones for +\cmd{chordscheme}: +\begin{beschreibung} + \Option{name}{<title>}\newline + Set a title for the scale. + \Option{position}{<position>}\newline + Set the position for the first of the six frets. + \Option{finger}{<fret>/<string>:<label>}\newline + Specify the finger positions for the scale. This option accepts a list of entries. + The \code{:<label>} is optional. + \Option{root}{<fret>/<string>:<label>}\newline + The same as finger but uses a square instead of a circle to indicate that + this finger is playing the root of the scale. This option accepts a list of + entries. The \code{:<label>} is optional. + \Option{fret number}{<integer>}\Default{6} + The number of frets displayed for a scale. The minimum number is 6. + \Option{fingering}{type 1|type 1A|type 2|type 3|type 4}\newline + Set a whole predefined fingering. The types correspond to ones taught + in \citeauthor{leavitt:mmfg:1}'s \citetitle{leavitt:mmfg:1}~\cite{leavitt:mmfg:1}. + This option assumes an ionic scale a places the roots correspondingly. + \Option{fingering*}{type 1|type 1A|type 2|type 3|type 4}\newline + The same as \key{fingering} but not scale is assumed and no roots are + indicated. + \Option{fingering?}{type 1|type 1A|type 2|type 3|type 4}\newline + The same as \key{fingering*} but also no labels for the fingers are given. +\end{beschreibung} + +Let's see an example: +\begin{beispiel}[below] + \scales[ + name = F-major (Fingering Type~1A) , + position = I , + fingering = type 1A + ] +\end{beispiel} + +An example for \key{fingering*}: +\begin{beispiel}[below] + \scales[ + name = Fingering Type~3 , + fingering* = type 3 + ] +\end{beispiel} + +Now an example for \key{fingering?}: +\begin{beispiel}[below] + \scales[ + name = Fingering Type~2 , + fingering? = type 2 + ] +\end{beispiel} + +At last an example for an explicitly set scale: +\begin{beispiel}[below] + \scales[ + finger = { + 2/1:1, 5/1:4, + 2/2:1, 5/2:4, + 2/3:1, 4/3:3, 5/3:4, + 2/4:1, 4/4:3, + 2/5:1, 3/5:2, 4/5:3, + 2/6:1, 5/6:4 + } + ] +\end{beispiel} + + +\section{Options} +There are quite a number of options determining the layout of the tablatures. +They can either be set as package options or via the setup command: +\begin{beschreibung} + \Befehl{setchordscheme}{<options>} +\end{beschreibung} + +Below every option and its corresponding default setting is described. +\begin{beschreibung} + \Option{x-unit}{<dim>}\Default{.8cm} + The basic $x$ unit for the \TikZ{} picture the chord scheme is set in. + \Option{y-unit}{<dim>}\Default{.8cm} + The basic $y$ unit for the \TikZ{} picture the chord scheme is set in. + \Option{finger-format}{<TeX code>}\Default{\cmd*{sffamily}\cmd*{small}} + The format the numbers for the fingers are typeset with. + \Option{finger-format+}{<TeX code>}\Default{} + Code to be appended to \key{finger-format}. + \Option{position-format}{<TeX code>}\Default{\cmd*{sffamily}} + The format the number for the position is typeset with. + \Option{position-format+}{<TeX code>}\Default{} + Code to be appended to \key{position-format}. + \Option{name-format}{<TeX code>}\Default{\cmd*{large}} + The format the chord name/symbol is typeset with. + \Option{name-format+}{<TeX code>}\Default{} + Code to be appended to \key{name-format}. + \Option{string-name-format}{<TeX code>}\Default{\cmd*{sffamily}\cmd*{small}} + The format the names of the strings are typeset with. + \Option{string-name-format+}{<TeX code>}\Default{} + Code to be appended to \key{string-name-format}. + \Option{line-width}{<dim>}\Default{1pt} + The line width used for all lines drawn in the chord scheme. + \Option{finger-radius}{<dim>}\Default{.1875} + The radius of the circles that represent the fingers in multiples of + \key{x-unit}. Also determines the size of the root markers and the barr\'e. + \Option{finger-x-offset}{<dim>}\Default{.375} + The $x$ offset of the number with respect to the circle in multiples of + \key{x-unit}. + \Option{finger-y-offset}{<dim>}\Default{.375} + The $y$ offset of the number with respect to the circle in multiples of + \key{y-unit}. + \Option{finger-style}{<tikz style>}\Default{fill} + The \TikZ{} style the circles representing the fingers are drawn with. + This is equivalent to\linebreak \cmd{tikzset}{finger style/.style=\{<tikz style>\}}. + \Option{root-style}{<tikz style>}\Default{fill} + The \TikZ{} style the squares representing the roots are drawn with. + This is equivalent to\linebreak \cmd{tikzset}{root style/.style=\{<tikz style>\}}. + \Option{show-root-style}{<tikz style>}\Default{draw} + The \TikZ{} style the squares representing the “ghost roots” are drawn with. + This is equivalent to \cmd{tikzset}{show root style/.style=\{<tikz style>\}}. + \Option{ringing-style}{<tikz style>}\Default{draw} + The \TikZ{} style the circles representing the open string markers are drawn + with. This is equivalent to \cmd{tikzset}{ringing style/.style=\{<tikz style>\}}. + \Option{muted-style}{<tikz style>}\Default{\{cross out,draw\}} + The \TikZ{} style the nodes representing muted strings are drawn with. + This is equivalent to \cmd{tikzset}{muted style/.style=\{<tikz style>\}}. + \Option{tuning}{<comma list of string names>}\Default{\{E,B,G,D,A,E\}} + The tuning. + \Option{use-rbc}{\default{true}|false}\Default{false} + If set to true the \key{name} will be set in the command \cmd{rbc} from the + \paket*{realbookchords}. If this option is not used as a package option + then make sure you also load \paket*{realbookchords}~\cite{pkg:realbookchords}. + Please be aware that the latter requires \XeLaTeX{} or \LuaLaTeX. See + section~\ref{sec:realbookchords} for details. +\end{beschreibung} + +\section{Using \paket*{realbookchords}}\label{sec:realbookchords} +Setting \cmd{setchordscheme}{use-rbc=true} or using the same as package option +will set the chord names/symbols in \paket*{realbookchords}' command \cmd{rbc}. + +In order to use this option you need to install the \paket*{realbookchords} +package~\cite{pkg:realbookchords}. I expect it to go to \ac{ctan} eventually but +until then you can get it at \url{https://bitbucket.org/cgnieder/realbookchords/}. +The package uses Jochen Pietsch's “New Real Book” font~\cite{web:pietsch:fonts} +for typesetting the chord symbols which you can get at +\url{http://notation.jochenpietsch.de/} or from me. I published it here: \url{http://www.niederberger.com.de/gitarren-akkorde-und-skalen-mit-latex}. +It is placed under the Creative Commons Attribution-Noncommercial-Share Alike~3.0 +Unported License \ccbyncsaeu. + +\paket*{realbookchords} requires that you compile your document with \XeLaTeX{} +or \LuaLaTeX. + +Here is an example of how the chord symbol looks with \paket*{realbookchords}: +\begin{beispiel} + \setchordscheme{use-rbc=true} + \chordscheme[ + name = Gmi7(\b5) , + position = II , + finger = {1/2:1, 2/3:4, 2/4:3} , + show-root = {4/4} , + root = {2/6:2} , + mute = {1,5} + ] +\end{beispiel} + +\printbibliography + +\printindex + +\end{document} |