2021-05-25 02:48:50 +00:00
|
|
|
# IPyDrawio
|
|
|
|
|
2022-01-17 04:40:21 +00:00
|
|
|
> Interactive diagram documents and [widgets] in [JupyterLab], powered by [drawio].
|
2021-05-25 02:48:50 +00:00
|
|
|
|
2021-07-06 13:40:08 +00:00
|
|
|
[drawio]: https://github.com/jgraph/drawio
|
|
|
|
[jupyterlab]: https://github.com/jupyterlab/jupyterlab
|
|
|
|
[widgets]: https://github.com/jupyter-widgets/ipywidgets
|
|
|
|
|
|
|
|
---
|
2021-05-25 02:48:50 +00:00
|
|
|
|
|
|
|
## Get Started
|
|
|
|
|
2022-01-17 04:40:21 +00:00
|
|
|
Install `ipydrawio` (and optionally `ipydrawio-export`) with `pip`, `mamba`, or `conda`:
|
2021-05-25 02:48:50 +00:00
|
|
|
|
|
|
|
```bash
|
2021-07-06 13:40:08 +00:00
|
|
|
pip install ipydrawio[all]
|
2023-04-09 16:46:27 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
or...
|
|
|
|
|
|
|
|
```bash
|
2022-08-31 13:06:41 +00:00
|
|
|
mamba install -c conda-forge ipydrawio # ipydrawio-export
|
2023-04-09 16:46:27 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
or...
|
|
|
|
|
|
|
|
```bash
|
2022-08-31 13:06:41 +00:00
|
|
|
conda install -c conda-forge ipydrawio # ipydrawio-export
|
2021-05-25 02:48:50 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Start JupyterLab and [start making diagrams](./diagrams/index.md)!
|
|
|
|
|
2021-07-06 13:40:08 +00:00
|
|
|
---
|
|
|
|
|
2022-01-19 22:32:13 +00:00
|
|
|
## Try it Now
|
|
|
|
|
|
|
|
```{warning}
|
|
|
|
The in-browser demo has some <strong>pointy edges</strong>...
|
|
|
|
<ul>
|
|
|
|
<li>
|
2022-08-31 13:06:41 +00:00
|
|
|
<code>jupyterlite</code> is <em>beta</em> software, and evolving quickly
|
2022-01-19 22:32:13 +00:00
|
|
|
</li>
|
|
|
|
<li>
|
|
|
|
<strong>Don't</strong> use the demo site for important work
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
```
|
|
|
|
|
|
|
|
Click the _Try IPyDrawio Now_ button to launch a new browser tab running IPyDrawio in
|
|
|
|
JupyterLite. It contains all of the example _Diagrams_ from this documentation site, and
|
|
|
|
some notebooks that show what's posssible.
|
|
|
|
|
|
|
|
---
|
|
|
|
|
2021-07-06 13:40:08 +00:00
|
|
|
## Features
|
|
|
|
|
|
|
|
[![What is IPyDrawio?][poster]][poster]
|
|
|
|
|
|
|
|
[poster]: ./Poster.dio.svg
|
|
|
|
|
|
|
|
## More Screenshots and Examples
|
|
|
|
|
2023-04-09 16:46:27 +00:00
|
|
|
> these are editable SVG files made with IPyDrawio, and can be found in the demo.
|
2021-07-06 13:40:08 +00:00
|
|
|
|
|
|
|
### What can you draw with IPyDrawio
|
|
|
|
|
2021-05-25 02:48:50 +00:00
|
|
|
[![What can you draw with IPyDrawio?][what-can-you-draw]][what-can-you-draw]
|
|
|
|
|
|
|
|
[what-can-you-draw]: ./_static/what-can-you-draw.dio.svg
|
|
|
|
|
2021-07-06 13:40:08 +00:00
|
|
|
---
|
|
|
|
|
2021-05-25 02:48:50 +00:00
|
|
|
## Learn More
|
|
|
|
|
|
|
|
```{toctree}
|
|
|
|
:maxdepth: 2
|
|
|
|
diagrams/index
|
2021-06-03 11:19:51 +00:00
|
|
|
tutorials/index
|
2021-05-25 02:48:50 +00:00
|
|
|
about/index
|
|
|
|
api/index
|
|
|
|
about/contributing
|
|
|
|
```
|
|
|
|
|
|
|
|
<!--
|
2023-04-09 16:46:27 +00:00
|
|
|
# Copyright 2023 ipydrawio contributors
|
2021-05-25 02:48:50 +00:00
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
# See the License for the specific language governing permissions and
|
|
|
|
# limitations under the License.
|
|
|
|
-->
|