view release on metacpan or  search on metacpan

lib/ChordPro/res/config/config.tmpl  view on Meta::CPAN

// Example: Alternative for Bes chord.
# chords: [ { name: Bes, frets: [ 1 1 3 3 3 1 ], fingers: [ 1 1 2 3 4 1 ] } ]

/**************** Format to show chord names. May contain marku ****************/

// Format string for rendering common chord names.
# chord-formats.common : "%{root|%{}%{qual|%{}}%{ext|%{}}%{bass|/%{}}|%{name}}"

// Format string for rendering roman chord names.
# chord-formats.roman : "%{root|%{}%{qual|<sup>%{}</sup>}%{ext|<sup>%{}</sup>}%{bass|/<sub>%{}</sub>}|%{name}}"

// Format string for rendering nashville chord names.
# chord-formats.nashville : "%{root|%{}%{qual|<sup>%{}</sup>}%{ext|<sup>%{}</sup>}%{bass|/<sub>%{}</sub>}|%{name}}"

/**************** Shows selected or all chord diagrams at end ****************/

// "all": shows all chords
// "user": shows user defined chords only
// "none": suppresses chords from being printed
# diagrams.show : all

// Sorts the diagrams by key. Default is order of appearance.
# diagrams.sorted : false

// Chords (names) that will not generate diagrams, e.g. if they
// are considered trivial.
# diagrams.suppress : [ C F G A E Am ]

/**************** Settings for PDF output ****************/

// PDF Properties. Arbitrary key/values may be added.
// Note that the context for substitutions is the first song.

// Document title.
# pdf.info.title : "%{title}"

// Name of the author.
# pdf.info.author : ""

// Document subject.
# pdf.info.subject : ""

// Document keywords.
# pdf.info.keywords : ""

// Output paper size, e.g. "a4" or [595,842].
# pdf.papersize : a4

// Theme

// Foreground colour. Usually black.
# pdf.theme.foreground : black

// Light foreground colour
# pdf.theme.foreground-medium : grey70

// Very light foreground colour
# pdf.theme.foreground-light : grey90

// Background colour. Usually white.
# pdf.theme.background : none

// Distance between columns in multi-column mode.
# pdf.columnspace : 20

// Page top margin, excluding headspace.
# pdf.margintop : 80

// Page bottom margin, excluding footspace.
# pdf.marginbottom : 40

// Page left margin.
# pdf.marginleft : 40

// Page right margin.
# pdf.marginright : 40

// Space for page titles.
# pdf.headspace : 60

// Space for page footers.
# pdf.footspace : 20

// Heading on first page only, add the headspace to
// the other pages so they become larger.
# pdf.head-first-only : false

// Baseline distances as a factor of the font size.

// Spacing for page titles.
# pdf.spacing.title : 1.2

// Spacing for lyrics.
# pdf.spacing.lyrics : 1.2

// Spacing for chord names.
# pdf.spacing.chords : 1.2

// Spacing for diagram chords.
# pdf.spacing.diagramchords : 1.2

// Spacing for grid lines.
# pdf.spacing.grid : 1.2

// Spacing for tab lines.
# pdf.spacing.tab : 1

// Spacing for table of contents lines.
# pdf.spacing.toc : 1.4

// Spacing for empty (blank) lines.
// By setting this to a small value you get fine-grained control over
// the distance between song elements by adding empty lines.
# pdf.spacing.empty : 1

// Appearance of chorus.

// Indent of the chorus, not including bar.
# pdf.chorus.indent : 0

// Appearance of side bar.

lib/ChordPro/res/config/config.tmpl  view on Meta::CPAN

// Colour of special symbols.
# pdf.grids.symbols.color : blue

// Properties of the volta.

// Volta span (fraction of measure).
# pdf.grids.volta.span : 0.7

// Colour of the volta.
# pdf.grids.volta.color : blue

// Dual (odd/even) pages when set to true.
// False means all pages will be the same (odd, right)
// With dual pages, all the parts of the songbook (covers,
// tables of contents, etc.) are always aligned to a right page.
# pdf.songbook.dual-pages : true

// With dual pages, align individual tables of content
// to right pages by inserting a blank filler page.
// Values are true, false, or "song". In the latter case the
// pagealign settings for songs are used for the tables of contents.
# pdf.songbook.align-tocs : true

// With dual pages, all songs will start on a right.
// A blank filler page is inserted if needed for alignment.
// If false, no alignment takes place, all pages follow
// each other.
# pdf.songbook.align-songs : true

// If true, all songs will start on left pages instead of right pages.
# pdf.songbook.align-songs-spread : false

// If true, filler pages will have headings and footers
// as if they were part of the song.
# pdf.songbook.align-songs-extend : false

