https://github.com/rlespinasse/drawio-export

Export Draw.io diagrams using docker
https://github.com/rlespinasse/drawio-export

docker drawio drawio-batch drawio-tools hacktoberfest

Last synced: 4 days ago
JSON representation

Export Draw.io diagrams using docker

• Host: GitHub
• URL: https://github.com/rlespinasse/drawio-export
• Owner: rlespinasse
• License: mit
• Created: 2020-04-05T18:27:36.000Z (almost 5 years ago)
• Default Branch: v4.x
• Last Pushed: 2024-12-10T15:35:29.000Z (26 days ago)
• Last Synced: 2024-12-24T20:07:30.859Z (12 days ago)
• Topics: docker, drawio, drawio-batch, drawio-tools, hacktoberfest
• Language: Shell
• Homepage: https://hub.docker.com/r/rlespinasse/drawio-export
• Size: 272 KB
• Stars: 66
• Watchers: 3
• Forks: 10
• Open Issues: 5
• Metadata Files:
  • Readme: README.adoc
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
= Draw.io Export

Export Draw.io diagrams using docker

== Features

* Recursive export

* Partial export (newer, or based on git reference)

* Additional export formats with link extraction

== Supported Export formats

* **draw.io** export formats : jpg, pdf, png, svg, vsdx, and xml

* **drawio-exporter** additional formats

** adoc - Export in png and create an additional asciidoc file (with support external links).

** md - Export in png and create an additional markdown file (with support external links).

== Additional fonts

Check installed fonts list from https://github.com/rlespinasse/docker-drawio-desktop-headless[drawio-desktop-headless] docker base image.

NOTE: Want a new font package, modify the https://github.com/rlespinasse/docker-drawio-desktop-headless[drawio-desktop-headless] project.

== Installation

[source,bash]

----

docker pull rlespinasse/drawio-export

----

== Usage

.Print the available options

[source,bash]

----

docker run -it rlespinasse/drawio-export --help

----

.Simple run with default options

[source,bash]

----

$ cd directory-with-drawio-files

$ docker run -it -v $(pwd):/data rlespinasse/drawio-export

+ export file : ./file1.drawio

++ export page 1 : Page-1

+++ generate pdf file

++ export page 2 : Page 2

+++ generate pdf file

----

== Build on top of

* https://github.com/rlespinasse/docker-drawio-desktop-headless[**rlespinasse/drawio-export-headless**] as base docker image to use Draw.io Desktop for its command lines,

* https://github.com/rlespinasse/drawio-exporter[**drawio-exporter**] as backend for export capabilities.

== Used by

* GitHub Action https://github.com/rlespinasse/drawio-export-action[**drawio-export-action**] : which is build on top of **drawio-export** docker image.

== Contributing

Pull requests are welcome.

For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.