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. _______________________________________________ Rust-dev mailing list [email protected] https://mail.mozilla.org/listinfo/rust-dev
