You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chris Done 672d2c4b22 Add coming soon to docs 6 years ago
config Start of downloads split off 6 years ago
design Theme tweaks 6 years ago
scripts Use lzma for deployment (a bit faster to upload) 6 years ago
src Add coming soon to docs 6 years ago
static Add coming soon to docs 6 years ago
submodules Add submodule and README.md 6 years ago
themes/purple/fonts First commit 6 years ago
.ghci Add landing page 6 years ago
.gitignore Ignore .hsenvs 6 years ago
.gitmodules Add submodule and README.md 6 years ago
LICENSE First commit 6 years ago
README.md Haskell code pages docs 6 years ago
Setup.hs First commit 6 years ago
hl.cabal Fix warnings 6 years ago
hl.org Add to hl.org 6 years ago

README.md

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 git@github.com:chrisdone/hl.git

You need one of these GHC versions:

  • GHC 7.6
  • GHC 7.8

Create an hsenv:

$ 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:

$ sh scripts/pull-build

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

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.

Templates are written in senza, a convenience wrapper to blaze-html. There is presently no database.

Style

I use this style for code. You don’t have to use this style, I can reformat patches as they come in.