Skip to content

Documentation request - document how to override CSS elements #48

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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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