Haskell web site.
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.
Clone the repo:
$ git clone git@github.com: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!
Clone the repo:
$ git clone git@github.com:haskell-infra/hl.git
Set up sandbox:
$ cabal sandbox init
Install dependencies and build:
$ cabal install --only-dependencies
$ cabal build
Done!
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.
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.
We generally use this style for this project. You don't have to use this style, we can reformat patches as they come in.