24.8.15

What's new in 24.8.15

Long time no see – it's been over a year since the previous release. :( There are no major updates, though: there's one breaking change and three new scripts, some new features and many minor updates and bug fixes.

Also, since there are quite a lot of files, I've organized them into a new scheme related to their scope: document, page/spread, objects on page, and application environment. Some scripts were renamed as follows:

Old name	New name
BreakLinkToStyles	RemoveStyles
ClipUndo	ClipRelease
DefaultLayers	AddLayers
DefaultSwatches	AddSwatches
FilesToSpreads	JoinDocs
ReplaceSnippets	ReplaceTextSnippets
SpreadsToFiles	SplitDocBySpreads

Document

Assets

• AddLayers:

  • brk Finally, I added a new column for the layers' locked state. When I originally made the script I didn't need this property, but later I discovered that I keep adding hacks to DocCleanup to lock certain layers. :) This is a breaking change, meaning that you will have to manually update all your layers.tsv files to 7 columns (see README for more info):

    Name	Color	Visible	Printable	Locked	Order	Variants
    ...

• AddSwatches:

  • Every swatch automatically gets two new implicit variants along its Color Value Name: its lowercase name (this also fixes case variations), and the alternative spelling of its Color Value Name ('cXmXyXkX' or 'rXgXbX' or 'lXaXbX'). So, if you have this line:

    Name	Color Model	Color Space	Values	Variants
    Rich Black	process	cmyk	60 40 40 100

    all document swatches named rich black (and other case variations), C=60 M=40 Y=40 K=100, or c60m40y40k100 will be merged with Rich Black.

• ReplaceLinks:

  • Filenames containing commas are now properly recognized, but they must be quoted.

• new ResetLayers:

  • A new script that (re)sets the visible/printable/locked state of document layers to their state defined in layers.tsv.

Export

• QuickExport:
  • new Added an option to sort exported files in subfolders by date; the index added to the file names when Overwrite existing files is disabled takes these subfolders into account.
  • new Added an elapsed time report when the export takes longer than 9 seconds.
  • When you export with a preset whose name ends with '_print', the exported file name will have all visible and printable layers beginning with '+' appended to the suffix (for example, if there is a visible and printable layer named '+varnish', the exported file name will have the suffix '_print+varnish').
  • The options for updating documents were simplified to just Save and Save as.
  • When Add a suffix was disabled, it ignored Sort files into subfolders by suffix. This is fixed: you can sort by suffix without adding it to the file names.
  • Skip export when fonts are missing; skip export when links are set to be updated but are missing.
  • Fixed aborting the export when 'Escape' was detected.
  • Small additional fixes and some improvements to error reports.

Housekeeping

• DocCleanup:

  • When deleting empty frames, those having type on path are preserved.
  • When cleaning text frames skip threaded ones.
  • Replaced a hack used to lock certain layers with a proper solution that uses the layers' state from layers.tsv.
  • Simplified the logic that sets the pasteboard size.

• RemoveStyles:

  • In addition to breaking links to object/paragraph/character styles, it will remove orphaned styles and groups.

Page

Guides

• GuidesAdd:

  • By default, it adds page guides; added an option to use spread guides if run while pressing Opt/Alt.
  • Changed guides view threshold to 100%.

• LabelPageRatios:

  • Improved label info to display the page ratio and the visible area ratio; if the visible area is not defined, it falls back to the margins ratio.

• new MarkSafetyArea:

  • A new script to mark the safety area of a page by creating a frame around the page margins.

Layout

• PageMarginsFromScriptName:

  • When HW was zero it still added a HW guide; fixed.

• PageSizeFromFilename:

  • Improved detection of size pairs (e.g., 'Filename 000x000_000x000' is now recognized).
  • Added checks to ensure that page sizes and margins are within valid limits.

Spreads

• SplitDocBySpreads:

  • After merging documents the page numbering will be reset to start at 1.
  • The open documents are merged in a natural sorting order.

• new SplitSpreadsByLayers:

  • A new script that splits/combines the active document spreads using a list of predefined layers ('DE', 'FR', 'IT'): elements from these layers, depending on the initial number of document spreads, are either distributed into multiple spreads or combined into a single spread.

