drawio_sync_img

Synchronizes the pages of a drawio document. The script saves each page in an image with the same page name. The script saves synchronization information about previous saves avoiding to re-save image not updated.

Setup

• install drawio software (need drawio commands line) refer to: https://github.com/jgraph/drawio-desktop/releases/

• install yaml python lib: pip3 install pyyaml

• use the script such as a command line, inside your bashrc or zshrc insert the following line:

export PATH=$PATH:/path/this/folder

Use

Run the following command

$ drawio_sync_img -f path/to/drawio/file -o path/to/output/folder {-a} {-p x} {-t x} {--force}
# x = number
$ drawio_sync_img --help
usage: drawio_sync_img.py [-h] -f FILE [-o OUTPUT] [-a] [-p PAGE] [-t THREADS] [--force]

optional arguments:
  -h, --help            show this help message and exit
  -f FILE, --file FILE  drawio file to sync
  -o OUTPUT, --output OUTPUT
                        folder where image will be saved
  -a, --all-pages       sync all pages from the drawio file
  -p PAGE, --page PAGE  sync specific page number from the drawio file
  -t THREADS, --threads THREADS
                        threads number
  --force               force sync all images

Example

Run example:

$ drawio_sync_img -f example/example_multi_pages.drawio -o example/img/

• images should be saved in example/img/ folder;
• sync information example/.sync.example_multi_pages.yaml should be updated;

References

• drawio commands line: https://j2r2b.github.io/2019/08/06/drawio-cli.html#drawio-from-the-command-line