diff --git a/site/start-coding.markdown b/site/start-coding.markdown new file mode 100644 index 0000000..72c3107 --- /dev/null +++ b/site/start-coding.markdown @@ -0,0 +1,34 @@ +--- +title: Start Coding Now +page: start-coding +isSetUp: true +--- + +## Install a development environment in three steps + +A Haskell development environment consists of: + +- a compiler (`ghc`) +- a language server (`hls`) +- a build tool (`cabal` and/or `stack`) +- an editor compatible with the language server protocol. + +It is recommended to use `ghcup` to manage your haskell toolchain and `vscode` as your editor. + +- **Step 1**: Install [GHCup](https://www.haskell.org/ghcup/). You'll be prompted to install some tools: Install `hls` and optionally `stack`. (`stack` users should [configure it properly](https://docs.haskellstack.org/en/stable/Stack_and_VS_Code/#workaround-1)). +- **Step 2**: Install [vscode](https://code.visualstudio.com/). For integration with other editors see `hls` [documentation](https://haskell-language-server.readthedocs.io/en/latest/configuration.html#configuring-your-editor) +- **Step 3**: Open `vscode` and install the [haskell extension](https://marketplace.visualstudio.com/items?itemName=haskell.haskell) either using the extension panel or pressing CTRL+P and `ext install haskell.haskell`. + +## Try without installing Haskell + +If you don't want to install the Haskell toolchain locally, you can: + +- Try it in the [Haskell Playground](https://play-haskell.tomsmeding.com/) + +- Use a complete visual studio code environment in Gitpod. + +[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/gitpod-io/template-haskell) + +## Learn Haskell + +Now you are ready to code. Pick up a learning resource from the [documentation page](/documentation/) and start to learn Haskell. Also, you may want to familiarize yourself with the build tool of your choice and the library ecosystem. Check out sections [Manuals and guides](/documentation/#manuals-and-guides) and [Library Documentation](/documentation/#library-documentation) for this purpose. diff --git a/site/templates/nav.html b/site/templates/nav.html index 2117608..bde0d83 100644 --- a/site/templates/nav.html +++ b/site/templates/nav.html @@ -8,6 +8,7 @@