// Sort songs by "title" or "subtitle".
// title    : sort songs ascending by title.
// subtitle : sort songs ascending by subtitle.
// Put a minus sign before the value to obtain descending order.
# pdf.songbook.sort-songs : false

// If true, the order of the songs is adjusted to make the
// songbook as compact as possible, while each of the songs
// require minimal page turns.
// Note: this option requires extra processing time since
// the songbook has to be processed twice.
# pdf.songbook.compact-songs : false

// PDF file to add as cover page(s).
# pdf.songbook.cover : false

// PDF file to add as front matter.
# pdf.songbook.front-matter : false

// PDF file to add as back matter.
# pdf.songbook.back-matter : false

// Formats.
// Pages have two title elements and one footer element. They also
// can have a page of an existing PDF file as underlay (background).
// Topmost is "title". It uses the "title" font as defined further below.
// Second is "subtitle". It uses the "subtitle" font.
// The "footer" uses the "footer" font.
// All elements can have three fields, that are placed to the left side,
// centered, and right side of the page.
// The contents of all fields is defined below. You can use metadata
// items in the fields as shown. By default, the "title" element shows the
// value of metadata item "title", centered on the page. Likewise
// "subtitle".
// NOTE: The "title" and "subtitle" page elements have the same names
// as the default metadata values which may be confusing. To show
// metadata item, e.g. "artist", add its value to one of the
// title/subtitle fields. Do not try to add an artist page element.
// 
// The left, center and right parts are for odd pages.
// On even pages, the left and right parts are swapped.
// It is possible to define distinct even page formats with "default-even",
// "title-even" and "first-even".
//    
// When a background document is specified, with odd/even printing,
// the 1st background page is used for left pages and
// the next page (if it exists) for right pages.
// For even/odd printing, the order is reversed.

// By default, a page has:

// Three-part title format specification, left, center, right.
# pdf.formats.default.title : [ "" "" "" ]

// Three-part title format specification, left, center, right.
# pdf.formats.default.subtitle : [ "" "" "" ]

// Three-part title format specification, left, center, right.
# pdf.formats.default.footer : [ "%{title}" "" "%{page}" ]

// Background page.
# pdf.formats.default.background : ""

// The first page of a song has:

// Three-part title format specification, left, center, right.
# pdf.formats.title.title : [ "" "%{title}" "" ]

// Three-part title format specification, left, center, right.
# pdf.formats.title.subtitle : [ "" "%{subtitle}" "" ]

// Three-part title format specification, left, center, right.
# pdf.formats.title.footer : [ "" "" "%{page}" ]

// Background page.
# pdf.formats.title.background : ""

// The very first output page is slightly different:

// Three-part title format specification, left, center, right.
# pdf.formats.first.footer : [ "" "" "" ]

// Background page.
# pdf.formats.first.background : ""

// Filler pages (for alignment) are empty by default.

// Background page.
# pdf.formats.filler.background : ""

// Split marker for syllables that are smaller than chord width.
// split-marker is a 3-part array: "start", "repeat", and "final".
// "final" is always printed, last.
// "start" is printed if there is enough room.
// "repeat" is printed repeatedly to fill the rest.
// If split-marker is a single string, this is "start".
// All elements may be left empty strings.
# pdf.split-marker : [ "" "" "" ]

// Font families and properties.
// "fontconfig" maps members of font families to physical fonts.
// Optionally, additional properties of the fonts can be specified.
// Physical fonts can be the names of TrueType/OpenType fonts,
// or names of built-in fonts (corefonts).
// Relative filenames are looked up in the fontdir.
// For example:
// "fontdir" : [ "/usr/share/fonts/liberation", "/home/me/fonts" ]
# pdf.fontdir : []

// Remap corefonts to better fonts. null = if possible.
# pdf.corefonts.remap         : null

// IMPORTANT: THE ENTRY WITH THE TRAILING . DENOTES THE REGULAR FONT.

// The font families.
# pdf.fontconfig.serif.           : Times-Roman
# pdf.fontconfig.serif.bold       : Times-Bold
# pdf.fontconfig.serif.italic     : Times-Italic
# pdf.fontconfig.serif.bolditalic : Times-BoldItalic

# pdf.fontconfig.times.           : Times-Roman
# pdf.fontconfig.times.bold       : Times-Bold
# pdf.fontconfig.times.italic     : Times-Italic
# pdf.fontconfig.times.bolditalic : Times-BoldItalic

# pdf.fontconfig.helvetica.            : Helvetica
# pdf.fontconfig.helvetica.bold        : Helvetica-Bold
# pdf.fontconfig.helvetica.oblique     : Helvetica-Oblique
# pdf.fontconfig.helvetica.boldoblique : Helvetica-BoldOblique

