update upcoming

_pages/en/upcoming.md

@@ -1,7 +1,7 @@
 ---
 title: "New Features, Updates and Fixes for the upcoming Ink/Stitch version"
 permalink: /upcoming/
-last_modified_at: 2025-03-19
+last_modified_at: 2025-03-23
 sidebar:
   nav: pages
 toc: true
@@ -179,7 +179,7 @@ A tool for font authors which sets a specified color sort index on selected elem
 
 ### Lettering
 
-`Lettering`
+`Lettering > Lettering`
 
 * Load with last selected font and some other settings [#3498](https://github.com/inkstitch/inkstitch/pull/3498) [#3504](https://github.com/inkstitch/inkstitch/pull/3504)
 * Add support for more languages (right to left) [#3432](https://github.com/inkstitch/inkstitch/pull/3358) [#3466](https://github.com/inkstitch/inkstitch/pull/3466)
@@ -190,6 +190,12 @@ A tool for font authors which sets a specified color sort index on selected elem
 
 ![Lettering: more options](/assets/images/upcoming/3.2.0/lettering.png)
 
+### Lettering Along Path
+
+`Lettering > Lettering Along Path`
+
+Add option for text position along the path (left, center, right, stretch)
+
 ### Multicolor Satin
 
 * Option to adjust underlay [#3152](https://github.com/inkstitch/inkstitch/pull/3152)
@@ -273,7 +279,15 @@ Glyphlist update has been part of the font management and was replaced by the mu
 
 ## Export / Import
 
-* Update pyembroidery (gcode) to allow customized setting for rgb values [#3530](https://github.com/inkstitch/inkstitch/pull/3530)
+### GCODE
+
+Update pyembroidery to allow customized setting for rgb values [#3530](https://github.com/inkstitch/inkstitch/pull/3530)
+
+### Batch Lettering
+
+Ink/Stitch can now export multiple files with text at once. A path with a specified label within the open document can be used to define text position.
+
+[More information](/docs/import-export/#batch-lettering)
 
 ## Developer and Build Stuff
 

collections/_docs/en/005-002-import-export.md

@@ -34,3 +34,51 @@ If you wish for the files within the zip-archive to have an other name than the
 
 The zip-export also offers panelization options. If repeat values are higher than one Ink/Stitch will create copies of the stitchplan and place them in defined distances.
 The distances are measured from the top left position of the original design. Colorblocks will be ordered to reduce color changes.
+
+## Batch Lettering
+
+{% include upcoming_release.html %}
+
+* Prepare a design file.
+  If the file contains a path with the label `batch lettering` it will be used for the text position.
+  It will work the same say as [Lettering Along Path](/docs/lettering/#lettering-along-path).
+* Go to `File > Save a copy...` and click on the little arrow on the file format selection field to open a list of available file formats.
+* Choose `Ink/Stitch: batch lettering (.zip)`
+* Navigate to your desired output folder and click on Save
+
+### Options
+
+* **Text:** Enter the text, by default each new line will be placed in it's own file
+* **Custom Separator:** Defaults to new lines. Specify an other separator if you wish that your text file has multiline text.
+  The text will be split and placed into a new file with every occurence of the custom separator.
+
+* **Font name:** The name of the font you wish to use. Have a look at the [font library](/fonts/font-library/) to find a list of available fonts
+* **Scale (%):** Scale value to resize a font. The value will be clamped to the available scale range of the specific font.
+* **Color sort:** Wether multicolor fonts should be color sorted or not
+* **Add trims:** Wether trims should be added or not (never, after each line, word or letter)
+* **Use command symbols:** Wether the trims should be added as command symbols or as a param option (only relevant for svg output)
+* **Align Multiline Text:** Define how multiline text should be aligned
+* **Lettering along path: text position:** The text position on the `batch lettering` path
+* **File formats:** Enter a comma separated list of [file formats](/docs/file-formats/#writing)
+
+### Command line usage
+
+Here is a minimal example for command line usage of the batch lettering extension
+
+```
+./inkstitch --extension=batch_lettering --text="Hello\nworld" --font="Abecedaire" --file-formats="svg,dst" input_file.svg > output_file.zip
+```
+
+#### Options
+
+Option           |Input Type|Values
+-----------------|----------|------
+--text           |string    |cannot be empty
+--separator      |string    |default: '\n'
+--font           |string    |must be a valid font name
+--scale          |integer   |default: 100
+--color-sort     |string    |off, all, line, word<br>default: off
+--trim           |string    |off, line, word, glyph<br>default: off 
+--command_symbols|bool      |default: False
+--text-align     |string    |left, center, right, block, letterspacing<br>default: left
+--file-formats   |string    |must be at least one valid output format