Object

Clipping

• Clip:

  • Color-filled text frames were clipped ignoring their background; fixed.
  • Empty clipping frames are now ignored.

• Clip, ClipRelease:

  • When releasing objects from their clipping frames, only those released will remain selected.

Fit

• TextAutoSize:
  • Text frames labeled 'hw' will be processed regularly.
  • When trimming ending whitespaces sometimes the styling was affected; fixed by using native Find/Change GREP.
  • Items on the '.guides' layer are now ignored.

Other

• OffsetPaths:
  • new You can create an offset path around groups (it processes 1^st level objects so we don't get a boring rectangle).

Miscellaneous

• EAN:

  • new You can sequentially insert a list of barcodes into multiple objects (in the order they were selected).
  • List height was supposed to grow depending on selection; fixed.
  • Placing code failed when target frames were already populated; fixed.

• QR:

  • The code text now defaults to the file name.

• QR, QRBatch:

  • Fixed document path detection for '[Converted]' documents.
  • The fill and stroke were using document defaults; now are set explicitly.

Other

• HW guides are now added to the '.guides' layer.
• Overprinting was attempted on pseudo-white when marking the visible area; fixed.

For other changes not mentioned here see the full changelog.

23.7.18

What's new in 23.7.18

Cleanup

• DefaultPrefs:
  • The default text wrap mode is now off.
  • Removed color profile settings.
• DocCleanup:
  • Empty frames from '.guides' are protected from deletion.
  • Added '.segmentation' to 'Show/hide layers' list.
• Added DumpLinks: Saves document's links to a TSV file compatible with ReplaceLinks.
• ReplaceLinks: Improved reports (shown when run with Ctrl key pressed).
• ReplaceSnippets: Find/Change settings are now cleared when script finishes.
• SwatchesCleanup: Moved deletion of unused swatches as the last step.

Fit

• TextAutosize: Fixed a bug that in certain circumstances reverted a frame's auto-sizing to height-only.

Export

• QuickExport:
  • Major UI refactoring: most of the common options have been moved to workflows to make them more independent (in the future it will be possible to create presets).
  • Added an option to create Acrobat layers.
  • Added an option to exclude any layer beginning with '.' or '-' (do-not-print layers). You can also add a custom layer list or use the default one.
  • Added an option to automatically upgrade documents from previous versions of InDesign.
  • hack There is a hack that automatically appends the names of technical layers like 'dielines,' 'varnish,' etc., to the suffix; unfortunately it used to add them even if the layers were not actually exported. Fixed.
  • If you keep the Opt/Alt key pressed while clicking Start, the script will run without saving the settings.
• Hide/ShowDNPLayers, PrepareForExport: Tweaked the internal list of do-not-print layers.
• PrepareForExport: No longer creates an 'info' layer if not actually needed.

View

• TileAll: Documents with square formats will use the generic Window ‣ Arrange ‣ Tile.

Misc

• EAN: The code will be inserted into all selected objects.

• LabelPageRatios: Now both outer (visible area, or page size if undefined) and inner ratios (margins) will be marked.

Other

• Added a dot prefix to do-not-print layers (e.g., '.visible area').
• Replaced layer 'ID' with 'info' to simplify layer management.
• Increased stroke width when marking the visible area for large visuals.
• Improved feedback when the current document doesn't have a valid path.
• Added MasterSpread as a valid parent, thus scripts also work on the parent/master pages.

For other changes not mentioned here see the full changelog.

23.2.1

What's new in 23.2.1

Cleanup

• DefaultPrefs: Changed General ‣ Object Editing ‣ When Scaling to Apply to Content.
• DefaultLayers: You can now order layers to top or bottom using these keywords.
• DocCleanup: Minor tweaks and fixes.
• RemoveScriptLabels: Renamed from misc/LabelsCleanup.

Export

• QuickExport:
  • Preferences will be silently created on first run.
  • Added a fix for queued documents that disappear before the actual export.

Layout

• Added PageMarginsFromScriptName: Sets the page margins and optionally the HW area (expressed in percentage of the visible/page area), getting the values from the script name. It's designed to be duplicated and renamed to customize the values, using one or two numbers and the keyword HW. Example: MG5HW10.jsx sets the margins to 5% and the HW to 10% (HW can also be used without a number, which sets it to 10%, or omitted, which sets it to 0).

View

• ZoomToSelection/Spreads: When zooming to page include the slug if preview mode is off.
• Added ZoomTo300Percent: Zooms the current view to 300%.

Misc

• QR, QRBatch: Minor tweaks and fixes.

For other changes not mentioned here see the full changelog.

22.11.10

What's new in 22.11.10

Cleanup

• Added BreakLinkToStyles: Unnaplies paragraph/character/object styles from all or selected objects.
• Added DumpLayers: Saves a TSV file with the properties of the active document layers (compatible with DefaultLayers).
• DefaultPrefs: Preferences are now applied in two steps: application/document.
• DocCleanup: Reinstated conversion of empty text frames to generic frames, but only when they are not auto-sized.
• Renamed SwatchesSave to DumpSwatches.

Export

• QuickExport:
  • Custom bleed is now imported when defined in the PDF preset.
  • Document layers will be restored to initial status after export.
  • Increased maximum bleed value to 152.4 mm.
  • Improved the PDF preset tooltip info.
  • Errors are now reported after running additional scripts.
  • When the PDF preset is set to preserve original resolution the DPI option is now disabled.

Misc

• Added EAN: Embeds an EAN code in the selected frame or adds it to a new page.
• QR:
  • Switched uppercase and white label options.
  • Set label leading to 100%.

Other

• Dialogs are centered in the InDesign window.

For other fixes and improvements not mentioned here see the full changelog.

22.9.25

Cleanup

• DefaultSwatches: You can now cancel by pressing 'Esc'.
• DocCleanup: No longer converts empty text frames to generic frames.
• ReplaceLinks:
  • Fixed an error for names containing %.
  • You can now cancel relinking by pressing 'Esc'.
• SwatchesSave: Changed the TSV encoding to UTF-8 to preseve swatch names using non-ASCII characters.

Export

• QuickExport: Cosmetic tweaks to 'Export in subfolders' description.

File

• SpreadsToFiles: Cosmetic tweaks to the prompt text.

View

• ZoomTo...:
  • Tweaked the zoom factor (fits a square page to 90% of 'Fit Page in Window').
  • Refactored to use similar code.

Other

• All scripts that use TSVs as input:
  • Added an @includepath statement which sets a reference path to which subsequent relative paths will refer.
  • You can now use relative paths for both @include and @includepath: thus, a path may be an absolute path, one relative to the current data file, or a path relative to a reference path, if defined by a previous @includepath statement.
  • Changed data files extension to .tsv (it still looks for .txt as fallback).
  • Added support for comments at the end of lines (everything after a # is ignored).
• Activated auto filtering to the status report for scripts that need it.

22.8.22

Cleanup

• DefaultPrefs: Changed baseline grid color to a lighter grey (230,230,230).
• DefaultSwatches: Added / to the list of values separators (thus, you can write values as 34 42 23 5, 34|42|23|5, or 34/42/23/5).
• DocCleanup:
  • Items on dielines layer will not be converted to graphic frames.
  • Also locked the varnish layer.
• ReplaceSnippets: Fixed a replacement quirk.
• SwatchesSave: Will no longer open the TSV file after export.
• Improved info/error reporting.

Export

• QuickExport:

  • new Added a resolution field; bumped settings version.
  • Input/output folder fields are now editable (in a future version it will also create the output folder if it doesn't exist).
  • The titlebar and the 'Start' button help tip will display the errors that prevent the script from running.
  • Added a preset help tip that shows the selected preset settings.
  • hack Will show/hide layers starting with a dot when using a preview/print suffix (aka DNP layers).
  • hack When exporting with a print suffix, will append +diecut if documents have a dielines layer.

• PrepareForExport: Dielines are no longer moved to separate page.

File

• SpreadsToFiles: new Added a custom positioning placeholder character – if the file name contains a #, the index will be placed in that position.

Fit

• Protected the <visible area> frames and items on dielines layer from reframing (they will reframe in enforced mode).

Other

• Added a button for saving the reports to file.
• Relaxed the list of invalid file name characters (< > : " \ / \ | ? *).
• Enforced straight corners to new rectangles and text frames.
• Added an #includepath directive with a list of fallback folders.

22.6.11

This is a streamlined, statically-linked version of the repository to eliminate the need for libraries and make the scripts stand-alone.

New features

• new ReplaceSnippets: Replaces text snippets from a substitution list
• new LayersToSpreads: Moves layers of the active document to separate spreads

Updates

• upd DocCleanup: Split step 3 into separate steps
• upd MarkVisibleArea, PageSizeFromFilename: Updated 'Visible area' swatch
• upd upd DefaultLayers/Swatches/ReplaceFonts/Links, QRBatch: Trimmed trailing whitespace on import
• upd ReplaceSnippets: Added a scope limiting column – replacement will only be done if a string appears in the filename (regex)
• upd upd PrepareForExport, Show/HideDNPLayers: All layers starting with hyphen or dot are now included in the 'do-not-print' list
• upd ScaleTo: Scaling now takes into account the transformations reference point

Bug fixes

• fix fix DefaultLayers/Swatches/ReplaceFonts/Links: Enforced UTF-8 encoding on opening the data file
• fix DefPrefs: Added 'Coated FOGRA39' as CMYK profile fallback
• fix ReplaceSnippets: Skip locked layers & stories

22.4.11

This is a streamlined, statically-linked version of the repository to eliminate the need for libraries and make the scripts stand-alone.

New features

• new DocCleanup: Added a prompt to delete empty frames

Updates

• upd QuickExport: Check cancel request more often (between each export instead of between documents)
• upd DefaultLayers: Layers get themselves as the first variant
• upd DefaultSwatches: Swatches get their 'Color Value Name' as the first variant
• upd DocCleanup: Improved pasteboard setting logic
• upd DefaultSwatches, ReplaceLinks: Added progress bars
• upd DocCleanup: Changed visibility and locked state of some technical layers (e.g., 'dielines')

Bug fixes

• fix TextAutosize: Added a check for overflown text when disabling hyphenation for one-liners
• fix DefaultLayers/Swatches/ReplaceFonts/Links: Don't skip error reporting when there are no records
• fix DocCleanup: Fixed an overzealous trimming of overflowed text
• fix DocCleanup: Skip frames with strokes when converting empty frames to graphic frames

Miscellaneous

• del Removed DocDefaults stub
• ref QRBatch: Processed lines are commented with just a '#', no space; works better when aligning columns with 'Rainbow CSV'
• ref DefaultLayers/Swatches/ReplaceFonts/Links: Tweaked messages for BigSur's vertical alerts
• doc ReplaceLinks: Clarified/removed a mention about local links

22.3.11

This is a statically-linked version of the repository to eliminate the need for libraries and make the scripts stand-alone.

New features

• new DocCleanup: Empty non-text frames will be converted to graphic frames to make them visible on complex layouts
• new ReplaceLinks: 'Document links' list now accepts '*' and '?' wildcards

Updates

• upd upd DocCleanup, DocDefaults: Added progress bars
• ref QRBatch: Removed bounds fallback (it's done in the GetBounds lib now)
• upd DefaultLayers/Swatches/ReplaceFonts/Links: Set verbosity to INFO when Ctrl is pressed
• upd SwatchesCleanup: Merged 'R=0 G=0 B=0' to the default Black swatch

Bug fixes

• fix fix QR, QRBatch: Fixed some errors in suffix regexp matching (01/27 bugs)
• fix Don't resize (PageSizeFromFilename) or don't split (QuickExport) documents with a mixture of sizes (e.g., 210x297 + 297x210)

Miscellaneous

• doc Added a folder with sample data files

22.2.9

This is a statically-linked version of the repository to eliminate the need for libraries and make the scripts stand-alone.

New features

• brk QR 4.0, QRBatch 3.0: Added suffix support (see SpreadsToFiles)
• upd QuickExport 2.19: Cancel export if 'Esc' is kept pressed
• new QuickExport 2.17: Added a 'Save as…' option for removing cruft and reducing documents size
• upd QR 3.7, QRBatch 2.9: Added a checkbox for uppercase text
• upd QuickExport 2.13: When exporting files to subfolders, a '+' in the suffix will truncate the subfolder name
• upd DefaultLayers/Swatches/ReplaceFonts/Links: You can now use backslash at the end of a line to split long lines
• new Added GuidesAdd: Adds guides on pages' edges and inner centers or on selected objects' edges (mostly a template script)
• new Added ReplaceLinks: Replaces document links from a substitution list
• upd DocCleanup 2.9: Added a step to clear default effects
• new Added ScaleToSpreadBleed/H/W
• new Added OffsetPath 1.2 by Olav Martin Kvern to /misc (it uses InDesign's text wrap feature to create offset/inset paths)

Updates

• upd QuickExport 2.20: Added a second progress bar when exporting separate pages
• upd QuickExport 2.18: Input files are now sorted in natural order
• upd QR 3.6.1, QRBatch 2.8.1: The on-page label now has insets on both left and right sides
• upd DefaultLayers 3.4, DefaultSwatches 4.6, ReplaceFonts 2.3, ReplaceLinks 1.3: Improved the error alert for missing data files; added a check for converted documents
• upd DefaultPrefs 1.5: Disabled layout adjustment
• upd QR 3.6, QRBatch 2.8: If it fits, the code will now be aligned outside visible area, instead of margins
• upd ReplaceLinks 1.2: Update out-of-date links
• upd LabelPage 1.3, LabelPageRatios 2.2, PrepareForExport 2.3: Aligned page label to crop marks
• upd QuickExport 2.15: Report overflowed text; don't report missing links from the pasteboard
• upd DefaultLayers 3.3, DefaultSwatches 4.5, ReplaceFonts 2.2, ReplaceLinks 1.1: Improved data parsing and error reporting
• upd QuickExport 2.12: Moved crop marks at 1 mm from trimbox; don't include printer's marks if no bleed
• upd OffsetPath 2.0: Fixed container-objects; added option to join contours; streamlined logic
• upd Debug 1.0: Updated description, simplified arguments parsing, updated trunc/pad function
• upd HW 2.7: Also match old <safe area> frames as visible area marks
• upd ShowProfiles 1.5: Profiles are only available with a document opened, so create a temporary one

Removed features

• ref QuickExport 2.21: Removed advanced mode 'Save prefs' button

Bug fixes

• fix QRBatch 2.9.2: Forgot to pass along the uppercase checkbox value (d'oh!)
• fix TextAutosize 2.5.2: Hopefully fixed hyphenated lines breaking
• fix QuickExport 2.16.1: Fixed a bug when skipping page information on pages with small widths
• fix QR 3.7.1, QRBatch 2.9.1: Made the label uppercase by default
• fix QuickExport 2.16: Don't include page information when pages/spreads widths are less than 335 pt
• fix LabelPage 1.3.1, LabelPageRatios 2.2.1, PrepareForExport 2.3.1: Added a white outline to labels
• fix ShowFonts 1.4.6: Fixed name reporting for missing fonts
• upd QuickExport 2.14: When exporting separate pages don't add a counter if doc has a single page/spread
• fix DefaultLayers 3.3.1, DefaultSwatches 4.5.1, ReplaceFonts 2.2.1, ReplaceLinks 1.1.1: Changed 'No data file found' alert verbosity level to info
• fix SpreadsToFiles 1.7.12: Fixed separator validation (regex fuckup)
• fix QuickExport 2.11.3: Fixed clash with regex tokens when uniquifying filenames
• fix PrepareForExport 2.2.2: Hidden layers are now ignored
• fix Clip 2.7, ClipUndo 2.5: Only clip objects directly on spread
• fix QRBatch 2.7: Converted documents are now skipped and reported

Miscellaneous

• ref Changed scripts grouping & switched to calendar versioning
• ref Renamed DeleteGuides to GuidesDelete and CleanupSwatches to SwatchesCleanup
• ref Linked helper functions by #include preprocessor directive
• ref Updated helper functions
• doc SpreadsToFiles 1.7.10: Added an example to the prompt message
• ref Renamed OffsetPath to OffsetPaths
• doc Added a changelog