# pdf.fontconfig.sans.           : Helvetica
# pdf.fontconfig.sans.bold       : Helvetica-Bold
# pdf.fontconfig.sans.italic     : Helvetica-Oblique
# pdf.fontconfig.sans.bolditalic : Helvetica-BoldOblique

# pdf.fontconfig.sans-serif.           : Helvetica
# pdf.fontconfig.sans-serif.bold       : Helvetica-Bold
# pdf.fontconfig.sans-serif.italic     : Helvetica-Oblique
# pdf.fontconfig.sans-serif.bolditalic : Helvetica-BoldOblique

# pdf.fontconfig.courier.           : Courier
# pdf.fontconfig.courier.bold       : Courier-Bold
# pdf.fontconfig.courier.italic     : Courier-Oblique
# pdf.fontconfig.courier.bolditalic : Courier-BoldOblique

# pdf.fontconfig.mono.           : Courier
# pdf.fontconfig.mono.bold       : Courier-Bold
# pdf.fontconfig.mono.italic     : Courier-Oblique
# pdf.fontconfig.mono.bolditalic : Courier-BoldOblique

# pdf.fontconfig.monospace.           : Courier
# pdf.fontconfig.monospace.bold       : Courier-Bold
# pdf.fontconfig.monospace.italic     : Courier-Oblique
# pdf.fontconfig.monospace.bolditalic : Courier-BoldOblique

# pdf.fontconfig.muse.           : MuseJazzText.otf
# pdf.fontconfig.muse.bold       : MuseJazzText.otf
# pdf.fontconfig.muse.italic     : MuseJazzText.otf
# pdf.fontconfig.muse.bolditalic : MuseJazzText.otf

# pdf.fontconfig.musejazztext.           : MuseJazzText.otf
# pdf.fontconfig.musejazztext.bold       : MuseJazzText.otf
# pdf.fontconfig.musejazztext.italic     : MuseJazzText.otf
# pdf.fontconfig.musejazztext.bolditalic : MuseJazzText.otf

// "fonts" maps output elements to fonts as defined in "fontconfig".
// The elements can have a background colour associated.
// Colours are "#RRGGBB" or predefined names like "black", "white",
// and lots of others.
// NOTE: In the built-in config we use only "name" since that can
// be overruled with user settings.
// 
// Some element mappings can be specified, but need not since
// they default to other elements.
// subtitle       --> text
// chorus         --> text
// comment        --> text
// comment_italic --> chord
// comment_box    --> chord
// annotation     --> chord
// toc            --> text
// grid           --> chord
// grid_margin    --> comment
// footer         --> subtitle @ 60%
// empty          --> text
// diagram        --> comment
// diagram_base   --> text (but at a small size)

// Font for typesetting titles.
# pdf.fonts.title : "serif bold 14"

// Font for typesetting lyrics.
# pdf.fonts.text : "serif 12"

// Font for typesetting chord names.
# pdf.fonts.chord : "sans italic 10"

// Colour specification.
# pdf.fonts.chordfingers.numbercolor : background

// Font for typesetting comment text.
# pdf.fonts.comment : "sans 12; background=foreground-light"

// Font for typesetting italised comment text.
# pdf.fonts.comment_italic : "Helvetica-Oblique 12"

// Font for typesetting boxed comment text.
# pdf.fonts.comment_box : "sans 12; frame=1"

// Font for typesetting tabs.
# pdf.fonts.tab : "mono 10"

// Font for typesetting the table of contents.
# pdf.fonts.toc : "serif 11"

// Font for typesetting grids.
# pdf.fonts.grid : "sans 10"

/**************** Settings for A2Crd (input) frontend ****************/

// Treat leading lyrics lines as title/subtitle lines.
# a2crd.infer-titles : true

// Analysis strategy.
# a2crd.classifier : pct_chords

// Tab stop width for tab expansion. Set to zero to disable.
# a2crd.tabstop : 8

/**************** Settings for the markup processor ****************/

// Shortcodes allow user defined markup, e.g. <foo>...</foo>.
// With shortcode
//    heavy :  "weight='bold' size='large'"
// each occurrence of <heavy>...</heavy> will be replaced by
// <span weight='bold' size='large'>...</span>.
# markup.shortcodes {}

/**************** Settings for the parser/preprocessor ****************/

// For selected lines, you can specify a series of 
// { "target" : "xxx", "replace" : "yyy" }
// Every occurrence of "xxx" will be replaced by "yyy".
// Use "pattern" instead of "target" for regular expression replacement.
// Use wisely.
# parser.preprocess.all       : []
# parser.preprocess.directive : []
# parser.preprocess.songline  : []

// For the exceptional case you need brackets [] in your lyrics or annotations.
// These characters are replaced by normal brackets **after** chord analysis.
// E.g. parser.altbrackets: "«»"
// Use wisely. Better still, do not use this.
# parser.altbrackets : null