Skip to content

Documentation request - document how to override CSS elements #48

@couling

Description

@couling

Looking here: https://mkdocstrings.github.io/python/customization/ it describes the CSS classes which are used with mkdocstrings-python. Unfortunelty some of us are coming into this cold and so it's much less obvious how to customise them. Despite giving example CSS rules for Material and ReadTheDocs, there's no hint of where to copy-paste this code to.

I understand the basic principle of CSS and HTML, but have no idea about the architecture that would allow me to add additional CSS files.

Would it be possible to document how to override CSS elements (on the page linked above) or otherwise cross link the relevant documentation (say on Mkdocs?). At minimum, it would be helpful if those code examples for themes could be completed with instructions on what to do with them.


I'm hitting this because I personally find the grey styled code headings very distracting. All features other than the background are fine, but the grey box is tripping my eye into missing that it's a heading.

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions