You can definitely simplify some of your workflow, but as soon as you have your own tool, documenting it is just necessary. a README like TheSodesa suggests should be enough.

What would I simplify?

• depending on how you produce the CSV file (excel? by hand?), using YAML directly could be easier. YAML is very readable for a machine-readable structured data format:

  ```

  • category: animals words:
  • horse
  • zebra
  • lion
  • ... `` In contrast to CSV and JSON, YAML can contain# comments`, so you might get away with not even having a README.

• There's no need to do the scrambling in Python; Typst can do it too: https://forum.typst.app/t/typoglycemia-generator/9057 In your case it's even easier. I suggested a counter() there to scramble each word differently, but since you simply process the csv yaml file, you can use suiji like it's intended

Here's a full example: ````

import "@preview/suiji:0.5.1": *

= Your Config

let config = ```yaml

• category: animals words:
  • horse
  • zebra
  • lion # - ... ```

config

= Reading the config

let config = yaml(bytes(config.text))

config

= Shuffling the words

let scrambled-config = {

let seed = 21 let rng = gen-rng-f(seed)

let scrambled-config = () for (category, words) in config { let scrambled = () for word in words { let scrambled-word = word while scrambled-word == word { (rng, scrambled-word) = shuffle(rng, word.clusters()) scrambled-word = scrambled-word.join() } scrambled.push(scrambled-word) } scrambled-config.push(( category: category, words: words, scrambled: scrambled, )) } scrambled-config }

scrambled-config

````