9

Haddock は、ドキュメント内の非 ASCII 文字を UTF-8 でエンコードされたソース ファイルに誤って再エンコードしているようです。ドキュメントに数式を含める必要があることがよくありますが、合計 (∑) などの一般的な数学記号を使用できると、はるかに読みやすくなります。

ただし、haddock を使用してファイルを実行すると、これらの記号は空白の四角形になります。Haddockにはオプション--use-unicodeがありますが、実際のドキュメントを壊しながら、関数シグネチャなどの関数矢印をUnicode文字に変換するだけです。

これがから制御できるとさらに良いでしょうcabal haddock

Haddock バージョン 2.9.4 を使用しています。

4

2 に答える 2

9

Haddock は GHC API を使用して解析を行うことに注意してください。コメント内の非 ASCII 文字は GHC < 7.4 では適切に処理されませんが、GHC 7.4 では問題なく動作するようです。

于 2012-03-01T21:36:57.630 に答える
4

UTF-8を使用できず、&#8721;または&­#x2211;(これらはn-ary合計記号∑の正しい参照)のような数字参照が読み取り不能と見なされる場合、唯一のオプションは、のような名前付き参照を使用する&sum;ことです。 HTML結果渡され、使用されるブラウザでサポートされます。

新しいHTML5エンティティのサポートはかなり限られているため、これは大きな「if」ですが、おそらく誰もがFirefoxを使用するイントラネットでは... HTML5エンティティ: http ://www.whatwg.org/specs/web-apps/current- work / multipage / named-character-references.html

(そして、ほとんどの参照は、それほどニーモニックではありません&sum;。)

于 2012-03-01T16:54:21.403 に答える