Difference between revisions of "Diagrams/Install"

From HaskellWiki
Jump to navigation Jump to search
(→‎Installing on Mac OS X: add link to ML discussion re: OS X Lion)
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
  +
= Default installation =
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
 
   
 
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
cabal install gtk2hs-buildtools diagrams
 
   
  +
cabal install diagrams
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.
 
   
  +
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).
== Installing on Linux/Unix ==
 
   
  +
The <code>diagrams-rasterific</code> backend is also fully-featured and can output various raster formats; if you run
As far as we know there are currently no issues installing diagrams on Linux/Unix systems.
 
   
 
cabal install -frasterific diagrams
== Installing on Windows ==
 
   
  +
it will be installed as well.
Cairo can unfortunately be difficult to install on Windows.
 
   
  +
There are also some [[/Install-cairo|very old installation instructions for the cairo backend]]; YMMV.
[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).
 
 
[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].
 

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.