[Haskell-cafe] Multi-site haddock documentation with proper links?

Brent Yorgey byorgey at seas.upenn.edu
Wed Apr 25 16:09:55 CEST 2012


It is possible.  I have done it for 
  
  http://projects.haskell.org/diagrams/doc/index.html

But it is not fun, and it took me several days of work (spread over
two weeks) to figure out the proper magic incantations to get
everything to work properly.  I really ought to write up a blog post
with instructions; I'll try to do that soon.

-Brent

On Tue, Apr 24, 2012 at 08:34:53PM -0400, Ryan Newton wrote:
> Hello cafe,
> 
> For various reasons, some packages don't build documentation on hackage:
> 
>    http://hackage.haskell.org/package/accelerate
> 
> Therefore I want to locally install documentation for a set of packages
> like this and host them on a separate website.  I want all of these ~ten
> packages' haddock documentation to be properly interlinked with eachother,
> but also to link to Hackage for types and classes defined in other modules.
> 
> Is this possible?  Hackage haddocks are all interlinked, but that is simply
> because hackage is one giant local install, right?
> 
> If it's not possible (and it seems not) do any haddock devs have pointers
> on how to implement this?
> 
> Thanks,
>   -Ryan
> 
> P.S.  Someone recommended to me the following simple hack -- just use sed
> to rewrite the links after haddock generates the html.  I think I'll do
> that for the time being unless someone has a better suggestion.

> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe




More information about the Haskell-Cafe mailing list