/ html /
html/Installation.html
1 <html>
2 <head>
3 <title>INblobs editor</title>
4 <meta name="keywords" content="IN, Interaction Nets, editor, INblobs" />
5 <meta name="description" content="Free Interaction Nets editor." />
6 </head>
7
8 <body>
9
10 <p/>
11 <center>
12 <a href="#warnings">Warnings/Restrictions</a><br />
13 <a href="#windows">Windows</a><br />
14 <a href="#macOsX">MacOsX</a><br />
15 <a href="#linux">Linux</a><br />
16 </center>
17 <p/>
18
19
20
21
22
23 <h2><a name="warnings">Warnings/Restrictions</a></h2>
24 <ul>
25 <li> HaXml >= 1.17 only compiles with GHC >= 6.6
26 <li> to compile HaXml or INblobs using Cabal (i.e. <code>runhaskell Setup.hs OPTION</code>) you need at least Cabal 1.1.4 (with GHC >= 6.4.2 this requirement is automatically satisfied)
27 <li> you can obtain the latest version of HaXml, wxHaskell or INblobs picking it up from the respective repositories with <code>darcs get URL_TO_REPOSITORY</code>. Alternatively download tarball releases.
28 <li> for wxHaskell is recommended to download the repository version; actual package versions are really out of date.
29 <li> This gives the usual equivalences between Cabal commands and typical <code>make</code>.
30 <table>
31 <head><th>without Cabal</th><th>with Cabal</th></head>
32 <tr><td><code>./configure</code></td><td><code>runhaskell Setup.hs configure</code></td></tr>
33 <tr><td><code>make</code></td><td><code>runhaskell Setup.hs build</code></td></tr>
34 <tr><td><code>make install</code></td><td><code>runhaskell Setup.hs install</code></td></tr>
35 <tr><td><code>make doc</code></td><td><code>runhaskell Setup.hs haddock</code></td></tr>
36 </table>
37 </ul>
38
39 <h2><a name="windows">Windows</a></h2>
40 It compiles at least with the following versions:
41 <ol>
42 <li>Download <a href="http://www.haskell.org/ghc/dist/6.4/ghc-6-4-bld2.msi">GHC 6.4</a>
43 <li>Download <a href="ftp://ftp.cs.york.ac.uk/pub/haskell/HaXml/HaXml-1.19.1.zip">HaXml 1.19</a>
44 <br/>Install with <code>HaXml-1.19\Build.bat</code> editing this file as needed.
45 <li>Download <a href="http://prdownloads.sourceforge.net/wxhaskell/wxhaskell-bin-msw2.4.2-ghc6.4-0.9.4-1.zip?download">wxHaskell 0.9.4</a>
46 <br/>Install with <code>wxhaskell-0.9.4\bin\wxhaskell-register.bat</code>
47 <li>Download <a href="http://haskell.di.uminho.pt/jmvilaca/INblobs/INblobs.tar.gz">INblobs</a>
48 <br/>Compile with <code>INblobs\startghc.bat</code>
49 </ol>
50
51 <h2><a name="macOsX">MacOsX</a></h2>
52
53 <ol>
54 <li> Install GHC 6.4 (ensure that is 6.4 and not 6.4.X) (<a href="http://www.haskell.org/ghc/dist/6.4/MacOSX/GHC-6.4.pkg.zip">download here</a>)</li>
55 <li> Install wxHaskell for Mac (<a href="http://prdownloads.sourceforge.net/wxhaskell/wxhaskell-bin-mac2.5.4-ghc6.4-0.9.4-0.dmg?download">download here</a>)</li>
56 <li> Download <a href="ftp://ftp.cs.york.ac.uk/pub/haskell/HaXml/HaXml-1.19.1.tar.gz">HaXml 1.19</a>
57 <br/><code>./configure<br/>
58 make<br/>
59 make install
60 </code>
61 <li> Download <a href="http://haskell.di.uminho.pt/jmvilaca/INblobs/INblobs.tar.gz">INblobs</a>
62 <br/>Edit <code>Makefile</code>
63 <br/><code>make</code>
64 </ol>
65
66 <h2><a name="linux">Linux</a></h2>
67 <h3>Ubuntu Feisty</h3>
68 The following script is available (<a href="../scriptINblobs">scriptINblobs</a>).
69 <ol>
70 <li>Ensure the universe repository of Ubuntu is enabled:
71 <br/><code>sudo vi /etc/apt/sources.list</code>
72 <br/>and uncomment the universe repository lines:
73 <br/><code> # deb http://archive.ubuntu.com/ubuntu feisty universe<br/>
74 # deb-src http://archive.ubuntu.com/ubuntu feisty universe
75 </code>
76 <br/> Then
77 <br/><code>sudo apt-get update</code>
78
79 <li> install GHC and darcs
80 <br/><code>
81 sudo apt-get install ghc6<br/>
82 sudo apt-get install darcs
83 </code>
84
85 <li> install HaXml
86 <br/><code>
87 darcs get http://www.cs.york.ac.uk/fp/darcs/polyparse<br/>
88 cd polyparse<br/>
89 runhaskell Setup.hs configure<br/>
90 runhaskell Setup.hs build<br/>
91 sudo runhaskell Setup.hs install<br/>
92 cd ..<br/>
93 <br/>
94 darcs get http://www.cs.york.ac.uk/fp/darcs/HaXml<br/>
95 cd HaXml<br/>
96 runhaskell Setup.hs configure<br/>
97 runhaskell Setup.hs build</code> (this operation take some time)<br/><code>
98 sudo runhaskell Setup.hs install<br/>
99 cd ..
100 </code>
101
102 <li>install WxWidgets 2.6
103 <br/><code>
104 sudo apt-get install libwxgtk2.6-dev<br/>
105 sudo apt-get install freeglut3-dev<br/>
106 sudo apt-get install g++
107 </code>
108
109 <li>install wxHaskell
110 <br/><code>
111 sudo apt-get install libghc6-time-dev<br/>
112 darcs get http://darcs.haskell.org/wxhaskell<br/>
113 cd wxhaskell<br/>
114 chmod u+x configure<br/>
115 ./configure --with-opengl<br/>
116 make<br/>
117 sudo make install<br/>
118 make wx<br/>
119 sudo make wx-install<br/>
120 cd ..
121 </code>
122
123 <li> compile INblobs
124 <br/><code>
125 darcs get http://haskell.di.uminho.pt/jmvilaca/INblobs<br/>
126 cd INblobs<br/>
127 runhaskell Setup.hs configure<br/>
128 runhaskell Setup.hs build</code> (this operation take some time)
129
130 <li> run INblobs
131 <br/><code>./dist/build/INblobs/INblobs</code>
132 <br/>On this moment you should see the application.
133 <li>Go to <a href="HowToUse.html">How To Use INblobs</a>
134
135 <h3>Any distribution</h3>
136
137 <ol>
138 <li> You need GHC 6.6 at least. There are binaries to several platforms at <a href="http://haskell.org/ghc/">GHC web page</a>. Install it and put it available in path.
139 <li> Download the necessary things
140 <ul>
141 <li> <a href="http://www.cs.york.ac.uk/fp/HaXml-1.14/HaXml-1.19.1.tar.gz">HaXml 1.19</a>
142 <li> <a href="http://prdownloads.sourceforge.net/wxhaskell/wxhaskell-src-0.9.4-1.zip?download">wxHaskell 0.9.4-1</a>
143 <li> <a href="http://prdownloads.sourceforge.net/wxwindows/wxGTK-2.6.2.tar.gz">wxWidgets 2.6.2</a>
144 <li> <a href="http://haskell.di.uminho.pt/jmvilaca/INblobs/INblobs.tar.gz">INblobs</a>
145 </ul>
146
147 <li> Supposing you are in the folder with all the downloaded files, unpack the files:<br/>
148 <li> Install HaXml
149 <ol>
150 <li>
151 <code>
152 ./configure<br/>
153 make
154 </code>
155 <li> Then as root run<br/>
156 <code>make install</code>
157 <li> run <code>ghci -package HaXml</code> to test.
158 </ol>
159 <li> Install wxGTK
160 <ol>
161 <li> create a new directory for build, inside the wxGTK directory
162 <li> run <br/>
163 <code>
164 ../configure --disable-shared --with-opengl --enable-sound --with-gtk --enable-gtk2 --disable-unicode<br/>
165 make
166 </code>
167 <li> Then as root run<br/>
168 <code>make install</code>
169 <li> Test wxGTK installation
170 <ul> <li> run <code> wx-config --version</code> </ul>
171 </ol>
172 <li> Install wxHaskell
173 <ol>
174 <li> run <code>./configure --help</code> to see if everything is correct
175 <li>
176 <code>
177 ./configure --with-opengl<br/>
178 make
179 </code>
180 <li> Then as root run<br/>
181 <code>make install<br/>
182 make doc</code>
183 <li> Test it running <code>ghci -package wx</code>
184 </ol>
185 <li> compile INblobs<br/>
186 <code>make</code><br/>
187 <li> Finally run INblobs
188 <ul> <li> run <code>./INblobs</code> </ul>
189 </ol>
190
191 <p/>
192 If you prefer the whole bundle of commands...<br/>
193 <code>
194 tar xzvf HaXml-1.19.1.tar.gz<br/>
195 tar xzvf wxGTK-2.6.2.tar.gz<br/>
196 unzip wxhaskell-src-0.9.4-1.zip<br/>
197 tar xzvf INblobs.tar.gz<br/>
198 cd HaXml-1.19.1<br/>
199 ./configure<br/>
200 make<br/>
201 sudo make install<br/>
202 cd ..<br/>
203 cd wxGTK-2.6.2
204 mkdir mybuild<br/>
205 cd mybuild<br/>
206 ../configure --disable-shared --with-opengl --enable-sound --with-gtk --enable-gtk2 --disable-unicode<br/>
207 make<br/>
208 sudo make install<br/>
209 cd ../..<br/>
210 wx-config --version<br/>
211 cd wxhaskell-0.9.4<br/>
212 ./configure --help<br/>
213 ./configure --with-opengl<br/>
214 make<br/>
215 sudo make install<br/>
216 sudo make doc<br/>
217 ghci -package wx<br/>
218 cd ..<br/>
219 cd INblobs<br/>
220 make<br/>
221 ./INblobs<br/>
222 </code>
223
224 <a href="../index.html">back to main page</a>
225 </body>
226 </html>