[haddock] #108: Output semantically correct HTML

haddock haddock at projects.haskell.org
Fri May 22 08:04:22 EDT 2009


#108: Output semantically correct HTML
-------------------+--------------------------------------------------------
Reporter:  tibbe   |       Owner:  tibbe
    Type:  defect  |      Status:  new  
Priority:  major   |   Milestone:  _|_  
 Version:  2.4.2   |    Keywords:       
-------------------+--------------------------------------------------------
 Haddock's HTML output relies on tables for layout and formatting. This has
 two drawbacks:

 1. The generated HTML is much larger than needed as more tags are needed.

 2. It's hard to write alternative stylesheets.

 I've been experimenting with a new stylesheet and I believe we can get
 away with using less markup than we currently do. The only place where I
 see a possible need to use tables in the markup is in the function
 parameter listings and even there a definition list would probably be more
 appropriate.

 I've attached an example HTML file that demonstrates what the markup could
 look like. It comes with a stylesheet that mimics the style used at Google
 Code. This stylesheet is for demonstration purposes only.

 The first two tasks would be to change the HTML backend to output
 semantically correct HTML and to create a stylesheet that replicates the
 current Haddock style using this HTML.

-- 
Ticket URL: <http://trac.haskell.org/haddock/ticket/108>
haddock <http://www.haskell.org/haddock>
Haddock, The Haskell Documentation Tool


More information about the Haddock mailing list