Settings Help
CTAN
Comprehensive TeX Archive Network
Home Upload Browse

Direc­tory tex-archive/macros/latex/contrib/songs

------------------------------------------------------------------------------
                       Songs LaTeX Package Documentation
------------------------------------------------------------------------------

Table Of Contents:
   I. Overview
   II. Copyright Notice
   III. Manifest
   IV. Installation Instructions
   V. Help & Support


I. Overview

The Songs package is for producing songbooks containing lyrics and chords
(but not sheet music).  Each songs document can produce a lyric-only songbook
for singers, a chorded songbook for musicians, a set of overhead
transparencies, or a set of digital projector slides, all from a single master
document.  It can also automatically generate partial songbooks consisting of
only some songs from the master document in a specified order.  Facilities for
automatic transposition and creation of guitar tablature diagrams are also
included.


II. Copyright Notice

The Songs LaTeX Package is copyright (C) 2012 Kevin W. Hamlen.

It is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA  02110-1301, USA.


III. Manifest

This software consists of three main components:

1. The LaTeX2e "Songs" style package for creating songbooks, with source
consisting of:
     songs.dtx (self-documenting source code)
     songs.ins (installer script for docstrip)
     Makefile  (makefile for generating songs.sty and songs.pdf)

2. The songidx index-generation program, to be compiled from C sources:
     songidx/*.c      (C source files)
     songidx/*.h      (C header files)
     songidx/*.can    (text data files used by songidx at runtime)
     songidx/Makefile (makefile for generating the songidx executable)

(Please note that the "makeindex" program that comes standard with LaTeX
is NOT a suitable replacement for songidx.)

3. A sample chord book, lyric book, slide book, and transparency book:
     sample/songs.sbd           (song data for all four books)
     sample/chordbook.tex       (chord book LaTeX source)
     sample/lyricbook.tex       (lyric book LaTeX source)
     sample/slidebook.tex       (slide book LaTeX source)
     sample/transparencies.tex  (transparencies LaTeX source)
     sample/Makefile            (GNU makefile for generating all four books)


IV. Installation Instructions

1. The songs/Makefile file generates the songs package (songs.sty) and its
documentation (songs.pdf). If pdflatex and makeindex are both in your path,
you should be able to invoke Make to generate both:

     cd songs
     gmake

Otherwise you will need to first edit the top three lines of the Makefile
to indicate where pdflatex and makeindex are located on your system. If you
wish to use latex instead of pdflatex you must also change the "TEXOUT"
line to "TEXOUT = dvi".

If desired, copy the resulting songs.sty file to the appropriate place in
your LaTeX tree (usually /usr/local/share/texmf/tex/latex/songs).

     mkdir /usr/local/share/texmf/tex/latex/songs
     cp songs.sty /usr/local/share/texmf/tex/latex/songs

2. If you want to create song books with indexes, you will also need to
compile the songidx program:

     cd songidx
     gmake

If desired, copy the resulting songidx program to an appropriate directory
in your path:

     cp songidx /usr/local/bin

3. The sample books can be compiled using the files in songs/sample.  If
pdflatex is in your path, you should be able to invoke GNU Make to generate
all of them (note that GNU-compatible version of Make is REQUIRED):

     cd ../sample
     gmake

Otherwise you will need to first edit the top line of the Makefile to
indicate where pdflatex is located on your system. If you wish to use
latex instead of pdflatex you must also change the "TEXOUT" line to
"TEXOUT = dvi".


V. Help & Support

The songs.pdf file contains documentation precompiled from the songs.dtx
source code. For more support, including example songbooks, songbook
editing tools, and self-installing executables for Windows, please refer
to the Songs package homepage at:

     http://songs.sourceforge.net

Direc­to­ries

Name Notes
sample
songidx

Files

Name Size Date Notes
Makefile 564 2007-10-21 03:18:00
README 4614 2012-03-16 12:23:40
history.txt 17218 2012-03-17 05:30:10
license.txt 17990 2006-05-17 10:24:30
songs.dtx 400709 2012-03-17 05:34:06
songs.ins 2334 2012-03-16 12:29:28
songs.pdf 1137225 2012-04-10 05:37:18

Down­load the com­plete con­tents of this di­rec­tory in one zip archive (991.8k).

songs – Pro­duce song books for church or fel­low­ship

The pack­age pro­vides a means of pro­duc­ing beau­ti­ful song books for church or fel­low­ship. It of­fers:

  • a very easy chord-en­try syn­tax;
  • mul­ti­ple modes (words-only; words+chords; slides; hand­outs);
  • mea­sure bars;
  • gui­tar tab­la­tures;
  • au­to­matic trans­po­si­tion;
  • scrip­ture quo­ta­tions;
  • mul­ti­ple in­dexes (sorted by ti­tle, au­thor, im­por­tant lyrics, or scrip­ture ref­er­ences); and
  • pro­jec­tor-style out­put gen­er­a­tion, for in­ter­ac­tive use.
A set of ex­am­ple doc­u­ments is pro­vided.

Doc­u­men­ta­tion
Home pagehttp://songs.source­forge.net
Ver­sion2.14
Li­censeGNU Gen­eral Public Li­cense
Copy­right2009 Kevin W. Hamlen
Main­tainerKevin W. Hamlen
Con­tained inTeXLive as songs
Topics type­set­ting mu­sic and re­lated stuff
chord no­ta­tions, as for song books
See also songbook
Guest Book Sitemap Contact 2014-04-19 01:49 CEST