Skip to content
This repository has been archived by the owner on May 20, 2020. It is now read-only.

Flag: html-*-content #145

Open
steveklabnik opened this issue Aug 10, 2017 · 2 comments
Open

Flag: html-*-content #145

steveklabnik opened this issue Aug 10, 2017 · 2 comments

Comments

@steveklabnik
Copy link
Owner

This issue is part of #125

I'm lumping two into this issue:

--html-before-content: include more HTML before the content

Using this flag looks like this:

$ rustdoc src/lib.rs --html-before-content extra.html
$ rustdoc README.md --html-before-content extra.html

This flag takes a list of files, and inserts them inside the <body> tag but
before the other content rustodc would normally produce in the rendered
documentation.

--html-after-content: include more HTML after the content

Using this flag looks like this:

$ rustdoc src/lib.rs --html-after-content extra.html
$ rustdoc README.md --html-after-content extra.html

This flag takes a list of files, and inserts them before the </body> tag but
after the other content rustodc would normally produce in the rendered
documentation.


Should we keep this flag or not?

@steveklabnik
Copy link
Owner Author

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

@steveklabnik
Copy link
Owner Author

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.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

1 participant