One of the possible use-cases for Gitit is as a web frontend to a repo of
Haskell code with Haddock markup - the idea being that people could easily
edit the code and docs.
If Haddock could be input (and output as HTML), then .hs files could be
treated as a sort of literate Haskell file: the '-- | foo' sections would
be rendered as a normal kind of text (similar to what one would get if one
had written in Markdown), and the source code itself could appear in nice
~~~{.haskell} sections.
Thus, a user could edit a page and immediately see whether he created nice
Haddock output (something which otherwise requires a tedious cycle of
Haddock build && install && browse to the generated HTML).
The Hackage server is already compiling Haddock markup to HTML, as the
'description:' field of Cabal files is Haddock as dcoutts tells me. Thus,
besides the Haddock codebase itself, there are Haddock parsers in
http://code.haskell.org/hackage-server/Distribution/Server/Pages/Package/ or
http://darcs.haskell.org/hackage-scripts/
Original issue reported on code.google.com by gwe...@gmail.com on 25 Jan 2009 at 12:00
Original issue reported on code.google.com by
gwe...@gmail.comon 25 Jan 2009 at 12:00