gelisam/haskell.org

Haskell web site

haskell-lang

Haskell web site.

Editing pages

If you're just here to contribute a content change, read this section.

All pages that are produced by markdown are here. To contribute changes simply fork this repo and open a pull request. It will be merged and redeployed in short order.

If you want to edit a page which has some custom code in it, you'll want to see the next sections for building and running instructions. Maybe also take a look at architecture.

If you want to include Haskell code samples in markdown, use:

``` haskell
main = putStrLn "Hello, World!"
```

If you want to include Haskell code samples in Haskell code pages, use:

haskellPre "main = print 123"
haskellCode "peyton `simon` jones"

Pre for <pre> block, code for <code> span snippet.

Building

Clone the repo:

$ git clone [email protected]:haskell-infra/hl.git

You need one of these GHC versions:

• GHC 7.6
• GHC 7.8

Heads up: hsenv doesn't currently work on GHC 7.8. To get around this, you can instead try just making a cabal sandbox and using the hl-ghc7.8.cabal file to setup all direct and transient dependencies.

Create an hsenv (cabal sandbox doesn't support specifying a repo yet):

$ cd hl
$ hsenv
$ source .hsenv/bin/activate

You need the right package set. Add the following to your .hsenv/cabal/config, replacing the Hackage reference:

• If you have GHC 7.6:

    remote-repo: stackage:http://www.stackage.org/stackage/1ba546f8f281c02d135ec3babd86516f726b4453
  

• If you have GHC 7.8:

    remote-repo: stackage:http://www.stackage.org/stackage/160b97ce7459820d4de720d6a867b85297ab4351
  

Now just run:

$ git submodule init
$ sh scripts/pull-build

To do the cabal update, submodule, install, etc.

Done!

Using sandboxes

Clone the repo:

$ git clone [email protected]:haskell-infra/hl.git

Set up sandbox:

$ cabal sandbox init

Install dependencies and build:

$ cabal install --only-dependencies
$ cabal build

Done!

Running

It runs at: http://localhost:1990/

Manually running the binary:

$ dist/build/hl/hl

Running from inside GHCi:

> :l DevelMain
> DevelMain.update

Run this every time you want to update the web handler in-place, as in this demo.

If you use Emacs, you can just bind it to a key:

(define-key html-mode-map [f12] 'haskell-process-reload-devel-main)

Just hit f12 to recompile and restart.

Architecture

It uses Yesod and an MVC organization.

• HL.M.* -- models
• HL.V.* -- views
• HL.C.* -- controllers

Templates are written in Lucid. There is presently no database.

Style

We generally use this style for this project. You don't have to use this style, we can reformat patches as they come in.