chore: autopublish 2024-01-31T19:33:33Z

Author: github-actions[bot]

dist/articulation_autoposition_rolled_chords.lua

@@ -360,20 +360,39 @@ function plugindef()
     finaleplugin.MinJWLuaVersion = 0.59
     finaleplugin.Notes = [[
         How to use this script:
+
         1. Manually apply rolled-chord articulations to the chords that need them (without worrying about how they look).
         2. Select the region you want to change.
         3. Run the script.
+
         The script searches for any articulations with the "Copy Main Symbol Vertically" option checked.
         It automatically positions them to the left of any accidentals and changes their length so that they align
         with the top and bottom of the chord with a slight extension. (Approximately 1/4 space on either end.
         It may be longer depending on the length of the character defined for the articulation.)
+
         If you are working with a keyboard or other multi-staff instrument, the script automatically extends the top
         articulation across any staff or staves below, provided the lower staves also have the same articulation mark.
         It then hides the lower mark(s). This behavior is limited to staves that are selected. To suppress this behavior
         and restrict positioning to single staves, hold down Shift, Option (macOS), or Alt (Windows) key when invoking
         the script.
+
         This script requires RGP Lua 0.59 or later.
     ]]
+    finaleplugin.RTFNotes = [[
+        {\rtf1\ansi\deff0{\fonttbl{\f0 \fswiss Helvetica;}{\f1 \fmodern Courier New;}}
+        {\colortbl;\red255\green0\blue0;\red0\green0\blue255;}
+        \widowctrl\hyphauto
+        \f0\fs20
+        \f1\fs20
+        {\pard \ql \f0 \sa180 \li0 \fi0 How to use this script:\par}
+        {\pard \ql \f0 \sa0 \li360 \fi-360 1.\tx360\tab Manually apply rolled-chord articulations to the chords that need them (without worrying about how they look).\par}
+        {\pard \ql \f0 \sa0 \li360 \fi-360 2.\tx360\tab Select the region you want to change.\par}
+        {\pard \ql \f0 \sa0 \li360 \fi-360 3.\tx360\tab Run the script.\sa180\par}
+        {\pard \ql \f0 \sa180 \li0 \fi0 The script searches for any articulations with the \u8220"Copy Main Symbol Vertically\u8221" option checked. It automatically positions them to the left of any accidentals and changes their length so that they align with the top and bottom of the chord with a slight extension. (Approximately 1/4 space on either end. It may be longer depending on the length of the character defined for the articulation.)\par}
+        {\pard \ql \f0 \sa180 \li0 \fi0 If you are working with a keyboard or other multi-staff instrument, the script automatically extends the top articulation across any staff or staves below, provided the lower staves also have the same articulation mark. It then hides the lower mark(s). This behavior is limited to staves that are selected. To suppress this behavior and restrict positioning to single staves, hold down Shift, Option (macOS), or Alt (Windows) key when invoking the script.\par}
+        {\pard \ql \f0 \sa180 \li0 \fi0 This script requires RGP Lua 0.59 or later.\par}
+        }
+    ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/articulation_autoposition_rolled_chords.hash"
     return "Autoposition Rolled Chord Articulations", "Autoposition Rolled Chord Articulations",
             'Automatically positions rolled chords and other articulations with "Copy Main Symbol Vertically" set.'

dist/articulation_reset_auto_positioning.lua

@@ -13,6 +13,15 @@ Due to complications arising from how Finale stored articulation positions befor
 Due to issues around maintaining the context for automatic stacking, it must be run under RGP Lua. JW Lua does not have the necessary
 logic to manage the stacking context.
     ]]
