diagrams-builder: hint-based build service for the diagrams graphics EDSL.
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 and SVG
backends are included (more executables specific
to other backends may be included in the future).
Both take an input file and an expression to
render, and outputs an image file. If you want
these executables you must explicitly enable the
-fcairo and/or -fsvg 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. 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.
[Skip to Readme]
Flags
Manual Flags
| Name | Description | Default |
|---|---|---|
| cairo | install cairo-specific builder tool | Disabled |
| svg | install svg-specific builder tool | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- diagrams-builder-0.2.1.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
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), base16-bytestring (>=0.1.1 && <0.2), bytestring (>=0.9.2 && <0.11), cmdargs (>=0.6 && <0.11), cryptohash (>=0.7.4 && <0.9), diagrams-lib (>=0.6 && <0.7), directory, filepath, haskell-src-exts (>=1.13.1 && <1.14), hint (>=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 |
| Uploaded | by BrentYorgey at 2012-12-12T02:52:35Z |
| 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 |
| Distributions | LTSHaskell:0.8.0.6, Stackage:0.8.0.6 |
| Reverse Dependencies | 4 direct, 0 indirect [details] |
| Executables | diagrams-builder-svg, diagrams-builder-cairo |
| Downloads | 41454 total (150 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs uploaded by user Build status unknown [no reports yet] |
Readme for diagrams-builder-0.2.1.0
[back to package description]
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.