Package to provide embedded Draw.io diagram editing support in Atom

2022-11-21 Project archived as no longer using Atom due to it being discontinued by GitHub...

Create and edit your draw.io diagrams directly from within the Atom editor.

This is an early release - please feel free to contribute and improve this package.

atom-drawio now creates and edits SVG files directly (by leveraging the draw.io feature of embedding the draw.io document in the image), so you can reference these images from markdown, e.g. README.md on your projects and they should render.

Example Link to SVG

(above cannot be viewed via atom.io website, instead view in github here)

Screenshot

Enjoy :-)

License

The atom-drawio project is released under the MIT License.

Draw.io itself is released by jpgraph under the Apache-2.0 License

Developer Notes

Git Subtree Draw.io repo

Note: Change branch names below as appropriate - update here for reference.

Add subtree

git subtree add --prefix drawio https://github.com/gbevan/drawio.git D20180402_support_atom --squash

Pull subtree

git subtree pull --prefix drawio https://github.com/gbevan/drawio.git D20180402_support_atom --squash

Prepare clone for pushing to drawio fork

git remote add gbevan-drawio git@github.com:gbevan/drawio.git

Get diff of subtree against remote branch

cd drawio
git diff-tree -r --name-status gbevan-drawio/D20180402_support_atom
837953b034d80c38b0f428f2cffffef449441718
M	src/main/webapp/cache.manifest
M	src/main/webapp/js/app.min.js
M	src/main/webapp/js/viewer.min.js

This still reports changes even after the push to the subtree remote. Found this discussion - progit/progit2#571

git diff-tree -r --name-status HEAD:drawio/ gbevan-drawio/D20180402_support_atom

(changes must have been committed) TODO: further testing needed of this above.

Push subtree to fork

To push changes back to the subtree fork:

git subtree push --prefix drawio gbevan-drawio D20180402_support_atom

and raise pull requests against the upstream repo as needed.

Prepare Build

npm run-script build

This prepares the drawio build by running ant all in drawio/etc/build - this the *.min.js files for drawio.

Test Locally

apm link

links the local clone to Atom for testing, prior to release.

Release to Atom

# for a patch release
apm publish patch

# for a minor release
apm publish minor

# for a major release
apm publish major