devoutdrawio

KO | EN

gitlite — search

#javascript #python #hacktoberfest #llm #machine-learning #deep-learning #linux #docker #macos #nodejs #cli #pytorch #mcp #openai

(★ 14)

R graphics device to output to draw.io XML vector format

devoutdrawio Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# devoutdrawio <img src="man/figures/logo.png" align="right" height=230/>

![](https://img.shields.io/badge/cool-useless-green.svg)
![](http://img.shields.io/badge/dev-out-blue.svg)

`drawio` is an open source web and desktop application for creating and
editing structured diagrams.

`devoutdrawio` is a new graphics output device for R which will output
graphics in the drawio XML format suitable for editing in
[drawio](http://draw.io).

#### Why drawio?

`drawio` allows you to quickly edit structured documents online for
free. By outputting in a format suitable for drawio, you can output
graphics from R and then manually edit individual elements, lines and
polygons to suite your needs.

## Installation

You can install from
[GitHub](https://github.com/coolbutuseless/devoutdrawio) with:

``` r
# install.packages("remotes")
remotes::install_github("coolbutuseless/devout")       # devout framework
remotes::install_github("coolbutuseless/minixml")      # xml creator
remotes::install_github("coolbutuseless/minidrawio")   # draw.io doc creator
remotes::install_github("coolbutuseless/devoutdrawio") # this device
```

#### Limitations

- No current support for clipping paths or rasters.
  - Text positioning and spacing is still a little off
  - Rotated text (except for 0 and 90 degrees) is probably going to be
    placed incorrectly.
  - No code has been written to handle changes to the font family so
    you’re stuck with helvetica for now.

# Basic Usage

Use `devoutdrawio::drawio` as you would the `pdf()` or `png()` device.

The output will be written to an XML file in the draw.io format.

You can then load this into the [draw.io web app](draw.io).

``` r
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# PNG output of plot
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
p <- ggplot(mtcars) +
    geom_density(aes(mpg, fill = as.factor(cyl)), colour = NA) +
    theme_bw() +
    labs(title = "Hello #RStats", subtitle = "{devoutdrawio} - draw.io graphics device")
  print(p)
```

``` r
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# Save to drawio XML format
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
drawio("man/figures/mtcars.xml")
print(p)
invisible(dev.off())
```

# Examples: click to view and edit on draw.io

Click on an image to take you to a draw.io preview page. At the bottom
of that page, click on the pencil icon to edit the image in the draw.io
web app.

The XML draw.io plots can be downloaded from here:
[1](man/figures/mtcars.xml), [2](man/figures/mtcars2.xml),
[3](man/figures/ggraph-simple.xml), [4](man/figures/geom-sf.xml)

</div>

</div>

</div>

</div>

# Editing in drawio - moving, adding text, changing colours

Rather than outputting a plot as an array of pixels, the `devoutdrawio`
device outputs the plot as a collection of geometric elements.

These elements can then be manipulated, resized, deleted or altered, all
from within the `drawio` web interface.

``` r
knitr::knit_exit()
```

devoutdrawio

devoutdrawio Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

devoutdrawio

devoutdrawio Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README