argumatronic / hl

Haskell web site

hl

Haskell.org 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

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.Model.* -- models
• HL.View.* -- views
• HL.Controller.* -- 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.