NAME

App::Music::ChordPro::Config - Built-in configuration

DESCRIPTION

The configurations files are 'relaxed' JSON files. This means that they may contain comments and trailing comma's.

Currently, most settings in the configuration files are for the PDF backend.

This is the current built-in configuration file, showing all settings.

// Configuration (mostly layout definitions) for ChordPro.
//
// This is a relaxed JSON document, so comments are possible.

{
    // Layout definitions for PDF output.

    "pdf" : {

	// Papersize, 'a4' or [ 595, 842 ] etc.
	"papersize" : "a4",

	// Number of columns.
	// Can be overridden with {columns} directive.
	// "columns"   : 2,
	// Space between columns, in pt.
	"columnspace"  :  20,

	// Page margins.
	// Note that top/bottom exclude the head/footspace.
	"margintop"    :  90,
	"marginbottom" :  40,
	"marginleft"   :  40,
	"marginright"  :  40,
	"headspace"    :  50,
	"footspace"    :  20,

	// Special: head on first page only, larger pages.
	"head-first-only" : 0,

	// Spacings.
	// Baseline distances as a factor of the font size.
	"spacing" : {
	    "title"  : 1.2,
	    "lyrics" : 1.2,
	    "chords" : 1.2,
	    "grid"   : 1.2,
	    "tab"    : 1.0,
	    "toc"    : 1.4,
	},

	// Style of chorus indicator.
	"chorus-indent"     :  0,
	// Chorus side bar. Suppress by setting offset and width to zero.
	"chorus-bar-offset" :  8,
	"chorus-bar-width"  :  1,
	"chorus-bar-color"  : "black",

	// Alternative songlines with chords in a side column.
	// Value is the column position.
	// "chordscolumn" : 400,
	"chordscolumn" :  0,

	// Suppress empty chord lines.
	// Overrides the -a (--single-space) command line options.
	"suppress-empty-chords" : 1,

	// Flush titles.
	"titles-flush" : "center",

	// Right/Left page numbers.
	"even-pages-number-left" : 1,

	// Fonts.
	// Fonts can be specified by name (for the corefonts)
	// or a filename (for TrueType/OpenType fonts).
	// Relative filenames are looked up in the fontdir.
	// "fontdir" : "/home/jv/.fonts",

	// Fonts for chords and comments can have a background
	// colour associated.
	// Colours are "#RRGGBB" or predefined names like "black", "white",
	// and lots of others.

	"fonts" : {
	    "title" : {
		"name" : "Times-Bold",
		"size" : 14
	    },
	    "text" : {
		"name" : "Times-Roman",
		"size" : 14
	    },
	    "chord" : {
		"name" : "Helvetica-Oblique",
		"size" : 10
	    },
	    "comment" : {
		"name" : "Helvetica",
		"size" : 12
	    },
	    "tab" : {
		"name" : "Courier",
		"size" : 10
	    },
	},

	// Fonts that can be specified, but need not.
	// subtitle       --> text
	// comment        --> text
	// comment_italic --> chord
	// comment_box    --> chord
	// toc            --> text
	// grid           --> chord
	// footer         --> subtitle @ 60%

	// This will show the page layout.
	// "showlayout" : 1,
    }
}
// End of config.