* best ways to generate simple diagrams?
@ 2019-05-06 18:17 Matt Price
2019-05-06 19:12 ` ckelty ckelty
` (3 more replies)
0 siblings, 4 replies; 10+ messages in thread
From: Matt Price @ 2019-05-06 18:17 UTC (permalink / raw)
To: Org Mode
[-- Attachment #1.1: Type: text/plain, Size: 918 bytes --]
So, I'm finding more and more that I want to include simple diagrams in my
course materials. At present I am generating them as svg's using Inkscape,
but that feels really tiresome to me. I would much rather make them
programmatically, preferably including the source code as an org-mode block.
I thought ditaa would be the tool for this, but I cannot figure out how to
do this work efficiently in ditaa. So for instance, I have this simple svg
file (attached). It consists of two text-containing symmetrical rectangles
separated by a bit of whitespace and connected by two curved arrows (one
pointing from each of the rectangles to the other).
Trying to replicate this in ditaa did not prove easy. Editing feels
extremely labourious. Am I missing something? Is there a really good
tutorial somehwere that I'm just not finding? Or is there maybe another
tool I should be using instead?
Thanks as always,
Matt
[-- Attachment #1.2: Type: text/html, Size: 1105 bytes --]
[-- Attachment #2: hum-cs-interface.svg --]
[-- Type: image/svg+xml, Size: 7946 bytes --]
^ permalink raw reply [flat|nested] 10+ messages in thread* Re: best ways to generate simple diagrams? 2019-05-06 18:17 best ways to generate simple diagrams? Matt Price @ 2019-05-06 19:12 ` ckelty ckelty 2019-05-06 20:08 ` Heinz Tuechler ` (2 subsequent siblings) 3 siblings, 0 replies; 10+ messages in thread From: ckelty ckelty @ 2019-05-06 19:12 UTC (permalink / raw) To: emacs-orgmode Matt, Did you already decide against graphviz? Admittedly it is only graphs and not "diagrams"... but it's very powerful and there is art in using a simple tool to make your life complex :) #+BEGIN_SRC dot :file test-dot.png :exports results digraph D { Humanities -> {"Computing Tools and Methodologies"} {"Computing Tools and Methodologies"} -> Humanities } #+END_SRC #+RESULTS: [[file:test-dot.png]] ck Matt Price <moptop99@gmail.com> writes: > So, I'm finding more and more that I want to include simple > diagrams in my > course materials. At present I am generating them as svg's using > Inkscape, > but that feels really tiresome to me. I would much rather make > them > programmatically, preferably including the source code as an > org-mode block. > > I thought ditaa would be the tool for this, but I cannot figure > out how to > do this work efficiently in ditaa. So for instance, I have this > simple svg > file (attached). It consists of two text-containing symmetrical > rectangles > separated by a bit of whitespace and connected by two curved > arrows (one > pointing from each of the rectangles to the other). > > Trying to replicate this in ditaa did not prove easy. Editing > feels > extremely labourious. Am I missing something? Is there a > really good > tutorial somehwere that I'm just not finding? Or is there maybe > another > tool I should be using instead? > > Thanks as always, > > Matt ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-06 18:17 best ways to generate simple diagrams? Matt Price 2019-05-06 19:12 ` ckelty ckelty @ 2019-05-06 20:08 ` Heinz Tuechler 2019-05-07 11:25 ` Fraga, Eric 2019-05-08 4:06 ` Marcin Borkowski 3 siblings, 0 replies; 10+ messages in thread From: Heinz Tuechler @ 2019-05-06 20:08 UTC (permalink / raw) To: emacs-orgmode Matt Price wrote/hat geschrieben on/am 06.05.2019 19:17: > So, I'm finding more and more that I want to include simple diagrams in my > course materials. At present I am generating them as svg's using Inkscape, > but that feels really tiresome to me. I would much rather make them > programmatically, preferably including the source code as an org-mode block. > > I thought ditaa would be the tool for this, but I cannot figure out how to > do this work efficiently in ditaa. So for instance, I have this simple svg > file (attached). It consists of two text-containing symmetrical rectangles > separated by a bit of whitespace and connected by two curved arrows (one > pointing from each of the rectangles to the other). > > Trying to replicate this in ditaa did not prove easy. Editing feels > extremely labourious. Am I missing something? Is there a really good > tutorial somehwere that I'm just not finding? Or is there maybe another > tool I should be using instead? > > Thanks as always, > > Matt > Maybe plantuml (http://plantuml.com/en/) is useful, e.g. #+begin_src plantuml :file hum-cs-interface-test.svg skinparam ArrowColor Blue node "Humanities" as H #DeepSkyBlue node "Computing\n Tools and\n Methodologies" as N #DeepSkyBlue N =l=> H H =r=> N #+end_src best regards, Heinz ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-06 18:17 best ways to generate simple diagrams? Matt Price 2019-05-06 19:12 ` ckelty ckelty 2019-05-06 20:08 ` Heinz Tuechler @ 2019-05-07 11:25 ` Fraga, Eric 2019-05-07 17:22 ` Matt Price 2019-05-08 4:06 ` Marcin Borkowski 3 siblings, 1 reply; 10+ messages in thread From: Fraga, Eric @ 2019-05-07 11:25 UTC (permalink / raw) To: Matt Price; +Cc: Org Mode On Monday, 6 May 2019 at 14:17, Matt Price wrote: > So, I'm finding more and more that I want to include simple diagrams in my > course materials. At present I am generating them as svg's using Inkscape, > but that feels really tiresome to me. I would much rather make them > programmatically, preferably including the source code as an org-mode block. You have had recommendations for graphviz (dot etc.) and plantuml already. Those are very good suggestions and I use them all the time. For more general drawings, and given that you want something programmatic, I would also suggest tikz (in LaTeX) as it's very powerful (but then harder to do some simple things that graphiz/plantuml will do very easily). #+begin_export latex \begin{tikzpicture}[node distance=4cm,minimum size=2cm] \node[draw,fill=blue!20!white] (humanities) {Humanities}; \node[draw,fill=blue!20!white] (tools) [right of=humanities] {\parbox{3cm}{Computing \\ Tools and \\ Methodologies}} edge [->,out=270,in=270,very thick,red] (humanities) edge [<-,out=90,in=90,very thick,red] (humanities); \end{tikzpicture} #+end_export -- Eric S Fraga via Emacs 27.0.50, Org release_9.2.3-327-g3375f0 ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-07 11:25 ` Fraga, Eric @ 2019-05-07 17:22 ` Matt Price 2019-05-07 17:52 ` Fraga, Eric 0 siblings, 1 reply; 10+ messages in thread From: Matt Price @ 2019-05-07 17:22 UTC (permalink / raw) Cc: Org Mode [-- Attachment #1: Type: text/plain, Size: 2318 bytes --] These are all great. I am struggling to some extent through the docs for all these tools. Eric, for the most part I'm very happy with graphviz & plantufml but I would be interested in trying latex as well. Since I'm mostly exporting to html and its derivatives (markdown mostly), I don't think epxort blocks work for my purposes. I thought that a latex src block with :exports results would work, but rather than a rendered graph I end up with a .png of the latex instructions themselves. Here's what I am trying: #+begin_src latex :exports results :file latex-dh.png \begin{tikzpicture}[node distance=4cm,minimum size=2cm] \node[draw,fill=blue!20!white] (humanities) {Humanities}; \node[draw,fill=blue!20!white] (tools) [right of=humanities] {\parbox{3cm}{Computing \\ Tools and \\ Methodologies}} edge [->,out=270,in=270,very thick,red] (humanities) edge [<-,out=90,in=90,very thick,red] (humanities); \end{tikzpicture} #+end_src Can you see my error and/or reproduce the issue? Thanks all of you! On Tue, May 7, 2019 at 7:25 AM Fraga, Eric <e.fraga@ucl.ac.uk> wrote: > On Monday, 6 May 2019 at 14:17, Matt Price wrote: > > So, I'm finding more and more that I want to include simple diagrams in > my > > course materials. At present I am generating them as svg's using > Inkscape, > > but that feels really tiresome to me. I would much rather make them > > programmatically, preferably including the source code as an org-mode > block. > > You have had recommendations for graphviz (dot etc.) and plantuml > already. Those are very good suggestions and I use them all the > time. For more general drawings, and given that you want something > programmatic, I would also suggest tikz (in LaTeX) as it's very powerful > (but then harder to do some simple things that graphiz/plantuml will do > very easily). > > #+begin_export latex > \begin{tikzpicture}[node distance=4cm,minimum size=2cm] > \node[draw,fill=blue!20!white] (humanities) {Humanities}; > \node[draw,fill=blue!20!white] (tools) [right of=humanities] > {\parbox{3cm}{Computing \\ Tools and \\ Methodologies}} > edge [->,out=270,in=270,very thick,red] (humanities) > edge [<-,out=90,in=90,very thick,red] (humanities); > \end{tikzpicture} > #+end_export > > -- > Eric S Fraga via Emacs 27.0.50, Org release_9.2.3-327-g3375f0 > [-- Attachment #2: Type: text/html, Size: 2868 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-07 17:22 ` Matt Price @ 2019-05-07 17:52 ` Fraga, Eric 2019-05-07 20:36 ` Matt Price 0 siblings, 1 reply; 10+ messages in thread From: Fraga, Eric @ 2019-05-07 17:52 UTC (permalink / raw) To: Matt Price; +Cc: Org Mode On Tuesday, 7 May 2019 at 13:22, Matt Price wrote: > I thought that a latex src block with :exports results would work, but > rather than a rendered graph I end up with a .png of the latex > instructions themselves. Here's what I am trying: It should work. Try with the following header settings: #+header: :exports results #+header: :results file raw #+header: :file image.png #+header: :fit yes #+begin_src latex \begin{tikzpicture}[node distance=4cm,minimum size=2cm] \node[draw,fill=blue!20!white] (humanities) {Humanities}; \node[draw,fill=blue!20!white] (tools) [right of=humanities] {\parbox{3cm}{Computing \\ Tools and \\ Methodologies}}; \draw[very thick,red] (tools) edge [out=270,in=270,->] (humanities); \end{tikzpicture} #+end_src -- Eric S Fraga via Emacs 27.0.50, Org release_9.2.3-327-g3375f0 ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-07 17:52 ` Fraga, Eric @ 2019-05-07 20:36 ` Matt Price 2019-05-07 20:51 ` Martin Schöön 0 siblings, 1 reply; 10+ messages in thread From: Matt Price @ 2019-05-07 20:36 UTC (permalink / raw) To: Fraga, Eric, Org Mode [-- Attachment #1.1: Type: text/plain, Size: 1074 bytes --] hmm, I still get just the attached image (approx). Presumably osmehting wrong w/ my latex setup (I use latex only very rarely). On Tue, May 7, 2019 at 1:52 PM Fraga, Eric <e.fraga@ucl.ac.uk> wrote: > On Tuesday, 7 May 2019 at 13:22, Matt Price wrote: > > I thought that a latex src block with :exports results would work, but > > rather than a rendered graph I end up with a .png of the latex > > instructions themselves. Here's what I am trying: > > It should work. Try with the following header settings: > > #+header: :exports results > #+header: :results file raw > #+header: :file image.png > #+header: :fit yes > #+begin_src latex > \begin{tikzpicture}[node distance=4cm,minimum size=2cm] > \node[draw,fill=blue!20!white] (humanities) {Humanities}; > \node[draw,fill=blue!20!white] (tools) [right of=humanities] > {\parbox{3cm}{Computing \\ Tools and \\ Methodologies}}; > \draw[very thick,red] (tools) edge [out=270,in=270,->] (humanities); > \end{tikzpicture} > #+end_src > > -- > Eric S Fraga via Emacs 27.0.50, Org release_9.2.3-327-g3375f0 > [-- Attachment #1.2: Type: text/html, Size: 1448 bytes --] [-- Attachment #2: latex-headers.png --] [-- Type: image/png, Size: 22904 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-07 20:36 ` Matt Price @ 2019-05-07 20:51 ` Martin Schöön 2019-05-08 5:47 ` Fraga, Eric 0 siblings, 1 reply; 10+ messages in thread From: Martin Schöön @ 2019-05-07 20:51 UTC (permalink / raw) To: Matt Price; +Cc: Org Mode, Fraga, Eric [-- Attachment #1: Type: text/plain, Size: 84 bytes --] Maybe missing a "\usepackage{tikz}"? (That caught me out) -- Martin Schöön [-- Attachment #2: Type: text/html, Size: 222 bytes --] ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-07 20:51 ` Martin Schöön @ 2019-05-08 5:47 ` Fraga, Eric 0 siblings, 0 replies; 10+ messages in thread From: Fraga, Eric @ 2019-05-08 5:47 UTC (permalink / raw) To: Martin Schöön; +Cc: Org Mode On Tuesday, 7 May 2019 at 22:51, Martin Schöön wrote: > Maybe missing a "\usepackage{tikz}"? > (That caught me out) Ah, that is a very likely reason! I have the following in my emacs initialization for org: (add-to-list 'org-latex-packages-alist '("" "tikz")) (add-to-list 'org-latex-packages-alist '("" "xcolor")) as I use tikz all the time... (so I'd forgotten it's not a default). -- Eric S Fraga via Emacs 27.0.50, Org release_9.2.3-327-g3375f0 ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: best ways to generate simple diagrams? 2019-05-06 18:17 best ways to generate simple diagrams? Matt Price ` (2 preceding siblings ...) 2019-05-07 11:25 ` Fraga, Eric @ 2019-05-08 4:06 ` Marcin Borkowski 3 siblings, 0 replies; 10+ messages in thread From: Marcin Borkowski @ 2019-05-08 4:06 UTC (permalink / raw) To: Matt Price; +Cc: Org Mode On 2019-05-06, at 20:17, Matt Price <moptop99@gmail.com> wrote: > So, I'm finding more and more that I want to include simple diagrams in my > course materials. At present I am generating them as svg's using Inkscape, > but that feels really tiresome to me. I would much rather make them > programmatically, preferably including the source code as an org-mode block. > > I thought ditaa would be the tool for this, but I cannot figure out how to > do this work efficiently in ditaa. So for instance, I have this simple svg > file (attached). It consists of two text-containing symmetrical rectangles > separated by a bit of whitespace and connected by two curved arrows (one > pointing from each of the rectangles to the other). > > Trying to replicate this in ditaa did not prove easy. Editing feels > extremely labourious. Am I missing something? Is there a really good > tutorial somehwere that I'm just not finding? Or is there maybe another > tool I should be using instead? Eric beat me to mentioning TikZ, which I've been using to create all sorts of drawings for the past ten years or so. Another TeX-related tool is METAPOST. TikZ is apparently inspired by it a lot, and it has some very nice features (like solving systems of linear equations given in a declarative style to get intersection points of straight lines - very handy). There is another macro system built on top of it, called METAFUN (https://wiki.contextgarden.net/MetaFun). Since you mentioned exporting to HTML, d3.js came to my mind immediately. I don't have a lot of experience with it, and its main aim is something different, but it's definitely worth knowing about. Last but not least, I guess writing directly in SVG format might or might not be what you want. (I remember ye olden days when they said that XML was something to be written and read by humans... And in some cases this is in fact true!) Hth, -- Marcin Borkowski http://mbork.pl ^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2019-05-08 5:47 UTC | newest] Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2019-05-06 18:17 best ways to generate simple diagrams? Matt Price 2019-05-06 19:12 ` ckelty ckelty 2019-05-06 20:08 ` Heinz Tuechler 2019-05-07 11:25 ` Fraga, Eric 2019-05-07 17:22 ` Matt Price 2019-05-07 17:52 ` Fraga, Eric 2019-05-07 20:36 ` Matt Price 2019-05-07 20:51 ` Martin Schöön 2019-05-08 5:47 ` Fraga, Eric 2019-05-08 4:06 ` Marcin Borkowski
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs/org-mode.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).
![[-- Attachment #2: latex-headers.png --] [-- Type: image/png, Size: 22904 bytes --]](../../CAN_Dec_HNMB8RPAYTuSQBt-+usMAidCm9GfbfQP4BWUwzdMZDw@mail.gmail.com/2-latex-headers.png){kind=link}