name: BlogLiterately-diagrams
version: 0.1.2
synopsis: Include images in blog posts with inline diagrams code
description: 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:
.
<<http://projects.haskell.org/diagrams/hosted/BLD-post-result.png>>
license: BSD3
license-file: LICENSE
extra-source-files: CHANGES
author: Brent Yorgey
maintainer: byorgey@cis.upenn.edu
bug-reports: http://hub.darcs.net/byorgey/BlogLiterately-diagrams/issues
copyright: Copyright 2012 Brent Yorgey
category: Web
build-type: Simple
cabal-version: >=1.10
source-repository head
type: darcs
location: http://hub.darcs.net/byorgey/BlogLiterately-diagrams
library
default-language: Haskell2010
exposed-modules: Text.BlogLiterately.Diagrams
build-depends: base >= 4.3 && < 4.7,
containers,
filepath,
directory,
diagrams-cairo >= 0.6 && < 0.7,
diagrams-builder >= 0.2 && < 0.5,
diagrams-lib >= 0.6 && < 0.7,
BlogLiterately ==0.6.*,
pandoc >= 1.9 && < 1.12,
safe ==0.3.*
hs-source-dirs: src
executable BlogLiteratelyD
build-depends: base,
BlogLiterately >= 0.6 && < 0.7,
BlogLiterately-diagrams
main-is: BlogLiteratelyD.hs
hs-source-dirs: src/tools
default-language: Haskell2010