FP installation guide - Revision history

Beh01: /* Installation Guide */

2023-09-01T07:52:00Z

Installation Guide

Beh01: /* Installation Guide */

2023-09-01T07:51:39Z

Installation Guide

Beh01: /* Installation Guide */

2023-09-01T07:51:25Z

Installation Guide

Beh01 at 07:50, 1 September 2023

2023-09-01T07:50:46Z

Beh01 at 09:15, 22 September 2021

2021-09-22T09:15:52Z

Beh01 at 14:14, 20 August 2020

2020-08-20T14:14:08Z

Beh01 at 14:07, 20 August 2020

2020-08-20T14:07:55Z

Beh01 at 13:57, 20 August 2020

2020-08-20T13:57:16Z

Beh01: Created page with "=Installation Guide= == VS Code with Haskell plugin == == Haskero with Haskell GHCi debugger == Older variant of working environment. For VS Code, we will be using two e..."

2020-08-20T13:25:52Z

Created page with "=Installation Guide= == VS Code with Haskell plugin == == Haskero with Haskell GHCi debugger == Older variant of working environment. For VS Code, we will be using two e..."

New page

=Installation Guide=

== VS Code with Haskell plugin ==

== Haskero with Haskell GHCi debugger ==

Older variant of working environment.

For VS Code, we will be using two extensions:
*[https://marketplace.visualstudio.com/items?itemName=Vans.haskero Haskero]
*[https://marketplace.visualstudio.com/items?itemName=phoityne.phoityne-vscode Haskell GHCi Debug Adapter Phoityne]

=== Installation guide Windows (single user) ===

# Download and install Haskell platform from [https://www.haskell.org/platform/windows.html https://www.haskell.org/platform/windows.html]
#* Use default paths. Installer adds to system variable <code>PATH</code> a path to executable <code>stack.exe</code>.
# Download and install VS Code [https://code.visualstudio.com/#alt-downloads https://code.visualstudio.com/#alt-downloads]
# Open <code>cmd</code> and type:<pre class="bash">stack install intero phoityne-vscode haskell-dap --system-ghc</pre>
# Open file <code>c:\sr\config.yaml</code> and add a line <pre>system-ghc : true</pre>
#* Attribute <code>--system-ghc</code> is optional and redundant to previous step (it is the same setting, but global).
# Open VS Code and install extensions:
#* Haskero
#* Haskell GHCi Debug Adapter Phoityne

=== Installation guide Windows (all users) ===
This guide assumes, that there is on user, that prepares the development environment for other user.
<ol>
<li>Download and install Haskell platform from [https://www.haskell.org/platform/windows.html https://www.haskell.org/platform/windows.html] </li>
<li>* For <code>stack</code>, use a path accessible to all user (for example <code>c:\stack</code>). Installer adds to user variable <code>PATH</code> a path to executable <code>stack.exe</code>, and adds a new user variable <code>STACK_ROOT</code>. Move these values from user variables to system variables.
</li>
<li>Download and install VS Code [https://code.visualstudio.com/#alt-downloads https://code.visualstudio.com/#alt-downloads]. Use the system installer.</li>
<li>Open <code>cmd</code> and type:<pre class="bash">stack install intero phoityne-vscode haskell-dap --system-ghc</pre>
* It will generate some executable files to default location: <code>c:\Users\ -- YOUR NAME -- \AppData\Roaming\local\bin\</code> move them to the directory with <code>stack.exe</code>.
</li>
<li>Open file <code>c:\sr\config.yaml</code> and add lines:
<pre>
system-ghc : true
skip-msys : true
</pre>
These settings save time and space on disk (it will not install GHC while installing packages and [https://www.msys2.org/ MSYS2] for every user).
</li>
<li> Open VS Code and install extensions:
* Haskero
* Haskell GHCi Debug Adapter Phoityne
</li>
</ol>

=== Installation guide Ubuntu (single users) ===
<ol>
<li>Perform following commands:
<pre class="bash">
sudo apt-get install haskell-platform
sudo apt-get install haskell-stack
sudo snap install code --classic
</pre>
* ''Optional step'' - Right now (August, 2019) Haskell Platform from Ubuntu repositories contains GHC 8.4.4. Stack current default resolver is lts-14.00. It requires GHC version 8.6.5. It will automatically download this version. To save disk space, you can generate stack global config (for example <code>stack path</code>) and change the global resolver in file <code>~/.stack/global-project/stack.yaml</code> to <code>lts-12.15</code>. Then open file <code>~/.stack/config.yaml</code> and add lines:
<pre>
system-ghc : true
skip-ghc-check: true
</pre>
</li>
<li> Continue with installation of required packages:
<pre class="bash">
stack install intero phoityne-vscode haskell-dap
</pre></li>
<li> Open VS Code and install extensions:
* Haskero
* Haskell GHCi Debug Adapter Phoityne
</li>
</ol>

=== Installation guide Ubuntu (all users) ===
<ol>
<li>
Perform following commands:
<pre class="bash">
sudo apt-get install haskell-platform
sudo apt-get install haskell-stack
sudo snap install code --classic
</pre>
</li>
<li>Create a directory that will be a stack root, it should be readable by all users (for example <code>/opt/stack</code>).</li>
<li>Create a file <code>/etc/profile.d/stack.sh</code> with following line:<CODE>export STACK_ROOT=</CODE>''your stack root directory''</li>
<li>Create a file <code>/etc/stack/config.yaml</code> with following lines:
<pre>
skip-ghc-check: true
system-ghc: true
allow-different-user: true
</pre>
</li>
<li>Generate stack global config (for example <code>stack path</code>) and change the global resolver in file <code>$STACK_ROOT/global-project/stack.yaml</code> to
*<code>lts-12.15</code> for Ubuntu 19.04 (ghc 8.4.4)
*<code>lts-8.0</code> for Ubuntu 18.04 (ghc 8.0.2)</li>
<li> Continue with installation of required packages:
<pre class="bash">
stack install intero phoityne-vscode haskell-dap
</pre></li>
<li>It will produce some executable files to <code>~/.local/bin</code> copy them to: <code>/usr/local/bin</code> (or other ''search when executing'' location).
</li>
<li> Open VS Code and install extensions:
* Haskero
* Haskell GHCi Debug Adapter Phoityne
</translate>
<pre class="bash">code --install-extension phoityne.phoityne-vscode
code --install-extension Vans.haskero</pre>
</li>
</ol>

@@ Line 3: / Line 3: @@
 In our lectures, we will be using Glasgow Haskell Compiler (GHC). It is a part of [https://www.haskell.org/downloads/#platform Haskell Platform].
-'''Best way is to use:''' [https://www.haskell.org/ghcup GHCUP]
+'''Best way is to use:''' [https://www.haskell.org/ghcup GHCup]
 In fact, any text editor is fine to create source codes. In our laboratories, we will be creating only a relatively small functions. By default, we will be using [https://code.visualstudio.com/ Visual Studio Code] with some plugins for syntax highlighting and code completion.

@@ Line 3: / Line 3: @@
 In our lectures, we will be using Glasgow Haskell Compiler (GHC). It is a part of [https://www.haskell.org/downloads/#platform Haskell Platform].
-'''Best way is to use:''' [GHCUP https://www.haskell.org/ghcup]
+'''Best way is to use:''' [https://www.haskell.org/ghcup GHCUP]
 In fact, any text editor is fine to create source codes. In our laboratories, we will be creating only a relatively small functions. By default, we will be using [https://code.visualstudio.com/ Visual Studio Code] with some plugins for syntax highlighting and code completion.

@@ Line 3: / Line 3: @@
 In our lectures, we will be using Glasgow Haskell Compiler (GHC). It is a part of [https://www.haskell.org/downloads/#platform Haskell Platform].
-'''Best way is to use GHCUP.''' [https://www.haskell.org/ghcup]
+'''Best way is to use:''' [GHCUP https://www.haskell.org/ghcup]
 In fact, any text editor is fine to create source codes. In our laboratories, we will be creating only a relatively small functions. By default, we will be using [https://code.visualstudio.com/ Visual Studio Code] with some plugins for syntax highlighting and code completion.

@@ Line 2: / Line 2: @@
 In our lectures, we will be using Glasgow Haskell Compiler (GHC). It is a part of [https://www.haskell.org/downloads/#platform Haskell Platform].
 In fact, any text editor is fine to create source codes. In our laboratories, we will be creating only a relatively small functions. By default, we will be using [https://code.visualstudio.com/ Visual Studio Code] with some plugins for syntax highlighting and code completion.
-== VS Code with Haskell plugin ==
+Recomendated is plugin: Haskell [https://marketplace.visualstudio.com/items?itemName=haskell.haskell]
-Default option for working environment. This option will be used in computer laboratories.
+== Outdated way to install Haskell ==
 === Installation guide Windows ===

@@ Line 17: / Line 17: @@
 <li>At an elevated command prompt, run:
 <pre>
-choco install ghc --version 8.10.1
+choco install ghc --version 8.10.5
 </pre>
-This will install GHC along with some utilities like Cabal. The version 8.10.1 is important. In the original guide, there is a command <code>choco install haskell-dev</code>. It will install newer version which is not supported by the VS Code Haskell plugin (valid 20.8.2020).
+This will install GHC along with some utilities like Cabal. The version 8.10.5 is important. In the original guide, there is a command <code>choco install haskell-dev</code>. It will install newer version which is not supported by the VS Code Haskell plugin (valid 20.8.2021).
   </li>
 <li>Restart may be required to continue.</li>

@@ Line 25: / Line 25: @@
 </ol>
-=== Installation guide Ubuntu ===
+=== Installation guide Ubuntu 20.04 ===
 == Haskero with Haskell GHCi debugger ==

@@ Line 1: / Line 1: @@
 =Installation Guide=
 == VS Code with Haskell plugin ==
 == Haskero with Haskell GHCi debugger ==
-Older variant of working environment.
+Other variant of working environment. It is configured using Stack.
 For VS Code, we will be using two extensions: