Latest revision as of 01:44, 19 April 2015

Default installation

The first step is to install the Haskell Platform, if you don't already have it. Then it should be enough to simply run

 cabal install diagrams

By default this will give you diagrams-core (core data structures), diagrams-lib (standard library), diagrams-contrib (user-contributed modules), and diagrams-svg (native Haskell backend outputting SVG files).

The diagrams-rasterific backend is also fully-featured and can output various raster formats; if you run

 cabal install -frasterific diagrams

it will be installed as well.

There are also some very old installation instructions for the cairo backend; YMMV.

@@ Line 1: / Line 1: @@
-The first step is to install the [http://haskell.org/platform Haskell Platform], if you don't already have it.  You will also need to have gtk and cairo (along with development headers) installed through your operating system. After that, it should ''ideally'' be enough to run
+= Default installation =
-  cabal install gtk2hs-buildtools diagrams
+The first step is to install the [http://haskell.org/platform Haskell Platform], if you don't already have it. Then it should be enough to simply run
-This will probably work under Linux/Unix but some workarounds may currently be required on Windows or Mac OS X; see below.  Please edit this page to add information about any problems you encounter, workarounds you discover, etc.
+  cabal install diagrams
-== Installing on Linux/Unix ==
+By default this will give you <code>diagrams-core</code> (core data structures), <code>diagrams-lib</code> (standard library), <code>diagrams-contrib</code> (user-contributed modules), and <code>diagrams-svg</code> (native Haskell backend outputting SVG files).
-As far as we know there are currently no issues installing diagrams on Linux/Unix systems.
+The <code>diagrams-rasterific</code> backend is also fully-featured and can output various raster formats; if you run
-== Installing on Windows ==
+  cabal install -frasterific diagrams
-Cairo can unfortunately be difficult to install on Windows.
+it will be installed as well.
-[http://jystic.com/2010/10/20/installing-gtk2hs-on-windows/ Here are instructions] for installing gtk2hs on Windows.  They work with the exception of the [http://hackage.haskell.org/trac/gtk2hs/ticket/1203 issue described here], which can be circumvented by passing the --global option to 'cabal install cairo' (if you don't mind installing cairo in the global package database).
+There are also some [[/Install-cairo|very old installation instructions for the cairo backend]]; YMMV.
-[http://www.haskell.org/pipermail/haskell-cafe/2011-May/091656.html Here is a discussion] about the most recent difficulties.
-== Installing on Mac OS X ==
-Here are [https://gist.github.com/1655271 instructions for getting gtk installed under OS X Lion with GHC 7.2].  They should also work for 7.4.
-Here is [https://groups.google.com/forum/?fromgroups#!topic/diagrams-discuss/csjDgbYdzcg more discussion about installation under OS X Lion].