On 06/20/2013 04:44 PM, Daniel Micay wrote:
On Thu, Jun 20, 2013 at 7:30 PM, Brian Anderson <[email protected]> wrote:
Regarding HTML generation, I think we should not lean on pandoc so heavily.
rustdoc currently produces a page of markdown at a time to pass to pandoc.
This conversion drops a lot of semantic content on the floor. We should
instead output proper semantic HTML that is tailored to Rust and only use a
markdown renderer to convert small sections of doc comments to HTML.
We could be making much better use of pandoc since it uses a superset
of markdown. For example, with an up-to-date pandoc, the function
signatures and code examples get syntax highlighted.
http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown
Another thing to consider is switching to sphinx and avoiding the pain
of doing this all ourselves. Converting our markdown to restructured
text would be pretty trivial.
I guess if we're going to switch to sphinx now is the time, but I
haven't looked at it. Their web page does make it sound fairly
python-centric though.
_______________________________________________
Rust-dev mailing list
[email protected]
https://mail.mozilla.org/listinfo/rust-dev
