Skip to content

Preserve .css files in target/doc #294

@japaric

Description

@japaric

Background / use case

For the cortex-m-rtfm crate I ship an mdbook with the API
documentation
and host both on GH pages. This setup works OK for now but
I'll start having problems once I release a new minor version: people looking at
older minor versions (e.g. on docs.rs) will be directed to the latest version of
the book on GH pages and get confused.

Ideally, I'd like to move away from GH pages and host both the API docs and the
mdbook on docs.rs. That way people will get the right version of the mdbook
regardless of the minor version of the crate they are looking at.


I experimented a bit with getting an mdbook rendered on docs.rs and managed to
place the mdbook output in the target/doc directory using build scripts. You can
see the results at
https://docs.rs/cautious-octo-funicular/0.1.3/cautious_octo_funicular/ -- the
mdbook is there but the layout is all wrong. According to @QuietMisdreavus the
mdbook CSS files are not being preserved and that's why the mdbook shows
unstyled.

This issue is to request that .css files placed in target/doc are preserved to
support the above use case.

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-buildsArea: Building the documentation for a crate

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions