steveklabnik/rustdoc

Flag: markdown-css

Opened this issue · 2 comments

steveklabnik commented

This issue is part of #125

--markdown-css: include more CSS files when rendering markdown

Using this flag looks like this:

$ rustdoc README.md --markdown-css foo.css

When rendering Markdown files, this will create a <link> element in the
<head> section of the generated HTML. For example, with the invocation above,

<link rel="stylesheet" type="text/css" href="foo.css">

will be added.

When rendering Rust files, this flag is ignored.

Should we keep this flag or not?

steveklabnik commented

I think we should support this use-case, but I'm not sure that this flag is the right way to do it.

steveklabnik commented

We talked about this at the tools team meeting today and the intention is to figure out support for lightly customizing rustdoc's output as a first-class thing, but not necessarily via this low-level mechanism.