CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/songs

README
------------------------------------------------------------------------------
                       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) 2018 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 script:
     songidx/songidx.lua  (Lua source file)
     songidx/*.can        (text data files used by songidx at runtime)

(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. 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

Download the contents of this package in one zip archive (1.3M).

songs – Produce song books for church or fellowship

The package provides a means of producing beautiful song books for church or fellowship. It offers:

  • a very easy chord-entry syntax;
  • multiple modes (words-only; words+chords; slides; handouts);
  • measure bars;
  • guitar tablatures;
  • automatic transposition;
  • scripture quotations;
  • multiple indexes (sorted by title, author, important lyrics, or scripture references); and
  • projector-style output generation, for interactive use.

A set of example documents is provided.

Packagesongs
Home pagehttp://songs.sourceforge.net
Repositoryhttps://sourceforge.net/projects/songs
Version3.1 2018-09-12
LicensesGNU General Public License, version 2
Copyright2009–2018 Kevin W. Hamlen
MaintainerKevin W. Hamlen
Contained inTeX Live as songs
MiKTeX as songs
TopicsMusic
Chords
See alsosongbook
...
Guest Book Sitemap Contact Contact Author