BlogLiterately-diagrams: Include images in blog posts with inline diagrams code
A plugin for BlogLiterately
(http://hackage.haskell.org/package/BlogLiterately) which turns inline diagrams
code into images.
This library also provides an executable,
BlogLiteratelyD
, providing a standard instance
of BlogLiterately
extended with support for
inline diagrams code. For most users it
should suffice to simply use BlogLiteratelyD
in
place of BlogLiterately
.
To use it, include code blocks with the dia
or
dia-def
class (using pandoc's special extended
Markdown syntax
(http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markdown.html),
or BlogLiterately's extended syntax for tagged
code blocks
(http://byorgey.wordpress.com/blogliterately/)),
like so:
[dia-def] -- This block produces no output but its -- declarations will be in scope in all the -- rest of the diagram blocks. gSq = square 1 # fc green NOTE: Square brackets below should be replaced by curly braces. Haddock chokes on curly braces. Here is a green square: ```[.dia width='200'] dia = gSq ``` Green squares like `gSq`[.dia height='16'] and blue circles like `circle 1 # fc blue`[.dia height='16'] are extremely important.
Note that attributes like width and height can also be specified, but be sure to put the numbers in quotes or else they will not parse properly.
Running this through BlogLiteratelyD
(after
replacing square brackets with curly braces)
should result in HTML that looks something like
this:
Downloads
- BlogLiterately-diagrams-0.1.2.2.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
Versions [RSS] | 0.1.0.0, 0.1.0.1, 0.1.1, 0.1.1.1, 0.1.1.2, 0.1.2, 0.1.2.1, 0.1.2.2, 0.1.2.3, 0.1.2.4, 0.1.3, 0.1.3.1, 0.1.4, 0.1.4.1, 0.1.4.2, 0.1.4.3, 0.2, 0.2.0.1, 0.2.0.2, 0.2.0.3, 0.2.0.4, 0.2.0.5, 0.2.0.6, 0.2.1, 0.3, 0.3.1 |
---|---|
Change log | CHANGES |
Dependencies | base (>=4.3 && <4.7), BlogLiterately (>=0.6 && <0.7), BlogLiterately-diagrams, containers, diagrams-builder (>=0.2 && <0.5), diagrams-cairo (>=0.6 && <0.8), diagrams-lib (>=0.6 && <0.8), directory, filepath, pandoc (>=1.9 && <1.12), safe (>=0.3 && <0.4) [details] |
License | BSD-3-Clause |
Copyright | Copyright 2012 Brent Yorgey |
Author | Brent Yorgey |
Maintainer | byorgey@cis.upenn.edu |
Category | Web |
Bug tracker | http://hub.darcs.net/byorgey/BlogLiterately-diagrams/issues |
Source repo | head: git clone git://github.com/byorgey/BlogLiterately-diagrams.git |
Uploaded | by BrentYorgey at 2013-08-29T20:41:23Z |
Distributions | |
Reverse Dependencies | 1 direct, 0 indirect [details] |
Executables | BlogLiteratelyD |
Downloads | 21519 total (42 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] |