Release 4.2

_config.yml

@@ -4,7 +4,7 @@ repository: rism-digital/verovio-reference-book
 baseurl: ""
 exclude: ['scripts']
 
-verovio-version: "4.1"
+verovio-version: "4.2"
 
 markdown: kramdown
 highlighter: rouge

_includes/options/0-base.md

@@ -1,13 +1,13 @@
 {% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-a, --all-pages `</span> {% endcol %}{% col 8 %} Output all pages {% endcol %}
-{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-h, --help `</span> {% endcol %}{% col 8 %} Display this message {% endcol %}
+{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-h, --help <string>`</span> {% endcol %}{% col 8 %} Display this message<br/>(default: "") {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"inputFrom": <string>`</span><span class="lang2">`-f, --input-from <string>`</span> {% endcol %}{% col 8 %} Select input format from: &quot;abc&quot;, &quot;darms&quot;, &quot;humdrum&quot;, &quot;mei&quot;, &quot;pae&quot;, &quot;xml&quot; (musicxml)<br/>(default: "mei")
 
 See also: [Input formats](/toolkit-reference/input-formats.html) {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-l, --log-level <string>`</span> {% endcol %}{% col 8 %} Set the log level: &quot;off&quot;, &quot;error&quot;, &quot;warning&quot;, &quot;info&quot;, or &quot;debug&quot;<br/>(default: "warning")
 
 See also: [Environment functions](/toolkit-reference/environment-functions.html) {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-o, --outfile <string>`</span> {% endcol %}{% col 8 %} Output file name (use &quot;-&quot; as file name for standard output)<br/>(default: "svg") {% endcol %}
-{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-t, --output-to <string>`</span> {% endcol %}{% col 8 %} Select output format to: &quot;mei&quot;, &quot;mei-pb&quot;, &quot;mei-basic&quot;, &quot;svg&quot;, &quot;midi&quot;, &quot;timemap&quot;, &quot;expansionmap&quot;, &quot;humdrum&quot; or &quot;pae&quot;<br/>(default: "svg")
+{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-t, --output-to <string>`</span> {% endcol %}{% col 8 %} Select output format to: &quot;mei&quot;, &quot;mei-pb&quot;, &quot;mei-facs&quot;, &quot;mei-basic&quot;, &quot;svg&quot;, &quot;midi&quot;, &quot;timemap&quot;, &quot;expansionmap&quot;, &quot;humdrum&quot; or &quot;pae&quot;<br/>(default: "svg")
 
 See also: [Output formats](/toolkit-reference/output-formats.html) {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">∅</span><span class="lang2">`-p, --page <integer>`</span> {% endcol %}{% col 8 %} Select the page to engrave (default is 1) {% endcol %}

_includes/options/1-general.md

@@ -46,6 +46,7 @@ See also: [Controlling the SVG output](/advanced-topics/controlling-the-svg-outp
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"scaleToPageSize":  <boolean>`</span><span class="lang2">`--scale-to-page-size `</span> {% endcol %}{% col 8 %} Scale the content within the page instead of scaling the page itself
 
 See also: [Scaling](/advanced-topics/controlling-the-svg-output.html#scaling) {% endcol %}
+{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"setLocale":  <boolean>`</span><span class="lang2">`--set-locale `</span> {% endcol %}{% col 8 %} Changes the global locale to C (this is not thread-safe) {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"showRuntime":  <boolean>`</span><span class="lang2">`--show-runtime `</span> {% endcol %}{% col 8 %} Display the total runtime on command-line {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"shrinkToFit":  <boolean>`</span><span class="lang2">`--shrink-to-fit `</span> {% endcol %}{% col 8 %} Scale down page content to fit the page height if needed {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"smuflTextFont": <string>`</span><span class="lang2">`--smufl-text-font <string>`</span> {% endcol %}{% col 8 %} Specify if the smufl text font is embedded, linked, or ignored<br/>(default: "embedded"; other values: ['embedded', 'linked', 'none'])

_includes/options/2-generalLayout.md

@@ -16,6 +16,9 @@
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"font": <string>`</span><span class="lang2">`--font <string>`</span> {% endcol %}{% col 8 %} Set the music font<br/>(default: "Leipzig")
 
 See also: [SMuFL fonts](/advanced-topics/smufl.html) {% endcol %}
+{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"fontAddCustom": <string> *`</span><span class="lang2">`--font-add-custom <string> *`</span> {% endcol %}{% col 8 %} Add a custom music font as zip file {% endcol %}
+{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"fontFallback": <string>`</span><span class="lang2">`--font-fallback <string>`</span> {% endcol %}{% col 8 %} The music font fallback for missing glyphs<br/>(default: "Leipzig"; other values: ['Leipzig', 'Bravura']) {% endcol %}
+{% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"fontLoadAll":  <boolean>`</span><span class="lang2">`--font-load-all `</span> {% endcol %}{% col 8 %} Load all music fonts {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"graceFactor": <decimal>`</span><span class="lang2">`--grace-factor <decimal>`</span> {% endcol %}{% col 8 %} The grace size ratio numerator<br/>(default: 0.75; min: 0.5; max: 1.0) {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"graceRhythmAlign":  <boolean>`</span><span class="lang2">`--grace-rhythm-align `</span> {% endcol %}{% col 8 %} Align grace notes rhythmically with all staves {% endcol %}
 {% endrow %}{% row option_row %}{% col 4 %} <span class="lang1">`"graceRightAlign":  <boolean>`</span><span class="lang2">`--grace-right-align `</span> {% endcol %}{% col 8 %} Align the right position of a grace group with all staves {% endcol %}