From 503ec6c5f74d002c0d4d6fa3739e42f5e3e6c503 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 16 Jan 2012 23:55:45 +0000 Subject: new latex package gtrcrd (15jan12) git-svn-id: svn://tug.org/texlive/trunk@25121 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/gtrcrd/README | 28 +++++ Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.pdf | Bin 0 -> 143529 bytes Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.tex | 132 ++++++++++++++++++++++ 3 files changed, 160 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/gtrcrd/README create mode 100644 Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.pdf create mode 100644 Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.tex (limited to 'Master/texmf-dist/doc/latex/gtrcrd') diff --git a/Master/texmf-dist/doc/latex/gtrcrd/README b/Master/texmf-dist/doc/latex/gtrcrd/README new file mode 100644 index 00000000000..7fb7e945e45 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gtrcrd/README @@ -0,0 +1,28 @@ +Package name: gtrcrd (Guitar chords) +Author: Riccardo Bresciani - gtrcrd@tex.nopkoguo.net + +Copyright 2012 Riccardo Bresciani + +Description: This package is suitable to add chords to lyrics. +The main advantages of using this package is that chords are +written before the text they refer to and LaTeX takes care of +typesetting them above the lyrics in the right place: thanks to +this we avoid the task of correctly aligning chords above the +lyrics, which is tedious in the case of a monospaced font and +absolutely non-trivial in the case of variable-width fonts. + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either +version 1.3c of this license or (at your option) any +later version. +The latest version of the license is in + http://www.latex-project.org/lppl.txt +and version 1.3c or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +This work consists of the files: README, gtrcrd.sty, +gtrcrd-doc.tex, gtrcrd-doc.pdf + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +2012/01/15: v1.0 \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.pdf b/Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.pdf new file mode 100644 index 00000000000..35a4aaa2f32 Binary files /dev/null and b/Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.pdf differ diff --git a/Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.tex b/Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.tex new file mode 100644 index 00000000000..d7c021338c5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/gtrcrd/gtrcrd-doc.tex @@ -0,0 +1,132 @@ +\documentclass[green,a4paper,oneside,openany,noparindent,noparskip,article,nomatter]{bookest} + +\usepackage{gtrcrd} +\usepackage{hyperref} +\usepackage{fancyvrb} + +\VerbatimFootnotes +\setleftmark{} +\setrightmark{} + +%pdfLaTeX +\hypersetup{ +pdftitle={gtrcrd}, +pdfsubject={A LaTeX package which is suitable to add chords to lyrics.}, +pdfauthor={Riccardo Bresciani}, +pdfkeywords={gtrcrd, LaTeX, chords, lyrics, TeX}, +pdfstartview=FitV, +%colorlinks +} + + +% Aliases +\newcommand{\ie}{\emph{i.e.} } + +\author{Riccardo Bresciani} +\title{gtrcrd\hfill{\small\href{http://tex.nopkoguo.net/gtrcrd}{http://tex.nopkoguo.net/gtrcrd}}} +\newcommand{\belowLine}{{\normalsize Version 1.0 --- \today}} + +\makeatletter +\renewcommand{\maketitle}{\thispagestyle{plain}{\Huge\textbf{\colorB\@title}\Large\\\vspace{2ex} +\@author{\colorA\hrule}\vspace{1ex}\belowLine\\\vspace{2ex}}} +\makeatother + + \geometry{ + hmargin=2.6cm, + vmargin={3.5cm,3cm}, + bindingoffset=0mm, + columnsep=20pt + } + + \pagestyle{plain} + +\begin{document} + +\maketitle + +\begin{abstract}{Brief description of the package:} +This package is suitable to add chords to lyrics. The main advantages of using this package is that chords are written before the text they refer to and \LaTeX\ takes care of typesetting them above the lyrics in the right place: thanks to this we avoid the task of correctly aligning chords above the lyrics, which is tedious in the case of a monospaced font and absolutely non-trivial in the case of variable-width fonts. +\end{abstract} + +\artsection{Usage} +\artsubsection{Chords} + +The following commands typeset a chord above a given text: + +\begin{center} +\ttfamily \textbackslash\A A \quad\textbackslash\B B \quad\textbackslash\C C \quad\textbackslash\D D \quad\textbackslash\E E \quad\textbackslash\F F \quad\textbackslash\G G + +\textbackslash\Ab Ab \quad\textbackslash\Bb Bb \quad\textbackslash\Cb Cb \quad\textbackslash\Db Db \quad\textbackslash\Eb Eb \quad\textbackslash\Fb Fb \quad\textbackslash\Gb Gb + +\textbackslash\As As \quad\textbackslash\Bs Bs \quad\textbackslash\Cs Cs \quad\textbackslash\Ds Ds \quad\textbackslash\Es Es \quad\textbackslash\Fs Fs \quad\textbackslash\Gs Gs + +\textbackslash\Am Am \quad\textbackslash\Bm Bm \quad\textbackslash\Cm Cm \quad\textbackslash\Dm Dm \quad\textbackslash\Em Em \quad\textbackslash\Fm Fm \quad\textbackslash\Gm Gm + +\textbackslash\Abm Abm \quad\textbackslash\Bbm Bbm \quad\textbackslash\Cbm Cbm \quad\textbackslash\Dbm Dbm \quad\textbackslash\Ebm Ebm \quad\textbackslash\Fbm Fbm \quad\textbackslash\Gbm Gbm + +\textbackslash\Asm Asm \quad\textbackslash\Bsm Bsm \quad\textbackslash\Csm Csm \quad\textbackslash\Dsm Dsm \quad\textbackslash\Esm Esm \quad\textbackslash\Fsm Fsm \quad\textbackslash\Gsm Gsm +\end{center} + +For example \texttt{\textbackslash Bb\{text\}} produces the following: \Bb{text}. + +\ppar +Each command takes an optional argument, in order to allow users to typeset variations of the above chords. + +For example \texttt{\textbackslash G[7sus4]\{text\}} produces the following: \G[7sus4]{text}. + +\artsubsubsection{An Example: London Bridge is Falling Down} + +\begin{tabular}{p{6cm}l} +\G London bridge is falling down &\texttt{\textbackslash G London bridge is falling down}\\ + +\D[7] Falling down, \G falling down. &\texttt{\textbackslash D[7] Falling down, \textbackslash G falling down.}\\ + +\G London bridge is falling down, &\texttt{\textbackslash G London bridge is falling down,}\\ + +\D my fair \G lady. &\texttt{\textbackslash D my fair \textbackslash G lady.} +\end{tabular} + +\artsubsection{Operations on chords}\label{opts} + +It is sometimes useful to transpose a song by a certain number of half-tones. This package provides the following commands to do this: + +\begin{center}\ttfamily +\begin{tabular}{p{4cm}p{4cm}p{4cm}} + +\textbackslash transposeOneUp &\textbackslash transposeTwoUp &\textbackslash transposeThreeUp\\ + +\textbackslash transposeFourUp &\textbackslash transposeFiveUp &\textbackslash transposeSixUp\\ + +\textbackslash transposeOneDown &\textbackslash transposeTwoDown &\textbackslash transposeThreeDown\\ + +\textbackslash transposeFourDown &\textbackslash transposeFiveDown &\textbackslash transposeSixDown +\end{tabular} +\end{center} + +Things can be brought back to normal via the command \texttt{\textbackslash notranspose}. + +\ppar +Another possibility is to convert all chords with a $\flat$ to the corresponding chords with a $\sharp$ or vice-versa: this is achieved with the commands \texttt{\textbackslash sharponly} and \texttt{\textbackslash flatonly}. + +\ppar +Finally it is possible to avoid all occurrences of E$\sharp$, F$\flat$, B$\sharp$ and C$\flat$ and replace them with F, E, C and B respectively by using the command \texttt{\textbackslash normalize}. + +\artsubsection{Package Options} +All commands from \S\ref{opts} can be run at the beginning of the document by using the desired ones as package options --- the initial backslash has to be omitted of course! + +\artsubsection{Changing the Way Things Look} +The line spacing in presence of a chord is controlled by the length \texttt{\textbackslash crdheight} --- the default setting is \texttt{3ex}. + +\ppar +The font of the chord is controlled by the command \texttt{\textbackslash crdfont} --- the default setting is \texttt{\textbackslash footnotesize \textbackslash sffamily}. + +\ppar +All chords are specific instances of the command \texttt{\textbackslash CHORD}, which takes two mandatory arguments and an optional one: the first argument is concatenated to the optional argument (respectively the chord and its variation) and is typeset above the text given as second argument. + +It is possible to change the way a chord is typeset by redefining this command --- and this does not compromise the functionality of the commands in \S\ref{opts} as long as the meaning of the arguments of \texttt{\textbackslash CHORD} is not changed. + +\artsection{Contacts} +If you have comments or want to report any bug, please send a mail to \textsl{\href{mailto:gtrcrd@tex.nopkoguo.net}{gtrcrd@tex.nopkoguo.net}}. + + +\end{document} \ No newline at end of file -- cgit v1.2.3