Copyright © 1995-2019, Ten by Ten Software.
Note: the contents of this document apply only to the macOS and Java platform versions of Songsheet Generator. For information about the Microsoft Windows® version, please see the Songsheet Generator web site.
On macOS, simply drop the app from the disk image into your Applications folder and run it. You don’t need to download Java.
On other platforms, you will need a Java runtime 1.6 or newer. Go to the Java web site, download, and install the most recent version.
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
New features in this release:
C D E G
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
User interface improvements:
Fixes and minor changes:
New features in this release:
{npp}
at the top of every song.){ns}
directives between them.
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
Fixes and minor changes:
New features in this release (there are many!):
{d_abc: xyz}
where abc is the key and xyz is the value.
This feature can be used for defining tags such as CCLI number, author, etc.
%?
and %?!
value query codes.%c%t
, and the default subtitle
format string is %c%s
; these mimic the classic Songsheet
Generator format. To get left-justified titles, change them to
%l%t
and %l%s
. Data keys can also be used,
to insert song data. There are lots of ways to customize the
output...! {define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E> fingers <Low-E> <B> <G> <D> <A> <E> key <KEY>}
{define: E5 base-fret 7 frets 0 1 3 3 x x fingers - 1 2 3 - - key E}
Summary of new song directives:
Directive | Description |
---|---|
{data_abc: xyz} | Data key and value; abc is the key, xyz is its value. |
{f_abc: xyz} | Shorthand for {data_abc: xyz} . |
{footer: xyz} | Footer override for the current song. |
{f: xyz} | Shorthand for {footer: xyz} . |
{key: xyz} | Key the chart is written in; xyz is a valid key; transposition will apply. |
{k: xyz} | Shorthand for {key: xyz} . |
Summary of new footer formatting codes:
Code | Description |
---|---|
%’abc’ | Data key value (abc is a key; xyz, its value, will be printed). Note: the quotes are required! |
%?jkl"xyz" | Value query jkl is a format code; if the value of jkl is not empty, then xyz will be evaluated and printed; xyz may contain nested format codes). Note: the quotes are required! |
%?!jkl"xyz" | Value query (negative) jkl is a format code; if the value of jkl is empty, then xyz will be evaluated and printed; xyz may contain nested format codes). Note: the quotes are required! |
%k | Song key (transposition will apply). |
%N | Total number of pages of song. |
%P | Current page number of song. |
%s | Song subtitle. |
%x | Song transpose (in half-steps; if the value is zero: nothing, not even a blank, will be printed). |
\n (backslash followed by 'n') | Manual line break in the footer. |
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
New features in this release:
Fixes and minor changes:
Fixes and minor changes:
New features in this release:
Code | Description | Example Output |
---|---|---|
%l (lowercase 'L') | Left-justify text following (printer & full screen only) | |
%c | Center-justify text following (printer & full screen only) | |
%r | Right-justify text following (printer & full screen only) | |
%p | Current page number | |
%n | Total number of pages | |
%t | Song title | My Song |
%T | Song title, with subtitle, if it exists (in parenthesis) | My Song (Reprise) |
%f | Song filename | my_song.txt |
%F | Song filename (complete path) | C:\songs\my_song.txt |
%x | Song transpose | +3 |
%dy | Two-digit representation of current year | 04 |
%dY | Four-digit representation of current year | 2004 |
%dm | Numeric representation of current month, with leading zeros | 01 to 12 |
%dn | Numeric representation of current month, without leading zeros | 1 to 12 |
%dM | Short textual representation of current month, three letters | Jan to Dec (localized) |
%dF | Full textual representation of current month | January to December (localized) |
%dd | Current day of the month, 2 digits, with leading zeros | 01 to 31 |
%dj | Current day of the month, 2 digits, without leading zeros | 1 to 31 |
%dD | Short textual representation of the current day of the week | Sun through Sat (localized) |
%dl (lowercase 'L') | Full textual representation of the current day of the week | Sunday through Saturday (localized) |
%dr | RFC 2822 formatted date | Thu, 21 Dec 2000 16:01:07 +0200 |
%% | Percent sign ('%') |
Fixes and minor changes:
Polishing basic functionality, plus porting ongoing fixes from the Windows version. This is still considered Beta software, although almost all of the features from the Windows version have now been properly implemented.
Changes to the software in this release:
{new_page}
({np}
),
{new_physical_page}
({npp}
), and
{column_break}
({colb}
) directives.
{np}
will cause a "cell break" in the Two and Four Discrete Cells per Page printing modes,
and a column break in the Two Flowing Columns printing mode. It will cause a physical page break otherwise.
{npp}
will always force a physical page break.
{colb}
will force a column break in the Flowing Columns printing modes,
which amounts to a physical page break in the One Flowing Column printing mode.
It has no effect in the Discrete Cells printing modes.
<div class=sg_newsong>
tag at the end of the HTML output.This is still considered Beta software, although almost all of the features from the Windows version have now been properly implemented.
New features in this release:
sg_song
, sg_toc
, sg_toc_header
, sg_toc_contents
now allow
further control over the appearance of the HTML output.Fixes and minor changes:
<div class=sg_song id=...>
instead of <a name=...>
.Known problems:
Polishing basic functionality, plus porting ongoing fixes from the Windows version.
Changes to the software in this release:
Finishing up basic functionality, plus porting ongoing fixes from the Windows version.
Changes to the software in this release:
{define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E>}
{define: E5 base-fret 7 frets 0 1 3 3 x x}
{define: <chord> base-fret <base> frets <Low-E> <B> <G> <D> <A> <E> fingers <Low-E> <B> <G> <D> <A> <E>}
{define: E5 base-fret 7 frets 0 1 3 3 x x fingers - 1 2 3 - -}
This was the first mostly-fully-functional version of Songsheet Generator written in the Java programming language.
Java code first checked into CVS for a version of Songsheet Generator that would run on Mac OS X.
Copyright © 1995-2015, Ten by Ten Software.
Mac OS is a registered trademark of Apple Computer, Inc. Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Windows is a registered trademark of Microsoft Corporation in the United States and other countries.