diagrams-builder: hint-based build service for the diagrams graphics EDSL.

[ bsd3, graphics, library ] [ Propose Tags ] [ Report a vulnerability ]

diagrams-builder provides backend-agnostic tools for dynamically turning code into rendered diagrams, using the hint wrapper to the GHC API. It supports conditional recompilation using hashing of diagrams source code, to avoid recompiling code that has not changed. It is useful for creating tools which compile diagrams code embedded in other documents. For example, it is used by the BlogLiterately-diagrams package (a plugin for BlogLiterately) to compile diagrams embedded in Markdown-formatted blog posts.

Executables specific to the cairo, SVG, and postscript backends are included (more executables specific to other backends may be included in the future). All take an input file and an expression to render, and output an image file. If you want these executables you must explicitly enable the -fcairo, -fsvg, or -fps flags.

A LaTeX package, diagrams-latex.sty, is also provided in the latex/ directory of the source distribution, which renders diagrams code found within diagram environments. Note that diagrams-latex.sty is licensed under the GPL.


[Skip to Readme]

Flags

Manual Flags

NameDescriptionDefault
cairo

install cairo-specific builder tool

Disabled
svg

install svg-specific builder tool

Disabled
ps

install postscript-specific builder tool

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.2.0.0, 0.2.1.0, 0.3, 0.3.0.1, 0.4, 0.4.0.1, 0.4.0.2, 0.4.0.3, 0.4.0.4, 0.4.0.5, 0.4.0.6, 0.4.1, 0.4.2, 0.5, 0.5.0.1, 0.5.0.2, 0.5.0.3, 0.5.0.4, 0.5.0.5, 0.5.0.6, 0.5.0.7, 0.5.0.8, 0.5.0.9, 0.5.0.10, 0.5.0.11, 0.6, 0.6.0.1, 0.6.0.2, 0.6.0.3, 0.6.0.4, 0.7.0.0, 0.7.0.1, 0.7.0.2, 0.7.0.3, 0.7.0.4, 0.7.1, 0.7.1.1, 0.7.2.0, 0.7.2.1, 0.7.2.2, 0.7.2.3, 0.7.2.4, 0.8, 0.8.0.1, 0.8.0.2, 0.8.0.3, 0.8.0.4, 0.8.0.5, 0.8.0.6 (info)
Change log CHANGES.markdown
Dependencies base (>=4.2 && <4.7), cmdargs (>=0.6 && <0.11), diagrams-lib (>=0.6 && <1.2), directory, filepath, hashable (>=1.1 && <1.3), haskell-src-exts (>=1.14 && <1.15), hint (>=0.3 && <0.4), lens (>=3.9 && <4.1), mtl (>=2.1 && <2.2), split (>=0.2 && <0.3), transformers (>=0.3 && <0.4) [details]
Tested with ghc ==7.4.2, ghc ==7.6.1
License BSD-3-Clause
Author Brent Yorgey
Maintainer diagrams-discuss@googlegroups.com
Category Graphics
Home page http://projects.haskell.org/diagrams
Bug tracker https://github.com/diagrams/diagrams-builder/issues
Source repo head: git clone https://github.com/diagrams/diagrams-builder
Uploaded by BrentYorgey at 2014-03-06T14:37:07Z
Distributions LTSHaskell:0.8.0.6, NixOS:0.8.0.6, Stackage:0.8.0.6
Reverse Dependencies 4 direct, 0 indirect [details]
Executables diagrams-builder-ps, diagrams-builder-svg, diagrams-builder-cairo
Downloads 39824 total (146 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user [build log]
All reported builds failed [all 1 reports]

Readme for diagrams-builder-0.5.0.2

[back to package description]

Build Status

diagrams-builder provides backend-agnostic tools for dynamically turning code into rendered diagrams, using the hint wrapper to the GHC API. It supports conditional recompilation using hashing of diagrams source code, to avoid recompiling code that has not changed. It is useful for creating tools which compile diagrams code embedded in other documents. For example, it is used by the BlogLiterately-diagrams package (a plugin for BlogLiterately) to compile diagrams embedded in Markdown-formatted blog posts.

An executable specific to the cairo backend is included (more executables specific to other backends will be included in the future). It takes an input file and an expression to render and outputs an image file, using the cairo backend. If you want it you must explicitly enable the cairo flag with -fcairo.

A LaTeX package, diagrams-latex.sty, is also provided in the latex/ directory of the source distribution, which renders diagrams code found within diagram environments. It makes use of the diagrams-builder-cairo executable, so if you want to use diagrams-latex.sty you should install diagrams-builder with the -fcairo option. Note that diagrams-latex.sty is licensed under the GPL.