+    finaleplugin.RTFNotes = [[
+        {\rtf1\ansi\deff0{\fonttbl{\f0 \fswiss Helvetica;}{\f1 \fmodern Courier New;}}
+        {\colortbl;\red255\green0\blue0;\red0\green0\blue255;}
+        \widowctrl\hyphauto
+        \f0\fs20
+        \f1\fs20
+        {\pard \ql \f0 \sa180 \li0 \fi0 This script resets all selected articulations to their default positions but only if they are not manually positioned. Due to complications arising from how Finale stored articulation positions before Finale 26, it requires Finale 26 or higher. Due to issues around maintaining the context for automatic stacking, it must be run under RGP Lua. JW Lua does not have the necessary logic to manage the stacking context.\par}
+        }
+    ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/articulation_reset_auto_positioning.hash"
     return "Reset Automatic Articulation Positions", "Reset Automatic Articulation Positions", "Resets the position of automatically positioned articulations while ignoring those with manual positioning."
 end

dist/articulation_reset_positioning.lua

@@ -13,6 +13,15 @@ how Finale stored articulation positions before Finale 26, it requires Finale 26
 maintaining the context for automatic stacking, it must be run under RGP Lua. JW Lua does not have the necessary
 logic to manage the stacking context.
     ]]
+    finaleplugin.RTFNotes = [[
+        {\rtf1\ansi\deff0{\fonttbl{\f0 \fswiss Helvetica;}{\f1 \fmodern Courier New;}}
+        {\colortbl;\red255\green0\blue0;\red0\green0\blue255;}
+        \widowctrl\hyphauto
+        \f0\fs20
+        \f1\fs20
+        {\pard \ql \f0 \sa180 \li0 \fi0 This script resets all selected articulations to their default positions. Due to complications arising from how Finale stored articulation positions before Finale 26, it requires Finale 26 or higher. Due to issues around maintaining the context for automatic stacking, it must be run under RGP Lua. JW Lua does not have the necessary logic to manage the stacking context.\par}
+        }
+    ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/articulation_reset_positioning.hash"
     return "Reset Articulation Positions", "Reset Articulation Positions", "Resets the position of all selected articulations."
 end

dist/barline_chooser.lua

@@ -4914,11 +4914,20 @@ function plugindef()
     finaleplugin.ScriptGroupName = "Barline Chooser"
     finaleplugin.ScriptGroupDescription = "Change barlines in the selection by hotkey"
 	finaleplugin.Notes = [[
-        Change all barlines in the selection to one of seven styles by hotkey.
-        To repeat the same barline change as last time without a confirmation dialog,
-        select the "Barline Chooser Repeat" menu or hold down the SHIFT key when
+        Change all barlines in the selection to one of seven styles by hotkey. 
+        To repeat the same barline change as last time without a confirmation dialog, 
+        select the "Barline Chooser Repeat" menu or hold down the SHIFT key when 
         starting the script.
     ]]
+    finaleplugin.RTFNotes = [[
+        {\rtf1\ansi\deff0{\fonttbl{\f0 \fswiss Helvetica;}{\f1 \fmodern Courier New;}}
+        {\colortbl;\red255\green0\blue0;\red0\green0\blue255;}
+        \widowctrl\hyphauto
+        \f0\fs20
+        \f1\fs20
+        {\pard \ql \f0 \sa180 \li0 \fi0 Change all barlines in the selection to one of seven styles by hotkey. To repeat the same barline change as last time without a confirmation dialog, select the \u8220"Barline Chooser Repeat\u8221" menu or hold down the SHIFT key when starting the script.\par}
+        }
+    ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/barline_chooser.hash"
     return "Barline Chooser...", "Barline Chooser", "Change barlines in the selection by keystroke"
 end

dist/baseline_move_reset.lua

@@ -356,17 +356,22 @@ function plugindef()
         This script nudges system baselines up or down by a single staff-space (24 evpus). It introduces 10
         menu options to nudge each baseline type up or down. It also introduces 5 menu options to reset
         the baselines to their staff-level values.
+
         The possible prefix inputs to the script are
+
         ```
-        direction
-        baseline_types
-        nudge_evpus
+        direction 
+        baseline_types 
+        nudge_evpus 
         ```
+
         You can also change the size of the nudge by creating a configuration file called `baseline_move.config.txt` and
         adding a single line with the size of the nudge in evpus.
+
         ```
-        nudge_evpus = 36
+        nudge_evpus = 36 
         ```
+
         A value in a prefix overrides any setting in a configuration file.
     ]]
     finaleplugin.AdditionalMenuOptions = [[
@@ -402,8 +407,8 @@ function plugindef()
         Resets the selected fretboard baselines
     ]]
     finaleplugin.AdditionalPrefixes = [[
-        direction = 1
-        direction = 0
+        direction = 1 
+        direction = 0 
         direction = -1 baseline_types = {finale.BASELINEMODE_EXPRESSIONABOVE}
         direction = 1 baseline_types = {finale.BASELINEMODE_EXPRESSIONABOVE}
         direction = 0 baseline_types = {finale.BASELINEMODE_EXPRESSIONABOVE}
@@ -417,6 +422,35 @@ function plugindef()
         direction = 1 baseline_types = {finale.BASELINEMODE_FRETBOARD}
         direction = 0 baseline_types = {finale.BASELINEMODE_FRETBOARD}
     ]]
+    finaleplugin.RTFNotes = [[
+        {\rtf1\ansi\deff0{\fonttbl{\f0 \fswiss Helvetica;}{\f1 \fmodern Courier New;}}
+        {\colortbl;\red255\green0\blue0;\red0\green0\blue255;}
+        \widowctrl\hyphauto
+        \f0\fs20
+        \f1\fs20
+        {\pard \ql \f0 \sa180 \li0 \fi0 \f1 This script nudges system baselines up or down by a single staff-space (24 evpus). It introduces 10\line
+        menu options to nudge each baseline type up or down. It also introduces 5 menu options to reset\line
+        the baselines to their staff-level values.\line
+        \line
+        The possible prefix inputs to the script are\line
+        \line
+        ```\line
+        direction 
+        baseline_types 
+        nudge_evpus 
+        ```\line
+        \line
+        You can also change the size of the nudge by creating a configuration file called `baseline_move.config.txt` and\line
+        adding a single line with the size of the nudge in evpus.\line
+        \line
+        ```\line
+        nudge_evpus = 36 
+        ```\line
+        \line
+        A value in a prefix overrides any setting in a configuration file.\par}
+        {\pard \ql \f0 \sa180 \li0 \fi0 ]] finaleplugin.AdditionalMenuOptions = [[ Move Lyric Baselines Up Reset Lyric Baselines Move Expression Baseline Above Down Move Expression Baseline Above Up Reset Expression Baseline Above Move Expression Baseline Below Down Move Expression Baseline Below Up Reset Expression Baseline Below Move Chord Baseline Down Move Chord Baseline Up Reset Chord Baseline Move Fretboard Baseline Down Move Fretboard Baseline Up Reset Fretboard Baseline]] finaleplugin.AdditionalDescriptions = [[ Moves all lyrics baselines up one space in the selected systems Resets all selected lyrics baselines to default Moves the selected expression above baseline down one space Moves the selected expression above baseline up one space Resets the selected expression above baselines Moves the selected expression below baseline down one space Moves the selected expression below baseline up one space Resets the selected expression below baselines Moves the selected chord baseline down one space Moves the selected chord baseline up one space Resets the selected chord baselines Moves the selected fretboard baseline down one space Moves the selected fretboard baseline up one space Resets the selected fretboard baselines]] finaleplugin.AdditionalPrefixes = [[ direction = 1 \u8211- no baseline_types table, which picks up the default (lyrics) direction = 0 \u8211- no baseline_types table, which picks up the default (lyrics) direction = -1 baseline_types = \{finale.BASELINEMODE_EXPRESSIONABOVE\} direction = 1 baseline_types = \{finale.BASELINEMODE_EXPRESSIONABOVE\} direction = 0 baseline_types = \{finale.BASELINEMODE_EXPRESSIONABOVE\} direction = -1 baseline_types = \{finale.BASELINEMODE_EXPRESSIONBELOW\} direction = 1 baseline_types = \{finale.BASELINEMODE_EXPRESSIONBELOW\} direction = 0 baseline_types = \{finale.BASELINEMODE_EXPRESSIONBELOW\} direction = -1 baseline_types = \{finale.BASELINEMODE_CHORD\} direction = 1 baseline_types = \{finale.BASELINEMODE_CHORD\} direction = 0 baseline_types = \{finale.BASELINEMODE_CHORD\} direction = -1 baseline_types = \{finale.BASELINEMODE_FRETBOARD\} direction = 1 baseline_types = \{finale.BASELINEMODE_FRETBOARD\} direction = 0 baseline_types = \{finale.BASELINEMODE_FRETBOARD\}\par}
+        }
+    ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/baseline_move_reset.hash"
     return "Move Lyric Baselines Down", "Move Lyrics Baselines Down", "Moves all lyrics baselines down one space in the selected systems"
 end

dist/beam_selected_region.lua

@@ -304,8 +304,8 @@ package.preload["library.note_entry"] = package.preload["library.note_entry"] or
     return note_entry
 end
 function plugindef()
-
-
+    
+    
     finaleplugin.RequireSelection = true
     finaleplugin.Author = "Robert Patterson"
     finaleplugin.Copyright = "CC0 https://creativecommons.org/publicdomain/zero/1.0/"
@@ -320,11 +320,14 @@ function plugindef()
         Document Settings determine whether rests can be included at the start or end of a beam.
         If you select multiple staves vertically, you can create the same beaming pattern
         across all the staves with a single invocation of the script.
+
         It does *not* create beams over barlines.
+
         By default, the plugin installs two menu options, one to beam the selected region and
         the other to unbeam the selected region. You can instead unbeam all notes in the selected region
         by invoking the "Beam Selected Region" menu option with the Option key pressed (macOS) or
         the Shift key pressed. This is identical to invoking the "Unbeam Selected Region" menu option.
+
         This script could be particularly useful if you assign it a keystroke using a keyboard macro utility.
     ]]
     finaleplugin.AdditionalMenuOptions = [[
@@ -336,6 +339,30 @@ function plugindef()
     finaleplugin.AdditionalPrefixes = [[
         do_unbeam = true
     ]]
+    finaleplugin.RTFNotes = [[
+        {\rtf1\ansi\deff0{\fonttbl{\f0 \fswiss Helvetica;}{\f1 \fmodern Courier New;}}
+        {\colortbl;\red255\green0\blue0;\red0\green0\blue255;}
+        \widowctrl\hyphauto
+        \f0\fs20
+        \f1\fs20
+        {\pard \ql \f0 \sa180 \li0 \fi0 \f1 This script beams together any notes or rests in the selected region that can\line
+        be beamed together and breaks beams that cross into or out of the selected\line
+        region at the boundaries of the selected region. The beam options in Finale\u8217's\line
+        Document Settings determine whether rests can be included at the start or end of a beam.\line
+        If you select multiple staves vertically, you can create the same beaming pattern\line
+        across all the staves with a single invocation of the script.\line
+        \line
+        It does *not* create beams over barlines.\line
+        \line
+        By default, the plugin installs two menu options, one to beam the selected region and\line
+        the other to unbeam the selected region. You can instead unbeam all notes in the selected region\line
+        by invoking the "Beam Selected Region" menu option with the Option key pressed (macOS) or\line
+        the Shift key pressed. This is identical to invoking the "Unbeam Selected Region" menu option.\line
+        \line
+        This script could be particularly useful if you assign it a keystroke using a keyboard macro utility.\par}
+        {\pard \ql \f0 \sa180 \li0 \fi0 ]] finaleplugin.AdditionalMenuOptions = [[ Unbeam Selected Region]] finaleplugin.AdditionalDescriptions = [[ Unbeam Selected Region]] finaleplugin.AdditionalPrefixes = [[ do_unbeam = true\par}
+        }
+    ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/beam_selected_region.hash"
     return "Beam Selected Region", "Beam Selected Region", "Beam Selected Region"
 end

dist/clef_change.lua

@@ -328,13 +328,14 @@ package.preload["library.clef"] = package.preload["library.clef"] or function()
     return clef
 end
 function plugindef()
-
-
+    
+    
     finaleplugin.Author = "Jacob Winkler"
     finaleplugin.Copyright = "2022"
     finaleplugin.Version = "1.0.1"
     finaleplugin.Date = "2022-08-30"
     finaleplugin.RequireSelection = true
+
     finaleplugin.AuthorEmail = "[email protected]"
     finaleplugin.AdditionalMenuOptions = [[
     Clef 2: Bass